Translator Text API v2.0Translator Text API v2.0

重要

Translator Text API のこのバージョンは非推奨になっています。This version of the Translator Text API has been deprecated. Translator Text API v3 のドキュメントは、こちらをご覧ください。View documentation for v3 of the Translator Text API.

Translator Text API V2 は、アプリケーション、Web サイト、ツール、またはその他のソリューションにシームレスに統合して、多言語ユーザー エクスペリエンスを提供することができます。Translator Text API V2 can be seamlessly integrated into your applications, websites, tools, or other solutions to provide multi-language user experiences. 業界標準を活用することで、任意のハードウェア プラットフォーム上で使用でき、また任意のオペレーティング システムを使用して、言語翻訳や、テキストの言語の検出やテキスト読み上げなど、その他の言語に関連する操作を実行できます。Leveraging industry standards, it can be used on any hardware platform and with any operating system to perform language translation and other language-related operations such as text language detection or text to speech. Microsoft Translator API の詳細については、ここをクリックしてください。Click Here for more information about the Microsoft Translator API.

使用の開始Getting started

Translator Text API にアクセスするには、Microsoft Azure にサインアップする必要があります。To access the Translator Text API you will need to sign up for Microsoft Azure.

AuthorizationAuthorization

Translator Text API への呼び出しでは、いずれも認証にサブスクリプション キーが必要です。All calls to Translator Text API require a subscription key to authenticate. API では、2 つの認証モードがサポートされています。The API supports two modes of authentication:

  • アクセス トークンを使用します。Using an access token. ステップ 9 で参照されているサブスクリプション キーを使用して、承認サービスに POST 要求を行うことで、アクセス トークンを生成します。Use the subscription key referenced in step 9 to generate an access token by making a POST request to the authorization service. 詳細については、トークン サービスに関するドキュメントを参照してください。See the token service documentation for details. Authorization ヘッダーまたは access_token クエリ パラメーターを使用して、アクセス トークンを Translator サービスに渡します。Pass the access token to the Translator service using the Authorization header or the access_token query parameter. アクセス トークンは 10 分間有効です。The access token is valid for 10 minutes. 10 分ごとに新しいアクセス トークンを取得し、このような 10 分以内で繰り返す要求に対して同じアクセス トークンを使い続けます。Obtain a new access token every 10 minutes, and keep using the same access token for repeated requests within these 10 minutes.

  • サブスクリプション キーを直接使用します。Using a subscription key directly. サブスクリプション キーを、Translator API への要求に含まれる Ocp-Apim-Subscription-Key ヘッダー内の値として渡します。Pass your subscription key as a value in Ocp-Apim-Subscription-Key header included with your request to the Translator API. このモードでは、アクセス トークンを生成するために認証トークン サービスを呼び出す必要はありません。In this mode, you do not have to call the authentication token service to generate an access token.

サブスクリプション キーとアクセス トークンはシークレットと見なし、非表示にする必要があります。Consider your subscription key and the access token as secrets that should be hidden from view.

不適切な表現の処理Profanity handling

通常、Translator サービスでは、ソースに存在する不適切な表現は翻訳でも保たれます。Normally the Translator service will retain profanity that is present in the source in the translation. 不適切な表現の程度や、言葉に不敬な意味を込めるコンテキストは文化によって異なります。結果として、ターゲット言語での不適切な表現の程度は強められることもあれば、弱められることもあります。The degree of profanity and the context that makes words profane differ between cultures, and as a result the degree of profanity in the target language may be amplified or reduced.

ソース テキスト内での不適切な表現の有無に関係なく、翻訳で不適切な表現が生じるのを防ぐには、不適切な表現のフィルター処理オプションを、それをサポートしているメソッドで使用できます。If you want to avoid getting profanity in the translation, regardless of the presence of profanity in the source text, you can use the profanity filtering option for the methods that support it. このオプションを使用すると、不適切な表現が削除されているか、適切なタグでマークされているかどうかを確認する、あるいはアクションを起こさないかを選択できます。The option allows you to choose whether you want to see profanity deleted or marked with appropriate tags, or no action taken. ProfanityAction に指定できる値は、NoAction (既定値)、Marked、Deleted です。The accepted values of ProfanityAction are NoAction (default), Marked and Deleted.

ProfanityActionProfanityAction ActionAction サンプル ソース (日本語)Example Source (Japanese) 翻訳の例 (英語)Example Translation (English)
NoActionNoAction [既定]。Default. オプションを設定しない場合と同じです。Same as not setting the option. 不適切な表現はソースからターゲットに渡されます。Profanity will pass from source to target. 彼はジャッカスです。彼はジャッカスです。 He is a jackass.He is a jackass.
MarkedMarked 不適切な単語が XML タグ で囲まれます。Profane words will be surrounded by XML tags and . 彼はジャッカスです。彼はジャッカスです。 He is a jackass.He is a jackass.
DeletedDeleted 不適切な単語は、置換されずに出力から削除されます。Profane words will be removed from the output without replacement. 彼はジャッカスです。彼はジャッカスです。 He is a.He is a.

翻訳からのコンテンツの除外Excluding content from translation

HTML (contentType=text/html) などのタグを持つコンテンツを翻訳するときに、翻訳から特定のコンテンツを除外する方が便利な場合があります。When translating content with tags such as HTML (contentType=text/html), it is sometimes useful to exclude specific content from translation. 属性 class=notranslate を使用すると、元の言語のまま残す必要があるコンテンツを指定できます。You may use the attribute class=notranslate to specify content that should remain in its original language. 次の例では、1 番目の div 要素内のコンテンツは翻訳されませんが、2 番目の div 要素内のコンテンツは翻訳されます。In the following example, the content inside the first div element will not be translated, while the content in the second div element will be translated.

<div class="notranslate">This will not be translated.</div>
<div>This will be translated. </div>

GET /TranslateGET /Translate

実装に関するメモImplementation notes

1 つの言語から別の言語にテキスト文字列を翻訳します。Translates a text string from one language to another.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/Translate です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/Translate.

戻り値: 翻訳されたテキストを表す文字列です。Return value: A string representing the translated text.

