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

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

获取 Gemini Enterprise 订阅并分配许可

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

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

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

许可简介

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

手动分配的许可：您可以通过用户邮箱添加相应用户。
自动分配的许可：您可以配置订阅，以便 Gemini Enterprise 在用户首次访问 Gemini Enterprise 或 Gemini Notebook Enterprise 界面时，自动为其分配许可。

订阅简介

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

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

您可以使用Google Cloud 控制台购买 Gemini Enterprise Standard 版、Gemini Enterprise Plus 版和 Gemini Enterprise 随用随付版订阅。

订阅状态简介

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

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

准备工作

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

完成设置 Gemini Enterprise 中列出的所有任务。其中包括：
- 为项目设置结算账号。
- 向您许可使用 Gemini Enterprise 的任何用户授予至少 Gemini Enterprise User 角色。
验证您的 Google Cloud 项目是否已启用结算功能。如需了解详情，请参阅验证 Google Cloud 项目是否已启用结算功能。

注意： Gemini Enterprise 随用随付订阅仅适用于已启用账单结算的账号。如需了解详情，请参阅 Cloud Billing 账号类型。

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

Gemini Enterprise 管理员角色。

如果您负责管理组织的结算，则必须具备以下角色才能管理 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
依次点击管理订阅 > 创建订阅。
在您要订阅的版本上，点击订阅。支持的版本包括 Gemini Enterprise Standard 版、Gemini Enterprise Plus 版和 Gemini Enterprise 随用随付版。
为版本配置结算详细信息。
标准版和 Plus 版

配置 Gemini Enterprise Standard 版和 Gemini Enterprise Plus 版的结算详细信息。
1. 从下拉菜单中选择结算账号。
2. 输入订阅名称。
3. 输入相应版本所需的许可数量。
随用随付

注意：对于随用随付型订阅，您只需为实际用量付费，并且系统会按照超额使用中列出的超额使用费率向您收取费用。

为 Gemini Enterprise 随用随付版配置结算详细信息。
1. 输入订阅名称。
2. 输入相应版本所需的许可数量。
选择订阅期。
如果您希望订阅自动续订，请选择自动续订。
配置分发详情：
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 订阅表中，点击要更新的订阅。
点击订阅详情旁边的修改。
更新许可数量，或开启/关闭自动续订。
点击提交。

取消订阅

如需取消 Gemini Enterprise 订阅，您必须关闭自动续订。您的订阅在当前订阅期结束之前仍然有效，之后会过期且不会续订。

如需取消订阅，请按以下步骤操作：

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

Gemini Enterprise
点击管理订阅。
在 Gemini 订阅表中，点击您订阅的名称以打开订阅详情页面。
点击修改。
在修改订阅面板中，取消选中自动续订复选框。
点击提交。

分发许可

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

控制台

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

Gemini Enterprise
点击管理订阅。
从下拉菜单中选择结算账号。
在 Gemini 订阅表中，点击您订阅的名称。
点击页面顶部的分发许可。系统会显示一个列表，其中包含现有许可分配以及剩余和总席位的统计信息。
如需将许可分配给项目，请执行以下操作：
1. 点击项目选择器以选择项目。选择器支持自动补全。
2. 注意：如果您尚未为所选项目启用 Discovery Engine API，系统会显示一个对话框，提示您启用该 API。
3. 选择位置。
4. 输入要分配的许可数量。
5. 如果您想将许可分配给多个项目或位置，请重复执行这些步骤。
点击提交。
在确认对话框中，查看更改摘要，然后点击确认。

REST

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

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。

回收订阅中未分配的许可

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

控制台

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

Gemini Enterprise
点击管理订阅。
从下拉菜单中选择结算账号。
在 Gemini 订阅表中，点击您订阅的名称。
点击页面顶部的分发许可（此按钮会打开所有分配的管理表单）。
在分配列表中，找到要回收许可的项目和位置对应的行。
选择以下其中一项操作：
- 如需减少许可数量，请减少许可输入字段中的数量。
- 如需完全回收许可，请将指针悬停在相应行上以显示“删除”按钮，然后点击删除。
点击提交。
在确认对话框中，查看更改摘要（其中会列出所有回收的许可），然后点击确认。

REST

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

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 都会自动从此订阅中为其分配一个许可。如果订阅中没有剩余许可，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": "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 许可
选择现有许可所在的多区域。
确保您拥有有效订阅。如果您没有有效订阅，请获取订阅。
选择自动分配许可，然后选择有效订阅。
选择自动更新已过期的许可。

当许可过期的用户下次登录时，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": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

替换以下内容：

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

后续步骤

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

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

许可简介

订阅简介

订阅状态简介

准备工作

获取订阅

标准版和 Plus 版

随用随付

管理订阅

查看订阅详情

控制台

REST

更新订阅设置

取消订阅

分发许可

控制台

REST

回收订阅中未分配的许可

控制台

REST

处理提前终止

管理用户许可

查看许可

为用户分配许可

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

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

控制台

REST

转移已过期订阅中的许可

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

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

列出许可

从许可中移除用户

控制台

REST

后续步骤

获取 Gemini Enterprise 订阅并分配许可