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

Google Workspace アドオンは、ユーザーの言語 / 地域とタイムゾーンにアクセスし、 インターフェースと動作をカスタマイズできます。構成する必要があります アドオンのマニフェスト アプリケーションにアクセスできるよう、 確認できます。

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

ユーザーの言語 / 地域と言語にアクセスできるようアドオンを設定できます。 タイムゾーン情報 手順は次のとおりです。

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

アドオンの oauthScope リストにスコープを追加した場合、 再度認証する必要があります。 アドオン 次回開いたときに有効になります

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

イベント オブジェクト ユーザーの言語 / 地域情報を伝える。次のフィールド commonEventObjectに表示されます。 サブ構造体です:

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

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

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