设置

如要开始使用 Cloud Translation,您需要一个启用了 Cloud Translation API 的项目以及能进行身份验证调用的凭据。以下部分详细介绍了在首次调用 Cloud Translation API 之前如何进行设置。

设置过程涉及 Google Cloud 控制台。Google Cloud 控制台是一个网页界面,可用于在 Google Cloud 中预配、配置、管理和监控系统。如果您之前未使用过 Google Cloud 控制台,请参阅 Cloud 控制台页面了解详情。

准备工作

Cloud Translation 有两个版本(基本版和高级版)。决定要使用哪个版本,因为这会决定您将安装哪个版本的客户端库。

创建或选择项目

如需使用 Google Cloud 提供的服务,您必须创建一个项目。项目用于组织您的所有 Google Cloud 资源。 项目由一组协作者、已启用的 API(和其他资源)、监控工具、结算信息以及身份验证和访问权限控制组成。您可以创建一个项目,也可以创建多个项目,并使用这些项目按资源层次结构组织 Google Cloud 资源。创建项目时,请记下项目 ID。您需要此 ID 才能进行 API 调用。 如需详细了解项目,请参阅 Resource Manager 文档

我们建议您分别创建用于实验、测试和生产的项目。创建项目后,请记录项目编号或 ID。调用 Cloud Translation API 时,您必须提供项目编号(或 ID)。

在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

转到“项目选择器”

启用结算功能

您必须启用结算功能才能使用 Cloud Translation。如需详细了解 Cloud Translation 价格,请参阅价格页面

结算帐号用于定义一组给定资源的付款方,并且可以关联到一个或多个项目。 项目的使用费将计入关联的结算帐号名下。 在大多数情况下,您在创建项目时配置结算。 如需了解详情,请参阅结算文档

确保您的 Google Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能

启用 API

您必须为项目启用 Cloud Translation API。如需详细了解如何启用 API,请参阅 Service Usage 文档

启用 Cloud Translation API。

启用 API

设置用量配额

Cloud Translation 提供了配额管理系统,可帮助您和 Google 管理服务的使用。默认情况下,您每天可以发送的字符数没有限制。如果您设置了预算,则建议您监控每日使用量,并根据您计划的支出调整配额。

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

设置身份验证

如果您计划使用 Cloud Translation API,则需要设置身份验证。任何使用 API 的客户端应用都必须经过身份验证,并且拥有所请求资源的访问权限。本部分介绍重要的身份验证概念及其设置步骤。如需了解详情,请参阅 Google Cloud 身份验证概览

服务帐号和私钥

身份验证有多种可选方式,但建议您使用服务帐号执行身份验证和访问权限控制。服务帐号为应用而非最终用户提供凭据。服务帐号由项目拥有,您可以为一个项目创建多个服务帐号。 如需了解详情,请参阅了解服务帐号

服务帐号与一个或多个公钥/私钥对相关联。 创建新密钥对时,您需要下载私钥。私钥用于在调用 API 时生成凭据。 您需要负责确保私钥和其他管理操作(如密钥轮替)的安全性。 如需了解详情,请参阅管理服务帐号密钥的最佳实践

Identity and Access Management 角色

当主帐号(用户帐号、服务帐号等)调用 API 时,Google Cloud 要求主帐号具有适当的权限。您可以通过向主帐号授予角色来授予权限。如需了解详情,请参阅角色概览

如果您使用自己的用户帐号创建了项目,则您的用户帐号将具有项目的 Owner 基本角色。此角色可以对项目调用任何 API。但是,如果是其他帐号创建了项目,那么您可能需要先为自己的用户帐号授予相应的角色,然后才能调用 API。

创建服务帐号和密钥

创建服务帐号:

  1. 在 Google Cloud 控制台中,转到创建服务帐号页面。

    转到“创建服务帐号”
  2. 选择您的项目。
  3. 服务帐号名称字段中,输入一个名称。Google Cloud 控制台会根据此名称填充服务帐号 ID 字段。

    服务帐号说明字段中,输入说明。例如,Service account for quickstart

  4. 点击创建并继续
  5. 如需提供对项目的访问权限,请向服务帐号授予 Cloud Translation > Cloud Translation API Admin 角色。

    如需授予该角色,请找到选择角色列表,然后选择 Cloud Translation > Cloud Translation API Admin

  6. 点击继续
  7. 点击完成以完成服务帐号的创建过程。

    不要关闭浏览器窗口。您将在下一步骤中用到它。

创建服务帐号密钥:

  1. 在 Google Cloud 控制台中,点击您创建的服务帐号的电子邮件地址。
  2. 点击密钥
  3. 点击添加密钥,然后点击创建新密钥
  4. 点击创建。JSON 密钥文件将下载到您的计算机上。
  5. 点击关闭

如需详细了解不同的角色,请参阅 Cloud Translation 高级版角色。例如,如果您希望服务帐号能够翻译文本,则可以为其分配 roles/cloudtranslate.user 角色。与该服务帐号关联的所有密钥都具有相同的权限。

