驗證和授權機制分別用於驗證身分和資源存取權。本文列出您在應用程式中實作驗證和授權功能前，應瞭解的重要術語。
「驗證」會識別要求提出者。 「授權」會判斷要求者可以存取哪些資源，以及存取層級。授權的先決條件是驗證。您必須先確認要求者的身分，才能判斷要存取哪些資源。如需更詳細的定義，請參閱「重要術語」一節。
請參考以下簡化版飯店預訂範例。抵達飯店時，櫃檯人員會要求您出示身分證件，以驗證預訂資訊。你的 ID 可向飯店驗證身分。櫃台人員會給你房卡。這把鑰匙可讓你使用飯店的特定資源，例如客房、健身房和商務中心。飯店金鑰可授權您存取這些資源。
流程總覽
下圖顯示 Google Workspace API 的驗證和授權步驟概要：
設定 Google Cloud 專案和應用程式：在開發期間，您會在 Google Cloud 控制台中註冊應用程式，定義授權範圍和存取憑證，以便使用 API 金鑰、使用者憑證或服務帳戶憑證驗證應用程式。
驗證應用程式以取得存取權：應用程式執行時，系統會評估已註冊的存取憑證。如果應用程式是以一般使用者身分進行驗證，系統可能會顯示登入提示。
要求資源：當應用程式需要存取 Google 資源時，會使用您先前註冊的相關存取範圍向 Google 提出要求。
要求使用者同意：如果應用程式是以使用者身分進行驗證，Google 會顯示 OAuth 同意畫面，讓使用者決定是否要授予應用程式存取所要求資料的權限。
傳送已核准的資源要求：如果使用者同意存取範圍，應用程式會將憑證和使用者核准的存取範圍，一併封裝到要求中。要求會傳送至 Google 授權伺服器，以取得存取權杖。
Google 會傳回存取權杖：存取權杖包含已授予的存取範圍清單。如果傳回的範圍清單比要求的存取範圍更有限，應用程式會停用權杖限制的任何功能。
存取要求的資源：應用程式會使用 Google 提供的存取權杖，叫用相關 API 並存取資源。
取得更新權杖 (選用)：如果應用程式需要存取 Google API，且存取時間超過單一存取權杖的有效期限，可以取得更新權杖。
要求更多資源：如果需要額外存取權，應用程式會要求使用者授予新的存取權範圍，因此會產生新的存取權杖取得要求 (步驟 3 至 6)。
重要術語
以下列出與驗證和授權相關的術語：
- 驗證
確保主體 (可以是使用者，也可以是代表使用者執行的應用程式) 的身分與聲稱一致。撰寫 Google Workspace 應用程式時，請注意下列驗證類型：
- 使用者驗證
- 使用者向應用程式進行驗證 (登入) 的行為。使用者驗證通常是透過登入程序進行，使用者會使用使用者名稱和密碼組合向應用程式驗證身分。使用者驗證可透過「使用 Google 帳戶登入」功能整合至應用程式。
- 應用程式驗證
- 應用程式代表執行應用程式的使用者，直接向 Google 服務進行驗證。應用程式驗證通常是使用應用程式程式碼中預先建立的憑證進行。
- 授權
主體存取資料或執行作業的權限或「授權」。應用程式會告知使用者應用程式想代表他們執行動作，藉此要求授權。如果使用者允許要求，應用程式會使用專屬憑證向 Google 取得存取權杖。
- 憑證
軟體安全中使用的識別形式。就驗證而言，憑證通常是使用者名稱和密碼的組合。就 Google Workspace API 的授權而言，憑證通常是某種形式的識別資訊，例如只有應用程式開發人員和驗證伺服器知道的專屬密碼字串。Google 支援下列驗證憑證：API 金鑰、OAuth 2.0 用戶端 ID 和服務帳戶。
- API 金鑰
- 用於要求存取公開資料的憑證，例如使用 Maps API 提供的資料。使用「網路上擁有這個連結的任何人」設定共用的公開 Google Workspace 檔案，也能透過這種方式存取，但大多數 Google Workspace 資料都需要 OAuth 2.0。
- OAuth 2 用戶端 ID
- 用於要求存取使用者擁有資料的憑證。這是使用 Google Workspace API 要求存取資料時的主要憑證。這項憑證需要使用者同意聲明。
- 用戶端密鑰
- 一連串字元，只有應用程式和授權伺服器知道。用戶端密鑰只會授予權杖給授權要求者，藉此保護使用者資料。您絕不應在應用程式中加入未加密的用戶端密鑰。建議您安全地儲存用戶端密鑰。詳情請參閱「安全地處理用戶端憑證」。
- 服務帳戶金鑰
- 服務帳戶會使用這項憑證，取得 Google 服務的授權。
- 服務帳戶
- 用於伺服器對伺服器互動的憑證，例如沒有使用者介面的應用程式，這類應用程式會以程序形式執行，以存取資料或執行作業。服務帳戶通常用於存取雲端資料和作業。不過，如果搭配「全網域授權委派」使用，即可存取使用者資料。
- 範圍
OAuth 2.0 URI 字串，用於定義授予應用程式的資源或動作存取層級。以 Google Workspace 來說，授權範圍 URI 包含 Google Workspace 應用程式名稱、存取的資料類型，以及存取層級。應用程式使用者可以查看要求的範圍，並選擇要授予哪些存取權，然後 Google 的驗證伺服器會以存取權杖的形式，將允許的範圍傳回應用程式。詳情請參閱「如何為應用程式選擇範圍」。
- 授權伺服器
Google 的伺服器會使用存取權杖，授予應用程式存取所要求資料和作業的權限。
- 授權碼
授權伺服器傳送的代碼，用於取得存取權杖。只有在應用程式類型為網頁伺服器應用程式或已安裝應用程式時，才需要程式碼。
- 存取權杖
可授予 Google Workspace API 存取權的權杖。單一存取權杖可授予多個 API 不同程度的存取權，也就是所謂的「範圍」。應用程式的授權碼會要求存取權杖，並使用這些權杖叫用 Google Workspace API。
- 資源伺服器
託管應用程式要呼叫的 API 的伺服器。
- OAuth 2.0 架構
應用程式可使用這項標準，為使用者提供「安全委派存取權」，或代表使用者存取資料及執行作業。應用程式中使用的驗證和授權機制，代表您實作的 OAuth 2.0 架構。
- 原理
可以取得資源存取權的實體，也稱為「身分」。Google Workspace API 支援兩種主體：使用者帳戶和服務帳戶。詳情請參閱「主體」。
- 資料類型
在驗證和授權的脈絡中，資料類型是指擁有應用程式嘗試存取資料的實體。資料類型有三種：
- 公有領域資料
- 任何人都能存取的資料，例如部分 Google 地圖資料。這類資料通常是透過 API 金鑰存取。
- 使用者資料
- 特定使用者或群組的資料，例如特定使用者的 Google 雲端硬碟檔案。通常會使用 OAuth 2 用戶端 ID 或服務帳戶存取這類資料。
- 雲端資料
- Google Cloud 專案擁有的資料。服務帳戶通常會存取這類資料。
- 使用者同意聲明
授權步驟：要求應用程式使用者授權應用程式存取資料，並代表使用者執行作業。
- 應用程式類型
您要建立的應用程式類型。使用 Google Cloud 控制台建立憑證時，系統會要求您選取應用程式類型。應用程式類型包括：網頁應用程式 (JavaScript)、Android、Chrome 應用程式、iOS、電視和有限輸入裝置、電腦應用程式 (也稱為「已安裝的應用程式」)，以及通用 Windows 平台 (UWP)。
- 服務帳戶
這類 Google 帳戶是專為非人類使用者設計，需要通過驗證並取得授權，才能存取資料。您的應用程式以服務帳戶的身分呼叫 Google API，如此一來使用者即不會直接參與其中。服務帳戶本身無法用於存取通常透過 Google Workspace API 存取的使用者資料。不過，服務帳戶可以透過實作全網域授權委派，存取使用者資料。詳情請參閱「瞭解服務帳戶」。
- 全網域授權委派
這項管理功能可授權應用程式，代表 Google Workspace 機構中的使用者存取使用者資料。全網域委派功能可用於對使用者資料執行管理員相關工作。 如要以這種方式委派授權，Google Workspace 管理員必須使用 OAuth 2.0 服務帳戶。由於這項功能權限較大，只有超級管理員可以啟用全網域授權委派。詳情請參閱「將網域層級的權限委派給服務帳戶」。
下一步
設定應用程式的 OAuth 同意畫面，確保使用者瞭解並同意應用程式存取其資料的權限。