本文件包含經銷商 API 專屬授權和驗證資訊。閱讀本文件前,請務必參閱「瞭解驗證和授權」一文,瞭解 Google Workspace 的一般驗證和授權資訊。
設定授權所需的 OAuth 2.0
設定 OAuth 同意畫面並選擇範圍,定義要向使用者顯示的資訊及應用程式審查者,並註冊應用程式以供日後發布。
經銷商 API 範圍
如要定義授予應用程式的存取權層級,您必須識別並宣告授權範圍。授權範圍是 OAuth 2.0 URI 字串,包含 Google Workspace 應用程式名稱、應用程式存取的資料類型,以及存取層級。「範圍」是應用程式要求處理 Google Workspace 資料的要求,包括使用者的 Google 帳戶資料。
應用程式安裝完畢後,系統會要求使用者驗證應用程式使用的範圍。一般而言,您應選擇盡可能縮小的範圍,並避免要求應用程式不需要的範圍。使用者能夠更順利地授予描述過明確、有限範圍的存取權。
經銷商 API 支援下列範圍:
範圍 | 意義 |
---|---|
https://www.googleapis.com/auth/apps.order |
存取所有經銷商 API 作業的全域範圍。 |
https://www.googleapis.com/auth/admin.directory.user |
存取所有使用者和使用者別名作業的全域範圍。 |
https://www.googleapis.com/auth/siteverification |
具備全域範圍對現有已驗證網站的完整讀取權限以及驗證新網站的能力。 |