Gemini Enterprise のサブスクリプションを取得してライセンスを割り当てる

このページでは、Gemini Enterprise のサブスクリプションを取得する方法と、ユーザー ライセンスを管理する方法について説明します。

通常、アクセスの設定には次の段階があります。

  1. 調達: 請求先アカウントのプロダクト エディションのサブスクリプションを購入します。
  2. 配布: サブスクリプションのライセンスを特定のプロジェクトとロケーションに割り当てます。
  3. 割り当て: 分配されたライセンスを個々のユーザーに割り当てます。

ライセンスについて

Gemini Enterprise app にログインするには、ライセンスが必要です。ライセンスは、ユーザーに手動または自動で割り当てることができます。

  • 手動で割り当てられたライセンス: メールアドレスでユーザーを追加できます。

  • 自動割り当てライセンス: ユーザーが Gemini Enterprise または Gemini Notebook Enterprise インターフェースに初めてアクセスしたときに、Gemini Enterprise が自動的にライセンスを割り当てるようにサブスクリプションを構成できます。

サブスクリプションについて

ライセンスを取得するには、まず Gemini Enterprise エディションのサブスクリプションが必要です。サブスクリプションは請求先アカウントに固有のものです。利用可能なエディションについては、Gemini Enterprise のエディションの比較をご覧ください。

Gemini Enterprise では、月単位のサブスクリプションまたは年間サブスクリプションを購入できます。これらのサブスクリプションは自動更新するように設定できます。

Gemini Enterprise Standard、Gemini Enterprise Plus、Gemini Enterprise 従量課金制エディションのサブスクリプションは、Google Cloud コンソールで購入できます。

サブスクリプションのシート数の上限

Google Cloud コンソールから直接シートベースのサブスクリプションを購入または変更すると、シート数の上限が自動的に適用されます。最大シート数は、Cloud 請求先アカウントによって異なります。

組織でより多くのシートが必要な場合や、既存のサブスクリプションにライセンスを追加しようとしたときにシート数の上限エラーが発生した場合は、 Google Cloud の営業担当者またはアカウント マネージャーに連絡して、オフライン注文で追加のライセンスを購入するか、許可リストの除外をリクエストしてください。

定期購入の状態について

サブスクリプションは次のいずれかの状態になります。

状態 説明
未開始 サブスクリプションを購入しましたが、まだ有効になっていません。このサブスクリプションのライセンスをプロジェクトに配布することはできますが、これらのライセンスが割り当てられたユーザーは、サブスクリプションが有効になるまで Gemini Enterprise にアクセスできません。詳細については、ライセンスを配布するをご覧ください。
有効 サブスクリプションは有効であり、このサブスクリプションのライセンスを持つユーザーは Gemini Enterprise にアクセスできます。
無効にしています サブスクリプションは無効化中の状態であり、ライセンスの早期終了が予定されています。このサブスクリプションのライセンスを持つユーザーは、1 週間の猶予期間中、引き続き Gemini Enterprise にアクセスできます。この 1 週間が経過すると、ライセンスは期限切れの状態に移行します。詳細については、早期終了を処理するをご覧ください。
期限切れ このサブスクリプションのライセンスを持つユーザーは、サブスクリプション期間が終了するか、早期終了後にライセンスが無効状態から期限切れ状態に移行すると、Gemini Enterprise にアクセスできなくなります。

始める前に

このページの手順を開始する前に、次の前提条件を満たしていることを確認してください。

  • Gemini Enterprise の設定に記載されているすべてのタスクを完了します。以下が該当します。

    • プロジェクトの請求先アカウントを設定する。
    • Gemini Enterprise の使用ライセンスを付与するユーザーに、少なくとも Gemini Enterprise ユーザーロールを付与する。

  • Google Cloud プロジェクトで課金が有効になっていることを確認します。詳細については、 Google Cloud プロジェクトで課金が有効になっていることを確認するをご覧ください。

  • 必要な IAM ロールと権限があることを確認します。

    • Gemini Enterprise 管理者ロール。

    • 組織の請求を管理する場合は、Gemini Enterprise のサブスクリプションと調達注文を管理するために、次のロールが必要です。

      また、きめ細かい IAM 制御を行う場合は、請求先アカウント管理者ロールの代わりに、次の権限を持つカスタムロールを使用できます。

      サービス 権限
      ディスカバリー エンジン 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
      Service Usage serviceusage.services.get
      serviceusage.services.list

