本文說明 Google Docs API 專屬的授權和驗證資訊。閱讀本文前，請務必參閱「瞭解驗證和授權」一文，瞭解 Google Workspace 的一般驗證和授權資訊。
設定 OAuth 2.0 授權
設定 OAuth 同意畫面並選擇範圍，即可定義要向使用者和應用程式審查人員顯示哪些資訊，並註冊應用程式，以便日後發布。
Docs API 範圍
如要定義授予應用程式的存取權層級，您必須識別並宣告授權範圍。授權範圍是 OAuth 2.0 URI 字串，其中包含 Google Workspace 應用程式名稱、應用程式存取的資料類型，以及存取層級。「範圍」是指應用程式為了處理 Google Workspace 資料而提出的要求，包括使用者的 Google 帳戶資料。
應用程式安裝時，系統會要求使用者驗證應用程式使用的範圍。一般而言，您應選擇最精確的範圍，避免要求應用程式不需要的範圍。使用者更願意授予明確說明的有限範圍存取權。
如果可以，建議您使用非機密範圍，因為此範圍會授予每個檔案的存取權範圍，並縮小應用程式所需的特定功能的存取權。
Docs API 支援下列範圍：
| 範圍代碼 | 說明 | 用量 |
|---|---|---|
https://www.googleapis.com/auth/documents |
查看、編輯、建立及刪除您的所有 Google 文件檔案。 | 敏感內容 |
https://www.googleapis.com/auth/documents.readonly |
查看您所有的 Google 文件。 | 敏感內容 |
https://www.googleapis.com/auth/drive.file |
查看、編輯、建立及刪除您透過這個應用程式使用的特定 Google 雲端硬碟檔案。 | 建議 非敏感 |
https://www.googleapis.com/auth/drive |
查看、編輯、建立及刪除您的所有 Google 雲端硬碟檔案。 | 受限制 |
https://www.googleapis.com/auth/drive.readonly |
查看及下載 Google 雲端硬碟中的所有檔案。 | 受限制 |
表格中的「Usage」欄會根據下列定義，指出每個範圍的機密程度：
非敏感資料：這些範圍提供最小授權存取範圍，且只需要基本應用程式驗證。如要瞭解這項規定，請參閱「提交應用程式以供驗證」。
機密：這些範圍可提供存取特定 Google 使用者資料的權限，這些資料是使用者授權給您的應用程式。您必須進行額外的應用程式驗證。如要瞭解這項規定，請參閱「敏感和受限制的範圍規定」。
受限制：這些範圍可廣泛存取 Google 使用者資料，且需要您完成受限制範圍驗證程序。如需這項規定的相關資訊，請參閱「Google API 服務使用者資料政策」和「特定 API 範圍附加規定」。如果您將受限制的範圍資料儲存在伺服器上 (或傳輸)，就必須進行安全性評估。
如果應用程式需要存取其他 Google API，您也可以新增這些範圍。如要進一步瞭解 Google API 範圍，請參閱「使用 OAuth 2.0 存取 Google API」。
如要進一步瞭解特定 OAuth 2.0 範圍，請參閱 Google API 適用的 OAuth 2.0 範圍。