注意：本文档适用于 Gemini Enterprise 的 Standard 版、Plus 版和 Frontline 版。如需了解 Business 版，请参阅 Gemini Enterprise - Business 版帮助中心。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

获取 Gemini Enterprise 订阅并分配许可

本页面介绍了如何获取 Gemini Enterprise 订阅以及如何管理用户许可。

设置访问权限通常涉及以下阶段：

Procure：为结算账号购买产品版本的订阅。
分配：将订阅中的许可分配给特定项目和位置。
分配：将分发的许可分配给个别用户。

许可简介

用户必须拥有许可才能登录 Gemini Enterprise 应用。您可以手动或自动为用户分配许可。

手动分配的许可：您可以通过用户邮箱添加相应用户。
自动分配的许可：您可以选择让系统在用户首次访问 Gemini Enterprise 或 NotebookLM Enterprise 界面时，自动将订阅中的许可分配给该用户。

订阅简介

如需获取许可，您必须先订阅 Gemini Enterprise 版。订阅特定于结算账号。如需了解可用版本，请参阅比较 Gemini Enterprise 的各个版本。

对于 Gemini Enterprise，您可以购买按月订阅或按年订阅。这些订阅可以设置为自动续订。

订阅状态简介

订阅可能处于以下任一状态：

州	说明
尚未开始	您已购买订阅，但订阅尚未生效。您可以将此订阅中的许可分配给项目，但分配了这些许可的用户在订阅生效之前无法访问 Gemini Enterprise。如需了解详情，请参阅分发许可。
有效	订阅处于有效状态，拥有此订阅中许可的用户可以访问 Gemini Enterprise。
正在停用	订阅处于停用状态，许可已安排提前终止。拥有相应订阅中许可的用户在宽限期内（一周）仍可继续使用 Gemini Enterprise。一周后，许可会转为“已过期”状态。如需了解详情，请参阅处理提前终止。
已过期	如果订阅期限结束，或者许可在提前终止后从停用状态转为过期状态，则相应订阅中的许可所对应的用户将无法再使用 Gemini Enterprise。

准备工作

在开始执行本页面上的步骤之前，请确保满足以下前提条件：

完成设置 Gemini Enterprise 中列出的所有任务。其中包括：
- 为项目设置结算账号。
- 向您许可使用 Gemini Enterprise 的任何用户授予至少 Gemini Enterprise User 角色。

确认您拥有所需的 IAM 角色和权限：

Gemini Enterprise Admin 角色。

如果您负责管理组织的结算，则必须拥有以下角色才能管理 Gemini Enterprise 订阅和采购订单。

Billing Account Administrator (roles/billing.admin)
Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

或者，为了实现精细的 IAM 控制，您可以使用具有以下权限的自定义角色，而不是结算账号管理员角色：

服务	权限
Discovery Engine	`discoveryengine.billingAccountLicenseConfigs.distribute` `discoveryengine.billingAccountLicenseConfigs.get` `discoveryengine.billingAccountLicenseConfigs.list` `discoveryengine.billingAccountLicenseConfigs.retract` `discoveryengine.licenseConfigs.create` `discoveryengine.licenseConfigs.get` `discoveryengine.licenseConfigs.list` `discoveryengine.licenseConfigs.update` `discoveryengine.projects.get` `discoveryengine.projects.provision` `discoveryengine.projects.reportConsentChange` `discoveryengine.userStores.batchUpdateUserLicenses` `discoveryengine.userStores.listUserLicenses`
Consumer Procurement	`consumerprocurement.orders.get` `consumerprocurement.licensePools.assign` `consumerprocurement.licensePools.unassign` `consumerprocurement.licensePools.enumerateLicensedUsers`
Resource Manager	`resourcemanager.projects.get` `resourcemanager.projects.list`
服务用途	`serviceusage.services.get` `serviceusage.services.list`

获取订阅

如需为用户获取许可，您必须先为结算账号购买 Gemini Enterprise 版订阅。该订阅会提供许可池，然后您可以将许可分配给项目并指定给用户。

