選擇 Google 簡報 API 範圍

本文包含 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 範圍」。