Gemini for Google Cloud のライセンスを管理する

特定の Gemini for Google Cloud プロダクト（Gemini Code Assist など）を使用するには、組織内の各ユーザーにライセンスが必要です。

始める前に

請求先アカウント管理者（roles/billing.admin）または消費者調達注文管理者（roles/consumerprocurement.orderAdmin）の IAM ロールを付与されていることを確認してください。これにより、次のセクションで説明する特定のライセンス管理タスクに必要な追加の権限を付与できます。

Google Cloud コンソールではなく API を使用してライセンスを管理する場合は、次の点を確認してください。
- 請求先アカウントの割り当てプロジェクトを設定します。
- 割り当てプロジェクトで Cloud Commerce Consumer Procurement API を有効にしました。
- すべての API 呼び出しに次のヘッダー Key-Value ペアが存在することを確認します。
  - Authorization: Google Cloud CLI の Google Cloud アクセストークン
  - x-goog-user-project: 割り当てプロジェクトのプロジェクト ID。

サブスクリプション内の Gemini for Google Cloud ライセンス数を変更する

Gemini for Google Cloud ライセンスの数は、Google Cloud コンソール、Google アカウント担当者、または正規の販売店から直接追加または削除できます。

このタスクを実行するには、次の Identity and Access Management（IAM）権限が必要です。

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.orders.modify

サブスクリプションのライセンス数を変更する手順は次のとおりです。

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

Gemini の管理に移動
変更する定期購入を選択し、[定期購入を変更] をクリックします。
必要なライセンス数を入力します。次の情報が表示されます。
- 購入後の合計ライセンス数。
- 購入後に割り当て可能なライセンス数。
- 期間ごとの新しい定期購入価格。追加ライセンスの追加料金は、現在の期間の残り日数に基づいて按分されます。
[保存] をクリックします。

Gemini for Google Cloud のライセンスの割り当てを表示する

コンソール

Google Cloud コンソールで Gemini for Google Cloud ライセンスの割り当てを表示するには、次の権限が必要です。

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers

[Gemini の管理] ページに移動します。

Gemini の管理に移動
変更する定期購入を選択し、[定期購入を変更] をクリックします。

ライセンスが割り当てられている各ユーザーについて、次の情報を確認できます。
- 名前
- メール
- アカウントの種類
- 割り当て済みのライセンス
特定のユーザーセットを検索するには、次のようにリストをフィルタして並べ替えます。
- リストをフィルタするには、[フィルタ] フィールドにプロパティと値を入力します。
- リストを並べ替えるには、並べ替えるキーの列見出しをクリックします。たとえば、ユーザー名のアルファベット順に並べ替えるには、[名前] 列の見出しをクリックします。

API

Gemini for Google Cloud のライセンス割り当てを表示するには、billingAccounts.orders.licensePool.enumerateLicensedUsers メソッドを使用します。

このタスクを実行するには、consumerprocurement.licensePools.enumerateLicensedUsers 権限が必要です。

GET https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/

以下を置き換えます。

BILLING_ACCOUNT_ID: 請求先アカウント ID
ORDER_ID: IAM ポリシー

このコマンドが成功すると、licensedUsers の出力が次の形式で返されます。

{
  "licensedUsers": [
      {
          "username": "dana@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "lee@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "taylor@example.com",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "bola@example.com",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

個々のユーザーに Gemini for Google Cloud ライセンスを割り当てる

コンソール

Google Cloud コンソールで Gemini for Google Cloud ライセンスを個々のユーザーに割り当てるには、次の権限が必要です。

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.assign

[Gemini の管理] ページに移動します。

Gemini の管理に移動
変更する定期購入を選択し、[定期購入を変更] をクリックします。
[ライセンスを割り当て] をクリックします。ユーザー選択ダイアログが表示されます。特定のユーザーを検索するには、検索ボックスに名前を入力します。
リストから 1 人以上のユーザーを選択し、[次へ] をクリックします。
ライセンスを割り当てる Gemini for Google Cloud サービスを選択します。
[ライセンスを割り当て] をクリックします。

API

Gemini for Google Cloud ライセンスを割り当てるには、billingAccounts.orders.licensePool.assign メソッドを使用します。

このタスクを実行するには、consumerprocurement.licensePools.assign 権限が必要です。

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

以下を置き換えます。

BILLING_ACCOUNT_ID: 請求先アカウント ID
ORDER_ID: IAM ポリシー

コマンドが成功すると、空のレスポンス本文が次の形式で返されます。

{}

割り当てを確認するには、課題のリストを表示します。

Gemini for Google Cloud ライセンスの割り当てを解除する

コンソール

Google Cloud コンソールでユーザーからライセンスを割り当て解除するには、次の権限が必要です。

billing.accounts.get
consumerprocurement.orders.get
consumerprocurement.licensePools.get
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.unassign

[Gemini の管理] ページに移動します。

Gemini の管理に移動
変更する定期購入を選択し、[定期購入を管理] をクリックします。
ライセンスを割り当て解除するユーザーを選択し、[ライセンスを割り当て解除] をクリックします。
[変更を確認] をクリックします。

API

Gemini for Google Cloud ライセンスを割り当て解除するには、billingAccounts.orders.licensePool.unassign メソッドを使用します。

このタスクを実行するには、consumerprocurement.licensePools.unassign 権限が必要です。

POST https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/

{
  "usernames": [
            "dana@example.com",
            "lee@example.com"
  ]
}

以下を置き換えます。

BILLING_ACCOUNT_ID: 請求先アカウント ID
ORDER_ID: IAM ポリシー

コマンドが成功すると、空のレスポンス本文が次の形式で返されます。

{}

割り当てが解除されたことを確認するには、割り当てリストを表示します。

Gemini for Google Cloud ライセンスを移行する

Gemini for Google Cloud ライセンスをユーザー間で直接移行することはできません。代わりに、ユーザーからライセンスの割り当てを解除してから、新しいユーザーにライセンスを割り当ててください。

組織間のライセンス使用を防止する

Gemini for Google Cloud ライセンスは、組織やプロジェクトではなく個々のユーザーに割り当てられます。これにより、個々のユーザーは複数の組織で Gemini for Google Cloud 機能を使用できます。

Gemini for Google Cloud から生成されたログは、使用が発生したプロジェクトに関連付けられ、ライセンシーには関連付けられません。また、Gemini for Google Cloud のカスタマイズや構成（Gemini Code Assist コードのカスタマイズなど）は、ライセンスまたはサブスクリプションレベルではなく、プロジェクトで行う必要があります。

プロジェクトで Gemini for Google Cloud を組織間で使用しないようにするには、次のいずれかを行います。

プロジェクトで Gemini for Google Cloud API を無効にします。
権限を使用して、ユーザーによるプロジェクトへのアクセスを拒否する。

制限事項

Gemini for Google Cloud ライセンス管理は、Workforce Identity 連携をサポートしていません。