# Setup
To start using Cloud Translation, you need a project that has the Cloud Translation API
enabled and credentials to make authenticated calls. The following sections
detail how to get set up before you make your first call to the Cloud Translation API.
The setup process involves the Google Cloud console, which is a web interface that
you can use to provision, configure, manage, and monitor systems in
Google Cloud. If you haven't used the Google Cloud console before, see the
[Cloud console](https://docs.cloud.google.com/cloud-console) page for more information.
## Before you begin
Cloud Translation is available in [two
editions](https://docs.cloud.google.com/translate/docs/overview) (*Basic* and *Advanced*). Decide which
edition to use because each edition has its own set of client libraries.
## Create or select a project
To use services provided by Google Cloud,
you must create a *project* .
A project organizes all your Google Cloud resources.
A project consists of a set of collaborators,
enabled APIs (and other resources), monitoring tools, billing information,
and authentication and access controls.
You can create one project,
or you can create multiple projects
and use them to organize your Google Cloud resources in a
[resource hierarchy](https://docs.cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy.md.txt).
When creating a project, take note of the
[project ID](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects.md.txt#identifying_projects).
You will need this ID to make API calls.
For more information on projects, see the
[Resource Manager documentation](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects.md.txt).
We recommend that you create separate projects for experiments, testing, and
production. After you create a project, record the [project number or
ID](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects).
You must provide the project number (or ID) when you make calls to the
Cloud Translation API.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
**Roles required to select or create a project**
- **Select a project**: Selecting a project doesn't require a specific IAM role---you can select any project that you've been granted a role on.
- **Create a project** : To create a project, you need the Project Creator role (`roles/resourcemanager.projectCreator`), which contains the `resourcemanager.projects.create` permission. [Learn how to grant
roles](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access).
[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)
## Enable billing
You must enable billing to use Cloud Translation. For more information about
Cloud Translation pricing, see the [pricing page](https://cloud.google.com/translate/pricing).
> [!NOTE]
> **Note:** To help you manage your budget, you can set your usage limits on your projects. For more information, see [Set usage quotas](https://docs.cloud.google.com/translate/docs/setup.md.txt#quota).
A billing account is used to define who pays for a given set of resources,
and it can be linked to one or more projects.
Project usage is charged to the linked billing account.
In most cases, you configure billing when you create a project.
For more information, see the
[Billing documentation](https://docs.cloud.google.com/billing/docs.md.txt).
[Verify that billing is enabled for your Google Cloud project](https://docs.cloud.google.com/billing/docs/how-to/verify-billing-enabled.md.txt#confirm_billing_is_enabled_on_a_project).
## Enabling the API
You must enable the Cloud Translation API for your project.
For more information on enabling APIs, see the
[Service Usage documentation](https://docs.cloud.google.com/service-usage/docs/enable-disable.md.txt).
Enable the Cloud Translation API, if it is not already enabled.
**Roles required to enable APIs**
To enable APIs, you need the `serviceusage.services.enable` permission. If you
created the project, then you likely already have this permission through the
Owner role (`roles/owner`). Otherwise, you can get this permission through the
Service Usage Admin role (`roles/serviceusage.serviceUsageAdmin`).
[Learn how to grant roles](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).
[Enable the API](https://console.cloud.google.com/apis/enableflow?apiid=translate.googleapis.com)
## Set usage quotas
Cloud Translation has a quota management system to help you and Google manage
usage of the service. By default, the number of characters that you can send per
day is unlimited. If you have a set budget, we recommend monitoring your daily
usage and adjusting quotas according to your planned spend.
For more information about quotas, see [Quotas and limits](https://docs.cloud.google.com/translate/quotas.md.txt).
## Set up authentication
If you plan to use the Cloud Translation API, you need to set up authentication.
Any client application that uses the API must be authenticated and granted
access to the requested resources. For more information, see [Authenticate to
Cloud Translation](https://docs.cloud.google.com/translate/docs/authentication).
### Identity and Access Management roles
When a principal (user account, service account, and so on) calls an API,
Google Cloud requires that the principal has the appropriate permissions.
You can grant permissions by granting roles to a principal. For more
information, see [Control access with
IAM](https://docs.cloud.google.com/translate/docs/access-control).
> [!NOTE]
> **Note:** **Role permissions only apply to Cloud Translation - Advanced**. Although you can use service accounts for both editions, you can only set specific permissions for Cloud Translation - Advanced. For Cloud Translation - Basic, you can make any request regardless of the service account's permissions.
## Installing client libraries
Client libraries are available for several popular languages. We recommend that
you use these client libraries to make calls to Cloud Translation because they
make it easier to access the APIs. If a client library doesn't meet your
needs or isn't available for your language, build your own custom code. For
more information, see [Using your own client
code](https://cloud.google.com/apis/docs/client-libraries-explained#using_your_own_client_code).
For example, when you use a client library, it can determine your credentials
implicitly through the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.
You don't need to explicitly specify your credentials in code. For more
information, see [Client Libraries
Explained](https://docs.cloud.google.com/apis/docs/client-libraries-explained) in the Cloud APIs
documentation.
### Cloud Translation - Basic client libraries
Select the programming language that you are using for development, and then run
the related command. For more information, see the Cloud Translation - Basic
[client libraries overview](https://docs.cloud.google.com/translate/docs/reference/libraries/v2/overview-v2.md.txt).
### C#
```
nuget install Google.Cloud.Translation.V2
```
### Go
```
go get cloud.google.com/go/translate
```
### Java
> [!CAUTION]
> **Caution:** The Java client library does not support Android.
If you are using [Maven](https://maven.apache.org/), add
the following to your `pom.xml` file. For more information about
BOMs, see [The Google Cloud Platform Libraries BOM](https://cloud.google.com/java/docs/bom).
```java
com.google.cloud
libraries-bom
26.90.0
pom
import
com.google.cloud
google-cloud-translate
```
If you are using [Gradle](https://gradle.org/),
add the following to your dependencies:
```java
implementation platform('com.google.cloud:libraries-bom:26.90.0')
implementation 'com.google.cloud:google-cloud-translate'
```
If you are using [sbt](https://www.scala-sbt.org/), add
the following to your dependencies:
```java
libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.102.0"
```
If you're using Visual Studio Code or IntelliJ, you can add client libraries to your
project using the following IDE plugins:
- [Cloud Code for VS Code](https://docs.cloud.google.com/code/docs/vscode/client-libraries.md.txt)
- [Cloud Code for IntelliJ](https://docs.cloud.google.com/code/docs/intellij/client-libraries.md.txt)
The plugins provide additional functionality, such as key management for service accounts. Refer
to each plugin's documentation for details.
> [!NOTE]
> **Note:** Cloud Java client libraries do not currently support Android.
### Node.js
For more on setting up your Node.js development environment, refer to the
[Node.js Development Environment Setup Guide](https://docs.cloud.google.com/nodejs/docs/setup.md.txt).
```
npm install @google-cloud/translate
```
### PHP
```
composer require google/cloud-translate
```
### Python
For more on setting up your Python development environment, refer to the
[Python Development Environment Setup Guide](https://docs.cloud.google.com/python/docs/setup.md.txt).
```
pip install google-cloud-translate==2.0.1
```
### Ruby
For more on setting up your Ruby development environment, refer to the
[Ruby Development Environment Setup Guide](https://docs.cloud.google.com/ruby/docs/setup.md.txt).
```
gem install google-cloud-translate-v2
```
### Cloud Translation - Advanced client libraries
Select the programming language that you are using for development, and then run
the related command. For more information, see the Cloud Translation - Advanced
[client libraries overview](https://docs.cloud.google.com/translate/docs/reference/libraries/v3/overview-v3.md.txt).
### C#
```
nuget install Google.Cloud.Translate.V3 -Pre
```
### Go
```
go get cloud.google.com/go/translate/apiv3
```
### Java
> [!CAUTION]
> **Caution:** The Java client library does not support Android.
If you are using [Maven](https://maven.apache.org/), add
the following to your `pom.xml` file. For more information about
BOMs, see [The Google Cloud Platform Libraries BOM](https://cloud.google.com/java/docs/bom).
```java
com.google.cloud
libraries-bom
26.90.0
pom
import
com.google.cloud
google-cloud-translate
```
If you are using [Gradle](https://gradle.org/),
add the following to your dependencies:
```java
implementation platform('com.google.cloud:libraries-bom:26.90.0')
implementation 'com.google.cloud:google-cloud-translate'
```
If you are using [sbt](https://www.scala-sbt.org/), add
the following to your dependencies:
```java
libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.102.0"
```
If you're using Visual Studio Code or IntelliJ, you can add client libraries to your
project using the following IDE plugins:
- [Cloud Code for VS Code](https://docs.cloud.google.com/code/docs/vscode/client-libraries.md.txt)
- [Cloud Code for IntelliJ](https://docs.cloud.google.com/code/docs/intellij/client-libraries.md.txt)
The plugins provide additional functionality, such as key management for service accounts. Refer
to each plugin's documentation for details.
> [!NOTE]
> **Note:** Cloud Java client libraries do not currently support Android.
### Node.js
For more on setting up your Node.js development environment, refer to the
[Node.js Development Environment Setup Guide](https://docs.cloud.google.com/nodejs/docs/setup.md.txt).
```
npm install @google-cloud/translate
```
### PHP
```
composer require google/cloud-translate
```
### Python
For more on setting up your Python development environment, refer to the
[Python Development Environment Setup Guide](https://docs.cloud.google.com/python/docs/setup.md.txt).
```
pip install --upgrade google-cloud-translate
```
### Ruby
For more on setting up your Ruby development environment, refer to the
[Ruby Development Environment Setup Guide](https://docs.cloud.google.com/ruby/docs/setup.md.txt).
```
gem install google-cloud-translate
```
## Install the Google Cloud CLI
> [!NOTE]
> **Note:** You can skip this step if you won't be using the command line to make authenticated API calls.
If you plan to send Cloud Translation requests through the command line (such as
through curl commands), install and initialize the [gcloud CLI](https://docs.cloud.google.com/sdk/gcloud.md.txt)
, which is included in the Google Cloud CLI. The following link
provides more information:
[Install](https://docs.cloud.google.com/sdk/docs/install) the Google Cloud CLI.
After installation,
[initialize](https://docs.cloud.google.com/sdk/docs/initializing) the Google Cloud CLI by running the following command:
```bash
gcloud init
```
If you're using an external identity provider (IdP), you must first
[sign in to the gcloud CLI with your federated identity](https://docs.cloud.google.com/iam/docs/workforce-log-in-gcloud.md.txt).
### Test the SDK and authentication
If you have set up the `GOOGLE_APPLICATION_CREDENTIALS` environment variable,
you can use `gcloud` to test your authentication environment. Run the following
command and verify that no error occurs and that credentials are returned:
```
gcloud auth application-default print-access-token
```
The previous command is used by all Cloud Translation command line REST
samples to authenticate API calls.
## What's next
- Try the quickstarts to make simple translation calls:
- [Cloud Translation - Basic quickstart](https://docs.cloud.google.com/translate/docs/translate-text.md.txt#basic_tx)
- [Cloud Translation - Advanced quickstart](https://docs.cloud.google.com/translate/docs/translate-text.md.txt#advanced_tx)
- View the [product overview](https://docs.cloud.google.com/translate/docs/overview.md.txt) for more information about
using various Cloud Translation features.