サブスクリプションを取得する

ライセンスを取得するには、請求先アカウントの Gemini Enterprise エディションのサブスクリプションを購入します。このサブスクリプションでは、請求先アカウントに関連付けられているすべてのプロジェクトで使用できるライセンスのプールが提供されます。このライセンスは、プロジェクトに配布したり、ユーザーに割り当てたりできます。

Standard、Plus

Gemini Enterprise Standard エディションまたは Plus エディションに登録する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] > [サブスクリプションを作成] をクリックします。

  3. Gemini Enterprise Standard エディションまたは Gemini Enterprise Plus エディションの場合は、[登録] をクリックします。

  4. お支払い情報を構成します。

    1. プルダウン メニューから請求先アカウントを選択します。
    2. サブスクリプション名を入力します。
    3. エディションに必要なライセンス数を入力します。

  5. [サブスクリプションの期間] を選択します。

  6. サブスクリプションを自動更新する場合は、[サブスクリプションを自動更新する] を選択します。

  7. 配信の詳細を構成します。

    1. [プロジェクトを選択] プルダウンで、プロジェクトを選択します。
    2. サブスクリプションのロケーション タイプを選択します。米国または EU のマルチリージョンにデータを配置するためのコンプライアンス上または規制上の理由がない場合は、可用性を最大限に高め、レイテンシを低くするために、グローバル マルチリージョンを選択することをおすすめします。

  8. [作成] > [確認] をクリックします。

従量課金制

従量課金制のサブスクリプションでは、使用した分を毎月支払います。詳細については、従量課金制エディションの割り当てと料金をご覧ください。このサブスクリプションは、請求先アカウントに関連付けられているすべてのプロジェクトで使用できます。

Gemini Enterprise 従量課金制エディションに登録する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] > [サブスクリプションを作成] をクリックします。

  3. [Gemini Enterprise 従量課金制] エディションで、[登録] をクリックします。

  4. お支払い情報を構成します。

    1. サブスクリプション名を入力します。
    2. エディションに必要なライセンス数を入力します。

  5. 配信の詳細を構成します。

    1. [プロジェクトを選択] プルダウンで、プロジェクトを選択します。
    2. サブスクリプションのロケーション タイプを選択します。米国または EU のマルチリージョンにデータを配置するためのコンプライアンス上または規制上の理由がない場合は、可用性を最大限に高め、レイテンシを低くするために、グローバル マルチリージョンを選択することをおすすめします。

  6. [作成] > [確認] をクリックします。

  7. プロジェクトがセルフサービス（オンライン）の Cloud 請求先アカウントにリンクされている場合は、[クレジットを購入] ウィンドウが開きます。金額とお支払い方法を選択して、購入を完了します。必要に応じて、オートチャージを設定します。

    請求先アカウントに前払いクレジットがまだ設定されていない場合は、クレジットを購入する必要があります。キャンセルすると、サブスクリプションは作成されず、請求も行われません。詳細については、プリペイド クレジットを管理するをご覧ください。

サブスクリプションを管理

このセクションでは、Gemini Enterprise サブスクリプションを表示、更新、配布、再利用する方法について説明します。

定期購入の詳細を表示

Gemini Enterprise サブスクリプションの詳細を表示する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] をクリックします。

  3. プルダウン メニューから請求先アカウントを選択します。

  4. [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: この API 呼び出しの課金と割り当ての帰属に使用されるプロジェクト番号または ID。このプロジェクトに対する Service Usage コンシューマーのロールが必要です。

  • 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] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] をクリックします。

  3. [Gemini のサブスクリプション] テーブルで、更新するサブスクリプションをクリックします。

  4. [サブスクリプションの詳細] の横にある [編集] をクリックします。

  5. ライセンス数を更新したり、自動更新をオンまたはオフにしたりします。

  6. [送信] をクリックします。