以前に AddTranslation または AddTranslationArray を使用して、同じソース文に対して評価 5 以上の翻訳を入力した場合、Translate はシステムで使用可能な最上位の選択肢のみを返します。If you previously used AddTranslation or AddTranslationArray to enter a translation with a rating of 5 or higher for the same source sentence, Translate returns only the top choice that is available to your system. "同じソース文" とは、大文字と小文字、空白文字、タグ値、文末の句読点を除き、まったく同じ (100% 一致) であることを意味します。The "same source sentence" means the exact same (100% matching), except for capitalization, white space, tag values, and punctuation at the end of a sentence. 5 以上の評価が格納されていない場合、返される結果は、Microsoft Translator による自動翻訳になります。If no rating is stored with a rating of 5 or above then the returned result will be the automatic translation by Microsoft Translator.

応答クラス (ステータス 200)Response class (Status 200)

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization ヘッダーまたは Ocp-Apim-Subscription-Key ヘッダーを使用する場合は、appid フィールドを空白のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
texttext (空)(empty) 必須。Required. 翻訳するテキストを表す文字列。A string representing the text to translate. テキストのサイズは、10,000 文字を超えてはいけません。The size of the text must not exceed 10000 characters. queryquery 文字列string
fromfrom (空)(empty) 省略可能。Optional. 翻訳テキストの言語コードを表す文字列。A string representing the language code of the translation text. たとえば、en は英語を表します。For example, en for English. queryquery 文字列string
toto (空)(empty) 必須。Required. テキストの翻訳先の言語コードを表す文字列。A string representing the language code to translate the text into. queryquery 文字列string
contentTypecontentType (空)(empty) 省略可能。Optional. 翻訳されるテキストの形式。The format of the text being translated. サポートされている形式は、text/plain (既定値) および text/html です。The supported formats are text/plain (default) and text/html. HTML の場合は、適切な形式の完全な要素である必要があります。Any HTML needs to be a well-formed, complete element. queryquery 文字列string
categorycategory (空)(empty) 省略可能。Optional. 翻訳のカテゴリ (ドメイン) を含む文字列。A string containing the category (domain) of the translation. 既定値は "general" です。Defaults to "general". queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン:"Bearer" + " " + "access_token"。Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /TranslateArrayPOST /TranslateArray

実装に関するメモImplementation notes

TranslateArray メソッドを使用して、複数のソース テキストに対する翻訳を取得します。Use the TranslateArray method to retrieve translations for multiple source texts.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/TranslateArray です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/TranslateArray.

要求本文の形式は、次のようにする必要があります。The format of the request body should be as follows:

<TranslateArrayRequest>
  <AppId />
  <From>language-code</From>
  <Options>
    <Category xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" >string-value</Category>
    <ContentType xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">text/plain</ContentType>
    <ReservedFlags xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" />
    <State xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" >int-value</State>
    <Uri xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" >string-value</Uri>
    <User xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" >string-value</User>
  </Options>
  <Texts>
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">string-value</string>
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">string-value</string>
  </Texts>
  <To>language-code</To>
</TranslateArrayRequest>

TranslateArrayRequest 内の要素は次のとおりです。Elements within the TranslateArrayRequest are:

  • appid:必須。appid: Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token".
  • from:省略可能。from: Optional. テキストの翻訳元の言語コードを表す文字列。A string representing the language code to translate the text from. 空のままにすると、応答に自動検出の言語の結果が含まれます。If left empty the response will include the result of language auto-detection.
  • options:省略可能。options: Optional. 以下に示す値を含む Options オブジェクト。An Options object which contains the values listed below. これらはすべて省略可能で、最も一般的な設定が既定値です。They are all optional and default to the most common settings. 指定された要素は、アルファベット順に一覧表示する必要があります。Specified elements must be listed in alphabetical order.
    • Category:翻訳のカテゴリ (ドメイン) を含む文字列。Category: A string containing the category (domain) of the translation. 既定値は general です。Defaults to general.
    • ContentType:翻訳されるテキストの形式。ContentType: The format of the text being translated. サポートされている形式は、text/plain (既定値)、text/xmltext/html です。The supported formats are text/plain (default), text/xml and text/html. HTML の場合は、適切な形式の完全な要素である必要があります。Any HTML needs to be a well-formed, complete element.
    • ProfanityAction:上記で説明したように、不適切な表現を処理する方法を指定します。ProfanityAction: Specifies how profanities are handled as explained above. ProfanityAction に指定できる値は、NoAction (既定値)、MarkedDeleted です。Accepted values of ProfanityAction are NoAction (default), Marked and Deleted.
    • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. 応答では同じ内容が返されます。The same contents will be returned in the response.
    • Uri:この URI で結果をフィルター処理します。Uri: Filter results by this URI. 既定値: allDefault: all.
    • User:このユーザーで結果をフィルター処理します。User: Filter results by this user. 既定値: allDefault: all.
  • texts:必須。texts: Required. 翻訳のためのテキストを格納する配列。An array containing the texts for translation. すべての文字列が同じ言語である必要があります。All strings must be of the same language. 翻訳するすべてのテキストの合計が、10,000 文字を超えてはいけません。The total of all texts to be translated must not exceed 10000 characters. 配列要素の最大数は 2,000 です。The maximum number of array elements is 2000.
  • to:必須。to: Required. テキストの翻訳先の言語コードを表す文字列。A string representing the language code to translate the text into.

省略可能な要素は省略できます。Optional elements can be omitted. TranslateArrayRequest の直接の子である要素は、アルファベット順に一覧表示する必要があります。Elements which are direct children of TranslateArrayRequest must be listed in alphabetical order.

TranslateArray メソッドは、Content-Typeapplication/xml または text/xml を受け入れます。TranslateArray method accepts application/xml or text/xml for Content-Type.

戻り値:TranslateArrayResponse 配列。Return value: A TranslateArrayResponse array. TranslateArrayResponse には次の要素があります。Each TranslateArrayResponse has the following elements:

  • Error:エラーが発生した場合に示します。Error: Indicates an error if one has occurred. それ以外の場合は null に設定されます。Otherwise set to null.
  • OriginalSentenceLengths:元のソース テキスト内の各文の長さを示す整数の配列。OriginalSentenceLengths: An array of integers indicating the length of each sentence in the original source text. 配列の長さは、文の数を示します。The length of the array indicates the number of sentences.
  • TranslatedText:翻訳されたテキスト。TranslatedText: The translated text.
  • TranslatedSentenceLengths:翻訳されたテキスト内の各文の長さを示す整数の配列。TranslatedSentenceLengths: An array of integers indicating the length of each sentence in the translated text. 配列の長さは、文の数を示します。The length of the array indicates the number of sentences.
  • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. 要求と同じコンテンツを返します。Returns the same content as in the request.