在您的环境中使用服务帐号密钥文件

通过设置环境变量 GOOGLE_APPLICATION_CREDENTIALS 向应用代码提供身份验证凭据。此变量仅适用于当前的 Shell 会话。如果您希望变量应用于未来的 Shell 会话,请在 shell 启动文件中设置变量,例如在 ~/.bashrc~/.profile 文件中。

Linux 或 macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

例如:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

对于 PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

例如:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

对于命令提示符:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

KEY_PATH 替换为包含您的服务帐号密钥的 JSON 文件的路径。

或者,您可以指向代码中的 JSON 文件。如需了解详情,请参阅使用代码传递凭据

安装客户端库

客户端库支持多种主流语言。我们建议您使用这些客户端库来调用 Cloud Translation,因为它们可以更轻松地访问 API。如果客户端库不能满足您的需求,或者不适用于您的语言,请构建您自己的自定义代码。如需了解详情,请参阅使用您自己的客户端代码

例如,当您使用客户端库时,它可以通过 GOOGLE_APPLICATION_CREDENTIALS 环境变量隐式确定您的凭据。您无需在代码中明确指定您的凭据。如需了解详情,请参阅 Cloud API 文档中的客户端库说明

Cloud Translation 基本版客户端库

选择要用于开发的编程语言,然后运行相关命令。如需了解详情,请参阅 Cloud Translation 基本版客户端库概览

C#

nuget install Google.Cloud.Translation.V2

Go

go get cloud.google.com/go/translate

Java

如果您使用的是 Maven,请将以下代码添加到您的 pom.xml 文件中。如需详细了解 BOM,请参阅 Google Cloud Platform 库 BOM

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.12.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>

如果您使用的是 Gradle,请将以下代码添加到您的依赖项中:

implementation 'com.google.cloud:google-cloud-translate:2.18.0'

如果您使用的是 sbt,请将以下代码添加到您的依赖项中:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.18.0"

如果您使用的是 Visual Studio Code、IntelliJ 或 Eclipse,可以通过以下 IDE 插件将客户端库添加到您的项目中:

上述插件还提供其他功能,例如服务帐号密钥管理。如需了解详情,请参阅各个插件相应的文档。

Node.js

如需详细了解如何设置 Node.js 开发环境,请参阅 Node.js 开发环境设置指南

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

如需详细了解如何设置 Python 开发环境,请参阅 Python 开发环境设置指南

pip install google-cloud-translate==2.0.1

Ruby

如需详细了解如何设置 Ruby 开发环境,请参阅 Ruby 开发环境设置指南

gem install google-cloud-translate-v2

Cloud Translation 高级版客户端库

选择要用于开发的编程语言,然后运行相关命令。如需了解详情,请参阅 Cloud Translation 高级版客户端库概览

C#

nuget install Google.Cloud.Translate.V3 -Pre

Go

go get cloud.google.com/go/translate/apiv3

Java

如果您使用的是 Maven,请将以下代码添加到您的 pom.xml 文件中。如需详细了解 BOM,请参阅 Google Cloud Platform 库 BOM

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.12.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-translate</artifactId>
  </dependency>

如果您使用的是 Gradle,请将以下代码添加到您的依赖项中:

implementation 'com.google.cloud:google-cloud-translate:2.18.0'

如果您使用的是 sbt,请将以下代码添加到您的依赖项中:

libraryDependencies += "com.google.cloud" % "google-cloud-translate" % "2.18.0"

如果您使用的是 Visual Studio Code、IntelliJ 或 Eclipse,可以通过以下 IDE 插件将客户端库添加到您的项目中:

上述插件还提供其他功能,例如服务帐号密钥管理。如需了解详情,请参阅各个插件相应的文档。

Node.js

如需详细了解如何设置 Node.js 开发环境,请参阅 Node.js 开发环境设置指南

npm install --save @google-cloud/translate

PHP

composer require google/cloud-translate

Python

如需详细了解如何设置 Python 开发环境,请参阅 Python 开发环境设置指南

pip install --upgrade google-cloud-translate

Ruby

如需详细了解如何设置 Ruby 开发环境,请参阅 Ruby 开发环境设置指南

gem install google-cloud-translate

安装 Google Cloud CLI

如果您计划通过命令行(例如通过 curl 命令)发送 Cloud Translation 请求,请安装并初始化包含在 Google Cloud CLI 中的 gcloud CLI。以下链接提供了更多信息:

安装 Google Cloud CLI,然后通过运行以下命令初始化 Google Cloud CLI:

gcloud init

测试 SDK 和身份验证

如果您已设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量,则可以使用 gcloud 测试您的身份验证环境。运行以下命令,确认没有错误发生并且返回了凭据:

gcloud auth application-default print-access-token

所有 Cloud Translation 命令行 REST 示例都会使用上一个命令来验证 API 调用。

后续步骤

自行试用

如果您是 Google Cloud 新手,请创建一个帐号来评估 Cloud Translation 在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。

免费试用 Cloud Translation