Package google.cloud.translation.v3

重要: 丸かっこ内の URL にアクセスするには、インターネットに接続する必要があります。この URL は、エアギャップ環境外からアクセスするために提供されます。

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 は、リクエストごとに常に 1 つの結果のみを返します。

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 省略可。サポートされている言語のローカライズされた人間が読める形式の名前を返すために使用する言語。指定しない場合、表示名はレスポンスで返されません。

サポートされている言語

1 つのサポートされる言語のレスポンスは、1 つのサポートされる言語に関連する情報に対応します。

フィールド
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 必須。入力コンテンツ（文字列形式）。コンテンツの合計は 30k コードポイント未満にすることをおすすめします。このフィールドの最大長は 1,024 です。
mime_type	string 省略可。ソーステキストの形式（「text/html」、「text/plain」など）。空白のままにすると、MIME タイプはデフォルトで「text/html」になります。
source_language_code	string 入力テキストの BCP-47 言語コード（判明している場合）。例: en-US、sr-Latn。サポートされている言語コードは、言語サポートに記載されています。
target_language_code	string 必須。入力テキストの翻訳に使用する BCP-47 言語コード。言語サポートに記載されている言語コードのいずれかに設定します。
parent	string 必須。呼び出しを行うプロジェクト。呼び出し元のプロジェクトを参照する必要があります。 形式: projects/{project-id}

TranslateTextResponse

フィールド
translations[]	Translation テキスト翻訳のレスポンス。このフィールドの長さは contents と同じです。

翻訳

単一の翻訳レスポンス。

フィールド
translated_text	string ターゲット言語に翻訳されたテキスト。変換中にエラーが発生した場合、このフィールドがレスポンスから除外されることがあります。
detected_language_code	string ソース言語が渡された場合、言語の自動検出は行われず、このフィールドは空になります。