如需获取 Gemini Enterprise 订阅，请执行以下操作：

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
依次点击管理订阅 > 创建订阅。
在您要订阅的版本上，点击订阅。
配置结算详细信息：
1. 从下拉菜单中选择结算账号。
2. 输入订阅名称。
3. 输入相应版本所需的许可数量。
选择订阅期。
如果您希望订阅自动续订，请选择自动续订。
配置分发详情：
1. 在选择项目下拉菜单中，选择您的项目。
2. 为订阅选择位置类型。如果您不必因合规性或监管原因而将数据放置在美国或欧盟多区域，则 Google 建议您选择全球多区域，以实现最高的可用性和低延迟。
依次点击创建 > 确认。

管理订阅

本部分介绍了如何查看、更新、分发和回收 Gemini Enterprise 订阅。

查看订阅详情

如需查看 Gemini Enterprise 订阅的详细信息，请执行以下操作：

控制台

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
点击管理订阅。
从下拉菜单中选择结算账号。
在 Gemini 订阅表中，点击您订阅的名称。

REST

如需获取订阅详情，请运行以下命令：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

替换以下内容：

PROJECT_NUMBER：您拥有 Service Usage Consumer 角色的项目编号
BILLING_ACCOUNT_ID：您的 Google Cloud 结算账号的 ID。

示例输出

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

更新订阅设置

创建订阅后，您可以更新设置，例如许可数量或自动续订设置。

添加更多许可的方法取决于您最初购买订阅的方式：

如果您是通过 Google Cloud 控制台购买的订阅，请按照本部分中的步骤直接在 Google Cloud 控制台中添加更多许可。
如果您是通过离线订购表单购买的，则必须使用新的许可数量更新该表单。请与您的 Google 客户经理联系，以更新订购表单。

如果您是通过Google Cloud 控制台购买的许可，请按以下步骤更新许可：

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
点击管理订阅。
在 Gemini 订阅表中，点击要更新的订阅。
点击订阅详情旁边的修改。
更新许可数量，或开启/关闭自动续订。
点击提交。

分发许可

如果您尚未将订阅的许可分发给项目（这可能发生在离线购买订阅时，或者之前许可分发失败时），请执行以下操作：

如需将许可分发给一个项目或多个项目，请运行以下命令：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

替换以下内容：

PROJECT_NUMBER：您拥有 Service Usage Consumer 角色的项目编号
ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
- us（表示美国多区域）
- eu（表示欧盟多区域）
- global（表示全球位置）
如需了解详情，请参阅为数据存储区指定多区域。
LOCATION：数据存储区的多区域：global、us 或 eu
TARGET_PROJECT_NUMBER：您要向其分配许可的项目编号
LICENSE_COUNT：要分发的许可数量。
BILLING_ACCOUNT_ID：您的 Google Cloud 结算账号的 ID。
BILLING_ACCOUNT_LICENSE_CONFIG_ID：在订阅详情中找到结算账号许可配置 ID
可选 LICENSE_CONFIG_ID：现有项目级许可配置的 ID。您可以在查看订阅详情时在 licenseConfigDistributions 字段中找到此 ID。

注意：如果您在此 API 请求中省略 LICENSE_CONFIG_ID，系统会为指定的项目编号和位置创建新的许可配置。如需更新现有许可配置，您必须添加 LICENSE_CONFIG_ID。

回收订阅中未分配的许可

本部分介绍如何从项目中回收未分配的许可，以便在结算账号中重新分配给其他项目。

如需将订阅许可转移回结算账号以进行重新分发，请运行以下命令：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

替换以下内容：

PROJECT_NUMBER：您拥有 Service Usage Consumer 角色的项目编号
ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
- us（表示美国多区域）
- eu（表示欧盟多区域）
- global（表示全球位置）
如需了解详情，请参阅为数据存储区指定多区域。
LOCATION：数据存储区的多区域：global、us 或 eu
TARGET_PROJECT_NUMBER：您要回收许可的项目编号
LICENSE_COUNT：要回收的许可数量。
BILLING_ACCOUNT_ID：您的 Google Cloud 结算账号的 ID。
BILLING_ACCOUNT_LICENSE_CONFIG_ID：在订阅详情中找到结算账号许可配置 ID
LICENSE_CONFIG_ID：现有项目级许可配置的许可配置 ID

处理提前终止

当您在不同类型的订阅之间迁移时，或者您的结算账号存在问题时，订阅可能会比预期更早结束。

为确保顺利过渡并防止服务中断，我们提供为期一周（7 天）的宽限期，在此期间，受影响的许可处于停用状态，然后才会完全过期。在宽限期内，您可以继续使用该服务，同时改换为新的订阅。

