Gemini Code Assist Standard- und Enterprise-Lizenzen verwalten

Für die Nutzung von Gemini Code Assist Standard und Enterprise benötigt jeder Nutzer in Ihrer Organisation eine Lizenz.

Standardmäßig ist die automatische Lizenzzuweisung für alle Abos aktiviert. Nutzern in Ihrer Organisation mit den erforderlichen Berechtigungen wird automatisch eine Lizenz zugewiesen, wenn sie Gemini Code Assist in einer unterstützten IDE verwenden. Diese Berechtigungen werden weiter unten in diesem Dokument beschrieben. Nachdem Sie bestimmte Gemini for Google Cloud -Produkte eingerichtet haben, können Sie Lizenzen manuell zuweisen oder mit der automatischen Zuweisung fortfahren.

Sie können allen Nutzern, die Zugriff auf ein Projekt haben, das mit dem entsprechenden Rechnungskonto verknüpft ist, Lizenzen zuweisen.

Hinweis: Sie können einem Nutzer mit Premium-Abo für das Google Developer Program keine Gemini Code Assist Standard-Nutzerlizenz zuweisen, da diese bereits in seinem Abo enthalten ist.

Hinweis

• Sie benötigen die IAM-Rollen „Billing Account Administrator“ (roles/billing.admin) oder „Consumer Procurement Order Administrator“ (roles/consumerprocurement.orderAdmin), damit Sie weitere Berechtigungen für bestimmte Lizenzverwaltungsaufgaben im Rechnungskonto erteilen können. Weitere Informationen finden Sie in den folgenden Abschnitten.

• Vergewissern Sie sich, dass Gemini Code Assist eingerichtet ist.

• Wenn Sie Lizenzen lieber über eine API als über die Google Cloud Console verwalten möchten:

  • Richten Sie für Ihr Rechnungskonto ein Kontingentprojekt ein.
  • Aktivieren Sie in Ihrem Kontingentprojekt die Cloud Commerce Consumer Procurement API.
  • Vergewissern Sie sich, dass die folgenden Schlüssel/Wert-Paare für Header in allen API-Aufrufen vorhanden sind:
    • Authorization: Ihr Google Cloud -Zugriffstoken aus der Google Cloud CLI
    • x-goog-user-project: die Projekt-ID Ihres Kontingentprojekts

Anzahl der Gemini Code Assist Standard- und Enterprise-Lizenzen in einem Abo ändern

Sie können Gemini for Google Cloud -Lizenzen direkt über die Google Cloud Console oder mithilfe Ihres Google-Kundenbetreuers oder eines autorisierten Resellers hinzufügen oder entfernen.

So ändern Sie die Anzahl der Lizenzen in einem Abo:

1. Vergewissern Sie sich, dass Sie die folgenden IAM-Berechtigungen (Identity and Access Management) für das Abrechnungskonto haben, zu dem das Abo gehört:

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

2. Rufen Sie in der Google Cloud Console die Seite Administrator für Gemini auf.

   Zu Gemini for Google Cloud

3. Wählen Sie das Abo aus, das Sie ändern möchten, und klicken Sie dann auf Abo ändern. Wenn Sie sich in einem aktiven Testzeitraum befinden, zeigt dieser Button Automatische Verlängerung deaktivieren an.

4. Geben Sie die Anzahl der benötigten Lizenzen ein. Folgendes wird angezeigt:

   • Gesamtanzahl der gekauften Lizenzen
   • Lizenzanzahl, die nach dem Kauf zugewiesen werden kann
   • Neue Abokosten pro Laufzeit. Die zusätzlichen Kosten für die hinzugefügten Lizenzen werden anteilig zur verbleibenden Laufzeit berechnet.

5. Klicken Sie auf Speichern.

Gemini Code Assist Standard- und Enterprise-Lizenzzuweisungen aufrufen

Wählen Sie eine der folgenden Optionen aus:

Console