応答本文の形式は次のとおりです。The format of the response body is as follows.

<ArrayOfTranslateArrayResponse xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2"
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <TranslateArrayResponse>
    <From>language-code</From>
    <OriginalTextSentenceLengths xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:int>int-value</a:int>
    </OriginalTextSentenceLengths>
    <State/>
    <TranslatedText>string-value</TranslatedText>
    <TranslatedTextSentenceLengths xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:int>int-value</a:int>
    </TranslatedTextSentenceLengths>
  </TranslateArrayResponse>
</ArrayOfTranslateArrayResponse>

応答クラス (ステータス 200)Response class (Status 200)

成功した応答には、TranslateArrayResponse の配列が上で説明した形式で含まれています。A successful response includes an array of TranslateArrayResponse in format described above.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
AuthorizationAuthorization (空)(empty)) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン:"Bearer" + " " + "access_token"。Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response. 一般的なエラーの理由は、次のとおりです。Common errors include:
  • 配列要素を空にすることはできないArray element cannot be empty
  • 無効なカテゴリInvalid category
  • 翻訳元の言語が無効From language is invalid
  • 翻訳先の言語が無効To language is invalid
  • 要求に含まれている要素が多すぎるThe request contains too many elements
  • 翻訳元の言語がサポートされていないThe From language is not supported
  • 翻訳先の言語がサポートされていないThe To language is not supported
  • 翻訳要求に含まれるデータが多すぎるTranslate Request has too much data
  • HTML が正しい形式ではないHTML is not in a correct format
  • 翻訳要求で渡された文字列が多すぎたToo many strings were passed in the Translate Request
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /GetLanguageNamesPOST /GetLanguageNames

実装に関するメモImplementation notes

パラメーター languageCodes として渡され、渡されたロケールの言語を使用してローカライズされる言語の表示名を取得します。Retrieves friendly names for the languages passed in as the parameter languageCodes, and localized using the passed locale language.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/GetLanguageNames です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/GetLanguageNames.

要求本文には、表示名を取得する ISO 639-1 言語コードを表す文字列配列が含まれています。The request body includes a string array representing the ISO 639-1 language codes to retrieve the friendly names for. 例: For example:

<ArrayOfstring xmlns:i="http://www.w3.org/2001/XMLSchema-instance"  xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <string>zh</string>
    <string>en</string>
</ArrayOfstring>

戻り値: Translator サービスでサポートされ、要求された言語にローカライズされる言語名を含む文字列配列。Return value: A string array containing languages names supported by the Translator Service, localized into the requested language.

応答クラス (ステータス 200)Response class (Status 200)

Translator サービスでサポートされ、要求された言語にローカライズされる言語名を含む文字列配列。A string array containing languages names supported by the Translator Service, localized into the requested language.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
localelocale (空)(empty) 必須。Required. 言語に関連付けられている ISO 639 の小文字 2 文字のカルチャ コードと、言語名をローカライズする ISO 3166 の大文字 2 文字のサブカルチャ コードまたは ISO 639 自体の小文字のカルチャ コードの組み合わせを表す文字列。A string representing a combination of an ISO 639 two-letter lowercase culture code associated with a language and an ISO 3166 two-letter uppercase subculture code to localize the language names or an ISO 639 lowercase culture code by itself. queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /GetLanguagesForTranslateGET /GetLanguagesForTranslate

実装に関するメモImplementation notes

翻訳サービスでサポートされている言語を表す言語コードの一覧を取得します。Obtain a list of language codes representing languages that are supported by the Translation Service. Translate および TranslateArray は、これらの言語のうち、任意の 2 つの言語間を翻訳できます。Translate and TranslateArray can translate between any two of these languages.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/GetLanguagesForTranslate です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/GetLanguagesForTranslate.

戻り値: Translator サービスによってサポートされている言語コードを含む文字列配列。Return value: A string array containing the language codes supported by the Translator Services.

応答クラス (ステータス 200)Response class (Status 200)

Translator サービスによってサポートされている言語コードを含む文字列配列。A string array containing the language codes supported by the Translator Services.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /GetLanguagesForSpeakGET /GetLanguagesForSpeak

実装に関するメモImplementation notes

音声合成に使用できる言語を取得します。Retrieves the languages available for speech synthesis.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/GetLanguagesForSpeak です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/GetLanguagesForSpeak.

戻り値: Translator サービスによって音声合成がサポートされている言語コードを含む文字列配列。Return value: A string array containing the language codes supported for speech synthesis by the Translator Service.

応答クラス (ステータス 200)Response class (Status 200)

Translator サービスによって音声合成がサポートされている言語コードを含む文字列配列。A string array containing the language codes supported for speech synthesis by the Translator Service.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /SpeakGET /Speak

実装に関するメモImplementation notes

目的の言語で読み上げられる、渡されたテキストの wave または mp3 ストリームを返します。Returns a wave or mp3 stream of the passed-in text being spoken in the desired language.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/Speak です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/Speak.

戻り値: 目的の言語で話されている、渡されたテキストの wave または mp3 ストリーム。Return value: A wave or mp3 stream of the passed-in text being spoken in the desired language.

応答クラス (ステータス 200)Response class (Status 200)