为确保用户保留访问权限，请自动或手动将用户的许可转移到新的有效订阅。

下图展示了在Google Cloud 控制台中停用许可的示例：

在 Google Cloud 控制台中停用许可的示例

管理用户许可

本部分介绍了如何查看、分配、转移和移除单个用户的许可。

查看许可

如需查看许可及其分配到的用户，请执行以下操作：

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
点击管理用户。
选择现有许可所在的多区域。

为用户分配许可

本部分介绍了如何自动或手动为新用户分配许可。您可以随时向新用户分配许可，并且在分配许可后，用户可以立即访问 Gemini Enterprise。

添加用户并自动为其分配许可

如需在用户登录 Gemini Enterprise 应用时自动为其分配许可，请执行以下操作：

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
点击管理用户。
选择现有许可所在的多区域。
选择自动分配许可，然后选择订阅。

每次没有手动分配许可的用户登录时，系统都会从此订阅中为其分配一个许可。如果订阅中没有剩余许可，用户将看到一条消息，通知他们没有访问权限。

如需详细了解订阅，请参阅订阅简介部分。

添加用户并手动为其分配许可

如需向特定用户授予对 Gemini Enterprise 的访问权限，您可以手动为他们分配有效订阅中的许可。

控制台

如需手动向用户分配许可，请执行以下操作：

在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

Gemini Enterprise
点击管理用户。
选择现有许可所在的多区域。
点击 Add users（添加用户）。
在添加用户页面上：
1. 输入用户的邮箱。请务必使用他们将用于登录 Gemini Enterprise 应用的邮箱。
2. 选择要分配给这些用户的订阅。
3. 点击提交。

REST

如需手动向用户分配许可，请运行以下命令：

关键术语：在 Gemini Enterprise 中，“应用”一词在 API 上下文中可以与“引擎”一词互换使用。Gemini Enterprise 引擎是一种通用搜索引擎，其中 app_type 字段设置为 APP_TYPE_INTRANET。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask":{
         "paths":[
            "userPrincipal",
            "licenseConfig"
         ]
      }
   },
   "deleteUnassignedUserLicenses":false
  }'

替换以下内容：

PROJECT_ID：您的项目的 ID。
ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
- us（表示美国多区域）
- eu（表示欧盟多区域）
- global（表示全球位置）
如需了解详情，请参阅为数据存储区指定多区域。
LOCATION：数据存储区的多区域：global、us 或 eu
USER_EMAIL：您要添加到许可中的用户的邮箱。
PROJECT_NUMBER：您的 Google Cloud 项目编号。
SUBSCRIPTION_ID：您的 Gemini Enterprise 订阅的 ID。

转移已过期订阅中的许可

如果订阅已过期，用户将无法登录 Gemini Enterprise。您可以通过以下几种方法恢复其登录权限：

自动将许可已过期的现有用户转移到默认订阅。
手动将现有用户转移到新订阅。

自动将用户转移到有效订阅

如需自动将用户转移到有效订阅，请执行以下操作：

在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 管理用户页面。

Gemini Enterprise 许可
选择现有许可所在的多区域。
确保您拥有有效订阅。如果您没有有效订阅，请获取订阅。
选择自动分配许可，然后选择有效订阅。
选择自动更新已过期的许可。

当许可过期的用户下次登录时，系统会自动为其授予所选订阅中的许可。

手动将用户转移到有效订阅

如需手动将用户转移到有效订阅，请执行以下操作：

在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 管理用户页面。

Gemini Enterprise 许可
选择现有许可所在的多区域。
确保您拥有有效订阅。如果您没有有效订阅，请获取订阅。
选择用户，然后点击分配其他许可。
在修改用户窗格中，选择相应订阅，然后点击提交。

列出许可

如需列出许可及其分配到的用户，请运行以下命令：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

替换以下内容：

PROJECT_ID：您的项目的 ID。
ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
- us（表示美国多区域）
- eu（表示欧盟多区域）
- global（表示全球位置）
如需了解详情，请参阅为数据存储区指定多区域。
LOCATION：数据存储区的多区域：global、us 或 eu

从许可中移除用户

您可以随时移除用户的许可。移除许可后，用户会立即失去对 Gemini Enterprise 的访问权限。如需从许可中移除用户，请执行以下操作：