1. Vergewissern Sie sich, dass 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 für das Gemini Code Assist Standard- oder Enterprise-Abo verknüpft ist.

   Zu Gemini for 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, werden die folgenden Informationen angezeigt:

   • Name
   • E‑Mail-Adresse
   • Datum der Lizenzzuweisung
   • Datum und Uhrzeit der letzten Verwendung der Lizenz

4. Wenn Sie nach einer bestimmte Gruppe von Nutzern suchen, können Sie die Liste folgendermaßen filtern und sortieren:

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

API

Verwenden Sie die Methode billingAccounts.orders.licensePool.enumerateLicensedUsers, wenn Sie die Lizenzzuweisungen für Gemini Code Assist Standard oder Enterprise aufrufen möchten.

1. Sie benötigen die IAM-Berechtigung consumerprocurement.licensePools.enumerateLicensedUsers für das Rechnungskonto mit dem Lizenzpool, dessen Lizenzzuweisungen Sie anzeigen 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 die Informationen zu den licensedUsers im folgenden Format aus:

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

Wenn keine Gemini Code Assist Standard- oder Enterprise-Lizenzen zugewiesen sind oder die ORDER_ID ungültig ist, werden die Informationen zu den licensedUsers im folgenden Format ausgegeben:

{}

Gemini Code Assist Standard- und Enterprise-Lizenzen automatisch zuweisen

Sie können die automatische Lizenzzuweisung für ein Abo aktivieren.

Die automatische Lizenzzuweisung wird nur in VS Code, IntelliJ und anderen unterstützten JetBrains-IDEs unterstützt.

Wenn Sie für Gemini Code Assist Standard oder Enterprise automatisch Lizenzen zuweisen, können Sie in diesem Konto keine einzelnen Nutzerlizenzen entfernen oder hinzufügen. Lizenzen von Nutzern, die keine Gemini Code Assist Standard- oder Enterprise-Funktionen verwenden, werden am Ende des vom Administrator festgelegten Inaktivitätszeitraums automatisch deaktiviert.

1. Rufen Sie in der Google Cloud Console die Seite Administrator für Gemini auf.

   Zu Gemini for Google Cloud

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

3. Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung aktivieren aus. Das Dialogfeld Automatische Lizenzen aktivieren wird angezeigt.

   Wenn Sie für dieses Abo die automatische Lizenzzuweisung aktivieren, wird die manuelle Lizenzzuweisung nach der Änderung deaktiviert. Bereits zugewiesene Lizenzen sind davon jedoch nicht betroffen.

4. Legen Sie fest, nach welchem Zeitraum der Inaktivität eine Lizenz automatisch entfernt werden soll, und wählen Sie dann Änderung bestätigen aus. Das Dialogfeld Automatische Lizenzzuweisung wurde aktiviert wird angezeigt.

   Wenn Sie T Tage Inaktivität festlegen, wird die Zuweisung der Lizenz(en) an Tag T+1 automatisch aufgehoben und sie sind wieder im Lizenzpool verfügbar. Wenn Sie beispielsweise 7 Tage Inaktivität konfigurieren, wird die Zuweisung der Lizenz(en) an Tag 8 aufgehoben und sie sind wieder im Lizenzpool verfügbar.

5. Wählen Sie Schließen aus.

6. Weisen Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zu.

   Nutzer mit der Berechtigung cloudaicompanion.licenses.selfAssign erhalten automatisch eine Lizenz, wenn sie Gemini Code Assist Standard oder Enterprise zum ersten Mal in einem Projekt verwenden, das über ein Rechnungskonto bezahlt wird, für das ein gültiges Abo mit automatischer Lizenzzuweisung vorhanden ist und für das im Rechnungskonto Lizenzen verfügbar sind.

So deaktivieren Sie die automatische Lizenzzuweisung:

1. Rufen Sie in der Google Cloud Console die Seite Administrator für Gemini auf.

   Zu Gemini for Google Cloud

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

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

4. Wählen Sie Automatische Lizenzverwaltung deaktivieren aus.

5. Wählen Sie Änderung bestätigen aus.

