快速入门(基本版)

本页面介绍了如何使用 curl 发出 Cloud Translation 基本版 (v2) 请求。

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册一个新帐号

  2. 设置 Cloud Console 项目。

    设置项目

    点击即可执行以下操作:

    • 创建或选择项目。
    • 为该项目启用 Cloud Translation API。
    • 创建服务帐号。
    • 下载 JSON 格式的私钥。

    您可以随时在 Cloud Console 中查看和管理这些资源。

  3. 将环境变量 GOOGLE_APPLICATION_CREDENTIALS 设置为包含您的服务帐号密钥的 JSON 文件的路径。 此变量仅适用于当前的 shell 会话,因此,如果您打开新的会话,请重新设置该变量。

  4. 安装并初始化 Cloud SDK

发出 Translation API 请求

要发出 Translation API 请求,请使用 REST 方法调用 v2 翻译方法。

  1. 使用 curlhttps://translation.googleapis.com/language/translate/v2 端点发出请求。

    curl 命令中包含待翻译文本 (q)、源语言 (source) 以及目标语言 (target) 对应的 JSON 代码。

    源语言和目标语言使用 ISO-639-1 代码确定。源语言为英语 (en),目标语言为西班牙语 (es)。查询格式以“text”(表示纯文本)标示。

    示例 curl 命令使用 gcloud auth application-default print-access-token 命令来获取身份验证令牌。

    curl -s -X POST -H "Content-Type: application/json" \
        -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
        --data "{
      'q': 'The Great Pyramid of Giza (also known as the Pyramid of Khufu or the
            Pyramid of Cheops) is the oldest and largest of the three pyramids in
            the Giza pyramid complex.',
      'source': 'en',
      'target': 'es',
      'format': 'text'
    }" "https://translation.googleapis.com/language/translate/v2"
      

    您应该会看到如下所示的响应:

    {
      "data": {
        "translations": [
          {
            "translatedText": "La Gran Pirámide de Giza (también conocida como la
             Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más
             grande de las tres pirámides en el complejo de la pirámide de Giza."
          }
        ]
      }
    }
    
      

恭喜!您已向 Cloud Translation API 发送了第一个请求!

安装 Cloud Translation 基本版客户端库

客户端库支持多种主流语言,建议您使用这些客户端库。如需安装客户端库,请执行以下操作:

C#

nuget install Google.Cloud.Translation.V2

Go

go get -u 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>8.0.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,请将以下代码添加到您的依赖项中:

compile 'com.google.cloud:google-cloud-translate:1.95.0'

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

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

如果您使用的是 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

如需了解安装说明,请转到 Translation 客户端库

清理

为避免产生不必要的 Google Cloud 费用,请使用 Cloud Console 删除您不需要的项目。

后续步骤