---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DynamicTranslation - スコープ指定

# DynamicTranslation - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：40分

DynamicTranslation API は、翻訳サービスプロバイダーを使用してテキストを複数の言語にリアルタイムで翻訳するメソッドを提供します。

また、この API を使用して、特定の文字列の言語を検出し、翻訳サービスに対して DynamicTranslation メソッドが有効になっているかどうかをチェックできます。この API を使用して、ユーザーインターフェイスのシームレスなローカライズエクスペリエンスを作成し、1 つのインターフェイスで複数の国にサービスを提供できるようにします。

現在、この API は、Microsoft Azure Translator サービスと Google Cloud Translator サービスの 2 つの翻訳サービスプロバイダーをサポートしています。インスタンス内で他の翻訳サービスを設定し、DynamicTranslation API を使用してテキストを翻訳することもできます。

サーバー側スクリプトでこれらのメソッドを使用する場合は、`sn_dt_api` 名前空間識別子を使用します。この API を使用するには、Dynamic Translation (com.glide.dynamic_translation) プラグインをアクティブ化する必要があります。このプラグインの詳細と 動的翻訳に関する追加情報については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。

## DynamicTranslation - getDetectedLanguage(文字列 text, オブジェクト parms) {#ariaid-title2}

渡されたテキストの言語を検出します。
翻訳者を渡すと、 メソッドはその翻訳サービスを使用してソース言語を検出します。それ以外の場合は、デフォルトの翻訳サービスによって検出が実行されます。指定するテキスト文字列に、適切な言語検出を可能にするのに十分な言い回しが含まれていることを確認してください。

応答には、検出された言語に加えて、検出の信頼性レベルと他の考えられる代替言語が含まれています。翻訳者が渡されない場合、このメソッドは言語の検出に使用されるデフォルトの翻訳サービスも返します。
{#DynTran-getDetectedLanguage_S_O__table_rym_ftl_thb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| text | 文字列 | 言語の検出に使用するテキストです。 |
| parms | オブジェクト | オプション。追加の translation パラメーターを含む JSON オブジェクトです。 |
| parms.translator | 文字列 | オプション。テキストの翻訳に使用される翻訳サービス (大文字と小文字は区別されません)。 有効な値： * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguage_S_O__ul_jdd_zbl_thq} 注: カスタム翻訳サービスを使用するには、最初にインスタンスで翻訳サービスを設定する必要があります。詳しくは、 [翻訳サービスプロバイダーとの統合](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)をご覧ください。 デフォルト：翻訳者構成 \[sn_dt_translator_configuration\] テーブルで構成された翻訳サービス。 |
[表 : 1. パラメーター]

