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

コンソール

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

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

2. [Gemini の管理] ページに移動し、Gemini Code Assist Standard または Enterprise サブスクリプションの請求先アカウントに関連付けられているプロジェクトを選択します。

   [Gemini for Google Cloud] に移動

3. 変更するサブスクリプションを選択して、[サブスクリプションを変更] を選択します。

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

   • 名前。
   • メール。
   • ライセンスが割り当てられた日付。
   • ライセンスが最後に使用された日時。

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

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

API

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

1. ライセンス割り当てを表示するライセンス プールを含む請求先アカウントに対する consumerprocurement.licensePools.enumerateLicensedUsers IAM 権限があることを確認します。

2. cURL を使用してメソッドを呼び出します。

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:enumerateLicensedUsers/"
   

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

   • PROJECT_ID: プロジェクトの ID。API リクエストに関連付けられた割り当ての使用量と料金は、このプロジェクトに適用されます。
   • BILLING_ACCOUNT_ID: ライセンス プールに関連付けられている請求先アカウントの ID。
   • ORDER_ID: オーダー ID。オーダー ID がわからない場合は、請求先アカウントに関連付けられているオーダーのリストを表示して取得できます。

このコマンドが成功すると、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 Code Assist Standard または Enterprise のライセンス割り当てがない場合、または ORDER_ID が無効な場合、次の形式で licensedUsers 出力が返されます。

{}

コンソール

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

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

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

   [Gemini for Google Cloud] に移動

3. [Gemini Code Assist を管理]、[サブスクリプションを変更] の順に選択します。

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

5. [Add licensed user] を選択します。ユーザー選択のダイアログが表示されます。@gmail.com、@googlegroups.com、Google Workspace ドメインなど、個人の Google アカウントのメールアドレスのみがサポートされています。Workforce Identity 連携（BYOID）はサポートされていません。

6. [Add licensed user] を選択します。

7. ライセンスを持つユーザーに対して、Gemini for Google Cloud ユーザーと Service Usage ユーザーの IAM ロールを付与していることを確認します。

API

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

1. 割り当てるライセンスのライセンス プールを含む請求先アカウントに対して、次の IAM 権限があることを確認します。

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

1. 次の情報が含まれる JSON ファイルを作成します。

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   USER_EMAILS は、ライセンスが割り当てられているユーザー アカウントのカンマ区切りリストに置き換えます（例: "dana@example.com", "lee@example.com"）。@gmail.com、@googlegroups.com、Google Workspace ドメインなど、個人の Google アカウントのメールアドレスのみがサポートされています。Workforce Identity 連携（BYOID）はサポートされていません。

2. cURL を使用してメソッドを呼び出します。

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

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

   • JSON_FILE_NAME: 手順 2 で作成した JSON ファイルのパス。
   • PROJECT_ID: プロジェクトの ID。API リクエストに関連付けられた割り当ての使用量と料金は、このプロジェクトに適用されます。
   • BILLING_ACCOUNT_ID: ライセンス プールに関連付けられている請求先アカウントの ID。
   • ORDER_ID: オーダー ID。オーダー ID がわからない場合は、請求先アカウントに関連付けられているオーダーの一覧を表示して取得できます。

成功すると、レスポンスは次のようになります。

{}

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

次に、ライセンスを持つユーザーに対して、Gemini for Google Cloud ユーザーと Service Usage ユーザーの IAM ロールを付与していいることを確認します。

コンソール

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

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

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

   [Gemini for Google Cloud] に移動

3. [Gemini Code Assist を管理]、[サブスクリプションを管理] の順に選択します。

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

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

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

API

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

1. このタスクを行うには、ライセンスの割り当てを解除するライセンス プールを含む請求先アカウントに対する consumerprocurement.licensePools.unassign Identity and Access Management（IAM）権限が必要です。

2. 次の情報が含まれる JSON ファイルを作成します。

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   USER_EMAILS は、ライセンスが割り当てられているユーザー アカウントのカンマ区切りリストに置き換えます（例: "dana@example.com", "lee@example.com"）。

3. cURL を使用してメソッドを呼び出します。

   curl -X POST --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   -H "Content-Type: application/json" \
   "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:unassign/"

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

   • JSON_FILE_NAME: 手順 2 で作成した JSON ファイルのパス。
   • PROJECT_ID: プロジェクトの ID。API リクエストに関連付けられた割り当ての使用量と料金は、このプロジェクトに適用されます。
   • BILLING_ACCOUNT_ID: ライセンス プールに関連付けられている請求先アカウントの ID。
   • ORDER_ID: オーダー ID。オーダー ID がわからない場合は、請求先アカウントに関連付けられているオーダーの一覧を表示して取得できます。

成功すると、レスポンスは次のようになります。

{}

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