取得訂閱方案並指派 Gemini Enterprise 授權

本頁說明如何取得 Gemini Enterprise 訂閱方案,以及如何管理使用者授權。

如要設定存取權,通常需要完成下列階段:

  1. 採購:為帳單帳戶購買產品版本的訂閱方案。
  2. 分配:將訂閱方案中的授權分配給特定專案和位置。
  3. 指派:將分配的授權指派給個別使用者。

關於授權

使用者必須具備授權,才能登入 Gemini Enterprise 應用程式。您可以手動或自動指派授權給使用者。

  • 手動指派授權:您可以輸入使用者的電子郵件地址來新增使用者。

  • 自動指派授權:您可以設定訂閱方案,讓 Gemini Enterprise 在使用者首次存取 Gemini Enterprise 或 Gemini Notebook for Business 介面時,自動指派授權給使用者。

訂閱簡介

如要取得授權,您必須先訂閱 Gemini Enterprise 版本。訂閱方案會連結至帳單帳戶,如要瞭解可用的版本,請參閱「比較 Gemini Enterprise 版本」。

Gemini Enterprise 則可按月或按年訂閱。你可以將這些訂閱項目設為自動續訂。

您可以使用Google Cloud 控制台,購買 Gemini Enterprise Standard、Gemini Enterprise Plus 和 Gemini Enterprise 即付即用版本的訂閱方案。

訂閱授權數量限制

直接透過Google Cloud 控制台購買或修改依席次計費的訂閱方案時,控制台會強制執行自動席次數量上限。席次數量上限取決於您的 Cloud Billing 帳戶。

如果貴組織需要更多帳戶名額,或在嘗試為現有訂閱方案新增授權時,遇到授權數量上限錯誤,請與 Google Cloud 業務代表或客戶經理聯絡,透過離線訂單購買額外授權,或要求加入許可清單豁免。

關於訂閱狀態

訂閱項目可能處於下列其中一種狀態:

狀態 說明
尚未開始 您已購買訂閱項目,但尚未啟用。您可以將這個訂閱方案的授權分配給專案,但如果將這些授權指派給使用者,他們必須等到訂閱方案生效後,才能存取 Gemini Enterprise。詳情請參閱「發布授權」。
有效 訂閱方案已生效,擁有此訂閱方案授權的使用者可以存取 Gemini Enterprise。
停用中 訂閱方案正在停用,授權將提前終止。 擁有此訂閱方案授權的使用者,可繼續使用 Gemini Enterprise 一週的寬限期。一週後,授權就會轉換為「已過期」狀態。詳情請參閱「處理提前終止」。
已過期 訂閱方案到期後,或提早結束訂閱方案,導致授權從停用狀態轉為過期狀態時,擁有該訂閱方案授權的使用者將無法存取 Gemini Enterprise。

事前準備

開始執行本頁程序前,請先完成下列必要條件:

  • 完成「設定 Gemini Enterprise」中列出的所有工作。包括:

    • 為專案設定帳單帳戶。
    • 將 Gemini Enterprise 使用者角色 (或更高權限) 授予所有 Gemini Enterprise 授權使用者。
  • 確認 Google Cloud 專案已啟用計費功能。詳情請參閱「確認 Google Cloud 專案已啟用計費功能」。

  • 確認您具備必要的 IAM 角色和權限:

    • 專案的 Gemini Enterprise 管理員角色。

    • 如果您負責管理貴組織的帳單,則必須具備下列角色,才能購買及管理 Gemini Enterprise 訂閱方案和採購訂單:

      或者,如要精細控管 IAM 權限,您可以使用具備下列權限的自訂角色,而非帳單帳戶管理員角色。授予表格中所列資源的權限。

      資源 服務 權限
      Cloud Billing 帳戶 Cloud Billing billing.billingAccountPrices.list
      Cloud Billing 帳戶 消費者採購 consumerprocurement.orders.get
      consumerprocurement.orders.place
      consumerprocurement.licensePools.assign
      consumerprocurement.licensePools.unassign
      consumerprocurement.licensePools.enumerateLicensedUsers
      Cloud Billing 帳戶 Discovery Engine discoveryengine.billingAccountLicenseConfigs.distribute
      discoveryengine.billingAccountLicenseConfigs.get
      discoveryengine.billingAccountLicenseConfigs.list
      discoveryengine.billingAccountLicenseConfigs.retract
      專案 Discovery Engine 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
      專案 Resource Manager resourcemanager.projects.get
      resourcemanager.projects.list
      專案 服務使用情形 serviceusage.services.get
      serviceusage.services.list

訂閱

