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

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：與世界標準時間 (UTC) 之間的偏移量，以毫秒為單位。
  • commonEventObject.timeZone.id：使用者的時區 ID。例如 America/New_York。
  • commonEventObject.timeZone：使用者的時區 ID 和時差。

詳情請參閱「事件物件」。

當使用者與外掛程式互動時，事件物件會傳遞至動作回呼函式，以及主畫面和內容觸發函式。每個回呼或觸發事件函式都能讀取事件物件的語言代碼和時區資訊，並視需要加以使用。舉例來說，如果回呼函式是前往新資訊卡，則可在決定要新增哪些文字時參照語言代碼字串。