管理 Gemini Code Assist Standard 和 Enterprise 授權

主控台

1. 確認您在擁有訂閱項目的帳單帳戶中，具備下列 IAM 權限：

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • resourcemanager.projects.get

2. 前往「Admin for Gemini」頁面，然後選取已連結至帳單帳戶的專案，並訂閱 Gemini Code Assist Standard 或 Enterprise 方案。

   前往 Gemini 版 Google Cloud

3. 選擇要變更的訂閱方案，然後選取「修改訂閱方案」。

   系統會針對每位獲得授權的使用者提供以下資訊：

   • 名稱。
   • 電子郵件、
   • 授權指派日期。
   • 上次使用授權的日期和時間。

4. 如要尋找特定使用者，您可以按照下列方式篩選及排序清單：

   • 如要篩選清單，請在「Filter」(篩選條件) 欄位中輸入屬性和值。
   • 如要排序清單，請選取要排序的欄標題。如要依使用者名稱排序，請選取「Name」(名稱) 欄標題。

API

如要查看 Gemini Code Assist Standard 或 Enterprise 授權指派情形，請使用 billingAccounts.orders.licensePool.enumerateLicensedUsers 方法。

1. 確認您具備帳單帳戶的consumerprocurement.licensePools.enumerateLicensedUsers身分與存取權管理權限，該帳戶包含您要查看授權指派項目的授權集區。

2. 使用 cURL 呼叫方法：

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
   

   更改下列內容：

   • PROJECT_ID：專案的 ID。系統會根據這個專案，計算 API 要求相關的配額用量和費用。
   • BILLING_ACCOUNT_ID：與授權集區相關聯的帳單帳戶 ID。
   • ORDER_ID：訂單 ID。如果不知道訂單 ID，可以列出與帳單帳戶相關聯的訂單，藉此找出訂單 ID。

如果指令成功執行，則會傳回下列格式的 licensedUsers 輸出內容：

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

如果沒有 Gemini Code Assist Standard 或 Enterprise 授權指派，或 ORDER_ID 無效，系統會傳回下列格式的 licensedUsers 輸出內容：

{}

主控台

1. 確認您在擁有訂閱項目的帳單帳戶中，具備下列 IAM 權限：

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.assign
   • resourcemanager.projects.get

2. 前往「Gemini 管理」頁面。

   前往 Gemini 版 Google Cloud

3. 選取「管理 Gemini Code Assist」，然後選取「修改訂閱方案」。

4. 針對這項 Gemini Code Assist Standard 或 Enterprise 訂閱方案，請確認您已將「授權指派」設為「手動指派授權」。如果 Gemini Code Assist Standard 或 Enterprise 訂閱方案設為「自動指派授權」，您就無法管理個別授權。將這個帳單帳戶切換為「手動指派授權」後，系統會停用自動指派授權功能，但先前指派的授權不會受到影響。

5. 選取「新增授權使用者」。系統隨即會顯示使用者選取對話方塊。系統僅支援個人 Google 帳戶電子郵件地址，例如 @gmail.com、@googlegroups.com 和 Google Workspace 網域。不支援員工身分聯盟 (BYOID)。

6. 選取「新增授權使用者」。

7. 確認您已將「Gemini for Google Cloud 使用者」和「服務使用量消費者」這兩個 IAM 角色授予授權使用者。

API

如要指派 Gemini Code Assist Standard 和 Enterprise 授權，請使用 billingAccounts.orders.licensePool.assign 方法。

1. 確認您在包含授權集區的帳單帳戶中，擁有下列身分與存取權管理權限，可指派授權集區中的授權：

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

1. 建立包含下列資訊的 JSON 檔案：

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   將 USER_EMAILS 替換為以半形逗號分隔的使用者帳戶清單，這些帳戶將獲派授權，例如 "dana@example.com", "lee@example.com"。系統僅支援個人 Google 帳戶電子郵件地址，例如 @gmail.com、@googlegroups.com 和 Google Workspace 網域。不支援員工身分聯盟 (BYOID)。

2. 使用 cURL 呼叫方法：

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   更改下列內容：

   • JSON_FILE_NAME：您在步驟 2 建立的 JSON 檔案路徑。
   • PROJECT_ID：專案的 ID。系統會根據這個專案，計算 API 要求相關的配額用量和費用。
   • BILLING_ACCOUNT_ID：與授權集區相關聯的帳單帳戶 ID。
   • ORDER_ID：訂單 ID。如果不知道訂單 ID，可以列出與帳單帳戶相關聯的訂單，藉此找出訂單 ID。

如果成功，回應會類似以下內容：

{}

如要驗證指派情形，請查看指派清單。

然後，請確認您已將「Gemini for Google Cloud 使用者」和「服務使用量消費者」IAM 角色授予授權使用者。

主控台

1. 確認您在擁有訂閱項目的帳單帳戶中，具備下列 IAM 權限：

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

2. 前往「Gemini 管理」頁面。

   前往 Gemini 版 Google Cloud

3. 依序選取「管理 Gemini Code Assist」和「管理訂閱方案」。

4. 選取「授權管理」，然後選取「管理自動授權指派」。系統會顯示「管理自動指派授權功能」對話方塊。

5. 選取要取消指派授權的使用者，然後選取「取消指派授權」。

6. 選取「確認」。

API

如要取消指派 Gemini Code Assist Standard 和 Enterprise 授權，請使用 billingAccounts.orders.licensePool.unassign 方法。

1. 如要執行這項工作，您必須對包含授權集區的帳單帳戶，擁有consumerprocurement.licensePools.unassign身分與存取權管理權限，才能取消指派授權集區中的授權。

2. 建立包含下列資訊的 JSON 檔案：

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   將 USER_EMAILS 替換為以半形逗號分隔的授權使用者帳戶清單，例如 "dana@example.com", "lee@example.com"。

3. 使用 cURL 呼叫方法：

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

   更改下列內容：

   • JSON_FILE_NAME：您在步驟 2 建立的 JSON 檔案路徑。
   • PROJECT_ID：專案的 ID。系統會根據這個專案，計算 API 要求相關的配額用量和費用。
   • BILLING_ACCOUNT_ID：與授權集區相關聯的帳單帳戶 ID。
   • ORDER_ID：訂單 ID。如果不知道訂單 ID，可以列出與帳單帳戶相關聯的訂單，藉此找出訂單 ID。

如果成功，回應會類似以下內容：

{}

如要驗證取消指派作業，請查看指派作業清單。