2. Setup and Requirements

Self-paced environment setup

1. Sign-in to theGoogle Cloud Console and create a new project or reuse an existing one. If you don't already have a Gmail or Google Workspace account, you mustcreate one.

• TheProject name is the display name for this project's participants. It is a character string not used by Google APIs. You can always update it.
• TheProject ID is unique across all Google Cloud projects and is immutable (cannot be changed after it has been set). The Cloud Console auto-generates a unique string; usually you don't care what it is. In most codelabs, you'll need to reference your Project ID (typically identified asPROJECT_ID). If you don't like the generated ID, you might generate another random one. Alternatively, you can try your own, and see if it's available. It can't be changed after this step and remains for the duration of the project.
• For your information, there is a third value, aProject Number, which some APIs use. Learn more about all three of these values in thedocumentation.

2. Next, you'll need toenable billing in the Cloud Console to use Cloud resources/APIs. Running through this codelab won't cost much, if anything at all. To shut down resources to avoid incurring billing beyond this tutorial, you can delete the resources you created or delete the project. New Google Cloud users are eligible for the$300 USD Free Trial program.

Start Cloud Shell

While Google Cloud can be operated remotely from your laptop, in this codelab you will be usingGoogle Cloud Shell, a command line environment running in the Cloud.

From theGoogle Cloud Console, click the Cloud Shell icon on the top right toolbar:

It should only take a few moments to provision and connect to the environment. When it is finished, you should see something like this:

This virtual machine is loaded with all the development tools you'll need. It offers a persistent 5GB home directory, and runs on Google Cloud, greatly enhancing network performance and authentication. All of your work in this codelab can be done within a browser. You do not need to install anything.

3. Enable the Translation API

Before you can begin using the Translation API, you must enable the API. You can enable the API by using the following command in the Cloud Shell:

gcloudservicesenabletranslate.googleapis.com

6. Translate text

You can use Translate API to translate a text in one language into another language. Text is translated using the Neural Machine Translation (NMT) model. If the NMT model is not supported for the requested language translation pair, then the Phrase-Based Machine Translation (PBMT) model is used.

To translate text, navigate to theProgram.cs file inside theTranslationApiDemo folder and replace the code with the following:

usingSystem;usingGoogle.Cloud.Translation.V2;namespaceTranslationApiDemo{classProgram{staticvoidMain(string[]args){varclient=TranslationClient.Create();vartext="Hello World!";varresponse=client.TranslateText(text,LanguageCodes.Turkish,LanguageCodes.English);Console.WriteLine(response.TranslatedText);}}}

Take a minute or two to study the code. It translates the text "Hello World" from English to Turkish*.*

Back in Cloud Shell, run the app. You should see the following output:

dotnetrunSelamDünya!

Summary

In this step, you were able to use Translation API to translate a text from English to Turkish. Read more aboutTranslating text.

7. Detect language

You can use Translate API to also detect the language of a text string.

To detect language, navigate to theProgram.cs file inside theTranslationApiDemo folder and replace the code with the following:

usingSystem;usingGoogle.Cloud.Translation.V2;namespaceTranslationApiDemo{classProgram{staticvoidMain(string[]args){varclient=TranslationClient.Create();vartext="Selam Dünya!";vardetection=client.DetectLanguage(text);Console.WriteLine($"Language: {detection.Language}\tConfidence: {detection.Confidence}");}}}

Take a minute or two to study the code. It detects the language of the text "Selam Dünya!" which happens to be a Turkish phrase*.*

Back in Cloud Shell, run the app. You should see the following output:

dotnetrunLanguage:trConfidence:1

Summary

In this step, you were able to detect the language of a piece of text using Translation API. Read more aboutDetecting language.

8. Congratulations!

You learned how to use the Translation API using C#!

Clean up

To avoid incurring charges to your Google Cloud Platform account for the resources used in this quickstart:

• Go to theCloud Platform Console.
• Select the project you want to shut down, then click ‘Delete' at the top: this schedules the project for deletion.

Learn More

• Google Cloud Translation API:https://cloud.google.com/translate/docs
• C#/.NET on Google Cloud Platform:https://cloud.google.com/dotnet/
• Google Cloud .NET client:https://googlecloudplatform.github.io/google-cloud-dotnet/

License

This work is licensed under a Creative Commons Attribution 2.0 Generic License.