获取 Gemini Enterprise 许可

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

许可简介

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

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

许可特定于多区域。例如，如果用户需要同时访问 us 多区域和 global 中的应用，则需要为他们分别分配这两种区域中的许可。

订阅简介

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

订阅特定于区域。在全球区域创建应用的用户需要 global 订阅中的许可。同样，需要将应用和数据保留在欧盟境内的用户则需要 eu 订阅中的许可。

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

准备工作

在开始执行本页面上的步骤之前，请确保：

您已完成设置 Gemini Enterprise 中的任务。这包括为项目设置结算账号，以及向您许可使用 Gemini Enterprise 的任何用户授予至少 Discovery Engine User 角色。
您拥有 Discovery Engine Admin 角色。
如需管理订阅，您必须具有 Billing Account Administrator 角色。如需详细了解如何查找现有管理员，请参阅查找 Billing Account Administrator。

获取订阅

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

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

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

分发许可

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

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

Gemini Enterprise
点击管理订阅。
从下拉菜单中选择结算账号。
在 Gemini 订阅表中，点击您订阅的名称。
点击订阅详情旁边的分发许可。
配置分发许可详细信息：
1. 在选择项目下拉菜单中，选择您的项目。
2. 为您的订阅选择位置。如果您不必因合规性或监管原因而将数据放置在美国或欧盟多区域，则 Google 建议您选择全球多区域，以实现最高的可用性和低延迟。
点击提交。

更新订阅设置

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

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

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

为用户分配许可

本部分介绍了如何自动或手动为新用户分配许可。您可以随时向新用户分配许可，并且在分配许可后，用户可以立即访问 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/global/licenseConfigs/SUBSCRIPTION_ID"
       },
       {
          "userPrincipal":"USER_EMAIL_2",
          "licenseConfig":"projects/PROJECT_NUMBER/locations/global/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 许可
选择现有许可所在的多区域。
确保您拥有有效订阅。如果您没有有效订阅，请获取订阅。
选择用户，然后点击分配其他许可。
在修改用户窗格中，选择相应订阅，然后点击提交。

列出许可

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

REST

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：您要从许可中移除的用户的邮箱。

后续步骤

了解 IAM 角色和权限。

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

许可简介

订阅简介

准备工作

获取订阅

分发许可

更新订阅设置

为用户分配许可

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

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

控制台

REST

转移已过期订阅中的许可

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

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

列出许可

REST

从许可中移除用户

控制台

REST

后续步骤

获取 Gemini Enterprise 许可