binarybinary

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
texttext (空)(empty) 必須。Required. wave ストリームの読み上げに指定されている言語の文または文章を含む文字列。A string containing a sentence or sentences of the specified language to be spoken for the wave stream. 読み上げるテキストのサイズは、2,000 文字以内にする必要があります。The size of the text to speak must not exceed 2000 characters. queryquery 文字列string
languagelanguage (空)(empty) 必須。Required. テキストを読み上げるサポートされる言語コードを表す文字列。A string representing the supported language code to speak the text in. コードは、GetLanguagesForSpeak メソッドから返されるコードの一覧に存在している必要があります。The code must be present in the list of codes returned from the method GetLanguagesForSpeak. queryquery 文字列string
formatformat (空)(empty) 省略可能。Optional. content-type ID を指定する文字列。A string specifying the content-type ID. 現在、audio/wavaudio/mp3 が使用できます。Currently, audio/wav and audio/mp3 are available. 既定値は audio/wav です。The default value is audio/wav. queryquery 文字列string
optionsoptions (空)(empty)
  • 省略可能。Optional. 次の合成音声のプロパティを指定する文字列。A string specifying properties of the synthesized speech:
  • MaxQualityMinSize は、音声信号の品質を指定するために使用できます。MaxQuality and MinSize are available to specify the quality of the audio signals. MaxQuality を使用すると、最高品質と音声を取得することができ、MinSize を使用すると、最小サイズの音声を取得することができます。With MaxQuality, you can get voices with the highest quality, and with MinSize, you can get the voices with the smallest size. 既定値は MinSize です。Default is MinSize.
  • femalemale は、音声の性別を指定できます。female and male are available to specify the desired gender of the voice. 既定値は female です。Default is female. 垂直バー | を使用して複数のオプションを含めます。Use the vertical bar | to include multiple options. 例: MaxQuality|MaleFor example MaxQuality|Male.
queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /DetectGET /Detect

実装に関するメモImplementation notes

Detect メソッドを使用して、選択したテキストの一部の言語を識別します。Use the Detect method to identify the language of a selected piece of text.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/Detect です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/Detect.

戻り値: 指定したテキストの 2 文字の言語コードを含む文字列。Return value: A string containing a two-character Language code for the given text. .

応答クラス (ステータス 200)Response class (Status 200)

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
texttext (空)(empty) 必須。Required. 言語が識別されるいくつかのテキストを含む文字列。A string containing some text whose language is to be identified. テキストのサイズは、10,000 文字を超えてはいけません。The size of the text must not exceed 10000 characters. queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /DetectArrayPOST /DetectArray

実装に関するメモImplementation notes

DetectArray メソッドを使用して、文字列の配列の言語を一度に識別します。Use the DetectArray method to identify the language of an array of string at once. 個々の配列要素の独立した検出を実行し、配列の各行に対して結果を返します。Performs independent detection of each individual array element and returns a result for each row of the array.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/DetectArray です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/DetectArray.

要求本文の形式は、次のようにする必要があります。The format of the request body should be as follows.

<ArrayOfstring xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <string>string-value-1</string>
    <string>string-value-2</string>
</ArrayOfstring>

テキストのサイズは、10,000 文字を超えてはいけません。The size of the text must not exceed 10000 characters.

戻り値: 入力配列の各行の 2 文字の言語コードを含む文字列配列。Return value: A string array containing a two-character Language codes for each row of the input array.

応答本文の形式は次のとおりです。The format of the response body is as follows.

<ArrayOfstring xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <string>language-code-1</string>
  <string>language-code-2</string>
</ArrayOfstring>

応答クラス (ステータス 200)Response class (Status 200)

DetectArray が成功しました。DetectArray was successful. 入力配列の各行の 2 文字の言語コードを含む文字列配列を返します。Returns a string array containing a two-character Language codes for each row of the input array.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /AddTranslationGET /AddTranslation

実装に関するメモImplementation notes

重要

非推奨のお知らせ: 2018 年 1 月 31 日以降は、このメソッドは新しい文の送信を受け付けなくなり、エラー メッセージが表示されます。DEPRECATION NOTE: After January 31, 2018, this method will not accept new sentence submissions, and you will receive an error message. コラボレーション翻訳関数への変更に関するこのお知らせを参照してください。Please refer to this announcement about changes to the Collaborative Translation Functions.

翻訳メモリに翻訳を追加します。Adds a translation to the translation memory.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/AddTranslation です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/AddTranslation.

応答クラス (ステータス 200)Response class (Status 200)

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application: xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
originalTextoriginalText (空)(empty) 必須。Required. 翻訳元のテキストを含む文字列。A string containing the text to translate from. 文字列の最大長は 1,000 文字です。The string has a maximum length of 1000 characters. queryquery 文字列string
translatedTexttranslatedText (空)(empty) 必須。Required. ターゲット言語で翻訳されたテキストを含む文字列。A string containing translated text in the target language. 文字列の最大長は 2,000 文字です。The string has a maximum length of 2000 characters. queryquery 文字列string
fromfrom (空)(empty) 必須。Required. 翻訳テキストの言語コードを表す文字列。A string representing the language code of the translation text. en = 英語、de = ドイツ語など。en = english, de = german etc... queryquery 文字列string
toto (空)(empty) 必須。Required. テキストの翻訳先の言語コードを表す文字列。A string representing the language code to translate the text into. queryquery 文字列string
評価rating (空)(empty) 省略可能。Optional. この文字列の品質評価を表す整数。An integer representing the quality rating for this string. 値の範囲は -10 から 10 です。Value between -10 and 10. 既定値は 1 です。Defaults to 1. queryquery integerinteger
contentTypecontentType (空)(empty) 省略可能。Optional. 翻訳されるテキストの形式。The format of the text being translated. サポートされている形式は、"text/plain" と "text/html" です。The supported formats are "text/plain" and "text/html". HTML の場合は、適切な形式の完全な要素である必要があります。Any HTML needs to be a well-formed, complete element. queryquery 文字列string
categorycategory (空)(empty) 省略可能。Optional. 翻訳のカテゴリ (ドメイン) を含む文字列。A string containing the category (domain) of the translation. 既定値は "general" です。Defaults to "general". queryquery 文字列string
useruser (空)(empty) 必須。Required. 送信者を追跡するのに使用される文字列。A string used to track the originator of the submission. queryquery 文字列string
uriuri (空)(empty) 省略可能。Optional. この翻訳のコンテンツの場所を含む文字列。A string containing the content location of this translation. queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
410410 AddTranslation は現在サポートされていません。AddTranslation is no longer supported.
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /AddTranslationArrayPOST /AddTranslationArray

実装に関するメモImplementation notes

重要

