本文包含 Google Slides API 專屬的授權和驗證資訊。閱讀本文前,請務必先參閱「瞭解驗證和授權」,瞭解 Google Workspace 的一般驗證和授權資訊。
設定 OAuth 2.0 授權
設定 OAuth 同意���面���選擇範圍,���義向使用者和應用程式審查人員顯示的資訊,然後註冊應用程式,以便日後發布。
Slides API 範圍
如要定義授予應用程式的存取層級,您需要識別並宣告授權範圍。授權範圍是 OAuth 2.0 URI 字串,其中包含 Google Workspace 應用程式名稱、存取的資料類型和存取層級。「範圍」是指應用程式要求存取 Google Workspace 資料,包括使用者 Google 帳戶資料。
安裝應用程式時,系統會要求使用者驗證應用程式使用的範圍。一般來說,您應盡可能選擇範圍最窄的範圍,並避免要求應用程式不需要的範圍。使用者更願意授予存取權給範圍有限且說明清楚的項目。
建議盡可能使用非機密範圍,因為這會授予每個檔案的存取權範圍,並將存取權限縮小至應用程式所需的特定功能。
Slides API 支援下列範圍:
| 範圍代碼 | 說明 | 用量 |
|---|---|---|
https://www.googleapis.com/auth/presentations |
查看、編輯、建立及刪除您的所有 Google 簡報檔案。 | 敏感內容 |
https://www.googleapis.com/auth/presentations.readonly |
查看您的所有 Google 簡報檔案。 | 敏感內容 |
https://www.googleapis.com/auth/spreadsheets |
查看、編輯、建立及刪除您的所有 Google 試算表檔案。 | 敏感內容 |
https://www.googleapis.com/auth/spreadsheets.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 雲端硬碟中的所有檔案。 | 受限制 |
表格中的「用途」欄會根據下列定義,指出每個範圍的敏感程度:
非敏感:這類範圍提供的授權存取範圍最小,且僅需基本應用程式驗證。如要瞭解這項規定,請參閱「提交應用程式以供驗證」。
機密:這些範圍可讓應用程式存取使用者授權的特定 Google 使用者資料,但您必須通過額外的應用程式驗證。如要瞭解這項規定,請參閱「敏感和受限範圍規定」。
受限制:這些範圍提供 Google 使用者資料的廣泛存取權,因此您必須通過受限制範圍驗證程序。如要瞭解這項規定,請參閱《Google API 服務使用者資料政策》和《特定 API 範圍附加規定》。如果您在伺服器上儲存 (或傳輸) 受限制範圍的資料,就必須接受安全性評估。
如果應用程式需要存取任何其他 Google API,也可以新增這些範圍。如要進一步瞭解 Google API 範圍,請參閱「使用 OAuth 2.0 存取 Google API」。
如要進一步瞭解特定 OAuth 2.0 範圍,請參閱「Google API 適用的 OAuth 2.0 範圍」。