Cloud Translation - Advanced details

Cloud Translation - Advanced is part of the Cloud Translation service that provides support for glossaries, batch requests, and AutoML models.


The following list summarizes the key features of Cloud Translation - Advanced.

  • Glossaries - You can create a custom dictionary to correctly and consistently translate domain-specific terms.

  • Batch requests - You can make an asynchronous request to translate large amounts of text.

  • Document Translation - Translate documents, such as PDF files, to preserve the original format and layout.

  • Model selection and AutoML models - You can translate text by using Google's Neural Machine Translation (NMT) or AutoML models that you or someone else created by using AutoML Translation.

  • IAM roles - You secure your translation requests by using Identity and Access Management. Create service accounts and grant them permissions by adding IAM roles. Cloud Translation - Advanced doesn't support API keys.

  • Labels - You can add user-defined labels (key-value pairs) to your translation requests to better track usage.

  • Regional endpoint - You can have some control over where the resources for your project are stored and processed.


A glossary is a custom dictionary that Cloud Translation - Advanced uses to correctly and consistently translate terms that are specific to you. Glossaries are commonly used to translate domain-specific terms and named entities. For example, you can use a glossary to specify a specific translation for terms such as "Google Summer of Code," "Gmail confidential mode," or "placement performance report."

You can also use glossaries to prevent words, such as borrowed words or product names, from being translated. For information about creating and using glossaries, see Creating and using glossaries.

Batch requests

Batch translation requests are asynchronous requests that translate input from Cloud Storage bucket. Cloud Translation - Advanced performs the batch translation as a long-running operation and writes the output to a Cloud Storage bucket that you specify. Inline requests for batch translation are not supported.

For information on making batch requests, see Batch requests (Advanced).

Document Translation

Document Translation lets you directly translate existing documents, such as PDF and DOCX files, to a target language. Document Translation preserves the original format so that translated documents have the same layout and format as the original documents. For example, Document Translation keeps paragraph breaks and headings so that your translated content is divided like in the original document.

You can leverage Cloud Translation - Advanced features, such as glossaries and AutoML models, when you use Document Translation. For example, if you have an existing AutoML model that you use for text translations, you can use that same model for Document Translation. For more information about supported file types and how to translate documents, see Translate documents.

Model selection and AutoML models

Cloud Translation - Advanced model selection enables you to dynamically select Google's NMT or an AutoML Translation model, depending on the context and the content that you're translating.

You can create a custom model by using AutoML Translation to get more accurate translations for domain-specific terminology. You can then use the resulting model in Cloud Translation - Advanced to translate text.

For information on using custom models to translate text, see Translating text (Advanced).

IAM roles

Cloud Translation - Advanced integrates with IAM to provide additional security for your translation requests, enable fine-grained access control, and support integration with AutoML Translation.

You must add users and service accounts to one of the following roles to grant those accounts access to Cloud Translation - Advanced. For information about creating service accounts, see Creating and managing service accounts in the IAM documentation.

Role Role ID Description
Cloud Translation API Viewer roles/cloudtranslate.viewer Can access get and list operations.
Cloud Translation API User roles/cloudtranslate.user

Includes the permissions of roles/cloudtranslate.viewer. Can translate text using the NMT and AutoML Translation models in online and asynchronous (batch) mode. Can use Document Translation. Can detect language. Can list supported languages for the NMT and AutoML Translation models. Can use glossaries for translation.

Cloud Translation API Editor roles/cloudtranslate.editor

Includes the permissions of roles/cloudtranslate.user, and can create and delete glossaries, and cancel or delete long-running operations.

Cloud Translation API Admin roles/cloudtranslate.admin

Includes the permissions of roles/cloudtranslate.editor, and can set IAM policies and grant IAM permissions for the Cloud Translation API. Has all IAM permissions for the Cloud Translation API.

To see a list of permissions that are contained in each role, see Understanding roles.

These pre-configured roles address many typical use cases. However, you might need a role that includes a custom set of permissions. For instance, you might want to create a role that allows a user to create a glossary in a project, without letting them delete or update existing glossaries in the project. In those cases, you can create an IAM custom role that meets your needs.

For information on managing IAM roles, see Granting, changing, and revoking access to resources and [Granting roles to service accounts].


Cloud Translation - Advanced supports adding user-defined labels (key-value pairs) to TranslateText, BatchTranslateText and DetectLanguage requests. Information about a request's usage is forwarded to the billing system where you can break down your billing charges by filtering on your labels.

For more information about user-defined labels, see Reporting usage with labels (Advanced).

Regional endpoint

By default, Cloud Translation - Advanced stores and processes resources in a global location, which means there is no guarantee resources remain within a particular location. Instead of using the default global endpoint, you can use a regional endpoint to keep resources within a particular location, such as the European Union. For more information, see Specify a regional endpoint.

Migrate to Advanced from Basic

If already have existing applications that use Cloud Translation - Basic, you can migrate them to use Cloud Translation - Advanced. To use Cloud Translation - Advanced, you must update applications to use, for example, service accounts and the Advanced edition client libraries. For more information, see Migrating to Cloud Translation - Advanced.

What's next