Gemini Code Assist Standard- und Enterprise-Lizenzen einzelnen Nutzern manuell zuweisen

Bei der manuellen Lizenzzuweisung können Sie Lizenzen für einzelne Nutzer hinzufügen und entfernen. Mit dieser Methode haben Sie die direkte Kontrolle darüber, wer auf Gemini Code Assist zugreifen kann. Sie eignet sich ideal, um einer bestimmten Gruppe von Nutzern Zugriff zu gewähren.

Wählen Sie eine der folgenden Optionen aus:

Console

1. Vergewissern Sie sich, dass 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 for Google Cloud

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

4. Überprüfen Sie für dieses Gemini Code Assist Standard- oder Enterprise-Abo, ob die Lizenzzuweisung auf Lizenzen manuell zuweisen festgelegt ist. Wenn das Abo auf Lizenzen automatisch zuweisen eingestellt ist, können Sie Lizenzen nicht einzeln verwalten. Wenn Sie dieses Rechnungskonto auf Lizenzen manuell zuweisen umstellen, wird die automatische Lizenzzuweisung nach der Änderung deaktiviert. Bereits zugewiesene Lizenzen 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. Überprüfen Sie, ob Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zugewiesen haben.

API

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

1. Vergewissern Sie sich, dass Sie die folgenden IAM-Berechtigungen für das Rechnungskonto mit dem Lizenzpool haben, 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 kommagetrennte Liste mit Nutzerkonten, denen die Lizenz zugewiesen werden soll, z. B. "[e-mail]", "[e-mail]". 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:

{}

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

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

Zuweisung von Gemini Code Assist Standard- und Enterprise-Lizenzen manuell aufheben

Wählen Sie eine der folgenden Optionen aus:

Console

1. Vergewissern Sie sich, dass 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 for Google Cloud

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

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

5. Wählen Sie die Nutzer aus, für die Sie die Lizenzzuweisung aufheben möchten, und dann Lizenzzuweisung aufheben.

6. Wählen Sie Bestätigen aus.

API

Verwenden Sie die Methode billingAccounts.orders.licensePool.unassign, um die Zuweisung von Gemini Code Assist Standard- und Enterprise-Lizenzen aufzuheben.

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

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   Ersetzen Sie USER_EMAILS durch eine kommagetrennte Liste mit Nutzerkonten, denen die Lizenz zugewiesen ist, z. B. "[e-mail]", "[e-mail]".

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.

Gemini Code Assist Standard- und Enterprise-Lizenzen übertragen

Gemini Code Assist Standard- und Enterprise-Lizenzen können nicht direkt zwischen Nutzern übertragen werden. Stattdessen müssen Sie einem Nutzer die Lizenz entziehen und einem anderen Nutzer die Lizenz zuweisen.

Organisationsübergreifende Lizenznutzung verhindern

Gemini Code Assist Standard- und Enterprise-Lizenzen werden einzelnen Nutzern zugewiesen, nicht Organisationen oder Projekten. So können Nutzer Gemini Code Assist Standard und Enterprise in mehreren Organisationen verwenden.

Alle Protokolle zur Nutzung von Gemini Code Assist werden in dem Projekt gespeichert, in dem es genutzt wurde, und nicht beim Lizenzinhaber. Außerdem erfolgen Anpassungen oder Konfigurationen von Gemini Code Assist (z. B. Codeanpassung) auf Projektebene und nicht auf Lizenz- oder Aboebene.

Gehen Sie folgendermaßen vor, um die organisationsübergreifende Nutzung von Gemini Code Assist Standard und Enterprise in einem Projekt zu verhindern:

• Deaktivieren Sie im Projekt die Gemini for Google Cloud API.
• Verweigern Sie den Nutzerzugriff auf das Projekt mithilfe von Berechtigungen.

Beschränkungen

• Die Lizenzverwaltung für Gemini for Google Cloud unterstützt keine Mitarbeiteridentitätsföderation.

Nächste Schritte

• So verhindern Sie die organisationsübergreifende Lizenznutzung