Diese Seite wurde von der Cloud Translation API übersetzt.

Gemini Code Assist Standard- und Enterprise-Lizenzen verwalten

Vor der Nutzung von Gemini Code Assist Standard und Enterprise benötigt jeder Nutzer in Ihrer Organisation eine Lizenz.

Bei neuen Abos müssen Sie die Lizenzen standardmäßig manuell zuweisen. Nachdem Sie bestimmte Gemini für Google Cloud -Produkte eingerichtet haben, können Sie Lizenzen manuell oder automatisch zuweisen.

Hinweise

Sie benötigen die IAM-Rollen „Billing Account Administrator“ (roles/billing.admin) oder „Consumer Procurement Order Administrator“ (roles/consumerprocurement.orderAdmin), damit Sie dem Rechnungskonto zusätzliche Berechtigungen für bestimmte Aufgaben der Lizenzverwaltung gewähren können, die in den folgenden Abschnitten beschrieben werden.

Wenn Sie Lizenzen nicht über die Google Cloud Console, sondern über eine API verwalten möchten, müssen folgende Voraussetzungen erfüllt sein:
- Richten Sie ein Kontingentprojekt für Ihr Rechnungskonto ein.
- Aktivieren Sie die Cloud Commerce Consumer Procurement API in Ihrem Kontingentprojekt.
- Achten Sie darauf, dass die folgenden Kopfzeilen-Schlüssel/Wert-Paare 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 die Anzahl der Gemini for Google Cloud -Lizenzen direkt über die Google Cloud Console, über Ihren Google-Kontobevollmächtigten oder einen autorisierten Reseller hinzufügen oder entfernen.

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

Sie benötigen die folgenden IAM-Berechtigungen (Identity and Access Management) für das Rechnungskonto, zu dem das Abo gehört:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.orders.modify
- resourcemanager.projects.get
Rufen Sie in der Google Cloud Console die Seite Verwaltung für Gemini auf.

Gemini für Google Cloud aufrufen
Wählen Sie das Abo aus, das Sie ändern möchten, und dann Abo ändern.
Geben Sie die Anzahl der gewünschten Lizenzen ein. Folgende Informationen werden angezeigt:
- Gesamtzahl der Lizenzen nach dem Kauf.
- Anzahl der Lizenzen, die nach dem Kauf zugewiesen werden können.
- Neuer Abopreis pro Laufzeit. Der zusätzliche Betrag für die hinzugefügten Lizenzen wird anteilig auf der Grundlage der verbleibenden Zeit des aktuellen Zeitraums berechnet.
Klicken Sie auf Speichern.

Lizenzzuweisungen für Gemini Code Assist Standard und Enterprise aufrufen

Wählen Sie eine der folgenden Optionen aus:

Console

Sie benötigen die folgenden IAM-Berechtigungen für das Abrechnungskonto, zu dem das Abo gehört:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- resourcemanager.projects.get
Rufen Sie die Seite Verwaltung 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.

Gemini für Google Cloud aufrufen
Wählen Sie das Abo aus, das Sie ändern möchten, und dann Abo ändern.

Für jeden Nutzer, dem eine Lizenz zugewiesen wurde, sind die folgenden Informationen verfügbar:
- Name
- E-Mail aus.
- Datum, an dem die Lizenz zugewiesen wurde.
- Datum und Uhrzeit der letzten Verwendung der Lizenz.
Wenn Sie nach bestimmten Nutzern suchen 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 für Gemini Code Assist Standard- oder Enterprise-Lizenzen aufrufen möchten, verwenden Sie die billingAccounts.orders.licensePool.enumerateLicensedUsers-Methode.

Zum Ausführen dieser Aufgabe benötigen Sie die Berechtigung consumerprocurement.licensePools.enumerateLicensedUsers für das Rechnungskonto, zu dem das Abo gehört.

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

Ersetzen Sie Folgendes:

BILLING_ACCOUNT_ID: die ID des Rechnungskontos
ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto 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-Lizenzzuweisungen vorhanden sind oder die ORDER_ID ungültig ist, wird eine licensedUsers-Ausgabe im folgenden Format zurückgegeben:

{}

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

Wählen Sie eine der folgenden Optionen aus:

Console

Sie benötigen die folgenden IAM-Berechtigungen für das Abrechnungskonto, zu dem das Abo gehört:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.assign
- resourcemanager.projects.get
Rufen Sie die Seite Verwaltung für Gemini auf.

Gemini für Google Cloud aufrufen
Wählen Sie Gemini Code Assist verwalten und dann Abo ändern aus.
Achten Sie bei diesem Gemini Code Assist Standard- oder Enterprise-Abo darauf, dass Sie unter Lizenzzuweisung die Option Lizenzen manuell zuweisen auswählen. Wenn für das Gemini Code Assist Standard- oder Enterprise-Abo die Option Lizenzen automatisch zuweisen festgelegt ist, können Sie keine einzelnen Lizenzen verwalten. Wenn Sie dieses Abrechnungskonto auf Lizenzen manuell zuweisen umstellen, wird die automatische Lizenzzuweisung nach der Änderung deaktiviert. Vorhandene Lizenzzuweisungen bleiben davon jedoch unberührt.
Wählen Sie Lizenzen zuweisen aus. Ein Dialogfeld zur Nutzerauswahl wird angezeigt. Wenn Sie nach bestimmten Nutzern suchen möchten, geben Sie deren E-Mail-Adresse ein und wählen Sie dann Weiter aus.
Wählen Sie Lizenzen zuweisen aus.
Weisen Sie den lizenzierten Nutzern die IAM-Rollen „Gemini for Google Cloud User“ und „Service Usage Consumer“ zu.

API

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

