管理 Gemini Code Assist Standard 和 Enterprise 许可

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

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

准备工作

• 确保您拥有 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 Standard 和 Enterprise 许可数量

您可以直接通过 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 for Google Cloud

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

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

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

5. 选择保存。

查看 Gemini Code Assist Standard 和 Enterprise 许可分配

从下列选项中选择一项：

控制台

1. 确保您对拥有订阅的结算账号拥有以下 IAM 权限：

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

2. 前往 Gemini 管理页面，然后选择已与订阅了 Gemini Code Assist Standard 或 Enterprise 的结算账号关联的项目。

   前往 Gemini for Google Cloud

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

   系统会为已分配许可的每位用户提供以下信息：

   • 名称。
   • 电子邮件。
   • 许可分配日期。
   • 上次使用许可的日期和时间。

4. 如需查找一组特定用户，您可以按如下方式过滤和排序列表：

   • 如需过滤列表，请在过滤条件字段中输入属性和值。
   • 如需对列表进行排序，请选择要作为排序依据的列的标题。例如，如需按用户名称的字母顺序进行排序，请选择名称列标题。

API

如需查看 Gemini Code Assist Standard 或 Enterprise 许可分配情况，请使用 billingAccounts.orders.licensePool.enumerateLicensedUsers 方法。

如需执行此任务，您必须拥有对订阅所属结算账号的 consumerprocurement.licensePools.enumerateLicensedUsers 权限。

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

替换以下内容：

• BILLING_ACCOUNT_ID：结算账号 ID
• ORDER_ID：订单 ID。如果您不知道订单 ID，可以通过列出与您的结算账号关联的订单来检索该 ID。

如果命令成功，则会按以下格式返回 licensedUsers 输出：

{
  "licensedUsers": [
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

如果没有 Gemini Code Assist Standard 或 Enterprise 许可分配，或者 ORDER_ID 无效，则会返回以下格式的 licensedUsers 输出：

{}

手动向个别用户分配 Gemini Code Assist Standard 和 Enterprise 许可

从下列选项中选择一项：

控制台

1. 确保您对拥有订阅的结算账号拥有以下 IAM 权限：

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

2. 前往 Gemini 的管理页面。

   前往 Gemini for Google Cloud

3. 选择 Manage Gemini Code Assist（管理 Gemini Code Assist），然后选择 Modify Subscription（修改订阅）。

4. 对于此 Gemini Code Assist Standard 或 Enterprise 订阅，请确保将许可分配设置为手动分配许可。如果 Gemini Code Assist 标准版或企业版订阅设置为自动分配许可，则您无法管理个别许可。将此结算账号切换为手动分配许可后，系统会在更改生效后停用自动分配许可功能，但之前分配的许可不会受到影响。

5. 选择分配许可。系统会显示“用户选择”对话框。如需搜索特定用户，请输入其电子邮件地址，然后选择下一步。

6. 选择分配许可。

7. 确保您向已获许可的用户授予 Gemini for Google Cloud User 和 Service Usage Consumer IAM 角色。

API

如需分配 Gemini Code Assist Standard 和 Enterprise 许可，请使用 billingAccounts.orders.licensePool.assign 方法。

若要执行此任务，请确保您对拥有订阅的结算账号拥有以下权限：

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

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

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

替换以下内容：

• BILLING_ACCOUNT_ID：结算账号 ID
• ORDER_ID：订单 ID。如果您不知道订单 ID，可以通过列出与您的结算账号关联的订单来检索该 ID。

如果命令成功，则会返回以下格式的空响应正文：

{}

如需验证作业，请查看作业列表。

然后，确保您向用户授予 Gemini for Google Cloud User 和 Service Usage Consumer IAM 角色。

自动分配 Gemini Code Assist Standard 和 Enterprise 许可

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

如果您选择为 Gemini Code Assist 标准版或企业版自动分配许可，则无法移除或添加该账号下的个别用户许可。如果用户已获得许可分配，但在管理员设置的指定天数内未使用任何 Gemini Code Assist Standard 或 Enterprise 功能，则在结算周期结束时，系统会自动停用其许可。

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

   前往 Gemini for Google Cloud

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

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

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

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

5. 选择关闭。

6. 确保您向用户授予 Gemini for Google Cloud User 和 Service Usage Consumer IAM 角色。

   当具有 cloudaicompanion.licenses.selfAssign 权限的用户首次在由结算账号付费的项目中访问 Gemini Code Assist 标准版或企业版时，如果该结算账号具有已配置为自动分配许可的有效订阅，并且该结算账号中的订阅涵盖可用的许可，则该用户会自动获得许可。

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

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

   前往 Gemini for Google Cloud

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

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

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

5. 选择确认更改。

手动取消分配 Gemini Code Assist Standard 和 Enterprise 许可

从下列选项中选择一项：

控制台

1. 确保您对拥有订阅的结算账号拥有以下 IAM 权限：

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

2. 前往 Gemini 的管理页面。

   前往 Gemini for Google Cloud

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

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

5. 选择要取消分配许可的用户，然后选择取消分配许可。

6. 选择确认。

API

如需取消分配 Gemini Code Assist Standard 和 Enterprise 许可，请使用 billingAccounts.orders.licensePool.unassign 方法。

如需执行此任务，您必须拥有对订阅所属结算账号的 consumerprocurement.licensePools.unassign 权限。

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

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

替换以下内容：

• BILLING_ACCOUNT_ID：结算账号 ID
• ORDER_ID：订单 ID。如果您不知道订单 ID，可以通过列出与您的结算账号关联的订单来检索该 ID。

如果命令成功，则会返回以下格式的空响应正文：

{}

如需验证取消分配情况，请查看作业列表。

转移 Gemini Code Assist Standard 和 Enterprise 许可

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

防止跨组织使用许可

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

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

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

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

限制

• Gemini for Google Cloud 许可管理不支持员工身份联合。

后续步骤

• 了解如何帮助防止跨组织使用许可。