取得使用者語言代碼和時區
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Google Workspace 外掛程式可以存取使用者的語言代碼和時區,並使用
以便自訂介面和行為您必須設定
外掛程式的資訊清單
允許外掛程式存取
這些資訊
您可以設定外掛程式,存取使用者語言代碼和
時區資訊
步驟如下:
- 外掛程式的資訊清單
檔案,請將
addOns.common.useLocaleFromApp
新增至 true
。
- 如果找不到下列明確範圍,請在
資訊清單的
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 和偏移。
請參閱事件物件
,掌握更多詳細資訊。
事件物件會傳送至
動作回呼函式
以及使用者與外掛程式互動及首頁的互動情形
比對內容
觸發函式每個回呼或觸發條件函式都能讀取
事件物件的語言代碼和時區資訊,並視需要使用。
例如,回呼函式
可以參考語言代碼字串,決定要在資訊卡中新增哪些文字。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-02 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-02 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-02 (世界標準時間)。"]]