翻訳 API（Translation API）
Translation API を使用すると、サードパーティの開発者がアイテムのタイトルや説明をある言語から別の言語に翻訳できます。サポートされている言語翻訳の完全なリストについては、API の概要ページを参照してください。
バージョン: v1_beta.1.6
ベースURL: https://api.ebay.com/commerce/translation/v1_beta
認証（OAuth スコープ）
この API は クライアント資格情報（Client Credentials） フローを使用します。ユーザー認証は不要で、アプリケーショントークンのみで呼び出し可能です。
| スコープ |
説明 |
https://api.ebay.com/oauth/api_scope |
eBay の公開データを表示 |
リソース一覧
Translation API は 1 リソース、1 エンドポイント（POST）で構成されています。
translate — テキスト翻訳（1 エンドポイント）
POST /translate
translate — 出品タイトルと出品説明のテキストをある言語から別の言語に翻訳します。
| パラメータ | 場所 | 必須 | 説明 |
|---|
Content-Type | ヘッダー | 必須 | リクエスト本文の形式。値は application/json に設定。 |
リクエストボディ: TranslateRequest
レスポンス: 200 → TranslateResponse / 400 / 500
スキーマ定義（全 5 スキーマ）
翻訳
TranslateRequest
| フィールド | 型 | 説明 |
|---|
from | string | 翻訳元の言語（BCP 47 言語タグ、例: en） |
to | string | 翻訳先の言語（BCP 47 言語タグ、例: zh-Hans） |
text | array[string] | 翻訳するテキストの配列 |
translationContext | string | 翻訳コンテキスト。値: ITEM_TITLE、ITEM_DESCRIPTION |
TranslateResponse
| フィールド | 型 | 説明 |
|---|
from | string | 翻訳元の言語 |
to | string | 翻訳先の言語 |
translations | array[Translation] | 翻訳結果の配列 |
Translation
| フィールド | 型 | 説明 |
|---|
originalText | string | 翻訳元のテキスト |
translatedText | string | 翻訳後のテキスト |
共通スキーマ
Error
| フィールド | 型 | 説明 |
|---|
category | string | エラーカテゴリ |
domain | string | エラードメイン |
errorId | integer | エラー ID |
message | string | 短いメッセージ |
longMessage | string | 詳細メッセージ |
inputRefIds | array[string] | 入力参照 ID |
outputRefIds | array[string] | 出力参照 ID |
parameters | array[ErrorParameter] | エラーパラメータ |
subdomain | string | エラーサブドメイン |
ErrorParameter
| フィールド | 型 | 説明 |
|---|
name | string | パラメータ名 |
value | string | パラメータ値 |
エンドポイント一覧（全 1 エンドポイント）
| メソッド |
エンドポイント |
operationId |
説明 |
| POST | /translate | translate | テキストを翻訳 |
