管理 Gemini Code Assist 许可

在使用 Gemini Code Assist 之前，贵组织中的每位用户都需要获得许可。

默认情况下，如果是新订阅，您就需要手动分配许可。为 Google Cloud 产品设置特定 Gemini 后，您可以选择手动或自动分配许可。

准备工作

• 确保您拥有 Billing Account Administrator (roles/billing.admin) 或 Consumer Procurement Order Administrator (roles/consumerprocurement.orderAdmin) IAM 角色，以便您授予执行以下部分详述的特定许可管理任务所需的额外权限。

• 如果您想使用 API（而非 Google Cloud 控制台）管理许可，请确保满足以下条件：
  • 为您的结算账号设置配额项目。
  • 在配额项目中启用 Cloud Commerce Consumer Procurement API。
  • 确保所有 API 调用都包含以下标头键值对：
    • Authorization：Google Cloud CLI 中的 Google Cloud 访问令牌
    • x-goog-user-project：配额项目的项目 ID

更改订阅中的 Gemini Code Assist 许可数量

您可以直接通过 Google Cloud 控制台或通过 Google 客户代表或授权转销商添加或移除 Gemini for Google Cloud 许可的数量。

如需更改订阅中的许可数量，请按以下步骤操作：

1. 确保您对拥有订阅的结算账号拥有以下 Identity and Access Management (IAM) 权限：

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.orders.modify
   • resourcemanager.projects.get

2. 在 Google Cloud 控制台中，前往 Gemini 的管理页面。

   前往 Gemini 管理中心

3. 选择要更改的订阅，然后选择修改订阅。

4. 输入您要购买的许可数。系统会显示以下信息：

   • 购买后许可总数。
   • 购买后可分配的许可数量。
   • 每个订阅期的新订阅价格。添加的许可的额外费用将按当前期限剩余的时间按比例计算。

5. 选择保存。

查看 Gemini Code Assist 许可分配

从下列选项中选择一项：

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

{
  "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 许可

从下列选项中选择一项：

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

{}

自动分配 Gemini Code Assist 许可

您可以通过许可分配页面，为贵组织中需要访问 Gemini Code Assist 的任何用户自动分配许可。自动分配许可功能需针对每个订阅单独设置。

如果您选择为 Gemini Code Assist 自动分配许可，则无法移除或添加该账号下的个别用户许可。如果用户已获得许可分配，但在结算周期结束时未使用过任何 Gemini Code Assist 功能，且处于非活动状态的时间达到管理员设置的指定天数，则系统会自动取消配置该用户的许可。

1. 在 Google Cloud 控制台中，前往 Gemini 的管理页面。

   前往 Gemini 管理中心

2. 选择 Manage Gemini Code Assist（管理 Gemini Code Assist），然后选择 Manage Subscription（管理订阅）。

3. 选择许可管理，然后选择启用自动许可分配。系统随即会显示启用自动许可对话框。

   将此订阅切换为自动分配许可后，系统会在更改生效后停用手动许可分配功能，但之前的许可分配操作不会受到影响。

4. 设置在被分配者处于非活跃状态时，系统取消分配许可的等待时长，然后选择确认更改。系统随即会显示已启用自动分配许可功能对话框。

5. 选择关闭。

只要有许可可供分配，新用户在首次访问此结算账号中订阅的 Gemini Code Assist 时，就会自动获得许可。

如需停用自动分配许可，请按以下步骤操作：

1. 在 Google Cloud 控制台中，前往 Gemini 的管理页面。

   前往 Gemini 管理中心

2. 选择 Manage Gemini Code Assist（管理 Gemini Code Assist），然后选择 Manage Subscription（管理订阅）。

3. 选择许可管理，然后选择管理自动许可分配。系统随即会显示管理自动分配许可对话框。

4. 选择停用自动许可管理。

5. 选择确认更改。

手动取消分配 Gemini Code Assist 许可

从下列选项中选择一项：

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

{}

转移 Gemini Code Assist 许可

Gemini Code Assist 许可无法直接在用户之间转移。而是需要先取消向用户分配许可，然后再向新用户分配许可。

防止跨组织使用许可

Gemini Code Assist 许可分配给个人用户，而不是组织或项目，这让个人用户可以在多个组织中使用 Gemini Code Assist。

所有通过 Gemini Code Assist 生成的日志都位于发生使用行为的项目中，而非许可使用方。此外，Gemini Code Assist 的任何自定义或配置（例如代码自定义）都是在项目一级进行的，而不是在许可或订阅一级进行的。

如需进一步防止在项目中跨组织使用 Gemini Code Assist，您可以执行以下操作之一：

• 在项目中停用 Gemini for Google Cloud API。
• 使用权限拒绝用户访问项目。

限制

• 适用于 Google Cloud 许可管理的 Gemini 不支持员工身份联合。