非推奨のお知らせ: 2018 年 1 月 31 日以降は、このメソッドは新しい文の送信を受け付けなくなり、エラー メッセージが表示されます。DEPRECATION NOTE: After January 31, 2018, this method will not accept new sentence submissions, and you will receive an error message. コラボレーション翻訳関数への変更に関するこのお知らせを参照してください。Please refer to this announcement about changes to the Collaborative Translation Functions.

翻訳メモリを追加するために翻訳の配列を追加します。Adds an array of translations to add translation memory. これは AddTranslation の配列バージョンです。This is an array version of AddTranslation.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/AddTranslationArray です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/AddTranslationArray.

要求本文の形式は次のとおりです。The format of the request body is as follows.

<AddtranslationsRequest>
  <AppId></AppId>
  <From>A string containing the language code of the source language</From>
  <Options>
    <Category xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</Category>
    <ContentType xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">text/plain</ContentType>
    <User xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</User>
    <Uri xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</Uri>
  </Options>
  <To>A string containing the language code of the target language</To>
  <Translations>
    <Translation xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">
      <OriginalText>string-value</OriginalText>
      <Rating>int-value</Rating>
      <Sequence>int-value</Sequence>
      <TranslatedText>string-value</TranslatedText>
    </Translation>
  </Translations>
</AddtranslationsRequest>

AddtranslationsRequest 要素内の要素は次のとおりです。Elements within the AddtranslationsRequest element are:

  • AppId:必須。AppId: Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token".
  • From:必須。From: Required. ソース言語の言語コードを含む文字列。A string containing the language code of the source language. GetLanguagesForTranslate メソッドによって返されるいずれかの言語である必要があります。Must be one of the languages returned by the GetLanguagesForTranslate method.
  • To:必須。To: Required. ターゲット言語の言語コードを含む文字列。A string containing the language code of the target language. GetLanguagesForTranslate メソッドによって返されるいずれかの言語である必要があります。Must be one of the languages returned by the GetLanguagesForTranslate method.
  • Translations:必須。Translations: Required. 翻訳メモリに追加する翻訳の配列。An array of translations to add to translation memory. 各翻訳には、originalText、translatedText、rating を含める必要があります。Each translation must contain: originalText, translatedText and rating. originalText と translatedText のサイズは、それぞれ 1,000 文字に制限されます。The size of each originalText and translatedText is limited to 1000 chars. originalText と translatedText のすべての合計は、10,000 文字以内にする必要があります。The total of all the originalText(s) and translatedText(s) must not exceed 10000 characters. 配列要素の最大数は 100 です。The maximum number of array elements is 100.
  • Options:必須。Options: Required. オプションのセット (Category、ContentType、Uri、User など)。A set of options, including Category, ContentType, Uri, and User. User は必須です。User is required. Category、ContentType、Uri は省略可能です。Category, ContentType and Uri are optional. 指定された要素は、アルファベット順に一覧表示する必要があります。Specified elements must be listed in alphabetical order.

応答クラス (ステータス 200)Response class (Status 200)

AddTranslationArray メソッドが正常に完了しました。AddTranslationArray method was successful. 2018 年 2 月 1 日以降は、文の送信は受け付けられません。After January 31, 2018, sentence submissions will not be accepted. サービスでエラー コード 410 が返されます。The service will respond with error code 410.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン:"Bearer" + " " + "access_token"。Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
410410 AddTranslation は現在サポートされていません。AddTranslation is no longer supported.
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

GET /BreakSentencesGET /BreakSentences

実装に関するメモImplementation notes

テキストの一部を複数の文に分割し、各文の長さを含む配列を返します。Breaks a piece of text into sentences and returns an array containing the lengths in each sentence.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/BreakSentences です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/BreakSentences.

戻り値: 文の長さを表す整数の配列。Return value: An array of integers representing the lengths of the sentences. 配列の長さは文の数であり、値は各文の長さです。The length of the array is the number of sentences, and the values are the length of each sentence.

応答クラス (ステータス 200)Response class (Status 200)

文の長さを表す整数の配列。An array of integers representing the lengths of the sentences. 配列の長さは文の数であり、値は各文の長さです。The length of the array is the number of sentences, and the values are the length of each sentence.

integerinteger

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization ヘッダーまたは Ocp-Apim-Subscription-Key ヘッダーを使用する場合は、appid フィールドを空白のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
texttext (空)(empty) 必須。Required. 複数の文に分割するテキストを表す文字列。A string representing the text to split into sentences. テキストのサイズは、10,000 文字を超えてはいけません。The size of the text must not exceed 10000 characters. queryquery 文字列string
languagelanguage (空)(empty) 必須。Required. 入力テキストの言語コードを表す文字列。A string representing the language code of input text. queryquery 文字列string
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン:"Bearer" + " " + "access_token"。Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID をお知らせください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /GetTranslationsPOST /GetTranslations

実装に関するメモImplementation notes

ストアと MT エンジンから、指定した言語ペアの翻訳の配列を取得します。Retrieves an array of translations for a given language pair from the store and the MT engine. GetTranslations は、使用可能なすべての翻訳を返すため、Translate とは異なります。GetTranslations differs from Translate as it returns all available translations.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/GetTranslations です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/GetTranslations.

要求の本文には、次の形式の省略可能な TranslationOptions オブジェクトが含まれています。The body of the request includes the optional TranslationOptions object, which has the following format.

<TranslateOptions xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">
  <Category>string-value</Category>
  <ContentType>text/plain</ContentType>
  <ReservedFlags></ReservedFlags>
  <State>int-value</State>
  <Uri>string-value</Uri>
  <User>string-value</User>
</TranslateOptions>