サブスクリプションを解約する

Gemini Enterprise サブスクリプションを解約するには、自動更新をオフにする必要があります。サブスクリプションは、サブスクリプション期間が終了するまで有効です。その日までは料金が発生する可能性があります。サブスクリプションについて詳しくは、定期購入の詳細を表示をご覧ください。

サブスクリプションを解約する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] をクリックします。

  3. [Gemini のサブスクリプション] テーブルで、サブスクリプションの名前をクリックして、サブスクリプションの詳細ページを開きます。

  4. [編集] をクリックします。

  5. [サブスクリプションの編集] パネルで、[サブスクリプションを自動更新する] チェックボックスをオフにします。

  6. [送信] をクリックします。

ライセンスを配布する

サブスクリプション ライセンスをプロジェクトに配布していない場合（サブスクリプションをオフラインで購入した場合や、以前にライセンスの配布が失敗した場合など）は、次の操作を行います。

コンソール

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] をクリックします。

  3. プルダウン メニューから請求先アカウントを選択します。

  4. [Gemini のサブスクリプション] テーブルで、サブスクリプションの名前をクリックします。

  5. ページ上部の [ライセンスを配布] をクリックします。 リストが表示され、既存のライセンス配布と、残りのシート数および合計シート数の統計情報が表示されます。

  6. プロジェクトにライセンスを配布するには:

    1. プロジェクト セレクタをクリックしてプロジェクトを選択します。セレクタは予測入力をサポートしています。
    2. 注: 選択したプロジェクトで Discovery Engine API が有効になっていない場合は、有効にするように求めるダイアログが表示されます。
    3. [ロケーション] を選択します。
    4. 割り当てるライセンス数を入力します。
    5. 複数のプロジェクトまたはロケーションにライセンスを配布する場合は、これらの手順を繰り返します。

  7. [送信] をクリックします。

  8. 確認ダイアログで、変更の概要を確認し、[確認] をクリックします。

REST

1 つまたは複数のプロジェクトにライセンスを配布するには、次のコマンドを実行します。

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。このプロジェクトに対する Service Usage コンシューマーのロールが必要です。プロジェクトで Discovery Engine が有効になっている場合は、TARGET_PROJECT_NUMBER を使用できます。

  • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。

    • 米国のマルチリージョンの場合は us
    • EU のマルチリージョンの場合は 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。この ID は、サブスクリプションの詳細を表示すると、licenseConfigDistributions フィールドで確認できます。

サブスクリプションの未割り当てライセンスを回収する

このセクションでは、プロジェクトから未割り当てのライセンスを回収し、請求先アカウントで他のプロジェクトに再配布できるようにする方法について説明します。

コンソール

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [サブスクリプションを管理] をクリックします。

  3. プルダウン メニューから請求先アカウントを選択します。

  4. [Gemini のサブスクリプション] テーブルで、サブスクリプションの名前をクリックします。

  5. ページ上部の [ライセンスを配布] をクリックします（このボタンをクリックすると、すべての割り当ての管理フォームが開きます）。

  6. 割り当てのリストで、ライセンスを回収するプロジェクトとロケーションの行を見つけます。

  7. 次のいずれかの操作を選択します。

    • ライセンス数を減らすには、ライセンス入力フィールドの数を減らします。
    • ライセンスを完全に回収するには、行にポインタを合わせて削除ボタンを表示し、[削除] をクリックします。

  8. [送信] をクリックします。

  9. 確認ダイアログで、変更の概要（回収されるライセンスが一覧表示されます）を確認し、[確認] をクリックします。

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。このプロジェクトに対する Service Usage コンシューマーのロールが必要です。プロジェクトで Discovery Engine が有効になっている場合は、TARGET_PROJECT_NUMBER を使用できます。

  • ENDPOINT_LOCATION: API リクエストのマルチリージョン。次のいずれかの値を指定します。

    • 米国のマルチリージョンの場合は us
    • EU のマルチリージョンの場合は 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。

早期終了を処理する

