从基本版迁移到高级版

希望使用最新 Cloud Translation 功能（例如术语表和 AutoML 模型）的现有 Cloud Translation 基本版 (v2) 用户必须迁移应用以使用 Cloud Translation 高级版 (v3)。如需了解对比，请参阅基本版与高级版比较。

迁移到高级版包括使用 Identity and Access Management (IAM) 和高级版客户端库。以下部分概述了迁移任务以及两个版本的主要区别。

迁移到高级版

以下步骤概述了更新现有应用从使用 Cloud Translation 基本版到 Cloud Translation 高级版所需的操作。

  1. 清点您的 Google Cloud 项目、应用和访问 Cloud Translation 基本版 API 的用户。您需要提供服务帐号并更新它们才能使用 Cloud Translation 高级客户端库。
  2. 为您的应用设置服务帐号和身份验证。
  3. 使用 IAM 角色设置服务帐号的权限。
  4. 为您的项目启用 Cloud Translation 高级版。如果要将 AutoML 模型与 Cloud Translation 高级版搭配使用，还必须启用 AutoML。如需了解详情，请参阅设置指南
  5. 使用 Cloud Translation 高级版客户端库和方法。对于 Cloud Translation 高级版请求，您必须在请求中提供项目编号（或项目 ID）和项目位置（通常是 global 或 us-central1）。
  6. 检查对 Cloud Translation 高级版的翻译请求大小是否不超过限制。
  7. 规划您的翻译请求配额监控。这两个版本的 API 共享相同的每日和每月配额。
  8. 审核任何可能的结算变化。

高级版和基本版之间的主要区别

为了帮助您了解迁移任务，以下部分介绍了高级版与基本版之间的主要区别。

服务帐号

对于 Cloud Translation 基本版，您可以使用 API 密钥或服务帐号发送经过身份验证的请求。

Cloud Translation 高级版提供的功能需要使用客户管理的资源，这些资源需要通过 IAM 角色和权限进行管理。因此，您无法使用 API 密钥对该服务进行身份验证。而必须改用服务帐号进行 Cloud Translation 高级版身份验证。

如需了解详情，请参阅设置指南。

IAM 角色

使用服务帐号进行 Cloud Translation 基本版时，服务帐号仅用于身份验证。无论与服务帐号关联的权限如何，您都可以对 Cloud Translation 基本版进行调用。但是，对于 Cloud Translation 高级版，这些权限适用。

如需为服务帐号授予调用 Cloud Translation 高级版的权限，您需要为其分配 IAM 角色。Cloud Translation 高级版具有多个 IAM 角色，您可以将这些角色分配给您的服务帐号，以便访问项目中的特定资源。例如，如果要使用服务帐号翻译文本，则可以为其分配 roles/cloudtranslate.user 角色。如需了解详情，请参阅 Cloud Translation 高级版详细信息中的 IAM 角色。

如果您计划使用 AutoML 模型或任何依赖于 Cloud Storage 的功能，则还必须为这些服务添加适当的角色。如需查看所有 IAM 角色的列表，请参阅 IAM 角色文档。

翻译模型

当您使用 Cloud Translation 基本版请求翻译时，Google 会使用预训练的神经机器翻译 (NMT) 模型。对于 Cloud Translation 高级版，您可以使用预训练 NMT 模型或 AutoML Translation 自定义模型。

您用于翻译请求的服务帐号必须有权访问不同项目中的 NMT 和 AutoML 模型。例如，您可能有一个包含翻译模型的中心项目，用于简化维护和结算。该项目或其他项目中的服务帐号可以使用这些模型，但需要相应权限。

如需详细了解翻译模型，请参阅翻译文本（高级版）。

客户端库

Cloud Translation 高级版客户端库和方法与 Cloud Translation 基本版不同。例如，调用 Cloud Translation 高级版需要资源名称。如需了解详情，请参阅 Cloud Translation 高级版客户端库概览或试用翻译文本（高级版）快速入门。

资源、项目和位置

向 Cloud Translation 高级版发出的请求需要使用的服务名称。资源通常是某个包含项目名称及其位置的限定名称，用于指定请求的运行位置。例如，AutoML 模型的名称是资源名称。

如果您的 Google Cloud 项目名称为 my-project 并且资源的位置为 us-central1，该资源的全名可能如下所示：

projects/MY_PROJECT/locations/us-central1/...

您发送 getSupportedLanguages 请求的网址可能如下所示：

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

每个请求的内容限制

Cloud Translation API 针对较小的翻译请求进行了优化。每个请求的建议长度上限为 5K 字符（码位）。 您包含的字符越多，响应延迟时间就越长。 对于 Cloud Translation 高级版，单个请求的码位上限是 30K。Cloud Translation 基本版的请求大小上限为 100K 字节。

无论可用配额有多少，Cloud Translation API 都会拒绝大小超过此上限的请求并返回 400 INVALID_ARGUMENT 错误。

如需详细了解配额和限制，请参阅配额。

后续步骤

使用 Cloud Translation 高级版翻译文本、创建术语表或发出批量请求。