Gemini Code Assist Standard- und Enterprise-Lizenzen verwalten

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Administrator für Gemini auf und wählen Sie das Projekt aus, das mit Ihrem Rechnungskonto mit dem Gemini Code Assist Standard- oder Enterprise-Abo verknüpft ist.

   Zu Gemini für Google Cloud

3. Wählen Sie das Abo aus, das Sie ändern möchten, und klicken Sie dann auf Abo ändern.

   Für jeden Nutzer, dem eine Lizenz zugewiesen wurde, sind die folgenden Informationen verfügbar:

   • Name
   • E‑Mails,
   • Datum, an dem die Lizenz zugewiesen wurde.
   • Datum und Uhrzeit der letzten Verwendung der Lizenz.

4. Wenn Sie eine bestimmte Gruppe von Nutzern finden möchten, können Sie die Liste so filtern und sortieren:

   • Geben Sie zum Filtern der Liste die gewünschten Attribute und Werte in das Feld Filter ein.
   • Zum Sortieren der Liste wählen Sie die Überschrift der Spalte aus, nach der Sie sortieren möchten. Wenn Sie beispielsweise alphabetisch nach den Nutzernamen sortieren möchten, wählen Sie die Spaltenüberschrift Name aus.

API

Wenn Sie die Zuweisungen von Gemini Code Assist Standard- oder Enterprise-Lizenzen aufrufen möchten, verwenden Sie die Methode billingAccounts.orders.licensePool.enumerateLicensedUsers.

1. Sie benötigen die IAM-Berechtigung consumerprocurement.licensePools.enumerateLicensedUsers für das Rechnungskonto, das den Lizenzpool enthält, dessen Lizenzzuweisungen Sie aufrufen möchten.

2. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das mit dem Lizenzpool verknüpft ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Rechnungskonto verknüpften Bestellungen auflisten.

Bei erfolgreicher Ausführung gibt dieser Befehl licensedUsers-Diagnoseinformationen im nachfolgend dargestellten Format aus:

{
  "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"
      }
  ]
}

Wenn keine Gemini Code Assist Standard- oder Enterprise-Lizenzen zugewiesen sind oder die ORDER_ID ungültig ist, wird die licensedUsers-Ausgabe im folgenden Format zurückgegeben:

{}

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Administrator für Gemini auf.

   Zu Gemini für Google Cloud

3. Wählen Sie Gemini Code Assist verwalten und dann Abo ändern aus.

4. Prüfen Sie, ob Sie für dieses Gemini Code Assist Standard- oder Enterprise-Abo Lizenzzuweisung auf Lizenzen manuell zuweisen festgelegt haben. Wenn das Abo für Gemini Code Assist Standard oder Enterprise auf Lizenzen automatisch zuweisen eingestellt ist, können Sie einzelne Lizenzen nicht verwalten. Wenn Sie dieses Rechnungskonto auf Lizenzen manuell zuweisen umstellen, wird die automatische Lizenzzuweisung nach der Änderung deaktiviert. Vorhandene Lizenzzuweisungen sind davon jedoch nicht betroffen.

5. Wählen Sie Lizenzierten Nutzer hinzufügen aus. Ein Dialogfeld zur Auswahl von Nutzern wird angezeigt. Es werden nur E‑Mail-Adressen für individuelle Google-Konten unterstützt, z. B. @gmail.com, @googlegroups.com und Google Workspace-Domains. Die Mitarbeiteridentitätsföderation (BYOID) wird nicht unterstützt.

6. Wählen Sie Lizenzierten Nutzer hinzufügen aus.

7. Prüfen Sie, ob Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zuweisen.

API

Verwenden Sie die Methode billingAccounts.orders.licensePool.assign, um Lizenzen für Gemini Code Assist Standard und Enterprise zuzuweisen.

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Rechnungskonto haben, das den Lizenzpool enthält, dessen Lizenz Sie zuweisen möchten:

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

1. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ersetzen Sie USER_EMAILS durch eine durch Kommas getrennte Liste von Nutzerkonten, denen die Lizenz zugewiesen wird, z. B. "dana@example.com", "lee@example.com". Es werden nur E‑Mail-Adressen für individuelle Google-Konten unterstützt, z. B. @gmail.com, @googlegroups.com und Google Workspace-Domains. Die Mitarbeiteridentitätsföderation (BYOID) wird nicht unterstützt.

2. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"

   Ersetzen Sie Folgendes:

   • JSON_FILE_NAME: der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das mit dem Lizenzpool verknüpft ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Rechnungskonto verknüpften Bestellungen auflisten.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

{}

Sehen Sie sich die Liste der Zuweisungen an, um die Zuweisung zu überprüfen.

Prüfen Sie dann, ob Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zugewiesen haben.

Console

1. Prüfen Sie, ob Sie die folgenden IAM-Berechtigungen für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie die Seite Administrator für Gemini auf.

   Zu Gemini für Google Cloud

3. Wählen Sie Gemini Code Assist verwalten und dann Abo verwalten aus.

4. Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung verwalten aus. Das Dialogfeld Automatische Lizenzzuweisung verwalten wird angezeigt.

5. Wählen Sie die Nutzer aus, für die Sie die Zuweisung von Lizenzen aufheben möchten, und wählen Sie dann Zuweisung von Lizenz aufheben aus.

6. Wähle Bestätigen aus.

API

Wenn Sie die Zuweisung von Gemini Code Assist Standard- und Enterprise-Lizenzen aufheben möchten, verwenden Sie die Methode billingAccounts.orders.licensePool.unassign.

1. Für diese Aufgabe benötigen Sie die IAM-Berechtigung (Identity and Access Management) consumerprocurement.licensePools.unassign für das Rechnungskonto, das den Lizenzpool enthält, dessen Lizenz Sie aufheben möchten.

2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ersetzen Sie USER_EMAILS durch eine durch Kommas getrennte Liste von Nutzerkonten, denen die Lizenz zugewiesen wird, z. B. "dana@example.com", "lee@example.com".

3. Verwenden Sie cURL, um die Methode aufzurufen:

   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/"

   Ersetzen Sie Folgendes:

   • JSON_FILE_NAME: der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.
   • PROJECT_ID: die ID für ein Projekt. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angerechnet.
   • BILLING_ACCOUNT_ID: die ID des Rechnungskontos, das mit dem Lizenzpool verknüpft ist.
   • ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Rechnungskonto verknüpften Bestellungen auflisten.

Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:

{}

Rufen Sie die Liste der Zuweisungen auf, um die Aufhebung der Zuweisung zu überprüfen.