異なるサブスクリプション タイプ間で移行する場合や、請求先アカウントに問題がある場合、サブスクリプションが予定より早く終了することがあります。

移行をスムーズに行い、サービスの中断を防ぐため、影響を受けるライセンスが完全に期限切れになる前に、1 週間（7 日間）の猶予期間が設けられます。この期間中、ライセンスは無効化状態になります。この猶予期間中は、新しいサブスクリプションに移行する間もサービスを引き続き使用できます。

ユーザーが引き続きアクセスできるようにするには、ライセンスを新しい有効なサブスクリプションに自動または手動で移行します。

次の画像は、Google Cloud コンソールでライセンスを無効にする例を示しています。

Google Cloud コンソールでライセンスを無効にする例

ユーザー ライセンスを管理する

このセクションでは、ライセンスの表示、ユーザーデータのエクスポート、個々のユーザーへのライセンスの割り当て、移行、削除を行う方法について説明します。

ライセンスの表示

ライセンスと、それに割り当てられているユーザーを表示するには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. [ユーザーの管理] をクリックします。

  3. 既存のライセンスの [マルチリージョン] を選択します。

ユーザーデータをエクスポートする

Google Cloud コンソールのユーザー テーブルでは、並べ替えやフィルタリングはサポートされていません。ユーザーデータの並べ替え、フィルタ、分析が必要な場合は、最大 100 万件のユーザー レコードをカンマ区切り値（CSV）ファイルにエクスポートできます。

エクスポートされた CSV ファイルには、次の列が含まれます。

列名 説明
user_principal ユーザーのメールアドレス。
license_config ユーザーに割り当てられたサブスクリプションの完全な Google Cloud リソース名（例: projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID）。ライセンス構成 ID は、ユーザーに割り当てられた Gemini Enterprise エディション（Standard、Plus など）に対応しています。
assignment_time 管理者がライセンスを割り当てたときのタイムスタンプ（UTC）。
last_login_time ユーザーが最後にログインしたときのタイムスタンプ（UTC）。
license_assignment_state ライセンス割り当ての状態。指定できる値は次のとおりです。
  • ASSIGNED: ユーザーにライセンスが割り当てられています。
  • NO_LICENSE: 管理者がライセンスを割り当てていないか、既存のライセンスを削除したため、ユーザーにライセンスがありません。
  • BLOCKED: ポリシーまたは管理者が、ユーザーがライセンスを受け取ることをブロックしています。

ユーザーデータを CSV ファイルにエクスポートする手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] > [ユーザーの管理] ページに移動します。

    ユーザーを管理する

  2. 既存のライセンスの [マルチリージョン] を選択します。

  3. [ユーザー] セクションで、[すべてのユーザーをエクスポート] をクリックします。

    ユーザー テーブルのサイズによっては、エクスポート プロセスが完了するまでに最大 2.5 分かかることがあります。この間、コンソールには読み込み状態が表示されます。エクスポートが完了すると、ブラウザは CSV ファイルをデフォルトのダウンロード場所にダウンロードします。

エクスポートに関する問題のトラブルシューティング

次の表に、ユーザーデータのエクスポートに関する一般的な問題とその解決策を示します。

問題 解決策
[すべてのユーザーをエクスポート] ボタンが非表示になっている 選択したマルチリージョンでライセンスに割り当てられているユーザーが存在することを確認します。割り当てられたユーザーがいない場合、[すべてのユーザーをエクスポート] ボタンは表示されません。
エクスポート リクエストが上限超過エラーで失敗する ユーザーリストがエクスポートの上限である 1,000,000 ユーザーを超えると、 Google Cloud コンソールはエクスポート リクエストを拒否し、上限超過のエラー メッセージを表示します。
エクスポート リクエストが権限拒否エラーで失敗する アカウントに、必要な discoveryengine.userStores.listUserLicenses 権限を含む Gemini Enterprise 管理者ロールがあることを確認します。

ユーザーにライセンスを割り当てる

このセクションでは、新規ユーザーにライセンスを自動または手動で割り当てる方法について説明します。新規ユーザーへのライセンスの割り当ては随時行うことができます。ライセンスを割り当てると、そのユーザーはすぐに Gemini Enterprise を利用できるようになります。

