此页面由 Cloud Translation API 翻译。

管理 Gemini for Google Cloud 许可

在组织中的每位用户使用某些 Gemini for Google Cloud 产品（例如 Gemini Code Assist）之前，都需要获得许可。

准备工作

确保您拥有 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 访问令牌通过 Google Cloud CLI
  - x-goog-user-project：配额项目的项目 ID

更改订阅中的 Gemini for Google Cloud 许可数量

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

如需执行此任务，您必须拥有以下 Identity and Access Management (IAM) 权限：

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify

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

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

前往 Gemini 的“管理”页面
选择要更改的订阅，然后点击 修改订阅。
输入您希望拥有的许可数量。以下信息：
- 购买后的许可总数。
- 购买后可用于分配的许可数。
- 每个订阅期的新订阅价格。添加的许可的额外金额将按当前期限剩余的时间按比例计算。
点击保存。

查看 Gemini for Google Cloud 许可分配

控制台

如需在 Google Cloud 控制台中查看 Gemini for Google Cloud 许可分配，您必须拥有以下权限：

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers

前往 Gemini 管理页面。

前往 Gemini 管理中心
选择要更改的订阅，然后点击修改订阅。

对于每个已分配的用户，您都可以查看以下信息许可：
- 名称
- 电子邮件
- 账号类型
- 已分配许可
如需查找一组特定用户，您可以按如下方式过滤和排序列表：
- 如需过滤列表，请在过滤条件字段中输入属性和值。
- 如需对列表进行排序，请点击要排序的列的标题。例如，要按用户名的字母顺序进行排序，请点击名称列标题。

API

如需查看 Google Cloud 专用 Gemini 许可分配情况，请使用该 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：IAM 政策

如果命令执行成功，则会在以下命令中返回 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"
      }
  ]
}

为个别用户分配 Google Cloud 专用 Gemini 许可

控制台

如需在 Google Cloud 控制台中向个人用户分配 Gemini for Google Cloud 许可，您必须拥有以下权限：

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign

前往 Gemini 的管理页面。

前往 Gemini 管理中心
选择要更改的订阅，然后点击 修改订阅。
点击分配许可。系统会显示用户选择对话框。如需搜索特定用户，请在搜索框中输入其姓名。
从列表中选择一个或多个用户，然后点击下一步。
选择所需的 Google Cloud 专用 Gemini 服务来分配许可
点击分配许可。

API

如需分配 Google Cloud 专用 Gemini 许可，请使用 billingAccounts.orders.licensePool.assign 方法。

如需执行此任务，您必须拥有 consumerprocurement.licensePools.assign 权限。

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

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

替换以下内容：

BILLING_ACCOUNT_ID：结算账号 ID
ORDER_ID：IAM 政策

如果命令执行成功，则会在以下命令中返回一个空的响应正文格式：

{}

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

取消分配 Google Cloud 专用 Gemini 许可

控制台

如需在 Google Cloud 控制台中取消向用户分配许可，您必须拥有以下权限：

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign

前往 Gemini 的管理页面。

前往 Gemini 管理中心
选择要更改的订阅，然后点击 管理订阅。
选择您要取消分配许可的用户，然后点击 取消对许可的分配。
点击确认更改。

API

如需取消分配 Google Cloud 专用 Gemini 许可，请使用 billingAccounts.orders.licensePool.unassign 方法。

要执行此任务，您必须拥有 consumerprocurement.licensePools.unassign 权限。

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

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

替换以下内容：

BILLING_ACCOUNT_ID：结算账号 ID
ORDER_ID：IAM 政策

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

{}

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

转移 Gemini for Google Cloud 许可

无法转移 Google Cloud 专用 Gemini 许可用户之间的直接沟通而是需要先取消向用户分配许可，然后再向新用户分配许可。

防止跨组织使用许可

Gemini for Google Cloud 许可分配给个别用户，而不是组织或项目，这让个别用户可以在多个组织中使用 Gemini for Google Cloud 功能。

Google Cloud 专用 Gemini 生成的任何日志归产生使用的项目（而非被许可人）所有。此外，Google Cloud 专用 Gemini 的任何自定义或配置（例如为 Gemini Code Assist 代码自定义）在项目中完成，而不是在许可或订阅级别完成。

如需进一步防止在项目中跨组织使用 Gemini for Google Cloud，您可以执行以下任一操作：

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

限制

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