Package google.cloud.translation.v3

重要提示:如需访问圆括号中列出的网址,您必须连接到互联网。该网址用于在气隙环境之外进行访问。

TranslationService

提供自然语言翻译操作。

DetectLanguage

rpc DetectLanguage(DetectLanguageRequest) returns (DetectLanguageResponse)

检测请求文本使用的语言。

GetSupportedLanguages

rpc GetSupportedLanguages(GetSupportedLanguagesRequest) returns (SupportedLanguages)

返回支持的翻译语言列表。

TranslateText

rpc TranslateText(TranslateTextRequest) returns (TranslateTextResponse)

翻译输入文本并返回翻译后的文本。

DetectLanguageRequest

语言检测的请求消息。

字段
parent

string

必需。要拨打电话的项目。必须引用调用者的项目。

格式:projects/{project-id}.

mime_type

string

可选。源文本的格式,例如“text/html”“text/plain”。如果留空,MIME 类型将默认为“text/html”。

content

string

以字符串形式存储的输入内容。

DetectLanguageResponse

语言检测的响应消息。

字段
languages[]

DetectedLanguage

Translation API 检测到的最可能的语言。对于每个请求,Translation API 始终只会返回一个结果。

DetectedLanguage

语言检测的响应消息。

字段
language_code

string

请求中源内容的 BCP-47 语言代码,由系统自动检测。

confidence

float

相应语言的检测结果的置信度。

S3Source

输入内容的存储位置。

字段
input_uri

string

必需。源数据 URI。例如 s3://my_bucket/my_object

GetSupportedLanguagesRequest

发现受支持语言的请求消息。

字段
parent

string

必需。要拨打电话的项目。必须引用调用者的项目。

格式:projects/{project-id}

display_language_code

string

可选。用于返回受支持语言的本地化且易懂的名称的语言。如果缺少此字段,则不会在响应中返回显示名称。

SupportedLanguage

一个受支持语言响应对应于一种受支持语言的相关信息。

字段
language_code

string

受支持的语言代码,通常由其 ISO 639-1 标识符组成,例如“en”“ja”。在某些情况下,系统会返回包含语言和区域标识符的 BCP-47 代码(例如“zh-TW”和“zh-CN”)

display_name

string

以请求中指定的显示语言本地化的语言的人类可读名称。

support_source

bool

可作为源语言使用。

support_target

bool

可用作目标语言。

SupportedLanguages

发现受支持语言的响应消息。

字段
languages[]

SupportedLanguage

支持的语言响应列表。此列表包含 Translation API 支持的每种语言的条目。

TranslateTextRequest

同步翻译的请求消息。

字段
contents[]

string

必需。输入的内容(字符串格式)。 我们建议总内容量不超过 30,000 个码点。此字段的最大长度为 1024。

mime_type

string

可选。源文本的格式,例如“text/html”“text/plain”。如果留空,MIME 类型将默认为“text/html”。

source_language_code

string

输入文本的 BCP-47 语言代码(如果已知),例如 en-USsr-Latn。如需查看支持的语言代码,请参阅“语言支持”。

target_language_code

string

必需。用于翻译输入文本的 BCP-47 语言代码,设置为“语言支持”中列出的某种语言代码。

parent

string

必需。要拨打电话的项目。必须引用调用者的项目。

格式:projects/{project-id}

TranslateTextResponse

字段
translations[]

Translation

文本翻译响应。此字段的长度与 contents 相同。

翻译

单个翻译响应。

字段
translated_text

string

翻译成目标语言的文本。如果在翻译过程中发生错误,则响应中可能不包含此字段。

detected_language_code

string

如果传递了源语言,则不会自动检测语言,并且此字段为空。