ユーザーを追加してライセンスを自動的に割り当てる

ユーザーが Gemini Enterprise app にログインしたときにライセンスを自動的に割り当てるには、次の操作を行います。

  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. [ユーザーを追加] をクリックします。

  5. [ユーザーを追加] ページで次の操作を行います。

    1. ユーザーのメールアドレスを入力します。Gemini Enterprise app へのログインに使用するメールアドレスと同じメールアドレスを使用してください。

    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 のマルチリージョンの場合は eu
    • グローバル ロケーションの場合は global
    詳細については、データストアのマルチリージョンを指定するをご覧ください。
  • LOCATION: データストアのマルチリージョン（global、us、eu）
  • USER_EMAIL: ライセンスに追加するユーザーのメールアドレス。
  • PROJECT_NUMBER: Google Cloud プロジェクトの数。
  • SUBSCRIPTION_ID: Gemini Enterprise サブスクリプションの ID。

期限切れのサブスクリプションからライセンスを移行する

サブスクリプションの有効期限が切れている場合、ユーザーは Gemini Enterprise にログインできません。ログイン アクセス権を復元するには、次の 2 つの方法があります。

ユーザーを有効なサブスクリプションに自動的に移行する

ユーザーを有効なサブスクリプションに自動的に移行するには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] > [ユーザーの管理] ページに移動します。

    Gemini Enterprise ライセンス

  2. 既存のライセンスの [マルチリージョン] を選択します。

  3. 有効なサブスクリプションがあることを確認します。お持ちでない場合は、サブスクリプションを取得してください。

  4. [ライセンスを自動的に割り当てる] を選択し、有効なサブスクリプションを選択します。

  5. [期限切れのライセンスを自動更新する] を選択します。

    ライセンスの有効期限が切れたユーザーが次にログインすると、Gemini Enterprise は選択したサブスクリプションのライセンスを自動的に付与します。

ユーザーを有効なサブスクリプションに手動で移行する

ユーザーを有効なサブスクリプションに手動で移行するには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] > [ユーザーの管理] ページに移動します。

    Gemini Enterprise ライセンス

  2. 既存のライセンスの [マルチリージョン] を選択します。

  3. 有効なサブスクリプションがあることを確認します。お持ちでない場合は、サブスクリプションを取得してください。

  4. ユーザーを選択し、[別のライセンスを割り当てる] をクリックします。

  5. [ユーザーの編集] ペインで、サブスクリプションを選択して [送信] をクリックします。

ライセンスを一覧表示する

ライセンスと、それに割り当てられているユーザーを一覧表示するには、次のコマンドを実行します。

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 のマルチリージョンの場合は eu
    • グローバル ロケーションの場合は global
    詳細については、データストアのマルチリージョンを指定するをご覧ください。
  • LOCATION: データストアのマルチリージョン（global、us、eu）

ライセンスからユーザーを削除する

ライセンスはいつでもユーザーから削除できます。ライセンスを削除すると、そのユーザーは即座に Gemini Enterprise へのアクセス権を失います。ライセンスからユーザーを削除する手順は次のとおりです。

コンソール

Google Cloud コンソールを使用してライセンスからユーザーを削除するには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] > [ユーザーの管理] ページに移動します。

    Gemini Enterprise ライセンス

  2. 既存のライセンスの [マルチリージョン] を選択します。

  3. ユーザー テーブルでユーザーを選択します。

  4. ライセンスからユーザーを削除するには、次のいずれかを行います。

    • 選択したユーザーからライセンスを削除するだけの場合は、[ライセンスの割り当てを解除します] をクリックします。
    • ライセンスを削除し、選択したユーザーをプロジェクトから削除するには、[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 のマルチリージョンの場合は eu
    • グローバル ロケーションの場合は global
    詳細については、データストアのマルチリージョンを指定するをご覧ください。
  • LOCATION: データストアのマルチリージョン（global、us、eu）
  • USER_EMAIL: ライセンスから削除するユーザーのメールアドレス。

次のステップ