Cloud Translation - Advanced details

Cloud Translation - Advanced is part of the Cloud Translation service that provides access to state-of-the-art models like the Translation LLM, Adaptive Machine Translation (AMT) models, and custom AutoML models and supports translation features such as glossaries and batch requests.

Features

The key features of Cloud Translation - Advanced are:

  • Access to more models - Pick the right model for you from among state-of-the-art translation models like the Translation LLM, Google's Neural Machine Translation (NMT) model, Adaptive translation models, or custom AutoML models that you or someone else created by using AutoML Translation.

  • Glossaries - Create a custom dictionary to correctly and consistently translate domain-specific terms.

  • Batch requests - Make asynchronous requests to translate large amounts of text.

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

  • IAM roles - Secure your translation requests by using Identity and Access Management. Create service accounts and grant them permissions by adding IAM roles. Cloud Translation - Advanced does not support API keys.

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

  • Regional endpoint - Exercise control over where the resources for your project are stored and processed.

Glossaries

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, refer to Creating and using glossaries.

Batch requests

Batch translation requests are asynchronous requests that translate input from Cloud Storage buckets. 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, refer to 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.

Cloud Translation - Advanced features, such as glossaries and AutoML models also work with 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, refer to Translate documents.

Model selection and AutoML models

Cloud Translation - Advanced model selection lets you dynamically select the right model for your application from among the Translation LLM (which you can also further customize for adaptive translations), Google's NMT model or custom AutoML Translation models, depending on the context and the content that you're translating.

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, refer to 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, refer to 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, refer to 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 example, 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, refer to Granting, changing, and revoking access to resources and Granting roles to service accounts.

Labels

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, refer to 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 that 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, refer to 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