アプリをローカライズする

Microsoft Teams アプリをローカライズするには、次の要因を考慮してください。

1. AppSource の一覧をローカライズします。
2. アプリ マニフェスト内の文字列をローカライズします。
3. ユーザーからのローカライズされたテキストの送信を処理します。

AppSource の一覧をローカライズする

アプリを Microsoft Teams ストアに発行する場合は、アプリを一覧表示する言語のメタデータ (説明、スクリーンショット、名前) を指定し、パートナー センターの Marketplace 登録情報 ページでこれらの言語を明示的に指定します。 詳細については、「 ローカライズされた Microsoft AppSource フロント」を参照してください。 Teams ストアでローカライズされた登録情報をサポートするには、登録情報に言語を追加できます。 登録情報の パートナー センター で指定する既定の言語情報 アプリの AppSource Web サイト の一覧。 既定の言語は英語です。

ローカライズを構成する

アプリの追加言語を構成するには、 パートナー センターで、英語とアプリの追加言語の両方を選択します。 次の例では、フランス語を追加の言語として使用します。

1. 英語を追加する
   • アプリ名を入力します。
   • アプリの簡単な説明を英語で入力します。
   • アプリの長い説明を英語で入力します。
   • 長い説明に「: このアプリはフランス語で使用できます」と入力します。
   • アプリ UI の画像 (英語) をアップロードします。
2. フランス語の追加
   • アプリ名を入力します。
   • フランス語でアプリの簡単な説明を入力します。
   • フランス語でアプリの長い説明を入力します。
   • アプリ UI の画像 (フランス語) をアップロードします。

英語でアップロードした画像は、AppSource で使用されます。

アプリ マニフェストで文字列をローカライズする

Microsoft Teams アプリ スキーマ v1.5 以降を使用して、アプリをローカライズします。 これを行うには、manifest.json ファイルの $schema 属性を https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.json 以上に設定し、 manifestVersion プロパティを $schema バージョン (この場合は1.5 ) に更新します。

アプリケーションでサポートされている既定の言語で localizationInfo プロパティを追加します。 既定の言語は、ユーザーのクライアント設定が追加の言語と一致しない場合、最終的なフォールバック言語として使用されます。

変更manifest.json例

次のmanifest.jsonは、アプリケーションでサポートされている既定の言語とadditionalLanguagesを使用して、localizationInfo プロパティを追加するのに役立ちます。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
  "manifestVersion": "1.5",
  "localizationInfo": {
  "defaultLanguageTag": "en",
  "additionalLanguages": [
   {
    "languageTag": "es-mx",
    "file": "es-mx.json"
   }
  ]
 }
  ...
}

ローカライズ.json変更の例

ローカライズ .jsonの例を次に示します。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.Localization.schema.json",
  "manifestVersion": "1.5",
  "name.short": "Localización",
  "name.full": "Aplicación de localización",
  ...
}

マニフェスト内のすべてのユーザー向け文字列の翻訳を含む追加の.json ファイルを提供できます。 これらのファイルは 、ローカライズ ファイル JSON スキーマ に準拠している必要があり、マニフェストの localizationInfo プロパティに追加する必要があります。 各ファイルは、Teams や Outlook などの Microsoft 365 ホスト アプリケーションを使用して適切な文字列を選択する言語タグに関連付けられています。 言語タグは <language>-<region> の形式になりますが、 <region> 部分を省略して、目的の言語をサポートするすべてのリージョンをターゲットにすることができます。

Microsoft 365 ホスト アプリケーションは、文字列を次の順序で適用します。既定の言語文字列 -> ユーザーの言語のみ文字列 -> ユーザーの言語 + ユーザーのリージョン文字列。

たとえば、 fr (フランス語、すべてのリージョン) の既定の言語と、 en (英語、すべてのリージョン) と en-gb (英語、英国) の追加言語ファイルを指定すると、ユーザーの言語は en-gbに設定されます。 言語の選択に基づいて、次の変更が行われます。

1. Microsoft 365 ホスト アプリケーションは、 fr 文字列を受け取り、 en 文字列で上書きします。
2. en文字列をen-gb文字列で上書きします。

ユーザーの言語が en-ca に設定されている場合、言語の選択に基づいて次の変更が行われます。

1. Microsoft 365 ホスト アプリケーションは、 fr 文字列を受け取り、 en 文字列で上書きします。
2. en-caローカライズは提供されていないので、enローカライズが使用されます。

ユーザーの言語が es-es に設定されている場合、Microsoft 365 ホスト アプリケーションは fr 文字列を受け取ります。 Microsoft 365 ホスト アプリケーションでは、 es や es-es 翻訳が提供されていないため、どの言語ファイルでも文字列をオーバーライドしません。

そのため、マニフェストで最上位レベルの言語のみの翻訳を指定する必要があります。 たとえば、en-usの代わりにen。 リージョン レベルのオーバーライドは、それらを必要とするいくつかの文字列に対してのみ指定する必要があります。

変更manifest.json例

manifest.jsonの変更を次の例に示します。

{
  ...
  "localizationInfo": {
    "defaultLanguageTag": "en",
    "additionalLanguages": [
      {
        "languageTag": "en-gb",
        "file": "en-gb.json"
      },
      {
        "languageTag": "fr",
        "file": "fr.json"
      },
      {
        "languageTag": "pl",
        "file": "pl.json"
      }
    ]
  }
  ...
}

ローカライズ .json ファイルの例

localization.jsonの変更を次の例に示します。

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.8/MicrosoftTeams.Localization.schema.json",
  "name.short": "Le App",
  "name.full": "App pour Microsoft Teams",
  "description.short": "Créez d'excellentes applications pour Microsoft Teams avec App.",
  "description.full": "Créez de nouvelles applications Microsoft Teams, concevez et prévisualisez des cartes bot, et explorez la documentation avec App.",
  "staticTabs[0].name": "Editeur de manifest",
  "staticTabs[1].name": "Editeur de cartes",
  "staticTabs[2].name": "Bibliothèque de contrôles",
  "bots[0].commandLists[0].commands[0].title": "chercher",
  "bots[0].commandLists[0].commands[0].description": "Rechercher la documentation Teams pertinente"
}

ユーザーからのローカライズされたテキストの送信を処理する

ローカライズされたバージョンのアプリケーションを指定すると、ユーザーは同じ言語で応答します。 Teams ではユーザーの申請が既定の言語に翻訳されないため、アプリはローカライズされた言語の応答を処理する必要があります。 たとえば、ローカライズされた commandListを指定した場合、ボットへの応答は、既定の言語ではなく、コマンドのローカライズされたテキストです。 アプリは適切に応答する必要があります。

コード サンプル

次の手順

関連項目

• パートナー センターの開発者アカウントを作成する
• Teams ストアの申請を準備する
• パートナー センターで Apple App Store Connect Team ID を更新する