この記事の内容

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.

アクセス トークンを使用します。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.

不適切な単語は、置換されずに出力から削除されます。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.

以前に 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.

応答メッセージResponse messages

サーバー エラー。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.

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/xml、text/html です。The supported formats are text/plain (default), text/xml and text/html.HTML の場合は、適切な形式の完全な要素である必要があります。Any HTML needs to be a well-formed, complete element.

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.

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

戻り値: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.

翻訳要求で渡された文字列が多すぎた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.

応答メッセージResponse messages

サーバー エラー。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.

応答メッセージResponse messages

サーバー エラー。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.

応答メッセージResponse messages

サーバー エラー。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.

必須。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.

MaxQuality と MinSize は、音声信号の品質を指定するために使用できます。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.

female と male は、音声の性別を指定できます。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|Male。For example MaxQuality|Male.

応答メッセージResponse messages

サーバー エラー。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.

応答メッセージResponse messages

サーバー エラー。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.

応答メッセージResponse messages

サーバー エラー。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.

省略可能。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.

サーバー エラー。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.

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.

サーバー エラー。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.

戻り値: 文の長さを表す整数の配列。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.

応答メッセージResponse messages

サーバー エラー。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.

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.

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.

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.

応答メッセージResponse messages

サーバー エラー。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.

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.

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

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.

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.

応答メッセージResponse messages

サーバー エラー。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.