TranslateOptions オブジェクトには、以下に示す値が含まれます。The TranslateOptions object contains the values listed below. これらはすべて省略可能で、最も一般的な設定が既定値です。They are all optional and default to the most common settings. 指定された要素は、アルファベット順に一覧表示する必要があります。Specified elements must be listed in alphabetical order.

  • Category:翻訳のカテゴリ (ドメイン) を含む文字列。Category: A string containing the category (domain) of the translation. 既定値は "general" です。Defaults to "general".
  • ContentType:唯一サポートされていて、既定値となっているオプションは "text/plain" です。ContentType: The only supported, and the default, option is "text/plain".
  • IncludeMultipleMTAlternatives: MT エンジンから複数の翻訳候補を返すかどうかを決定するブール型のフラグ。IncludeMultipleMTAlternatives: boolean flag to determine whether more than one alternatives should be returned from the MT engine. 有効な値は true および false (大文字と小文字を区別) です。Valid values are true and false (case-sensitive). 既定値は false で、翻訳候補が 1 つだけ含まれます。Default is false and includes only 1 alternative. フラグを true に設定すると、コラボレーション翻訳フレームワーク (CTF) と完全に統合されている翻訳に、人工的な翻訳候補を生成することができます。Setting the flag to true allows for generating artificial alternatives in translation, fully integrated with the collaborative translations framework (CTF). この機能は、デコーダーの n-best リストから人工的な翻訳候補を追加して、CTF には翻訳候補がない文章の翻訳候補を返すことができます。The feature allows for returning alternatives for sentences that have no alternatives in CTF, by adding artificial alternatives from the n-best list of the decoder.
    • 評価: 評価は、次のように適用されます。1) 最善の自動翻訳は評価 5 になります。Ratings The ratings are applied as follows: 1) The best automatic translation has a rating of 5. 2) CTF からの翻訳候補は、レビュー担当者の権限を、-10 から + 10 で反映します。2) The alternatives from CTF reflect the authority of the reviewer, from -10 to +10. 3) 自動的に生成された (n-best) 翻訳候補の評価は 0 になり、一致度は 100 になります。3) The automatically generated (n-best) translation alternatives have a rating of 0, and have a match degree of 100.
    • 翻訳候補の数: 返される翻訳候補の数は最大で maxTranslations までですが、それより少ない場合もあります。Number of Alternatives The number of returned alternatives is up to maxTranslations, but may be less.
    • 言語ペア: この機能は、簡体字中国語と繁体字中国語の間では、翻訳方向を問わず使用できません。Language pairs This functionality is not available for translations between Simplified and Traditional Chinese, both directions. Microsoft Translator がサポートしている他のすべての言語ペアで使用できます。It is available for all other Microsoft Translator supported language pairs.
  • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. 応答では同じ内容が返されます。The same contents will be returned in the response.
  • Uri:この URI で結果をフィルター処理します。Uri: Filter results by this URI. 値を設定しなかった場合は、既定値として all が使用されます。If no value is set, the default is all.
  • User:このユーザーで結果をフィルター処理します。User: Filter results by this user. 値を設定しなかった場合は、既定値として all が使用されます。If no value is set, the default is all.

要求 Content-Typetext/xml にする必要があります。Request Content-Type should be text/xml.

戻り値: 応答の形式は次のとおりです。Return value: The format of the response is as follows.

<GetTranslationsResponse xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2"
  xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <From>Two character language code</From>
  <State/>
  <Translations>
    <TranslationMatch>
      <Count>int-value</Count>
      <MatchDegree>int-value</MatchDegree>
      <MatchedOriginalText/>
      <Rating>int value</Rating>
      <TranslatedText>string-value</TranslatedText>
    </TranslationMatch>
  </Translations>
</GetTranslationsResponse>

これには、次の値を含む GetTranslationsResponse 要素が含まれています。This includes a GetTranslationsResponse element containing the following values:

  • Translations:一致が見つかり、TranslationMatch (下記参照) オブジェクトに格納されている配列。Translations: An array of matches found, stored in TranslationMatch (see below) objects. 翻訳には、元のテキストとのわずかな違い (あいまい一致) が含まれている場合があります。The translations may include slight variants of the original text (fuzzy matching). 翻訳は、次の順に並べ替えられます:最初に 100% 一致、次にあいまい一致。The translations will be sorted: 100% matches first, fuzzy matches below.
  • From:メソッドで翻訳元の言語を指定しなかった場合、これが自動言語検出の結果になります。From: If the method did not specify a From language, this will be the result of auto language detection. それ以外の場合は、指定された翻訳元の言語になります。Otherwise it will be the given From language.
  • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. TranslateOptions パラメーターで指定されているのと同じ値が含まれています。Contains the same value as given in the TranslateOptions parameter.

TranslationMatch オブジェクトは、以下で構成されます。TranslationMatch object consists of the following:

  • Error:特定の入力文字列でエラーが発生している場合、そのエラー コードが格納されます。Error: If an error has occurred for a specific input string, the error code is stored. それ以外の場合は、このフィールドは空です。Otherwise the field is empty.
  • MatchDegree:システムにより、不正確な一致を含むストアに対して入力文が照合されます。MatchDegree: The system matches input sentences against the store, including inexact matches. MatchDegree は、入力テキストがストアで見つかった元のテキストにどのくらい一致しているかを示します。MatchDegree indicates how closely the input text matches the original text found in the store. 返される値の範囲は 0 から 100 です。0 は類似性なしで、100 は大文字と小文字が完全に一致します。The value returned ranges from 0 to 100, where 0 is no similarity and 100 is an exact case sensitive match. MatchedOriginalText:この結果の一致した元のテキストです。MatchedOriginalText: Original text that was matched for this result. 一致した元のテキストが、入力されたテキストと異なる場合にのみ返されます。Only returned if the matched original text was different than the input text. あいまい一致のソース テキストを返すために使用されます。Used to return the source text of a fuzzy match. Microsoft Translator の結果に対しては返されません。Not returned for Microsoft Translator results.
  • Rating:品質を決定する人の権限を示します。Rating: Indicates the authority of the person making the quality decision. 機械翻訳の結果は、評価 5 になります。Machine Translation results will have a rating of 5. 匿名で提供された翻訳が通常、評価 1 から 4 であるのに対し、信頼性のある提供元からの翻訳は通常、評価 6 から 10 になります。Anonymously provided translations will generally have a rating of 1 to 4, whilst authoritatively provided translations will generally have a rating of 6 to 10.
  • Count:この評価のこの翻訳が選択された回数。Count: The number of times this translation with this rating has been selected. 自動的に翻訳された応答の値は 0 になります。The value will be 0 for the automatically translated response.
  • TranslatedText:翻訳されたテキスト。TranslatedText: The translated text.

応答クラス (ステータス 200)Response class (Status 200)

