取得使用者語言代碼和時區

Google Workspace 外掛程式可以存取使用者的語言代碼和時區，並使用 以便自訂介面和行為您必須設定 外掛程式的資訊清單 允許外掛程式存取 這些資訊

設定外掛程式資訊清單

您可以設定外掛程式，存取使用者語言代碼和 時區資訊 步驟如下：

  1. 外掛程式的資訊清單 檔案，請將 addOns.common.useLocaleFromApp 新增至 true。
  2. 如果找不到下列明確範圍，請在 資訊清單的 oauthScopes 清單： https://www.googleapis.com/auth/script.locale

如果您在外掛程式的 oauthScope 清單中加入了範圍， 使用者必須重新授權 外掛程式 每次開啟時都會傳送回合

取得語言代碼和時區資訊

事件物件 正確設定後，即會處理使用者的語言代碼資訊。下列欄位 出現在commonEventObject中 事件物件的子結構：

  • commonEventObject.userLocale：使用者的語言和國家/地區 或 ID。例如 en-US。
  • commonEventObject.timeZone.offset：使用者的時區偏移，以 毫秒 (自世界標準時間)。
  • commonEventObject.timeZone.id：使用者的時區 ID。 例如 America/New_York。
  • commonEventObject.timeZone：使用者的時區 ID 和偏移。

請參閱事件物件 ，掌握更多詳細資訊。

事件物件會傳送至 動作回呼函式 以及使用者與外掛程式互動及首頁的互動情形 比對內容 觸發函式每個回呼或觸發條件函式都能讀取 事件物件的語言代碼和時區資訊，並視需要使用。 例如，回呼函式 可以參考語言代碼字串，決定要在資訊卡中新增哪些文字。