Sie benötigen die folgenden Berechtigungen für das Abrechnungskonto, zu dem das Abo gehört:

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": [
            "dana@example.com",
            "lee@example.com"
  ]
}

Ersetzen Sie Folgendes:

BILLING_ACCOUNT_ID: die ID des Rechnungskontos
ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Wenn der Befehl erfolgreich ist, wird ein leerer Antworttext im folgenden Format zurückgegeben:

{}

Sie können die Zuweisung in der Liste der Aufgaben prüfen.

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

Gemini Code Assist Standard- und Enterprise-Lizenzen automatisch zuweisen

Auf der Seite Lizenzzuweisung können Sie jedem Nutzer in Ihrer Organisation, der Zugriff auf Gemini Code Assist Standard oder Enterprise benötigt, automatisch eine Lizenz zuweisen. Die automatische Lizenzzuweisung wird für jedes Abo einzeln festgelegt.

Wenn Sie Lizenzen für Gemini Code Assist Standard oder Enterprise automatisch zuweisen, können Sie unter diesem Konto keine einzelnen Nutzerlizenzen entfernen oder hinzufügen. Nutzer mit Lizenzzuweisungen, die keine Gemini Code Assist Standard- oder Enterprise-Funktionen verwendet haben, werden am Ende des Abrechnungszeitraums nach einer vom Administrator festgelegten Anzahl von Tagen Inaktivität automatisch deaktiviert.

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

Gemini für Google Cloud aufrufen
Wählen Sie Gemini Code Assist verwalten und dann Abo verwalten aus.
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. Vorhandene Lizenzzuweisungen bleiben davon jedoch unberührt.
Legen Sie fest, wie lange eine Lizenz nach Inaktivität des Nutzers nicht mehr zugewiesen werden soll, und wählen Sie dann Änderung bestätigen aus. Das Dialogfeld Automatische Lizenzzuweisung wurde aktiviert wird angezeigt.
Wählen Sie Schließen aus.
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 zum ersten Mal in einem Projekt auf Gemini Code Assist Standard oder Enterprise zugreifen, das über ein Rechnungskonto bezahlt wird, das ein gültiges Abo hat, das für die automatische Lizenzzuweisung konfiguriert ist und über verfügbare Lizenzen verfügt, die durch Ihre Abos im Rechnungskonto abgedeckt sind.

So deaktivieren Sie die automatische Lizenzzuweisung:

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

Gemini für Google Cloud aufrufen
Wählen Sie Gemini Code Assist verwalten und dann Abo verwalten aus.
Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung verwalten aus. Das Dialogfeld Automatische Lizenzzuweisung verwalten wird angezeigt.
Wählen Sie Automatische Lizenzverwaltung deaktivieren aus.
Wählen Sie Änderung bestätigen aus.

Gemini Code Assist Standard- und Enterprise-Lizenzen manuell zuordnen

Wählen Sie eine der folgenden Optionen aus:

Console

Sie benötigen die folgenden IAM-Berechtigungen für das Abrechnungskonto, zu dem das Abo gehört:
- billing.accounts.get
- consumerprocurement.orders.get
- consumerprocurement.licensePools.get
- consumerprocurement.licensePools.enumerateLicensedUsers
- consumerprocurement.licensePools.unassign
- resourcemanager.projects.get
Rufen Sie die Seite Verwaltung für Gemini auf.

Gemini für Google Cloud aufrufen
Wählen Sie Gemini Code Assist verwalten und dann Abo verwalten aus.
Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung verwalten aus. Das Dialogfeld Automatische Lizenzzuweisung verwalten wird angezeigt.
Wählen Sie die Nutzer aus, für die Sie die Lizenzen widerrufen möchten, und wählen Sie dann Lizenz widerrufen aus.
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.

Zum Ausführen dieser Aufgabe benötigen Sie die Berechtigung consumerprocurement.licensePools.unassign für das Abrechnungskonto, zu dem das Abo gehört.

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

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

Ersetzen Sie Folgendes:

BILLING_ACCOUNT_ID: die ID des Rechnungskontos
ORDER_ID: die Bestell-ID. Wenn Sie die Bestell-ID nicht kennen, können Sie sie abrufen, indem Sie die mit Ihrem Abrechnungskonto verknüpften Bestellungen auflisten.

Wenn der Befehl erfolgreich ist, wird ein leerer Antworttext im folgenden Format zurückgegeben:

{}

In der Liste der Aufgaben können Sie prüfen, ob die Zuweisung aufgehoben wurde.

Gemini Code Assist Standard- und Enterprise-Lizenzen übertragen

Gemini Code Assist Standard- und Enterprise-Lizenzen können nicht direkt zwischen Nutzern übertragen werden. Entziehen Sie stattdessen einem Nutzer die Lizenz und weisen Sie dem neuen Nutzer eine Lizenz zu.

Verwendung von Lizenzen über mehrere Organisationen hinweg verhindern

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

Alle von Gemini Code Assist generierten Nutzungslogs sind dem Projekt zugeordnet, in dem die Nutzung stattgefunden hat, und nicht dem Lizenznehmer. Außerdem werden alle Anpassungen oder Konfigurationen von Gemini Code Assist (z. B. Codeanpassungen) auf Projektebene vorgenommen, nicht auf Lizenz- oder Aboebene.

Um die nutzungsübergreifende Verwendung von Gemini Code Assist Standard und Enterprise in einem Projekt zu verhindern, haben Sie folgende Möglichkeiten:

Deaktivieren Sie die Gemini for Google Cloud API im Projekt.
Verwenden Sie Berechtigungen, um Nutzern den Zugriff auf das Projekt zu verweigern.

Beschränkungen

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

Nächste Schritte

Informationen zum Verhindern der nutzungsübergreifenden Lizenz