{#DynTran-getDetectedLanguage_S_O__table_rym_ftl_thb} {#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb__entry__2}{#DynTran-getDetectedLanguage_S_O__detections_alternatives-entry-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_code-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_conf-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_alternatives_name-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_confidence-row-dynTran}{#DynTran-getDetectedLanguage_S_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getDetectedLanguage_S_O__translator-row-dynTran}

| タイプ | 説明 |
|-|-|
| alternatives | 一致する可能性がある他の言語を記述するオブジェクトのアレイです。 データタイプ：アレイ "alternatives": [ { "code": "String", "confidence": "String", "name": "String" } ] |
| alternatives.code | 代替言語の言語コード。 データタイプ：文字列 |
| alternatives.confidence | 代替言語の信頼性レベルを示す浮動小数点値。値は 0 と 1 の間です。値が小さいほど、信頼性レベルが低くなります。 データタイプ：文字列 |
| alternatives.name | 代替言語の言語コード。 データタイプ：文字列 |
| detectedLanguage | 検出された言語の説明です。 データタイプ：オブジェクト "detectedLanguage": { "code": "String", "confidence": "String", "name": "String" } |
| detectedLanguage.code | 検出された言語の言語コード。 データタイプ：文字列 |
| detectedLanguage.confidence | 代替言語の信頼性レベルを示す浮動小数点値。値は 0 と 1 の間です。値が小さいほど、信頼性レベルが低くなります。 データタイプ：文字列 |
| detectedLanguage.name | 検出された言語の言語コード。 データタイプ：文字列 |
| translator | 言語を検出するために使用される翻訳サービス。 データタイプ：文字列 |
| エラーメッセージ | メソッドが返す可能性があるエラーメッセージとエラーの根本原因の表示を以下に示します。 * テキスト (\[テキスト\] フィールド) が欠落しているか無効です。 (40000)：翻訳するテキストが欠落しているか、文字列ではありません。 * Dynamic Translation プラグインがインストールされていません。 (40001)： com.glide.dynamic_translation プラグインを有効にせずに Dynamic Translation API が呼び出されました。このプラグインのアクティブ化については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者 (\[翻訳者\] フィールド) が無効です。 (40003)：渡された translator パラメーターが文字列ではありません。 * \<translator\> 翻訳者が構成されていません。 (40004)：指定された翻訳サービスが \[翻訳者構成\] で構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が非アクティブです。 (40005)：指定された翻訳サービスが \[翻訳者構成\] で \[アクティブ\] に設定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 追加のパラメーターが無効です。 (40006)：渡された追加のパラメーターはオブジェクトではありません。 * 最大時間制限を超えました。(40009)：翻訳構成で指定された定義済みのタイムアウト値よりも長い時間が操作にかかりました。 デフォルト：40 秒 * デフォルトの翻訳者が検出用に構成されていません。 (40011)：\[翻訳者構成\] で言語検出のデフォルトの翻訳サービスが指定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が検出用に構成されていません。 (40013)：指定された翻訳サービスが \[翻訳者構成\] で言語検出用に構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 不明なエラーが発生しました。(40051):エラーが他のカテゴリに分類されない場合にスローされる既定のエラー。 * テキスト (\[テキスト\] フィールド) が最大長を超えました。(40052)：翻訳のために渡されたテキストが、対応する翻訳サービスでサポートされている最大長を超えています。 * 資格情報がないか無効であるため、要求は許可されません (40055)：\[接続 \& 資格情報\] で翻訳サービス用に構成された認証情報が無効です。接続と資格情報の詳細については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 {#DynTran-getDetectedLanguage_S_O__ul_ccq_ntm_b3b} |
[表 : 2. 返される内容]

{#DynTran-getDetectedLanguage_S_O__table_sym_ftl_thb}  
この例は、IBM の翻訳サービスを使用して英語の文字列を検出する サーバー側スクリプトのコードを示しています。

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":'IBM'});
     gs.info(JSON.stringify(detectedResponse));

出力:

    {
      detectedLanguage:
        { "code": "en", "confidence": "1", "name": "en" }
      alternatives: 
        [
          { "code": "vi", "confidence": "0.86", "name": "vi" },
          { "code": "id", "confidence": "0.86", "name": "id" }
        ]                  
     }

この例は、無効な翻訳サービスが渡されたときにエラーをスローするサーバースクリプトを示しています。

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguage('Please detect the language of this text', {"translator":123});
     gs.info(JSON.stringify(detectedResponse));

出力:

    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}

## DynamicTranslation - getDetectedLanguages(アレイ texts, オブジェクト parms) {#ariaid-title3}

渡されたテキスト文字列の言語を検出します。
翻訳者を渡すと、 メソッドはその翻訳サービスを使用してソース言語を検出します。それ以外の場合は、デフォルトの翻訳サービスによって検出が実行されます。指定するテキスト文字列に、適切な言語検出を可能にするのに十分な言い回しが含まれていることを確認してください。

応答には、検出された言語に加えて、検出の信頼性レベルと他の考えられる代替言語が含まれています。翻訳者が渡されない場合、このメソッドは言語の検出に使用されるデフォルトの翻訳サービスも返します。
{#DynTran-getDetectedLanguages_A_O__table_mnq_h3q_nnb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| テキスト | アレイ | 言語を検出するために使用するテキスト文字列のリスト。 |
| parms | オブジェクト | オプション。追加の translation パラメーターを含む JSON オブジェクトです。 "parms": { "translator": "String" } |
| parms.translator | 文字列 | 文字列の言語を検出するために使用する翻訳サービス。翻訳サービスは、\[翻訳者構成\] メニューで構成され、翻訳者構成 \[sn_dt_translator_configuration\] テーブルに置かれます。 可能な値 - 大文字と小文字を区別しない： * Google * Microsoft * IBM * \<custom\> {#DynTran-getDetectedLanguages_A_O__ul_gwz_cjr_nnb} 注: カスタム翻訳サービスを使用するには、最初にインスタンスで翻訳サービスを設定する必要があります。詳しくは、 [翻訳サービスプロバイダーとの統合](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)をご覧ください。 デフォルト：翻訳者構成 \[sn_dt_translator_configuration\] テーブルで構成された翻訳サービス。 |
[表 : 3. パラメーター]

{#DynTran-getDetectedLanguages_A_O__table_mnq_h3q_nnb} {#DynTran-getDetectedLanguages_A_O__table_nnq_h3q_nnb__entry__2}{#DynTran-getDetectedLanguages_A_O__detections-entry-dynTran}{#DynTran-getDetectedLanguages_A_O__status-entry-dynTran}{#DynTran-getDetectedLanguages_A_O__translator-entry-dynTran}

| タイプ | 説明 |
|-|-|
| 検出 | テキスト文字列の言語検出。 データタイプ：オブジェクト "detections": { "alternatives": [Array], "detectedLanguage": {Object}, "isError": Boolean ] |
| detections.alternatives | 一致する可能性がある他の言語を説明するオブジェクトのアレイです。 データタイプ：アレイ "alternatives": [ { "code": "String", "confidence": "String", "name": "String" } ] |
| detections.alternatives.code | 代替言語の言語コード。 データタイプ：文字列 |
| detections.alternatives.confidence | 代替言語の信頼性レベルを示す浮動小数点値。値は 0 と 1 の間です。値が小さいほど、信頼性レベルが低くなります。 データタイプ：文字列 |
| detections.alternatives.name | 代替言語の言語コード。 データタイプ：文字列 |
| detections.detectedLanguage | 検出された言語の説明です。 データタイプ：オブジェクト "detectedLanguage": { "code": "String", "confidence": "String", "name": "String" } |
| detections.detectedLanguage.code | 検出された言語の言語コード。 データタイプ：文字列 |
| detections.detectedLanguage.confidence | 代替言語の信頼性レベルを示す浮動小数点値。値は 0 と 1 の間です。値が小さいほど、信頼性レベルが低くなります。 データタイプ：文字列 |
| detections.detectedLanguage.name | 検出された言語の言語コード。 データタイプ：文字列 |
| detections.isError | テキストの言語の検出がエラーとなったかどうかを示すフラグ。 有効な値： * true：エラーが発生しました。 * false：言語の検出に成功しました。 {#DynTran-getDetectedLanguages_A_O__ul_alf_hmq_nnb} データタイプ：ブール |
| status | メソッド呼び出しへの応答のステータス。 可能な値： * エラー * 部分的 * 成功 {#DynTran-getDetectedLanguages_A_O__ul_slc_rmq_nnb} データタイプ：文字列 |
| translator | 言語を検出するために使用される翻訳サービス。 データタイプ：文字列 |
| エラーメッセージ | メソッドが返す可能性があるエラーメッセージとエラーの根本原因の表示を以下に示します。 * テキスト (\[テキスト\] フィールド) が欠落しているか無効です。 (40000)：翻訳するテキストが欠落しているか、文字列ではありません。 * Dynamic Translation プラグインがインストールされていません。 (40001)： com.glide.dynamic_translation プラグインを有効にせずに Dynamic Translation API が呼び出されました。このプラグインのアクティブ化については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者 (\[翻訳者\] フィールド) が無効です。 (40003)：渡された translator パラメーターが文字列ではありません。 * \<translator\> 翻訳者が構成されていません。 (40004)：指定された翻訳サービスが \[翻訳者構成\] で構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が非アクティブです。 (40005)：指定された翻訳サービスが \[翻訳者構成\] で \[アクティブ\] に設定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 追加のパラメーターが無効です。 (40006)：渡された追加のパラメーターはオブジェクトではありません。 * 最大時間制限を超えました。(40009)：翻訳構成で指定された定義済みのタイムアウト値よりも長い時間が操作にかかりました。 デフォルト：40 秒 * 複数のエラーで要求が失敗しました。 (40010)：言語検出呼び出しで複数のエラーが発生しました。詳細については、個々のテキスト文字列の応答を参照してください。 * デフォルトの翻訳者が検出用に構成されていません。 (40011)：\[翻訳者構成\] で言語検出のデフォルトの翻訳サービスが指定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が検出用に構成されていません。 (40013)：指定された翻訳サービスが \[翻訳者構成\] で言語検出用に構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者構成バージョンが無効です。v3 に移行してください。 (40014)：指定された翻訳サービスに関連付けられている翻訳者構成のバージョンは、指定されたテキスト翻訳方法をサポートしていません。詳細については、「 [翻訳ツール構成のバージョン v3 への移行](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 不明なエラーが発生しました。(40051):エラーが他のカテゴリに分類されない場合にスローされる既定のエラー。 * テキスト (\[テキスト\] フィールド) が最大長を超えました。(40052)：翻訳のために渡されたテキストが、対応する翻訳サービスでサポートされている最大長を超えています。 * 資格情報がないか無効であるため、要求は許可されません (40055)：\[接続 \& 資格情報\] で翻訳サービス用に構成された認証情報が無効です。接続と資格情報の詳細については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 {#DynTran-getDetectedLanguages_A_O__ul_ccq_ntm_b3b} |
[表 : 4. 返される内容]

{#DynTran-getDetectedLanguages_A_O__table_nnq_h3q_nnb}  
この例は、Microsoft の翻訳サービスを使用して、渡された文字列の言語として英語を検出するサーバースクリプトのコードを示しています。

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "Microsoft"});
    gs.info(JSON.stringify(detectedResponse));

出力

    {
      "translator":"Microsoft",
      "status":"Success",
      "detections":[
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"id", "code":"id", "confidence":"0.83"},
            {"name":"ms", "code":"ms", "confidence":"0.83"}
          ]
        },
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"fr", "code":"fr", "confidence":"0.83"},
            {"name":"id", "code":"id", "confidence":"0.83"}
          ]
        }
      ]
    }

この例は、2 つのテキスト文字列が渡されて、そのうちの 1 つが無効である場合に Partial というステータスを返すサーバースクリプトのコードを示しています。

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", ""], {"translator": "Microsoft"});
    gs.info(JSON.stringify(detectedResponse));

出力

    {
      "translator":"Microsoft",
      "status":"Partial",
      "detections":[
        {
          "isError":false,
          "detectedLanguage":{"name":"en", "code":"en", "confidence":"1"},
          "alternatives":[
            {"name":"id", "code":"id", "confidence":"0.83"},
            {"name":"ms", "code":"ms", "confidence":"0.83"}
          ]
        },
        {
          "isError":true,
          "code":"40000",
          "message":"Text is missing or invalid"
        }
      ]
    }

この例は、無効な翻訳サービスが渡されたときにエラーをスローするサーバースクリプトのコードを示しています。

    var detectedResponse = sn_dt_api.DynamicTranslation.getDetectedLanguages(["First text string language to detect", "Second text string language to detect"], {"translator": "123"});
    gs.info(JSON.stringify(detectedResponse));

出力

    {"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}

## DynamicTranslation - getTranslation(文字列 textToTranslate, オブジェクト parms) {#ariaid-title4}

渡されたテキストを 1 つ以上の言語に翻訳します。
この方法では、Microsoft Azure Translator サービスや Google Cloud Translator サービスなどの翻訳サービスを使用して翻訳を実行します。翻訳パラメーターを渡さない場合、メソッドはシステムのデフォルトを使用します。
{#DynTran-getTranslation_S_O__table_bzb_4zk_thb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| textToTranslate | 文字列 | 翻訳するテキスト。 |
| parms | オブジェクト | オプション。追加の translation パラメーターを含む JSON オブジェクトです。 "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parms.additionalParameters | アレイ | オプション。JSON オブジェクトのアレイ。各オブジェクトには、翻訳を実行するための追加情報を提供するキーと値のペアが含まれています。 "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.additionalParameters.parameterName | 文字列 | オプション。キー名。 有効な値： textype：翻訳するテキストのタイプ。Microsoft Azure Translator サービスの場合のみ。 |
| parms.additionalParameters.parameterValue | 文字列 | オプション。関連付けられたキーの値。 有効な値： * plain：標準的なテキスト文字列 * html：HTML テキスト文字列 {#DynTran-getTranslation_S_O__ul_jk3_hhb_xhb} デフォルト：plain |
| parms.sourceLanguage | 文字列 | オプション。ソーステキストの言語コード。 デフォルト：翻訳サービスがソース言語を検出します。 |
| parms.targetLanguages | アレイ | オプション。テキストの翻訳に使用する言語コードのリスト。このメソッドは、言語コードごとに翻訳されたテキストを返します。 デフォルト：ユーザーの優先言語。 |
| parms.translator | 文字列 | オプション。テキストの翻訳に使用される翻訳サービス (大文字と小文字は区別されません)。 有効な値： * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslation_S_O__ul_jdd_zbl_thq} 注: カスタム翻訳サービスを使用するには、最初にインスタンスで翻訳サービスを設定する必要があります。詳しくは、 [翻訳サービスプロバイダーとの統合](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)をご覧ください。 デフォルト：翻訳者構成 \[sn_dt_translator_configuration\] テーブルで構成された翻訳サービス。 |
[表 : 5. パラメーター]

{#DynTran-getTranslation_S_O__table_bzb_4zk_thb} {#DynTran-getTranslation_S_O__table_czb_4zk_thb__entry__2}{#DynTran-getTranslation_S_O__detections_detectedLanguage-row-dynTran}{#DynTran-getTranslation_S_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getTranslation_S_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getTranslation_S_O__translations-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__trans_trg_lang-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__trans_transText-trans-entry-dynTrans}{#DynTran-getTranslation_S_O__translator-row-dynTran}

| タイプ | 説明 |
|-|-|
| detectedLanguage | 検出された言語の説明です。 データタイプ：オブジェクト "detectedLanguage": { "code": "String", "name": "String" } |
| detectedLanguage.code | 検出された言語の言語コード。 データタイプ：文字列 |
| detectedLanguage.name | 検出された言語の言語コード。 データタイプ：文字列 |
| 翻訳 | 言語翻訳を説明するオブジェクトのアレイ。 データタイプ：アレイ translations": [ { "targetLanguage": "String", "translatedText": "String" } ] |
| translations.targetLanguage | ソーステキストが翻訳された言語コード。 データタイプ：文字列 |
| translations.translatedText | 翻訳されたテキスト。 データタイプ：文字列 |
| translator | 言語を検出するために使用される翻訳サービス。 データタイプ：文字列 |
| エラーメッセージ | メソッドが返す可能性があるエラーメッセージとその根本原因の表示を以下に示します。 * テキスト (\[テキスト\] フィールド) が欠落しているか無効です。 (40000)：翻訳するテキストが欠落しているか、文字列ではありません。 * Dynamic Translation プラグインがインストールされていません。 (40001)： com.glide.dynamic_translation プラグインを有効にせずに Dynamic Translation API が呼び出されました。このプラグインのアクティブ化については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * デフォルトの翻訳者が翻訳用に構成されていません。 (40002)：\[翻訳者構成\] でデフォルトの翻訳サービスとして選択されている翻訳サービスがありません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者 (\[翻訳者\] フィールド) が無効です。 (40003)：渡された translator パラメーターが文字列ではありません。 * \<translator\> 翻訳者が構成されていません。 (40004)：指定された翻訳サービスが \[翻訳者構成\] で構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が非アクティブです。 (40005)：指定された翻訳サービスが \[翻訳者構成\] で \[アクティブ\] に設定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 追加のパラメーターが無効です。 (40006)：渡された追加のパラメーターはオブジェクトではありません。 * ターゲット言語 (\[targetLanguages\] フィールド) が無効です。 (40007)：targetLanguages パラメーターが呼び出しで渡されましたが、次のいずれかの理由で有効ではありません。 * 値がアレイではありません * アレイが空です * 1 つまたは複数のエントリが文字列ではありません {#DynTran-getTranslation_S_O__ul_zdj_4b4_b3b} * ソース言語 (\[sourceLanguage\] フィールド) が無効です。 (40008)：sourceLanguage パラメーターが呼び出しで渡されましたが、値が文字列ではありません。 * 最大時間制限を超えました。(40009)：翻訳構成で指定された定義済みのタイムアウト値よりも長い時間が操作にかかりました。 デフォルト：40 秒 * \<translator\> 翻訳者が翻訳用に構成されていません。 (40012)：指定された翻訳サービスが \[翻訳者構成\] でテキスト翻訳用に構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 不明なエラーが発生しました。(40051):エラーが他のカテゴリに分類されない場合にスローされる既定のエラー。 * テキスト (\[テキスト\] フィールド) が最大長を超えました。(40052)：翻訳のために渡されたテキストが、対応する翻訳サービスでサポートされている最大長を超えています。 * ソース言語が無効です。 (40053)：渡された sourceLanguage パラメーターに、対応する翻訳サービスでサポートされていない言語コードが含まれています。 * ターゲット言語が無効です。 (40054)：targetLanguages パラメーターで渡された 1 つ以上の言語コードが、対応する翻訳サービスでサポートされていません。 * 資格情報がないか無効であるため、要求は許可されません (40055)：\[接続 \& 資格情報\] で翻訳サービス用に構成された認証情報が無効です。接続と資格情報の詳細については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * テキストをターゲット言語に翻訳できません。(40056)：指定された翻訳サービスは、渡されたテキストを指定されたターゲット言語に翻訳できません。 {#DynTran-getTranslation_S_O__ul_ccq_ntm_b3b} |
[表 : 6. 返される内容]

{#DynTran-getTranslation_S_O__table_czb_4zk_thb}  
この例は、 Microsoft の翻訳サービスを使用して、プレーンテキストを、(検出された) 英語からフランス語とイタリア語に翻訳するサーバースクリプトを示しています。

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslation("Translate this text using platform from server", {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{
          "parameterName": "texttype",
          "parameterValue": "plain"
        }],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.info(error.message);
    }

応答：

    {"translations":[
        {
          "targetLanguage":"it",
          "translatedText":"Tradurre questo testo utilizzando la piattaforma dal server"
        },
        {
          "targetLanguage":"fr",
          "translatedText":"Traduire ce texte en utilisant la plate-forme à partir du serveur"
        }
      ],
      "translator":"Microsoft",
      "detectedLanguage":{"code":"en","name":"en"}
    }

この例は、無効なターゲット言語が渡されたときにエラーをスローするサーバースクリプトを示しています。

    try {
        gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslation("Translate this text using platform from server", {
            "targetLanguages": ["123"],
            "additionalParameters": [{
                "parameterName": "texttype",
                "parameterValue": "plain"
            }],
            "translator": "Microsoft"
        })));
    } catch (error) {
        gs.info(error.message);
    }

応答：

    {"code":"40054","message":"Target language is invalid"}

## DynamicTranslation - getTranslations(アレイ texts, オブジェクト parms) {#ariaid-title5}

渡されたテキスト文字列を 1 つ以上の言語に翻訳します。
この方法では、Microsoft Azure Translator サービスや Google Cloud Translator サービスなどの翻訳サービスを使用して翻訳を実行します。翻訳パラメーターを渡さない場合、メソッドはシステムのデフォルトを使用します。
{#DynTran-getTranslations_A_O__table_bzb_4zk_thb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| テキスト | アレイ | 翻訳するテキスト文字列のリストです。 |
| parms | オブジェクト | オプション。追加の translation パラメーターを含む JSON オブジェクトです。 "parms": { "additionalParameters": {Object}, "sourceLanguage": "String", "targetLanguages": [Array], "translator": "String" } |
| parms.additionalParameters | オブジェクト | オプション。JSON オブジェクトのアレイ。各オブジェクトには、翻訳を実行するための追加情報を提供するキーと値のペアが含まれています。 "additionalParameters": { "parameterName": "String", "parameterValue": "String" } |
| parms.additionalParameters.parameterName | 文字列 | オプション。キー名。 有効な値： textype：翻訳するテキストのタイプ。Microsoft Azure Translator サービスの場合のみ。 |
| parms.additionalParameters.parameterValue | 文字列 | オプション。関連付けられたキーの値。 有効な値： * plain：標準的なテキスト文字列 * html：HTML テキスト文字列 {#DynTran-getTranslations_A_O__ul_jk3_hhb_xhb} デフォルト：plain |
| parms.sourceLanguage | 文字列 | オプション。ソーステキストの言語コード。 デフォルト：翻訳サービスがソース言語を検出します。 |
| parms.targetLanguages | アレイ | オプション。テキストの翻訳に使用する言語コードのリスト。このメソッドは、言語コードごとに翻訳されたテキストを返します。 デフォルト：ユーザーの優先言語。 |
| parms.translator | 文字列 | オプション。テキストの翻訳に使用される翻訳サービス (大文字と小文字は区別されません)。 有効な値： * Google * Microsoft * IBM * \<custom\> {#DynTran-getTranslations_A_O__ul_jdd_zbl_thq} 注: カスタム翻訳サービスを使用するには、最初にインスタンスで翻訳サービスを設定する必要があります。詳しくは、 [翻訳サービスプロバイダーとの統合](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)をご覧ください。 デフォルト：翻訳者構成 \[sn_dt_translator_configuration\] テーブルで構成された翻訳サービス。 |
[表 : 7. パラメーター]

{#DynTran-getTranslations_A_O__table_bzb_4zk_thb} {#DynTran-getTranslations_A_O__table_czb_4zk_thb__entry__2}{#DynTran-getTranslations_A_O__status-entry-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage-row-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage_code-row-dynTran}{#DynTran-getTranslations_A_O__detections_detectedLanguage_name-row-dynTran}{#DynTran-getTranslations_A_O__translator-row-dynTran}

| タイプ | 説明 |
|-|-|
| status | メソッド呼び出しへの応答のステータス。 可能な値： * エラー * 部分的 * 成功 {#DynTran-getTranslations_A_O__ul_slc_rmq_nnb} データタイプ：文字列 |
| 翻訳 | 言語翻訳を説明するオブジェクトのアレイ。 データタイプ：アレイ translations": [ { "isError": Boolean; "detectedLanguage": {Object}, "textTranslations": [Array] } ] |
| translations.isError | テキストの翻訳がエラーとなったかどうかを示すフラグです。 有効な値： * true：エラーが発生しました。 * false：テキストの翻訳に成功しました。 {#DynTran-getTranslations_A_O__ul_gf5_zvl_4nb} データタイプ：ブーリアン |
| translations.detectedLanguage | 検出された言語の説明です。 データタイプ：オブジェクト "detectedLanguage": { "code": "String", "name": "String" } |
| translations.detectedLanguage.code | 検出された言語の言語コード。 データタイプ：文字列 |
| translations.detectedLanguage.name | 検出された言語の言語コード。 データタイプ：文字列 |
| textTranlations | オブジェクトのアレイ。テキスト文字列の翻訳に使用される言語の説明。 "textTranslation": { "targetLanguage": "String", "translatedText": "String" } |
| textTranslations.targetLanguage | ソーステキストが翻訳された言語コード。 データタイプ：文字列 |
| textTranslations.translatedText | 翻訳されたテキスト。 データタイプ：文字列 |
| translator | テキストの翻訳に使用される翻訳サービスです。 データタイプ：文字列 |
| エラーメッセージ | メソッドが返す可能性があるエラーメッセージとその根本原因の表示を以下に示します。 * テキスト (\[テキスト\] フィールド) が欠落しているか無効です。 (40000)：翻訳するテキストが欠落しているか、文字列ではありません。 * Dynamic Translation プラグインがインストールされていません。 (40001)： com.glide.dynamic_translation プラグインを有効にせずに Dynamic Translation API が呼び出されました。このプラグインのアクティブ化については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * デフォルトの翻訳者が翻訳用に構成されていません。 (40002)：\[翻訳者構成\] でデフォルトの翻訳サービスとして選択されている翻訳サービスがありません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者 (\[翻訳者\] フィールド) が無効です。 (40003)：渡された translator パラメーターが文字列ではありません。 * \<translator\> 翻訳者が構成されていません。 (40004)：指定された翻訳サービスが \[翻訳者構成\] で構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * \<translator\> 翻訳者が非アクティブです。 (40005)：指定された翻訳サービスが \[翻訳者構成\] で \[アクティブ\] に設定されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 追加のパラメーターが無効です。 (40006)：渡された追加のパラメーターはオブジェクトではありません。 * ターゲット言語 (\[targetLanguages\] フィールド) が無効です。 (40007)：targetLanguages パラメーターが呼び出しで渡されましたが、次のいずれかの理由で有効ではありません。 * 値がアレイではありません * アレイが空です * 1 つまたは複数のエントリが文字列ではありません {#DynTran-getTranslations_A_O__ul_zdj_4b4_b3b} * ソース言語 (\[sourceLanguage\] フィールド) が無効です。 (40008)：sourceLanguage パラメーターが呼び出しで渡されましたが、値が文字列ではありません。 * 最大時間制限を超えました。(40009)：翻訳構成で指定された定義済みのタイムアウト値よりも長い時間が操作にかかりました。 デフォルト：40 秒 * 複数のエラーで要求が失敗しました。 (40010)：言語検出呼び出しで複数のエラーが発生しました。詳細については、個々のテキスト文字列の応答を参照してください。 * \<translator\> 翻訳者が翻訳用に構成されていません。 (40012)：指定された翻訳サービスが \[翻訳者構成\] でテキスト翻訳用に構成されていません。翻訳ツール構成の作成/変更については、「 [翻訳ツール構成の作成](https://www.servicenow.com/docs/access?context=create-custom-translator&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 翻訳者構成バージョンが無効です。v3 に移行してください。 (40014)：指定された翻訳サービスに関連付けられている翻訳者構成のバージョンは、指定されたテキスト翻訳方法をサポートしていません。詳細については、「 [翻訳ツール構成のバージョン v3 への移行](https://www.servicenow.com/docs/access?context=migrate-v3-dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * 不明なエラーが発生しました。(40051):エラーが他のカテゴリに分類されない場合にスローされる既定のエラー。 * テキスト (\[テキスト\] フィールド) が最大長を超えました。(40052)：翻訳のために渡されたテキストが、対応する翻訳サービスでサポートされている最大長を超えています。 * ソース言語が無効です。 (40053)：渡された sourceLanguage パラメーターに、対応する翻訳サービスでサポートされていない言語コードが含まれています。 * ターゲット言語が無効です。 (40054)：targetLanguages パラメーターで渡された 1 つ以上の言語コードが、対応する翻訳サービスでサポートされていません。 * 資格情報がないか無効であるため、要求は許可されません (40055)：\[接続 \& 資格情報\] で翻訳サービス用に構成された認証情報が無効です。接続と資格情報の詳細については、「 [動的翻訳の概要](https://www.servicenow.com/docs/access?context=dynamic-translation&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。 * テキストをターゲット言語に翻訳できません。(40056)：指定された翻訳サービスは、渡されたテキストを指定されたターゲット言語に翻訳できません。 {#DynTran-getTranslations_A_O__ul_ccq_ntm_b3b} |
[表 : 8. 返される内容]

{#DynTran-getTranslations_A_O__table_czb_4zk_thb}  
この例は、Microsoft の翻訳サービスを使用してテキスト文字列のリストをフランス語とイタリア語に翻訳するサーバー側スクリプトのコードを示しています。

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", "Translate second text using platform from server"], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.error(error.message);
    }

応答：

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il primo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        },
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il secondo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le deuxième texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage": {"name":"en", "code":"en"}
        }
      ],
      "translator":"Microsoft",
      "status":"Success"
    }

この例は、渡された 2 つのテキスト文字列のうちの 1 つが無効である場合に Partial というステータスを返すサーバースクリプトを示しています。

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", ""], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": "Microsoft"
      })));
    } catch (error) {
        gs.error(error.message);
    }

応答：

    {
      "translations":[
        {
          "isError":false,
          "textTranslations":[
            {
              "targetLanguage":"it",
              "translatedText":"Traduci il primo testo utilizzando la piattaforma dal server"
            },
            {
              "targetLanguage":"fr",
              "translatedText":"Traduire le premier texte à l'aide de la plate-forme à partir du serveur"
            }
          ],
          "detectedLanguage":{"name":"en", "code":"en"}
        },
        {
          "isError":true,
          "code":"40000",
          "message":"Text is missing or invalid"
        }
      ],
      "translator":"Microsoft",
      "status":"Partial"
    }

この例は、無効な翻訳サービスが渡されたときにエラーをスローするサーバースクリプトを示しています。

    try {
      gs.info(JSON.stringify(sn_dt_api.DynamicTranslation.getTranslations(["Translate first text using platform from server", "Translate second text using platform from server"], {
        "targetLanguages": ["fr", "it"],
        "additionalParameters": [{"parameterName": "texttype", "parameterValue": "plain"}],
        "translator": 123
      })));
    } catch (error) {
        gs.error(error.message);
    }

応答：

    {"code":"40003","message":"Translator (\"translator\" field) is invalid","status":"Error"}

## DynamicTranslation - isEnabled(文字列 translator) {#ariaid-title6}

DynamicTranslation API のさまざまなメソッドを翻訳サービスに対して有効にするかどうかを決定します。
特定の翻訳サービスを渡すと、メソッドはその翻訳サービスのメソッドのアクティブ化をチェックします。それ以外の場合、メソッドはデフォルトの翻訳サービスをチェックします。
{#DynTran-isEnabled_S__table_qx5_nwl_thb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| translator | 文字列 | オプション。メソッドがアクティブかどうかを確認するために使用する翻訳サービス。翻訳サービスは、\[翻訳者構成\] メニューで構成します。 可能な値 - 大文字と小文字を区別しない： * Google * Microsoft * IBM * \<custom\> {#DynTran-isEnabled_S__ul_jdd_zbl_thb} 注: カスタム翻訳サービスを使用するには、最初にインスタンスで翻訳サービスを設定する必要があります。詳しくは、 [翻訳サービスプロバイダーとの統合](https://www.servicenow.com/docs/access?context=integrate-translation-service-provider&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)をご覧ください。 デフォルト：デフォルトの翻訳サービス。 |
[表 : 9. パラメーター]

{#DynTran-isEnabled_S__table_qx5_nwl_thb} {#DynTran-isEnabled_S__table_rx5_nwl_thb__entry__2}

| タイプ | 説明 |
|-|-|
| batchDetection | getDetectedLanguages() メソッドが有効かどうかを示すフラグ。 可能な値： * true：有効 * false：無効 {#DynTran-isEnabled_S__ul_g5j_gqm_4nb} データタイプ：ブール |
| batchTranslation | getTranslations() メソッドが有効かどうかを示すフラグ。 可能な値： * true：有効 * false：無効 {#DynTran-isEnabled_S__ul_i5j_gqm_4nb} データタイプ：ブール |
| detection | getDetectedLanguage() メソッドが有効かどうかを示すフラグ。 可能な値： * true：有効 * false：無効 {#DynTran-isEnabled_S__ul_xtt_dzx_nnb} データタイプ：ブール |
| translation | getTranslation() メソッドが有効かどうかを示すフラグ。 可能な値： * true：有効 * false：無効 {#DynTran-isEnabled_S__ul_ahy_fzx_nnb} データタイプ：ブール |
| エラーメッセージ | API が返す可能性があるエラーメッセージとその根本原因の表示を以下に示します。 * 翻訳者 (\[翻訳者\] フィールド) が無効です。 (40003)：渡された translator パラメーターが文字列ではありません。 {#DynTran-isEnabled_S__ul_wp4_sfm_d3b} |
[表 : 10. 返される内容]

{#DynTran-isEnabled_S__table_rx5_nwl_thb}  
この例は、Microsoft Translator に対して DynamicTranslation メソッドがアクティブであるかどうかをチェックするサーバースクリプトを示しています。

    try {
      var response = sn_dt_api.DynamicTranslation.isEnabled('Microsoft');
      gs.info(JSON.stringify(response));
    } catch(error) {
        gs.info(error.message);
    }

出力:

    {"detection":true,"batchTranslation":true,"batchDetection":true,"translation":true}

この例は、無効な翻訳サービスが渡されたときにエラーをスローするサーバースクリプトを示しています。

    try {
      var response = sn_dt_api.DynamicTranslation.isEnabled(123);
      gs.info(JSON.stringify(response));
    } catch(error) {
        gs.info(error.message);
    }

出力:

    {"code":"40003","message":"Translator (\"translator\" field) is invalid"}