控制台

如需使用 Google Cloud 控制台从许可中移除用户，请执行以下操作：

在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 管理用户页面。

Gemini Enterprise 许可
选择现有许可所在的多区域。
在用户表中，选择相应用户。
如需从许可中移除用户，请选择以下任一选项：
- 如需仅从所选用户中移除许可，请点击取消分配许可。
- 如需从项目中移除许可并删除所选用户，请点击取消分配并删除许可。
点击确认。

REST

如需从许可中移除用户，请运行以下命令：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask":{
         "paths":[
            "userPrincipal",
            "licenseConfig"
         ]
      }
   },
   "deleteUnassignedUserLicenses":true
  }'

替换以下内容：

PROJECT_ID：您的项目的 ID。
ENDPOINT_LOCATION：API 请求的多区域。请指定以下某个值：
- us（表示美国多区域）
- eu（表示欧盟多区域）
- global（表示全球位置）
如需了解详情，请参阅为数据存储区指定多区域。
LOCATION：数据存储区的多区域：global、us 或 eu
USER_EMAIL：您要从许可中移除的用户的邮箱。

查看共享配额用量（公开预览版）

Gemini Enterprise 共享配额概览

在 Gemini Enterprise 中，资源配额（例如回答生成、操作和智能体使用方面的配额）在 Google Cloud 项目中的所有用户之间共享。这种配额共享也称为共用。资源消耗限额不再是每个用户单独拥有的，而是合并为一个项目范围内的共用限额。配额按版本共用。例如，拥有 Gemini Enterprise Plus 许可的用户共享一个配额池，而拥有 Gemini Enterprise Frontline 许可的用户共享另一个配额池。

例如，下表显示了 Gemini Enterprise Plus 版的图片生成配额是如何共享的：

配额类型	每个许可的限额	示例总数（针对 100 个许可）
图片生成	每天 10 张图片	每天 1,000 张图片

项目中的任何用户都可以使用此共享配额。

准备工作

只有在满足以下条件时，您才能查看配额使用情况信息中心：

您是 Gemini Enterprise 管理员。
您至少有一项有效的 Gemini Enterprise 订阅，包括 Gemini Enterprise Standard、Gemini Enterprise Plus 或 Gemini Enterprise Frontline。

如果您有有效的 Agentspace 订阅，则只有在同时拥有有效的 Gemini Enterprise 订阅时，才能看到配额使用情况信息中心。在这种情况下，信息中心会显示您的 Agentspace 和 Gemini Enterprise 订阅的合并配额，如下所示：

Gemini Enterprise Plus 配额包含 Agentspace Enterprise Plus 配额
Gemini Enterprise Standard 配额包含 Agentspace Enterprise 配额
Gemini Enterprise Frontline 配额包含 Agentspace Frontline Worker 配额

如果您只有 Agentspace 订阅，而没有有效的 Gemini Enterprise 订阅，则无法查看配额使用情况信息中心。

查看配额用量信息中心

作为 Gemini Enterprise 管理员，如需查看项目中的共享配额用量，请执行以下操作：

在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 管理用户页面。

Gemini Enterprise 许可
选择许可所在的多区域。
点击查看配额用量。
在打开的 Gemini Enterprise 配额用量窗格中，从订阅层级列表中选择您的产品版本。

信息中心会填充配额，并显示每个配额的绝对用量和百分比用量。

后续步骤

详细了解有关 Gemini Enterprise 许可的常见问题解答。
了解 IAM 角色和权限。

获取 Gemini Enterprise 订阅并分配许可 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

许可简介

订阅简介

订阅状态简介

准备工作

获取订阅

管理订阅

查看订阅详情

控制台

REST

更新订阅设置

分发许可

回收订阅中未分配的许可

处理提前终止

管理用户许可

查看许可

为用户分配许可

添加用户并自动为其分配许可

添加用户并手动为其分配许可

控制台

REST

转移已过期订阅中的许可

自动将用户转移到有效订阅

手动将用户转移到有效订阅

列出许可

从许可中移除用户

控制台

REST

查看共享配额用量（公开预览版）

Gemini Enterprise 共享配额概览

准备工作

查看配额用量信息中心

后续步骤

获取 Gemini Enterprise 订阅并分配许可