Gemini Code Assist ライセンスを管理する

Gemini Code Assist を使用するには、組織内の各ユーザーにライセンスが必要です。

新しいサブスクリプションの場合、デフォルトでは、ライセンスを手動で割り当てる必要があります。特定の Gemini for Google Cloud プロダクトを設定したら、ライセンスを手動または自動で割り当てることができます。

始める前に

• 請求先アカウント管理者（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 Code Assist ライセンス数を変更する

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

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

1. サブスクリプションを所有する請求先アカウントに対して、次の Identity and Access Management（IAM）権限があることを確認します。

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.orders.modify
   • resourcemanager.projects.get

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

   [Gemini の管理] に移動

3. 変更する定期購入を選択し、[定期購入を変更] を選択します。

4. 必要なライセンス数を入力します。次の情報が表示されます。

   • 購入後の合計ライセンス数。
   • 購入後に割り当て可能なライセンス数。
   • 期間ごとの新しい定期購入価格。追加ライセンスの追加料金は、現在の期間の残り日数に基づいて按分されます。

5. [保存] を選択します。

Gemini Code Assist ライセンスの割り当てを表示する

次のオプションのいずれかを選択します。

コンソール

1. サブスクリプションを所有する請求先アカウントに対する次の IAM 権限があることを確認します。

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • resourcemanager.projects.get

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

   [Gemini の管理] に移動

3. 変更する定期購入を選択し、[定期購入を変更] を選択します。

   ライセンスが割り当てられている各ユーザーについて、次の情報を確認できます。

   • 名前
   • メール
   • アカウントの種類
   • 割り当て済みのライセンス

4. 特定のユーザー セットを検索するには、次のようにリストをフィルタして並べ替えます。

   • リストをフィルタするには、[フィルタ] フィールドにプロパティと値を入力します。
   • リストを並べ替えるには、並べ替える列の見出しを選択します。たとえば、ユーザー名をアルファベット順に並べ替えるには、[名前] 列の見出しを選択します。

API

Gemini Code Assist ライセンスの割り当てを表示するには、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": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:40.559222Z"
      },
      {
          "username": "[e-mail]",
          "assignTime": "2024-09-26T16:24:14.610828Z"
      }
  ]
}

Gemini Code Assist ライセンスを個々のユーザーに手動で割り当てる

次のオプションのいずれかを選択します。

コンソール

1. サブスクリプションを所有する請求先アカウントに対する次の IAM 権限があることを確認します。

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.assign
   • resourcemanager.projects.get

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

   [Gemini の管理] に移動

3. [Gemini Code Assist を管理]、[定期購入を変更] の順に選択します。

4. この Gemini Code Assist サブスクリプションの [ライセンスの割り当て] を [ライセンスを手動で割り当てる] に設定します。Gemini Code Assist サブスクリプションが [ライセンスを自動的に割り当てる] に設定されている場合、個々のライセンスを管理することはできません。この請求先アカウントを [ライセンスを手動で割り当てる] に切り替えると、変更後にライセンスの自動割り当てが無効になりますが、既存のライセンスの割り当てには影響しません。

5. [ライセンスを割り当てる] を選択します。ユーザー選択のダイアログが表示されます。特定のユーザーを検索するには、メールアドレスを入力して [次へ] を選択します。

6. [ライセンスを割り当て] を選択します。

API

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

このタスクを実行するには、サブスクリプションを所有する請求先アカウントに対する次の権限があることを確認します。

• billing.accounts.get
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.unassign
• consumerprocurement.orders.get

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

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

次のように置き換えます。

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

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

{}

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

Gemini Code Assist ライセンスを自動的に割り当てる

[ライセンスの割り当て] ページで、Gemini Code Assist へのアクセスが必要な組織内のすべてのユーザーにライセンスを自動的に割り当てることができます。ライセンスの自動割り当ては、サブスクリプションごとに個別に設定します。

Gemini Code Assist のライセンスを自動的に割り当てる場合、そのアカウントの個々のユーザー ライセンスを削除または追加することはできません。ライセンスが割り当てられているユーザーが Gemini Code Assist の機能を使用していない場合、管理者が設定した一定の日数経過後に、請求期間の終了時に自動的にプロビジョニング解除されます。

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

   [Gemini の管理] に移動

2. [Manage Gemini Code Assist]、[Manage Subscription] の順に選択します。

3. [ライセンス管理]、[自動ライセンス割り当てを有効にする] の順に選択します。[自動ライセンスを有効にする] ダイアログが表示されます。

   このサブスクリプションをライセンスの自動割り当てに切り替えると、変更後に手動ライセンス割り当てが無効になりますが、既存のライセンス割り当てには影響しません。

4. 割り当て先がアクティブでない場合の、ライセンスの割り当て解除までの時間を設定し、[変更を確定] を選択します。[ライセンスの自動割り当てが有効になりました] ダイアログが表示されます。

5. [閉じる] を選択します。

ライセンスが割り当て可能な限り、新規ユーザーがこの請求先アカウントのサブスクリプションに含まれる Gemini Code Assist に初めてアクセスしたときに、ライセンスが自動的に付与されます。

ライセンスの自動割り当てを無効にする手順は次のとおりです。

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

   [Gemini の管理] に移動

2. [Manage Gemini Code Assist]、[Manage Subscription] の順に選択します。

3. [ライセンス管理]、[自動ライセンス割り当ての管理] の順に選択します。[ライセンスの自動割り当てを管理] ダイアログが表示されます。

4. [自動ライセンス管理を無効にする] を選択します。

5. [変更を確認] を選択します。

Gemini Code Assist ライセンスを手動で割り当て解除する

次のオプションのいずれかを選択します。

コンソール

1. サブスクリプションを所有する請求先アカウントに対する次の IAM 権限があることを確認します。

   • billing.accounts.get
   • consumerprocurement.orders.get
   • consumerprocurement.licensePools.get
   • consumerprocurement.licensePools.enumerateLicensedUsers
   • consumerprocurement.licensePools.unassign
   • resourcemanager.projects.get

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

   [Gemini の管理] に移動

3. [Manage Gemini Code Assist]、[Manage Subscription] の順に選択します。

4. [ライセンス管理]、[自動ライセンス割り当ての管理] の順に選択します。[ライセンスの自動割り当てを管理] ダイアログが表示されます。

5. ライセンスを割り当て解除するユーザーを選択し、[ライセンスを割り当て解除] を選択します。

6. [確認] を選択します。

API

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

このタスクを実行するには、サブスクリプションを所有する請求先アカウントに対する consumerprocurement.licensePools.unassign 権限が必要です。

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

{
  "usernames": [
            "[e-mail]",
            "[e-mail]"
  ]
}

次のように置き換えます。

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

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

{}

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

Gemini Code Assist ライセンスを移行する

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

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

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

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

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

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

制限事項

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