如要取得授權,請為帳單帳戶購買 Gemini Enterprise 版本訂閱方案。訂閱方案提供一組授權,可分配給專案並指派給使用者。您可以將授權型訂閱方案 (例如 Gemini Enterprise Standard 或 Plus) 的授權,分配給連結至任何帳單帳戶的專案。您只能將即付即用訂閱方案的授權,分配給連結至擁有該訂閱方案帳單帳戶的專案。

Standard 和 Plus

如要訂閱 Gemini Enterprise Standard 或 Plus 版,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 按一下 [Create Subscription] (建立訂閱項目)。

  4. 按一下「Gemini Enterprise Standard」或「Gemini Enterprise Plus」版本的「訂閱」。

  5. 設定「Billing details」(帳單詳細資料):

    1. 確認或從下拉式選單中選取「帳單帳戶」。
    2. 輸入訂閱項目名稱。
    3. 輸入該版本所需的授權數量。
  6. 選取「訂閱期」。

  7. 如要自動續訂,請勾選「Auto renew subscription」(自動續訂) 核取方塊。

  8. 設定「Distribution details」:

    1. 在「Project」(專案) 欄位中輸入專案 ID,然後從相符選項中選取專案。如果控制台出現提示,請啟用必要的 API。
    2. 選擇訂閱項目的「Location」(位置)。如果您並未受限於法規遵循或法規原因,不需要將資料存放在美國或歐盟境內的多個地區,Google 建議您選擇全球多區域,以獲得最高的可用性和低延遲。
  9. 依序點選「建立」>「確認」。

即付即用

如果訂閱即付即用方案,則須按月支付用量費用。詳情請參閱「即付即用版本的配額和定價」。訂閱方案可用於所有連結至帳單帳戶的專案。

如要訂閱 Gemini Enterprise 即付即用版,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 按一下 [Create Subscription] (建立訂閱項目)。

  4. 如果是 Gemini Enterprise 即付即用版,請按一下「Create plan」(建立方案)。

  5. 設定「Billing details」(帳單詳細資料):

    1. 確認或從下拉式選單中選取「帳單帳戶」。
    2. 輸入訂閱項目名稱。
    3. 輸入該版本所需的即付即用授權數量。
  6. 設定「Distribution details」:

    1. 在「Project」(專案) 欄位中輸入專案 ID,然後從相符選項中選取專案。如果控制台出現提示,請啟用必要的 API。
    2. 選擇訂閱項目的「Location」(位置)。如果您並未受限於法規遵循或法規原因,不需要將資料存放在美國或歐盟境內的多個地區,Google 建議您選擇全球多區域,以獲得最高的可用性和低延遲。
  7. 依序點選「建立」>「確認」。

  8. 如果專案連結至自助式 (線上) Cloud Billing 帳戶,系統會開啟「Buy credits」(購買抵免額) 視窗。選取金額和付款方式,然後完成購買。視需要設定自動儲值功能。

    如果尚未在帳單帳戶設定預付抵免額,則必須購買抵免額。如果取消,就不會建立訂閱方案,Google 也不會向您收費。詳情請參閱「管理預付抵免額」。

管理訂閱項目

本節說明如何查看、更新、分配及回收 Gemini Enterprise 訂閱方案。

查看訂閱詳細資料

如要查看 Gemini Enterprise 訂閱方案的詳細資料,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 在「Gemini Subscriptions」(Gemini 訂閱項目) 表格中,按一下訂閱項目名稱,開啟「Subscription detail」(訂閱項目詳細資料) 頁面。

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:用於歸因這項 API 呼叫的帳單和配額的專案編號或 ID。您必須具備這項專案的服務使用情形消費者角色。

  • 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 控制台購買訂閱方案,請按照下列步驟更新授權數量或續訂設定:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 在「Gemini Subscriptions」(Gemini 訂閱項目) 表格中,按一下訂閱項目名稱,開啟「Subscription detail」(訂閱項目詳細資料) 頁面。

  4. 在「Subscription detail」(訂閱詳細資料) 頁面中,按一下「Edit」(編輯)。

  5. 在「Edit Subscription」(編輯訂閱方案) 窗格中,在「Number of licenses」(授權數量) 欄位中輸入新值,或勾選/取消勾選「Auto renewal」(自動續約) 核取方塊。

  6. 按一下「提交」。

取消訂閱

如要取消 Gemini Enterprise 訂閱方案,請關閉自動續訂功能。訂閱約期結束之前,訂閱方案仍有效,Google 可能還是會向您收費。如要進一步瞭解訂閱方案,請參閱「查看訂閱詳細資料」一文。

