ローカライズとローカライズ

ユーザーはさまざまな地域の、さまざまな言語でやり取りしています。ユーザーのコミュニケーション設定に応答し、そのエクスペリエンスをローカライズするエージェントは、応答しないエージェントよりも多くのユーザーにリーチして、より充実したユーザー エクスペリエンスを作成し、繰り返しのやり取りを増やすことができます。ビジネス メッセージを使用すると、ユーザー ロケール設定をエージェントに渡し、エージェントがデフォルトのロケールとロケールごとの一意の会話設定を指定して、ユーザーのロケールとエージェントまたはロケーションがサポートしているロケールとの一致を解決することにより、エージェントとロケーションがユーザーの設定に対応できるようになります。

ビジネス メッセージ エージェントは、ロケールを検出することで、ユーザーの地域と言語の自動設定を認識し、自動かつライブでやり取りすることにより、エクスペリエンスをローカライズできます。

ユーザーの言語 / 地域

ユーザーがエージェントとの会話を開始すると、ユーザーがメッセージを送信するたびに、ビジネス メッセージがユーザーのデバイスのロケール設定を検出します。エージェントが受け取るメッセージごとに、context.userInfo.userDeviceLocale フィールドにユーザーの言語 / 地域が含まれます。

ビジネス メッセージでは、ユーザー デバイスの言語 / 地域を使用して、ユーザー インターフェースの言語と、プラットフォームによって生成された文字列の言語を変更します。

userDeviceLocale は、ユーザーがデバイスの言語を変更した場合や、ロケール設定が異なるデバイスを切り替えた場合、会話内で変更できます。userDeviceLocale を読み取る場合、エージェントは新しいメッセージごとに値が変更されたかどうかを確認し、値が変化している場合はそれに適応する必要があります。たとえば、エージェントは言語 / 地域の変更を検出し、現在の言語でのコミュニケーションを続けるか、新しい言語 / 地域に一致する言語に切り替えるかをユーザーに尋ねることができます。

userDeviceLocale はユーザーのデバイスによって指定され、任意の IETF BCP 47 言語タグを指定できます。

エージェントとロケール

エージェントとロケーションは、サポートする言語 / 地域ごとに会話設定を指定できます。たとえば、エージェントが「en」ロケールでウェルカム メッセージを英語に指定し、「es」ロケールでスペイン語で同じメッセージを指定している場合や、別のロケーションで「fr」ロケールで設定を指定している場合があります。

エージェントまたはロケーションにロケールの会話設定が設定されている場合、ビジネス メッセージは、エージェントまたはロケーションがそのロケールをサポートしていることを前提としています。エージェントとロケーションは、通常通信するデフォルトのロケール（defaultLocale）を設定できます。

エージェントまたはロケーションのデフォルトのロケールを更新するには、デフォルトのロケールを更新するをご覧ください。ロケールの会話設定を設定するには、会話を開始するをご覧ください。

解決された言語 / 地域

ユーザー デバイスの言語 / 地域を識別し、その言語 / 地域を、エージェントまたはユーザーが指定した言語 / 地域と比較することで、ビジネス メッセージはユーザーとエージェントの言語 / 地域間の一致を解決できます。ビジネス メッセージによって一致が解決されると、エージェントまたは場所の defaultLocale は、サポートされている他のロケールよりも優先されます。エージェントが受け取るメッセージごとに、この一致が context.resolvedLocale フィールドに含まれます。

ビジネス メッセージでは、解決されたロケールを使用して、表示する会話設定（ウェルカム メッセージやオフライン メッセージなど）と文字列（Live Agent Request Suggestion 文字列など）を選択します。一貫したユーザー エクスペリエンスを維持するため、エージェントは解決されたロケールで通信することをおすすめします。

ユーザーがデバイスの言語を変更したり、ロケール設定が異なるデバイスを切り替えたりした場合、解決されたロケールは会話内で変更されることがあります。エージェントは、新しいメッセージごとに値が変更されたかどうかを確認し、値が変化している場合はそれに適応する必要があります。たとえば、エージェントはロケールの変更を検出して、現在の言語でのコミュニケーションを続けるか、新しいロケールに一致する言語に切り替えるかをユーザーに尋ねることができます。

デフォルトの言語 / 地域を更新する

デフォルトの言語 / 地域を指定するには、Business Communications API を使用して PATCH リクエストを作成し、エージェントまたはビジネス情報の defaultLocale フィールドを更新します。

ロケールのエージェントまたはロケーションの会話設定（ウェルカム メッセージや会話の開始条件など）を更新するには、会話を開始するをご覧ください。

Prerequisites

デフォルトのロケールを更新する前に、次のアイテムが必要です。

更新リクエストを送信する

エージェントまたはロケーションを更新するには、次のコマンドを実行します。変数は、前提条件で特定した値に置き換えます。

エージェントのデフォルトの言語 / 地域


# This code sets the default locale of a Business Messages agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__, __AGENT_ID__ and __DEFAULT_LOCALE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "defaultLocale": "__DEFAULT_LOCALE__"
  }
}'
update-agent-bm-defaultLocale.sh

形式と値のオプションについては、BusinessMessagesAgent をご覧ください。

ロケーションのデフォルトの言語 / 地域


# This code updates the default locale of an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/patch

# Replace the __BRAND_ID__ and __LOCATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__?updateMask=defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "defaultLocale": "en"
}'
update-location-bm-defaultLocale.sh

形式と値のオプションについては、brands.locations をご覧ください。