ユーザーの言語 / 地域とタイムゾーンを取得する

Google Workspace アドオンは、ユーザーのロケールとタイムゾーンにアクセスし、その情報を使用してインターフェースと動作をカスタマイズできます。アドオンがこの情報にアクセスできるように、アドオンのマニフェストを構成する必要があります。

アドオン マニフェストを構成する

ユーザーのロケールとタイムゾーン情報にアクセスするようにアドオンを構成する手順は次のとおりです。

1. アドオンのマニフェスト ファイルで、addOns.common.useLocaleFromApp フィールドを true に設定します。
2. まだ存在しない場合は、マニフェストの oauthScopes リストに次の明示的なスコープを追加します。 https://www.googleapis.com/auth/script.locale

アドオンの oauthScope リストにスコープを追加した場合、ユーザーは次回アドオンを開くときにアドオンを再承認する必要があります。

注: アドオンで以前に Calendar API、Apps Script の カレンダー サービス、またはユーザーの言語 / 地域とタイムゾーンにアクセスする他のサービスを使用していた場合は、そのサービスがアドオンでまだ必要かどうかを検討してください。含まれていない場合は、サービスに必要なスコープをマニフェストから削除します。スコープ リストは、アドオンに必要なサービスにのみ制限してください。

言語 / 地域とタイムゾーン情報を取得する

イベント オブジェクトには、適切に構成されている場合にユーザーの言語 / 地域情報が含まれます。イベント オブジェクトの commonEventObject サブストラクチャには、次のフィールドが表示されます。

• commonEventObject.userLocale - ユーザーの言語と国/地域の ID。例: en-US
• commonEventObject.timeZone.offset - 協定世界時（UTC）からのユーザーのタイムゾーン オフセット（ミリ秒単位）。
• commonEventObject.timeZone.id - ユーザーのタイムゾーン ID。例: America/New_York
• commonEventObject.timeZone - ユーザーのタイムゾーン ID とオフセット。

詳しくは、イベント オブジェクトをご覧ください。

イベント オブジェクトは、ユーザーがアドオンを操作すると、アクション コールバック関数に渡され、ホームページとコンテキスト トリガー関数に渡されます。各コールバック関数またはトリガー関数は、イベント オブジェクトから言語 / 地域とタイムゾーン情報を読み取り、必要に応じて使用できます。たとえば、新しいカードに移動するコールバック関数は、カードに追加するテキストを決定するときにロケール文字列を参照できます。