授權存取 Google 使用者資料

驗證功能可確認使用者身分，通常稱為使用者註冊或登入。授權是指授予或拒絕存取資料或資源的程序。舉例來說，您的應用程式會要求使用者同意存取其 Google 雲端硬碟。

驗證和授權呼叫應根據應用程式需求，採用兩個獨立且不同的流程。

注意： Google Identity Services API 的授權支援功能已於 2022 年 2 月宣布。先前您可以在驗證流程中要求存取其他範圍。

如果應用程式具有可使用 Google API 資料的功能，但這並非應用程式核心功能的必要條件，則應設計可在無法存取 API 資料時妥善處理的應用程式。舉例來說，如果使用者未授予雲端硬碟存取權，您可以隱藏最近儲存的檔案清單。

只有在使用者執行需要存取特定 API 的動作時，您才應要求存取 Google API 所需的範圍。舉例來說，當使用者輕觸「儲存至雲端硬碟」按鈕時，您應要求存取使用者雲端硬碟的權限。

將授權與驗證分開，可避免新使用者感到不堪負荷，或對要求提供特定權限的原因感到困惑。

如要進行驗證，建議您使用 Credential Manager API。如要授權需要存取 Google 儲存的使用者資料，建議您使用 AuthorizationClient。

設定 專案

1. 在 中開啟專案，或建立專案 (如果尚未建立)。
2. 在 中，請確認所有資訊都完整且正確。
   1. 請確認應用程式已指派正確的應用程式名稱、應用程式標誌和應用程式首頁。這些值會在使用者註冊時，透過「使用 Google 帳戶登入」同意聲明畫面和「第三方應用程式和服務」畫面向使用者顯示。
   2. 請確認您已指定應用程式的隱私權政策和服務條款網址。
3. 在 中，為應用程式建立 Android 用戶端 ID (如果尚未建立)。您需要指定應用程式的套件名稱和 SHA-1 簽名。
   1. 前往 。
   2. 按一下「Create client」。
   3. 選取「Android」應用程式類型。
4. 在 中，建立新的「網頁應用程式」用戶端 ID (如果尚未建立)。您可以先忽略「Authorized JavaScript Origins」和「Authorized redirect URIs」欄位。當後端伺服器與 Google 驗證服務通訊時，這個用戶端 ID 會用於識別後端伺服器。
   1. 前往 。
   2. 按一下「Create client」。
   3. 選取「網頁應用程式」類型。

宣告依附元件

在模組的 build.gradle 檔案中，使用最新版 Google Identity Services 程式庫宣告依附元件。

dependencies {
  // ... other dependencies

  implementation "com.google.android.gms:play-services-auth:<latest version>"
}

要求使用者操作所需的權限

每當使用者執行需要額外範圍的動作時，請呼叫 AuthorizationClient.authorize()。

舉例來說，如果使用者執行的動作需要存取其雲端硬碟應用程式儲存空間，請執行下列操作：

List<Scopes> requestedScopes = Arrays.asList(DriveScopes.DRIVE_APPDATA);
AuthorizationRequest authorizationRequest = AuthorizationRequest.builder().setRequestedScopes(requestedScopes).build();
Identity.getAuthorizationClient(this)
        .authorize(authorizationRequest)
        .addOnSuccessListener(
            authorizationResult -> {
              if (authorizationResult.hasResolution()) {
                    // Access needs to be granted by the user
                PendingIntent pendingIntent = authorizationResult.getPendingIntent();
                try {
startIntentSenderForResult(pendingIntent.getIntentSender(),
REQUEST_AUTHORIZE, null, 0, 0, 0, null);
                } catch (IntentSender.SendIntentException e) {
                Log.e(TAG, "Couldn't start Authorization UI: " + e.getLocalizedMessage());
                }
              } else {
            // Access already granted, continue with user action
                saveToDriveAppFolder(authorizationResult);
              }
            })
        .addOnFailureListener(e -> Log.e(TAG, "Failed to authorize", e));

您可以在活動的 onActivityResult 回呼中檢查是否已成功取得必要權限，如果已取得，請執行使用者動作。

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == MainActivity.REQUEST_AUTHORIZE) {
    AuthorizationResult authorizationResult = Identity.getAuthorizationClient(this).getAuthorizationResultFromIntent(data);
    saveToDriveAppFolder(authorizationResult);
  }
}

如果您是在伺服器端存取 Google API，可以呼叫 AuthorizationResult 的 getServerAuthCode() 方法，取得驗證碼，然後傳送至後端，以交換存取權和更新權杖。