获取 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 角色。

订阅

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

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

    Gemini Enterprise

  2. 依次点击管理订阅 > 创建订阅。

  3. 在您要订阅的版本上，点击订阅。

  4. 配置结算详细信息：

    1. 从下拉菜单中选择结算账号。

    2. 输入订阅名称。

    3. 输入相应版本所需的许可数量。

  5. 选择订阅期限。

  6. 如果您希望订阅自动续订，请选择自动续订。

  7. 配置分发详情：

    1. 在选择项目下拉菜单中，选择您的项目。

    2. 为订阅选择位置类型。如果您不必因合规性或监管原因而将数据放置在美国或欧盟多区域中，Google 建议您选择全球多区域，以实现最高可用性和最低延迟时间。

  8. 依次点击创建 > 确认。

更新订阅设置

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

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

    Gemini Enterprise

  2. 点击管理订阅。

  3. 在 Gemini 订阅表格中，点击要更新的订阅。

  4. 点击订阅详情旁边的修改。

  5. 更新许可数量，或开启/关闭自动续订。

  6. 点击提交。

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

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

控制台

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

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

    Gemini Enterprise

  2. 点击管理用户。

  3. 选择现有许可的多区域。

  4. 点击 Add users（添加用户）。

  5. 在添加用户页面上：

    1. 输入用户的电子邮件地址。请务必使用他们将用来登录 Gemini Enterprise 应用的电子邮件地址。

    2. 选择要为这些用户分配的订阅。

    3. 点击提交。

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",
            "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 应用时自动向其分配许可，请执行以下操作：

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

    Gemini Enterprise

  2. 点击管理用户。

  3. 选择现有许可的多区域。

  4. 选择自动分配许可，然后选择订阅。

    每次没有手动分配许可的用户登录时，系统都会从相应订阅中分配一个许可。 如果订阅中没有剩余许可，系统会向用户显示一条消息，通知他们无法访问。

    如需详细了解订阅，请参阅关于订阅部分。

转移已过期订阅中的许可

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

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

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

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

    Gemini Enterprise 许可

  2. 选择现有许可的多区域。

  3. 确保您拥有有效的订阅。如果您没有订阅，请订阅。

  4. 选择自动分配许可，然后选择有效订阅。

  5. 选择自动更新已过期的许可。

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

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

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

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

    Gemini Enterprise 许可

  2. 选择现有许可的多区域。

  3. 确保您拥有有效的订阅。如果您没有订阅，请订阅。

  4. 选择用户，然后点击分配其他许可。

  5. 在修改用户窗格中，选择相应订阅，然后点击提交。

列出许可

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

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

从许可中移除用户

如需从许可中移除用户，请执行以下操作：

控制台

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

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

    Gemini Enterprise 许可

  2. 选择现有许可的多区域。

  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_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：您要从许可中移除的用户的电子邮件地址。

后续步骤