Admin: Enable users to request translations

As an admin, use the Google Cloud console to manage portals, business users, translators, and translation resources. To get started, create a portal and add business users to the portal. After adding users to the portal, they can sign in and start requesting translations.

Before you begin

Set up a project with billing and the Cloud Translation API enabled. Use that project for the following tasks.

Create a portal

Use the Google Cloud console to create translation portals for your business users.

You might create multiple portals for different sets of business users. For example, you might have several departments in your organization with different translation needs. One department translates technical publications and another translates legal documents. Because each department has different translation requirements, each department should have their own portal.

  1. In the Translation Hub section of the Google Cloud console, go to the Portals page.

    Go to the Portals page

  2. Click Create portal, which opens the Create new portal pane.

    1. Specify a portal display name that describes the purpose of this portal.

    2. Select a pricing tier and then click Create.

      For basic-tier users, you can only select the basic pricing tier. For advanced-tier users, you can choose to create a basic or advanced-tier portal, which affects the features that are available to your business users. You cannot change the tier later. If you must use a different tier, create additional portals.

      Translation Hub creates your portal and lists it on the Portals page. You can view details about your portal, such as its URL, by clicking the name of your portal.

Before users can request translations through the portal, you must add the portal's service account to your Google Cloud project. The service account allows business users to use the translation API and translation-specific resources that are in your project from the portal.

Add a service account

Add a portal's Identity and Access Management (IAM) service account as a principal in your project. Each portal has a distinct service account that enables business users to access translation-related APIs and resources without giving each user Google Cloud credentials.

  1. In the Translation Hub section of the Google Cloud console, go to the Portals page.

    Go to the Portals page

  2. From the list of portals, find the portal that you recently created.

  3. In the Service account column, copy the entire service account name, which ends with @gcp-sa-translationhub.iam.gserviceaccount.com.

  4. Go to the IAM page.

    Go to the IAM page

  5. Click Add.

  6. In the New principals field, paste your portal's service account name.

  7. Click Select a role and then select the Translation Hub Portal User role.

    The role grants translation-specific permissions. To see the exact set of permissions, see the assigned permissions in the Google Cloud console.

  8. Click Save.

Invite business users and add them to portals

Invite business users to your project, specify their sign-in method, and add them to one or more portals. If you're using Translation Hub in multiple projects, you can invite users to only one project.

For users with the email and password sign-in method, they receive a notification and sign-in link by email. For users with the Google sign-in method, users don't receive an email notification. They can sign in by following the instructions in requesting translations.

If users are added to multiple portals, they choose which one to use after signing in.

  1. In the Translation Hub section of the Google Cloud console, go to the Users page.

    Go to the Users page

  2. Click Add user, which opens the Add user pane.

  3. Select Add user's email to invite one user or Bulk import via a CSV file to invite multiple users in a single request.

    To invite one user, specify their email address, sign-in method, and the portals they can access. The sign-in method specifies whether users sign in with an email and password or, if they have a Google Account, with their Google Account (such as Google Workspace).

    To invite users in bulk, provide a CSV file where each line specifies a user's name, email address, sign-in method, and associated portals. You can specify an existing file in Cloud Storage or upload a local file to Cloud Storage. In either case, Translation Hub requires Cloud Storage permissions. For more information, see CSV file for bulk import and Service account for adding users in bulk.

  4. Click Add.

    Users with the GOOGLE sign-in method can access portals by going to https://translationhub.cloud.google.com/. Users with the EMAIL_PASSWORD sign-in method receive an email notification with a portal URL; they can also sign in by going to https://translationhub.cloud.google.com/.

CSV file for inviting users in bulk

Each line of the CSV file is a distinct user that contains the user's sign-in method and portal IDs, as shown in the following example:

EMAIL_ADDRESS,SIGN_IN_METHOD,PORTAL_ID_1;PORTAL_ID_2

The sign-in method can be google for Google Accounts or email/password. Portal IDs are listed on the Portals page in the Google Cloud console and are separated by a semicolon.

The following example shows a sample CSV file. Don't include a header row for column names. For more information about file size limits, see Quotas and limits.

amal@altostrat.com,email/password,123abc45def678f;234abc45def678g
charlie@altostrat.com,email/password,
hao@myownpersonaldomain.com,email/password,123abc45def678f

Add Cloud Storage permission to Translation Hub

If you plan to invite business users in bulk, you must list their information in a CSV file. This CSV file must be in a Cloud Storage bucket, which requires Translation Hub to have Cloud Storage admin privileges.

To set up permissions for Translation Hub, add the Translation Hub service account with the Storage Admin role. If you plan to add users one at a time through the Google Cloud console, you can skip adding this service account.

  1. Go to the IAM page.

    Go to the IAM page

  2. Click Add.

  3. For the New principals field, add cloud-translation-hub@system.gserviceaccount.com as a principal.

  4. Click Select a role and then select the Storage Admin role.

    The role grants permissions for Translation Hub to add and read files in Cloud Storage buckets. To see the exact set of permissions, see the assigned permissions in the Google Cloud console.

  5. Click Save.

Create translation resources

You can create translation resources through Translation Hub, except for custom translation models. Use AutoML Translation to create custom models. If you have previously created resources through the Cloud Translation API or AutoML Translation, you can use them in Translation Hub.

Translation memories and custom models are available to advanced-tier users only.

  1. In the Translation Hub section of the Google Cloud console, go to the Resources page.

    Go to the Resources page

  2. Click Add resource.

  3. In the Add resource pane, select either the Glossaries or Translation memories tab and then specify the resource details.

    For glossaries, specify the glossary type and your source file. For more information, see Creating and using glossaries in the Cloud Translation API documentation.

    For translation memories (advanced tier only), create an empty translation memory or import existing translations. For more information, see Translation memory.

  4. Click Add to add the resource.

Add translation resources to portals

Add translation resources, such as glossaries, to portals. Portals users will be able to use these resources when they request translations.

For basic-tier portals, you can add glossaries only.

  1. In the Translation Hub section of the Google Cloud console, go to the Resources page.

    Go to the Resources page

  2. From the list of resources, select the resources that you want to add to one or more portals.

  3. Click Add to portals, which opens the Add resource to portal pane.

  4. From the portals list, select the portals where the resources are added to.

  5. Click Add.

    On the Resources page, you can confirm the addition by viewing the Portal names column for each resource.

Create translation templates for portals

Translation templates can be used only with basic-tier portals.

For common translation requests, translation templates help business users quickly and consistently translate documents into the same target languages by using the same translation resources. For each request, Business users can select a template instead of selecting the source language, target languages, and glossaries each time.

An administrator can create up to two translation templates for a portal. All business users for that portal will be able to use those templates.

  1. In the Translation Hub section of the Google Cloud console, go to the Portals page.

    Go to the Portals page

  2. Click a portal to view its details page.

  3. Click Translation templates to open the Translation templates pane.

    1. Click Add an item.

    2. Enter a name for the template.

    3. Set the source language.

    4. Select a target language. You can also select a glossary to use with that target language.

    5. To add additional target languages, click Add rule.

  4. Click Save.

Business users can also create up to four of their own templates within each portal. These templates are not shared with any other business user. For more information, see Business user: Request translations.

What's next