上で説明した形式の GetTranslationsResponse オブジェクト。A GetTranslationsResponse object in the format described above.

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
appidappid (空)(empty) 必須。Required. Authorization または Ocp-Apim-Subscription-Key ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If the Authorization or Ocp-Apim-Subscription-Key header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token". queryquery 文字列string
texttext (空)(empty) 必須。Required. 翻訳するテキストを表す文字列。A string representing the text to translate. テキストのサイズは、10,000 文字を超えてはいけません。The size of the text must not exceed 10000 characters. queryquery 文字列string
fromfrom (空)(empty) 必須。Required. 翻訳テキストの言語コードを表す文字列。A string representing the language code of the translation text. queryquery 文字列string
toto (空)(empty) 必須。Required. テキストの翻訳先の言語コードを表す文字列。A string representing the language code to translate the text into. queryquery 文字列string
maxTranslationsmaxTranslations (空)(empty) 必須。Required. 返す翻訳結果の最大数を表す整数。An integer representing the maximum number of translations to return. queryquery integerinteger
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". 文字列string headerheader
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

POST /GetTranslationsArrayPOST /GetTranslationsArray

実装に関するメモImplementation notes

GetTranslationsArray メソッドを使用して、複数のソース テキストに対する複数の翻訳候補を取得します。Use the GetTranslationsArray method to retrieve multiple translation candidates for multiple source texts.

要求 URI は https://api.microsofttranslator.com/V2/Http.svc/GetTranslationsArray です。The request URI is https://api.microsofttranslator.com/V2/Http.svc/GetTranslationsArray.

要求本文の形式は次のとおりです。The format of the request body is as follows.

<GetTranslationsArrayRequest>
  <AppId></AppId>
  <From>language-code</From>
  <MaxTranslations>int-value</MaxTranslations>
  <Options>
    <Category xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</Category>
    <ContentType xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">text/plain</ContentType>
    <ReservedFlags xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2"/>
    <State xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">int-value</State>
    <Uri xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</Uri>
    <User xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2">string-value</User>
  </Options>
  <Texts>
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">string-value</string>
  </Texts>
  <To>language-code</To>
</GetTranslationsArrayRequest>

GetTranslationsArrayRequest には次の要素が含まれます。GetTranslationsArrayRequest includes the following elements:

  • AppId:必須。AppId: Required. Authorization ヘッダーを使用している場合は、appid フィールドは空のままにするか、"Bearer" + " " + "access_token" を含む文字列を含めます。If Authorization header is used, leave the appid field empty else include a string containing "Bearer" + " " + "access_token".
  • From:必須。From: Required. 翻訳テキストの言語コードを表す文字列。A string representing the language code of the translation text.
  • MaxTranslations:必須。MaxTranslations: Required. 返す翻訳結果の最大数を表す整数。An integer representing the maximum number of translations to return.
  • Options:省略可能。Options: Optional. 以下に示す値を含む Options オブジェクト。An Options object which contains the values listed below. これらはすべて省略可能で、最も一般的な設定が既定値です。They are all optional and default to the most common settings. 指定された要素は、アルファベット順に一覧表示する必要があります。Specified elements must be listed in alphabetical order.
    • Category`:翻訳のカテゴリ (ドメイン) を含む文字列。Category`: A string containing the category (domain) of the translation. 既定値は "general" です。Defaults to general.
    • ContentType:唯一サポートされていて、既定値となっているオプションは "text/plain" です。ContentType: The only supported, and the default, option is text/plain.
    • IncludeMultipleMTAlternatives: MT エンジンから複数の翻訳候補を返すかどうかを決定するブール型のフラグ。IncludeMultipleMTAlternatives: boolean flag to determine whether more than one alternatives should be returned from the MT engine. 有効な値は true および false (大文字と小文字を区別) です。Valid values are true and false (case-sensitive). 既定値は false で、翻訳候補が 1 つだけ含まれます。Default is false and includes only 1 alternative. フラグを true に設定すると、コラボレーション翻訳フレームワーク (CTF) と完全に統合されている翻訳に、人工的な翻訳候補を生成することができます。Setting the flag to true allows for generating artificial alternatives in translation, fully integrated with the collaborative translations framework (CTF). この機能は、デコーダーの n-best リストから人工的な翻訳候補を追加して、CTF には翻訳候補がない文章の翻訳候補を返すことができます。The feature allows for returning alternatives for sentences that have no alternatives in CTF, by adding artificial alternatives from the n-best list of the decoder.
      • 評価: 評価は、次のように適用されます。1) 最善の自動翻訳は評価 5 になります。Ratings The ratings are applied as follows: 1) The best automatic translation has a rating of 5. 2) CTF からの翻訳候補は、レビュー担当者の権限を、-10 から + 10 で反映します。2) The alternatives from CTF reflect the authority of the reviewer, from -10 to +10. 3) 自動的に生成された (n-best) 翻訳候補の評価は 0 になり、一致度は 100 になります。3) The automatically generated (n-best) translation alternatives have a rating of 0, and have a match degree of 100.
      • 翻訳候補の数: 返される翻訳候補の数は最大で maxTranslations までですが、それより少ない場合もあります。Number of Alternatives The number of returned alternatives is up to maxTranslations, but may be less.
      • 言語ペア: この機能は、簡体字中国語と繁体字中国語の間では、翻訳方向を問わず使用できません。Language pairs This functionality is not available for translations between Simplified and Traditional Chinese, both directions. Microsoft Translator がサポートしている他のすべての言語ペアで使用できます。It is available for all other Microsoft Translator supported language pairs.
  • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. 応答では同じ内容が返されます。The same contents will be returned in the response.
  • Uri:この URI で結果をフィルター処理します。Uri: Filter results by this URI. 値を設定しなかった場合は、既定値として all が使用されます。If no value is set, the default is all.
  • User:このユーザーで結果をフィルター処理します。User: Filter results by this user. 値を設定しなかった場合は、既定値として all が使用されます。If no value is set, the default is all.
  • Texts:必須。Texts: Required. 翻訳のためのテキストを格納する配列。An array containing the texts for translation. すべての文字列が同じ言語である必要があります。All strings must be of the same language. 翻訳するすべてのテキストの合計が、10,000 文字を超えてはいけません。The total of all texts to be translated must not exceed 10000 characters. 配列要素の最大数は 10 です。The maximum number of array elements is 10.
  • To:必須。To: Required. テキストの翻訳先の言語コードを表す文字列。A string representing the language code to translate the text into.