如要取消訂閱,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 在「Gemini Subscriptions」(Gemini 訂閱項目) 表格中,按一下訂閱項目名稱,開啟「Subscription detail」(訂閱項目詳細資料) 頁面。

  4. 在「Subscription detail」(訂閱詳細資料) 頁面中,按一下「Edit」(編輯)。

  5. 在「編輯訂閱項目」窗格中,取消勾選「自動續訂」核取方塊。

  6. 按一下「提交」。

分配授權

如果您尚未將訂閱授權分配給專案 (可能是因為您離線購買訂閱,或先前嘗試分配授權失敗),請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 在「Gemini Subscriptions」(Gemini 訂閱項目) 表格中,按一下訂閱項目名稱,開啟「Subscription detail」(訂閱項目詳細資料) 頁面。

  4. 在「訂閱詳細資料」頁面中,按一下「分配授權」。

    「Distribute Licenses」(分配授權) 窗格隨即開啟,顯示現有的專案授權分配情形,以及「Available licenses」(可用授權) 和「Total licenses」(授權總數) 計數。

  5. 如何將授權分配給專案:

    1. 在「Select a project」(選取專案) 欄位中輸入專案 ID,然後從相符選項中選取專案。
    2. 如果對話方塊提示您為所選專案啟用 Discovery Engine API,請點選啟用。
    3. 從「Region」(區域) 下拉式選單中選取區域。
    4. 在「License Count」(授權數量) 欄位中,輸入要分配的授權數量。
    5. 選用:如要將授權分配給其他專案或區域,請按一下「Add license distribution」(新增授權分配),然後重複上述步驟。
  6. 按一下「提交」。

  7. 在「確認授權分配設定」對話方塊中,按一下「提交」。

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:用於歸因這項 API 呼叫的帳單和配額的專案編號或 ID。您必須具備這項專案的服務使用情形消費者角色。如果您在該專案啟用了 Discovery Engine,則可使用 TARGET_PROJECT_NUMBER。

  • 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。

收回訂閱方案中未指派的授權

本節說明如何回收專案中未指派的授權,讓這些授權在帳單帳戶中可供重新分配給其他專案。

控制台

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Plans & billing」(方案與帳單) 頁面。

    前往「方案和帳單」

  2. 從「Selected billing account」(所選帳單帳戶) 下拉式選單中,選取帳單帳戶。

  3. 在「Gemini Subscriptions」(Gemini 訂閱項目) 表格中,按一下訂閱項目名稱,開啟「Subscription detail」(訂閱項目詳細資料) 頁面。

  4. 在「訂閱詳細資料」頁面中,按一下「分配授權」。

  5. 在分配清單中,找出要回收授權的專案和區域。

  6. 選擇下列其中一項操作:

    • 如要減少授權數量,請調降「License Count」(授權數量) 欄位中的數量。
    • 如要收回該列的所有授權,請將滑鼠游標移至該列,然後按一下「Delete item」(刪除項目)。
  7. 按一下「提交」。

  8. 在「Confirm License Distribution」(確認授權分配) 對話方塊中,查看授權撤銷次數每天僅限一次的警告,然後按一下「Submit」(提交)。

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:用於歸因這項 API 呼叫的帳單和配額的專案編號或 ID。您必須具備這項專案的服務使用情形消費者角色。如果您在該專案啟用了 Discovery Engine,則可使用 TARGET_PROJECT_NUMBER。

  • 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。

處理提早終止

如果您在不同訂閱類型之間遷移,或帳單帳戶發生問題,訂閱可能會提前結束。

為確保轉換順利並避免服務中斷,我們提供一週 (七天) 的寬限期,受影響的授權在完全到期前會處於停用狀態。在這段寬限期內,您可以繼續使用服務,同時轉換至新的訂閱方案。

為確保使用者能繼續存取服務,請自動或手動將授權轉移至新的有效訂閱方案。

下圖顯示Google Cloud 控制台中停用授權的範例:

 Google Cloud 控制台中停用授權的範例

管理使用者授權

本節說明如何查看授權、匯出使用者資料,以及指派、轉移和移除個別使用者的授權。

查看授權

如要查看授權和獲派授權的使用者,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 按一下 [管理使用者]。

  3. 選取現有授權的多區域。

匯出使用者資料

Google Cloud 控制台中的使用者表格不支援排序或篩選功能。如需排序、篩選或分析使用者資料,最多可將 1,000,000 筆使用者記錄匯出為逗號分隔值 (CSV) 檔案。

匯出的 CSV 檔案包含下列資料欄。

