Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用 Cloud OAuth API 擷取企業群組

本指南說明如何使用 Cloud OAuth API (cloudoauth.googleapis.com) 中的 /groups 端點，擷取已驗證員工使用者的企業群組成員資格。

/groups 端點可做為 OpenID Connect (OIDC) 整合的分散式宣告端點，為啟用 SCIM 和非 SCIM 的員工身分集區中的使用者，傳回分頁的企業群組成員資格。

事前準備

設定員工身分集區和提供者。詳情請參閱「設定員工身分聯盟」。
註冊 OAuth 用戶端，並將授權碼換成存取權杖。詳情請參閱「使用 Cloud OAuth API 交換權杖」。
啟用 Cloud OAuth API (如果尚未啟用)。
啟用 API 所需的角色
您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。
啟用 API

擷取企業群組

如要擷取已驗證使用者的群組成員資格，請將 HTTP GET 要求傳送至 /groups 端點：

Cloud OAuth API 的 common.groups 方法會擷取已驗證使用者的企業群組成員資格。

使用任何要求資料之前，請先修改下列項目的值：

TOKEN：從權杖交換端點取得的短期 OAuth 2.0 存取權杖。
PAGE_SIZE：選用。每頁傳回的群組數量上限 (介於 2500 到 5000 之間)。
PAGE_TOKEN：選用。從 next_page_token 欄位中先前 /groups 回應收到的分頁權杖。

HTTP 方法和網址：

GET https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer TOKEN" \
     "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN"

PowerShell (Windows)

執行下列指令：

$headers = @{ "Authorization" = "Bearer TOKEN" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudoauth.googleapis.com/v1/common/groups?page_size=PAGE_SIZE&page_token=PAGE_TOKEN" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "groups": [
    "security-admin@example.com",
    "data-analysts@example.com",
    "looker-developers@example.com"
  ],
  "next_page_token": "AE12aBcDeFgHiJkLmNoPqRsTuVwXyZ"
}

回應欄位

回應包含下列欄位：

欄位	類型	說明
`groups`	`array of strings`	已驗證使用者所屬的企業群組 ID 或電子郵件地址清單。
`next_page_token`	`string`	您可以在後續要求中，將這個權杖做為 `page_token` 傳遞，以便擷取下一頁結果。如果這個欄位留空或省略，表示沒有後續頁面。

如要瞭解 /groups 端點傳回的錯誤回應，請參閱「Cloud OAuth 使用者資訊和群組錯誤」。