本文包含 Gmail API 專屬的授權和驗證資訊。閱讀本文前，請務必先參閱「瞭解驗證和授權」，瞭解 Google Workspace 的一般驗證和授權資訊。
設定 OAuth 2.0 授權
設定 OAuth 同意畫面並選擇範圍，定義要向使用者和應用程式審查人員顯示的資訊，然後註冊應用程式，以便日後發布。
Gmail API 範圍
如要定義授予應用程式的存取層級，您需要識別並宣告授權範圍。授權範圍是 OAuth 2.0 URI 字串，其中包含 Google Workspace 應用程式名稱、存取資料類型和存取層級。「範圍」是指應用程式要求處理 Google Workspace 資料，包括使用者 Google 帳戶資料。
安裝應用程式時，系統會要求使用者驗證應用程式使用的範圍。一般來說，您應盡可能選擇範圍最窄的範圍，並避免要求應用程式不需要的範圍。使用者更願意授予存取權給範圍有限且說明清楚的應用程式。
Gmail API 支援下列範圍：
| 範圍代碼 | 說明 | 用量 |
|---|---|---|
https://www.googleapis.com/auth/gmail.addons.current.action.compose |
在你使用外掛程式時管理草稿及傳送電子郵件。 | 非機密 |
https://www.googleapis.com/auth/gmail.addons.current.message.action |
在您使用外掛程式時查看您的電子郵件。 | 非機密 |
https://www.googleapis.com/auth/gmail.addons.current.message.metadata |
在外掛程式執行時，查看電子郵件中繼資料。 | 敏感內容 |
https://www.googleapis.com/auth/gmail.addons.current.message.readonly |
在外掛程式執行期間查看你的電子郵件。 | 敏感內容 |
https://www.googleapis.com/auth/gmail.labels |
只能建立、讀取、更新及刪除標籤。 | 非機密 |
https://www.googleapis.com/auth/gmail.send |
僅傳送訊息。沒有信箱的讀取或修改權限。 | 敏感內容 |
https://www.googleapis.com/auth/gmail.readonly |
讀取所有資源及其中繼資料，但無法執行寫入作業。 | 受限制 |
https://www.googleapis.com/auth/gmail.compose |
建立、讀取、更新及刪除草稿。傳送訊息和草稿。 | 受限制 |
https://www.googleapis.com/auth/gmail.insert |
僅插入及匯入訊息。 | 受限制 |
https://www.googleapis.com/auth/gmail.modify |
所有讀取/寫入作業，但不能立即永久刪除討論串和郵件，略過「垃圾桶」。 | 受限制 |
https://www.googleapis.com/auth/gmail.metadata |
讀取資源中繼資料，包括標籤、記錄和電子郵件標頭，但不包括郵件內文或附件。 | 受限制 |
https://www.googleapis.com/auth/gmail.settings.basic |
管理基本郵件設定。 | 受限制 |
https://www.googleapis.com/auth/gmail.settings.sharing |
管理機密郵件設定，包括轉寄規則和別名。
注意：受這個範圍保護的作業僅限管理用途。只有使用全網域委派服務帳戶的 Google Workspace 客戶，才能使用這項功能。 |
受限制 |
https://mail.google.com/ |
完全存取帳戶的信箱，包括永久刪除郵件串和郵件。只有在應用程式需要立即永久刪除郵件串和郵件 (略過「垃圾桶」) 時，才應要求這項範圍；所有其他動作都可以使用限制較少的範圍執行。 | 受限制 |
上表中的「使用量」欄會根據下列定義，指出每個範圍的敏感度：
非機密：這類範圍提供的授權存取權範圍最小，只需要基本應用程式驗證。如要瞭解這項規定，請參閱「準備驗證的步驟」。
機密：這些範圍允許存取 Google 使用者資料，且必須通過機密範圍驗證程序。如要瞭解這項規定，請參閱《Google API 服務：使用者資料政策》。這些範圍不需要安全評估。
受限制：這些範圍提供廣泛的 Google 使用者資料存取權，您必須通過受限制範圍驗證程序。如要瞭解這項規定，請參閱「Google API 服務：使用者資料政策」和「特定 API 範圍附加規定」。如果您在伺服器上儲存 (或傳輸) 受限制範圍的資料，就必須接受安全性評估。
如要進一步瞭解您要求存取使用者資料時，使用及存取 Gmail API 的相關規定，請參閱 Gmail API 服務使用者資料和開發人員政策。
如果應用程式需要存取任何其他 Google API，您也可以新增這些範圍。如要進一步瞭解 Google API 範圍，請參閱「使用 OAuth 2.0 存取 Google API」。
OAuth 驗證
使用某些敏感的 OAuth 範圍時，應用程式可能需要通過 Google 的 OAuth 驗證程序。請參閱 OAuth 驗證常見問題，瞭解應用程式何時應通過驗證，以及需要哪種驗證。另請參閱《Google API 服務：使用者資料政策》。