本文档介绍了如何使用 Cloud Translation API (v2) 列出支持的语言。
准备工作
在开始使用 Cloud Translation API 之前,您必须具有启用了 Cloud Translation API 的项目,并且必须具有适当的凭据。您还可以安装常用编程语言的客户端库,以便调用 API。如需了解详情,请参阅设置页面。
列出支持的语言
REST
如需获取所有支持的语言列表,请向 https://translation.googleapis.com/language/translate/v2/languages
端点发出 GET
请求。下面显示了使用 curl
和 PowerShell 的 GET
请求的示例。该示例针对通过 Google Cloud CLI 为项目设置的服务账号使用访问令牌。如需了解有关安装 gcloud CLI、使用服务账号设置项目以及获取访问令牌的说明,请参阅设置页面。
在使用任何请求数据之前,请先进行以下替换:
PROJECT_NUMBER_OR_ID
:您的 Google Cloud 项目的数字或字母数字 ID
HTTP 方法和网址:
GET https://translation.googleapis.com/language/translate/v2/languages
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{ "languages": [ { "language": "en" }, { "language": "fr" }, { "language": "zh-CN" } ] }
此查询会返回受支持语言的 ISO-639 语言代码。一些语言代码还包含国家/地区代码(如 zh-CN 或 zh-TW)。该列表按照语言代码的字母顺序排列。由于空间限制,上述示例已被缩短。
Go
Java
Node.js
Python
其他语言
C#:请按照客户端库页面上的 C# 设置说明操作,然后访问 .NET 版 Cloud Translation 参考文档。
PHP:请按照客户端库页面上的 PHP 设置说明操作,然后访问 PHP 版 Cloud Translation 参考文档。
Ruby:请按照客户端库页面上的 Ruby 设置说明操作,然后访问 Ruby 版 Cloud Translation 参考文档。
使用目标语言名称列出支持的语言
REST
下面是返回受支持语言列表的另一个示例。返回的语言名称是用指定的目标语言编写的。返回的列表按照目标语言的字母顺序排列。
如需列出目标语言支持的语言,请发出 POST
请求并在请求正文中提供用于标识目标语言的 JSON 代码。下面显示了使用 curl
或 PowerShell 的 POST
请求的示例。
在使用任何请求数据之前,请先进行以下替换:
PROJECT_NUMBER_OR_ID
:您的 Google Cloud 项目的数字或字母数字 ID
HTTP 方法和网址:
POST https://translation.googleapis.com/language/translate/v2/languages
请求 JSON 正文:
{ "target": "zh-TW" }
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{ "data": { "languages": [ { "language": "zh-CN", "name": "中文(簡體)" }, { "language": "fr", "name": "法文" }, { "language": "en", "name": "英文" } ] } }
在这种情况下,查询会返回与上文相同的语言代码,以及 name
字符串,该字符串提供了使用目标语言 zh-TW 写出的语言的名称。由于空间限制,上述示例已被缩短。
Go
Java
Node.js
Python
其他语言
C#:请按照客户端库页面上的 C# 设置说明操作,然后访问 .NET 版 Cloud Translation 参考文档。
PHP:请按照客户端库页面上的 PHP 设置说明操作,然后访问 PHP 版 Cloud Translation 参考文档。
Ruby:请按照客户端库页面上的 Ruby 设置说明操作,然后访问 Ruby 版 Cloud Translation 参考文档。
其他资源
- 如需有关解决常见问题或错误的帮助,请参阅问题排查页面。