省略可能な要素は省略できます。Optional elements can be omitted. GetTranslationsArrayRequest の直接の子である要素は、アルファベット順に一覧表示する必要があります。Elements which are direct children of GetTranslationsArrayRequest must be listed in alphabetical order.

要求 Content-Typetext/xml にする必要があります。Request Content-Type should be text/xml.

戻り値: 応答の形式は次のとおりです。Return value: The format of the response is as follows.

<ArrayOfGetTranslationsResponse xmlns="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <GetTranslationsResponse>
    <From>language-code</From>
    <State/>
    <Translations>
      <TranslationMatch>
        <Count>int-value</Count>
        <MatchDegree>int-value</MatchDegree>
        <MatchedOriginalText>string-value</MatchedOriginalText>
        <Rating>int-value</Rating>
        <TranslatedText>string-value</TranslatedText>
      </TranslationMatch>
      <TranslationMatch>
        <Count>int-value</Count>
        <MatchDegree>int-value</MatchDegree>
        <MatchedOriginalText/>
        <Rating>int-value</Rating>
        <TranslatedText>string-value</TranslatedText>
      </TranslationMatch>
    </Translations>
  </GetTranslationsResponse>
</ArrayOfGetTranslationsResponse>

GetTranslationsResponse 要素には、次の値が含まれています。Each GetTranslationsResponse element contains the following values:

  • Translations:一致が見つかり、TranslationMatch (下記参照) オブジェクトに格納されている配列。Translations: An array of matches found, stored in TranslationMatch (see below) objects. 翻訳には、元のテキストとのわずかな違い (あいまい一致) が含まれている場合があります。The translations may include slight variants of the original text (fuzzy matching). 翻訳は、次の順に並べ替えられます:最初に 100% 一致、次にあいまい一致。The translations will be sorted: 100% matches first, fuzzy matches below.
  • From:メソッドで From 言語を指定しなかった場合、これが自動言語検出の結果になります。From: If the method did not specify a From language, this will be the result of auto language detection. それ以外の場合は、指定された翻訳元の言語になります。Otherwise it will be the given From language.
  • State:要求と応答を関連付けるのに役立つユーザー状態。State: User state to help correlate request and response. TranslateOptions パラメーターで指定されているのと同じ値が含まれています。Contains the same value as given in the TranslateOptions parameter.

TranslationMatch オブジェクトは、以下で構成されます。TranslationMatch object consists of the following:

  • Error:特定の入力文字列でエラーが発生している場合、そのエラー コードが格納されます。Error: If an error has occurred for a specific input string, the error code is stored. それ以外の場合は、このフィールドは空です。Otherwise the field is empty.
  • MatchDegree:システムにより、不正確な一致を含むストアに対して入力文が照合されます。MatchDegree: The system matches input sentences against the store, including inexact matches. MatchDegree は、入力テキストがストアで見つかった元のテキストにどのくらい一致しているかを示します。MatchDegree indicates how closely the input text matches the original text found in the store. 返される値の範囲は 0 から 100 です。0 は類似性なしで、100 は大文字と小文字が完全に一致します。The value returned ranges from 0 to 100, where 0 is no similarity and 100 is an exact case sensitive match.
  • MatchedOriginalText:この結果の一致した元のテキストです。MatchedOriginalText: Original text that was matched for this result. 一致した元のテキストが、入力されたテキストと異なる場合にのみ返されます。Only returned if the matched original text was different than the input text. あいまい一致のソース テキストを返すために使用されます。Used to return the source text of a fuzzy match. Microsoft Translator の結果に対しては返されません。Not returned for Microsoft Translator results.
  • Rating:品質を決定する人の権限を示します。Rating: Indicates the authority of the person making the quality decision. 機械翻訳の結果は、評価 5 になります。Machine Translation results will have a rating of 5. 匿名で提供された翻訳が通常、評価 1 から 4 であるのに対し、信頼性のある提供元からの翻訳は通常、評価 6 から 10 になります。Anonymously provided translations will generally have a rating of 1 to 4, whilst authoritatively provided translations will generally have a rating of 6 to 10.
  • Count:この評価のこの翻訳が選択された回数。Count: The number of times this translation with this rating has been selected. 自動的に翻訳された応答の値は 0 になります。The value will be 0 for the automatically translated response.
  • TranslatedText:翻訳されたテキスト。TranslatedText: The translated text.

応答クラス (ステータス 200)Response class (Status 200)

文字列string

応答コンテンツ タイプ: application/xmlResponse Content Type: application/xml

parametersParameters

パラメーターParameter Value 説明Description パラメーターのタイプParameter Type データ型Data Type
AuthorizationAuthorization (空)(empty) appid フィールドまたは Ocp-Apim-Subscription-Key ヘッダーが指定されていない場合は必須。Required if the appid field or Ocp-Apim-Subscription-Key header is not specified. 認証トークン: "Bearer" + " " + "access_token"Authorization token: "Bearer" + " " + "access_token". headerheader 文字列string
Ocp-Apim-Subscription-KeyOcp-Apim-Subscription-Key (空)(empty) appid フィールドまたは Authorization ヘッダーが指定されていない場合は必須。Required if the appid field or Authorization header is not specified. headerheader 文字列string

応答メッセージResponse messages

HTTP 状態コードHTTP Status Code 理由Reason
400400 無効な要求です。Bad request. 入力パラメーターと詳細なエラー応答を確認してください。Check input parameters and the detailed error response.
401401 無効な資格情報Invalid credentials
500500 サーバー エラー。Server error. エラーが解決しない場合は、お知らせください。If the error persists, let us know. 要求のおよその日時と、応答ヘッダー X-MS-Trans-Info に含まれている要求 ID を提供してください。Please provide us with the approximate date & time of the request and with the request ID included in the response header X-MS-Trans-Info.
503503 サービスが一時的に利用できません。Service temporarily unavailable. 再試行して、エラーが解決しない場合は、お知らせください。Please retry and let us know if the error persists.

次の手順Next steps