資料欄名稱 說明
user_principal 使用者的電子郵件地址。
license_config 使用者獲派訂閱方案的完整 Google Cloud 資源名稱 (例如 projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID)。授權設定 ID 對應至管理員指派給使用者的 Gemini Enterprise 版本 (例如 Standard 或 Plus)。
assignment_time 管理員指派授權的時間戳記 (世界標準時間)。
last_login_time 使用者上次登入的時間戳記 (世界標準時間)。
license_assignment_state 授權指派狀態。可用的值如下:
  • ASSIGNED:使用者已獲派授權。
  • NO_LICENSE:使用者沒有授權,因為管理員尚未指派授權,或已移除現有授權。
  • BLOCKED:政策或管理員禁止使用者取得授權。

如要將使用者資料匯出為 CSV 檔案,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台,依序點選「Gemini Enterprise」>「Manage users」(管理使用者)。

    管理使用者

  2. 選取現有授權的多區域。

  3. 在「使用者」部分,按一下「匯出所有使用者」。

    視使用者資料表的大小而定,匯出資料最多可能需要 2.5 分鐘。這段期間,控制台會顯示載入狀態。匯出完成後,瀏覽器會將 CSV 檔案下載到預設下載位置。

排解匯出問題

下表列出匯出使用者資料時的常見問題和解決方法。

問題 解析度
「匯出所有使用者」按鈕會隱藏 請確認您已將授權指派給所選多區域中的使用者。如果沒有使用者獲派授權,系統就不會顯示「匯出所有使用者」按鈕。
匯出要求失敗,並顯示超出限制的錯誤 如果使用者名單超過 1,000,000 人的匯出上限, Google Cloud 控制台會拒絕匯出要求,並顯示超出上限的錯誤訊息。
匯出要求失敗,並顯示權限遭拒錯誤 確認您的帳戶具備 Gemini Enterprise 管理員角色,其中包含必要的 discoveryengine.userStores.listUserLicenses 權限。

將授權指派給使用者

本節說明如何自動或手動指派授權給新使用者。您隨時可以將授權指派給新使用者,指派後,使用者就能立即存取 Gemini Enterprise。

新增使用者並自動指派授權

如要在使用者登入 Gemini Enterprise 應用程式時自動指派授權,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 按一下 [管理使用者]。

  3. 選取現有授權的多區域。

  4. 選取「自動指派授權」,然後選取訂閱方案。

    每次未手動指派授權的使用者登入時,Gemini Enterprise 都會自動從這個訂閱方案指派授權給他們。如果訂閱方案中沒有剩餘授權,Gemini Enterprise 會向使用者顯示訊息,通知他們沒有存取權。

    如要進一步瞭解訂閱項目,請參閱「關於訂閱項目」一節。

新增使用者並手動指派授權

如要讓特定使用者存取 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/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。您可以透過下列兩種方式還原登入存取權:

自動將使用者轉移至有效訂閱方案

如要自動將使用者轉移至有效訂閱方案,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Manage users」(管理使用者) 頁面。

    Gemini Enterprise 授權

  2. 選取現有授權的多區域。

  3. 請確認訂閱方案仍在啟用中。如果沒有,請訂閱。

  4. 選取「自動指派授權」,然後選擇有效訂閱方案。

  5. 選取「自動更新到期的授權」。

    當授權到期的使用者下次登入時,Gemini Enterprise 會自動授予所選訂閱方案的授權。

手動將使用者轉移至有效訂閱方案

如要手動將使用者轉移至有效的訂閱方案,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Manage users」(管理使用者) 頁面。

    Gemini Enterprise 授權

  2. 選取現有授權的多區域。

  3. 請確認訂閱方案仍在啟用中。如果沒有,請訂閱。

  4. 選取使用者,然後按一下「指派其他授權」。

  5. 在「Edit Users」(編輯使用者) 窗格中,選取訂閱方案,然後按一下「Submit」(提交)。

列出授權

如要列出授權和指派對象,請執行下列指令:

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 控制台移除使用者的授權,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「Manage users」(管理使用者) 頁面。

    Gemini Enterprise 授權

  2. 選取現有授權的多區域。

  3. 在使用者表格中選取使用者。

  4. 如要移除使用者的授權,請選擇下列其中一項:

    • 如要只移除所選使用者的授權,請按一下「Unassign license」(取消指派授權)。
    • 如要移除授權,並從專案中刪除所選使用者,請按一下「Unassign and delete license」(取消指派並刪除授權)。
  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": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

更改下列內容:

  • PROJECT_ID:專案 ID。
  • ENDPOINT_LOCATION:API 要求適用的多區域。請指定下列其中一個值:
    • us 適用於美國多區域
    • eu 代表歐盟多區域
    • global 適用於全域位置
    詳情請參閱「為資料儲存庫指定多區域」。
  • LOCATION:資料儲存庫的多區域:global、us 或 eu
  • USER_EMAIL:要從授權中移除的使用者電子郵件地址。

後續步驟