Introducing Cloud Translation - Advanced

The Cloud Translation - Advanced includes several additional features and updates:

Features

  • Glossaries - Create a custom dictionary to correctly and consistently translate terms that are customer-specific.

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

Updates

  • AutoML models - Cloud Translation - Advanced adds support for translating text with custom models that you create using AutoML Translation.

  • IAM roles - Cloud Translation - Advanced integrates with IAM to provide additional security for your translation requests, and to support integration with AutoML Translation.

  • Labels - The Cloud Translation - Advanced supports adding user-defined labels (key-value pairs) to requests.

  • No API Key Support - Cloud Translation - Advanced does not currently support API keys. We recommend that you create a service account for Cloud Translation - Advanced requests. For information on creating a service account, see Creating and managing service accounts. Your service account must be added to one of the IAM roles added for Cloud Translation - Advanced.

Getting started with Cloud Translation - Advanced

To get started using Cloud Translation - Advanced, go to this quickstart:

Migrating to Cloud Translation - Advanced

Cloud Translation - Advanced updates the way that you specify which model to use to translate text, detect languages, and get supported languages. For information on how to update your application and client library code to Cloud Translation - Advanced, see Migrating to Translation Advanced.

Glossaries

A glossary is a custom dictionary that the Cloud Translation - Advanced uses to correctly and consistently translate terms that are specific to you. Glossaries are commonly used to translate customer-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."

For information on creating and using glossaries, see Creating and using glossaries.

Batch requests

Batch translation requests let you make an asynchronous request to translate large amounts of text. The Cloud Translation - Advanced performs the batch translation as a long-running operation and writes the output to a Google Cloud Storage bucket that you specify. The input for a batch translation request must also come from a Google Cloud Storage bucket--inline requests for batch translation are not supported.

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

AutoML models

Cloud Translation - Advanced supports translating text with custom models that you create using AutoML Translation. You can create a custom model using AutoML Translation that lets you to get more accurate translations for customer-specific terminology.

For information on using an AutoML Translation model for translate text requests, see Translating text (Advanced).

Labels

The 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 by label.

For more information about user-defined labels, see Reporting usage with labels (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 in order for the accounts to have access to the Cloud Translation - Advanced.

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 general and AutoML Translation models in online and asynchronous (batch) mode. Can detect language. Can list supported languages for general 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. Has all IAM permissions for the Cloud Translation.

These pre-configured roles address many typical use cases. However, you may need a role that includes a custom set of permissions. For instance, you may wish 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 may be able to create an Cloud IAM custom role that meets your needs (see also Understanding IAM custom roles).

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

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Translation
Need help? Visit our support page.