ロケールの解決

リクエストされた言語、地域、文字体系に適用される保存済み設定と、指示、ボイス、モデル、用語での設定の使われ方を解説します。

リクエストには、そのロケール自体、そのロケールを含むより広いロケール、および*に保存された設定が使われます。より限定的なロケールや、同じ言語の別の地域に保存された設定は適用されません。適用対象となる設定の扱いは、リソースによって異なります。指示は積み重ねて適用され、ボイスは一つのバリエーションが選ばれ、モデルは順番に試行されます。また、カスタム翻訳には、リクエストと同じ文字体系を使う必要があります。

言語タグの選び方については、言語をご覧ください。このリファレンスでは、タグがローカライゼーションエンジンに渡された後の動作を説明します。

どの設定が適用されるか #

ロケールの処理では、CLDRのデータに基づき、同等の表記を同じロケールとして扱います。zh、zh-CN、zh-Hans、zh-Hans-CNは、いずれも中国で使われる簡体字中国語を表します。地域を指定しないロケールは、そのロケールの既定の地域を表します。esへのリクエストは、スペインで使われるスペイン語(es-ES)へのリクエストです。ptはpt-BRを、deはde-DEを表します。

設定のロケールが次のいずれかに該当する場合、その設定がリクエストに適用されます。

  • すべてのロケールに適用される*。
  • リクエストされたロケール。同等の表記も含みます。
  • リクエストされたロケールを含む、より広いロケール。deはde-CHに、zh-Hantはzh-TWに適用されます。

それ以外のロケールは対象外です。たとえば、deへのリクエストに対するde-CHのような、より限定的な地域や、de-CHへのリクエストに対するde-DEのような、同じ言語の別の地域は対象になりません。

リクエスト適用対象適用対象外
es*、es、es-ESes-MX、es-419
es-MX*、es、es-MXes-ES、es-419
de-CH*、de、de-CHde-DE、de-AT
zh-TW*、zh、zh-Hant、zh-TWzh-Hans、zh-CN
sr*、sr、sr-Cyrlsr-Latn

es-419のような地域グループは、それ自体が独立したロケールです。es-419へのリクエストにのみ適用され、es-MXやes-ARへのリクエストには適用されません。

ソースロケールを持つリソース、つまりモデル設定と用語集の用語では、ソースロケールにも同じルールが適用されます。ソースをen-GBとして保存した用語は、ソースロケールがenのコンテンツには適用されません。enはen-USを表すためです。

ある言語のすべての地域で指針を共有するには、esのように地域を付けず、言語だけを指定して保存してください。地域を指定して保存するのは、その地域の利用者だけを対象とする場合に限ります。

一致階層で適用対象の設定を順序付ける #

ローカライゼーションエンジンは、適用対象の設定を一致階層ごとに並べます。最初はリクエストされたロケール、次はより広いロケール、最後は*です。同じ階層内では、より具体的な表記が優先されます。そのため、deへのリクエストでは、de-DEのバリエーションがdeのバリエーションより上位になります。

地域が要件に含まれる場合は、その地域を明示したロケールを使ってください。また、異なる言語識別子は明確に区別してください。noとnbは別のコードであり、一方に保存した設定は他方には適用されません。

設定の使われ方はリソースごとに異なる #

リソース結果
ルール適用対象となる定義済みの指示とカスタム指示が、ロケールとの関連度順に積み重ねて適用されます。具体的なルールによって、広い範囲のルールが無効になることはありません。
ブランドボイス最もよく一致するバリエーションが選ばれます。それでも同順位の場合は、作成日時、次にIDによって選択結果が一定に保たれます。
モデルターゲットの一致階層、ソースの一致階層、ターゲットの具体性、ソースの具体性、設定された順位によって試行順が決まります。
用語集文字体系が異なるカスタム翻訳は除外されます。残った候補はロケールに基づいて順位付けされ、ソーステキストを基準に重複が取り除かれます。その後、検索によって該当するコンテキストが選ばれます。
人によるレビューレビューポリシーに指定された言語のいずれかがリクエストに適用される場合、またはポリシーに言語の指定がない場合に、リクエストがレビューされます。

モデルの順位を変更しても、ワイルドカード設定を、ロケールがより近く一致する設定より優先することはできません。また、用語集を関連付けた順序で優先順位が決まるわけではありません。必要な内容が設定に保存されているのに、リクエストで別の内容が選ばれる場合は、こうした違いを確認してください。

地域や文字体系の不一致を調べる #

ある地域に保存した指針が別の地域に適用されない #

用語集のスペイン語の用語がes-419に保存され、リクエストのターゲットがesまたはes-MXだとします。どちらのリクエストにも、その用語は適用されません。esはスペインを表し、es-419はes-419へのリクエストにのみ適用されるためです。スペイン語を使うすべての利用者に共通する用語はesに保存するか、リクエストする地域ごとに保存してください。ポルトガル語も同様です。ptはブラジルを表すため、pt-PTに保存した用語はpt-PTへのリクエストにのみ適用されます。

ボイスには地域が指定され、リクエストには言語だけが指定されている #

ボイスにde-DEとde-CHのバリエーションがあり、リクエストのターゲットがdeだとします。このリクエストにはde-DEのバリエーションが適用されます。deはドイツで使われるドイツ語を表すためです。de-CHのバリエーションは、de-CHへのリクエストにのみ適用されます。スイス向けのコンテンツでは、ローカライゼーションエンジンによるソースからの対象読者の推測に頼らず、de-CHをリクエストしてください。

地域固有のルールが広い範囲のルールと矛盾する #

丁寧な呼びかけを求めるワイルドカードのルールと、くだけた呼びかけを求める適用対象の地域ルールは、どちらもプロンプトに含まれることがあります。より具体的なルールを追加しても、広い範囲の要件が取り消されるわけではありません。矛盾を取り除くか適用範囲を絞り、選ばれる指示が意図した一つの動作を示すようにしてください。

優先する用語の文字体系が異なる #

カスタム翻訳は、ソースとターゲットの両方で、ロケールが示す文字体系がリクエストの文字体系と一致する場合にのみ適用されます。各ロケールの文字体系は、CLDRの既定値によって決まります。zh、zh-CN、zh-SGは簡体字、zh-TWとzh-HKは繁体字、srはキリル文字、sr-MEはラテン文字を示します。

そのため、zhに保存した用語は、zh、zh-CN、zh-SGへのリクエストには適用されますが、zh-TWへのリクエストには適用されません。zhに保存したルールやボイスがzh-TWに適用される場合でも、用語は別です。zh-Hansに保存した用語はzhへのリクエストに、zh-TWに保存した用語はzh-Hantへのリクエストに適用されます。台湾と香港で共通して使う繁体字の用語は、zh-Hantに保存してください。翻訳しない名前は表記が変わらないため、この制約の対象外です。

カスタム翻訳のターゲットがすべての言語になっている #

ターゲットが*のカスタム翻訳には、ソースと異なるターゲットテキストを指定できません。優先する翻訳には具体的なターゲットロケールを指定し、どこでも同じ表記を保つ必要があるテキストは、翻訳しないエントリとして登録してください。

ロケールを追加するときは各要素を確認する #

言語設定だけでは、右から左へのレイアウトや、ロケールに応じたアプリケーションの書式設定は実装されません。翻訳とあわせて、実際に表示された画面も確認してください。サンプルで確認できるのは、その事例での動作であり、追加したロケール全体の品質ではありません。