Diese Seite wurde von der Cloud Translation API übersetzt.

Gemini Code Assist-Lizenzen verwalten

Vor der Nutzung von Gemini Code Assist 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 „Rechnungskontoadministrator“ (roles/billing.admin) oder „Consumer Procurement Order Administrator“ (roles/consumerprocurement.orderAdmin), damit Sie zusätzliche Berechtigungen gewähren können, die für bestimmte Aufgaben zur Lizenzverwaltung erforderlich sind. Diese werden in den folgenden Abschnitten beschrieben.

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-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 über 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.

Zu „Administrator für Gemini“
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.

Gemini Code Assist-Lizenzzuweisungen ansehen

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.

Zu „Administrator für Gemini“
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
- Kontotyp
- Zugewiesene Lizenzen
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.
- Wählen Sie zum Sortieren der Liste 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

Verwenden Sie die billingAccounts.orders.licensePool.enumerateLicensedUsers-Methode, um sich Lizenzzuweisungen für Gemini Code Assist anzusehen.

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 IAM-Richtlinie

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

Einzelnen Nutzern manuell Gemini Code Assist-Lizenzen 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.

Zu „Administrator für Gemini“
Wählen Sie Gemini Code Assist verwalten und dann Abo ändern aus.
Legen Sie für dieses Gemini Code Assist-Abo Lizenzzuweisung auf Lizenzen manuell zuweisen fest. Wenn für das Gemini Code Assist-Abo die Option Lizenzen automatisch zuweisen festgelegt ist, können Sie keine einzelnen Lizenzen verwalten. Wenn Sie dieses Rechnungskonto 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.

API

Verwenden Sie die Methode billingAccounts.orders.licensePool.assign, um Gemini Code Assist-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 IAM-Richtlinie

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.

Gemini Code Assist-Lizenzen automatisch zuweisen

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

Wenn Sie Lizenzen für Gemini Code Assist automatisch zuweisen, können Sie keine einzelnen Nutzerlizenzen unter diesem Konto entfernen oder hinzufügen. Nutzer mit Lizenzzuweisungen, die keine Gemini Code Assist-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.

Zu „Administrator für Gemini“
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. Bereits vorhandene Lizenzzuweisungen bleiben davon unberührt.
Legen Sie fest, wie lange eine Lizenz nicht mehr zugewiesen werden soll, wenn der Nutzer inaktiv ist, und wählen Sie dann Änderung bestätigen aus. Das Dialogfeld Automatische Lizenzzuweisung wurde aktiviert wird angezeigt.
Wählen Sie Schließen aus.

Solange Lizenzen zur Zuweisung verfügbar sind, erhalten neue Nutzer automatisch eine Lizenz, wenn sie zum ersten Mal auf Gemini Code Assist zugreifen, das von Ihren Abos in diesem Rechnungskonto abgedeckt ist.

So deaktivieren Sie die automatische Lizenzzuweisung:

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

Zu „Administrator für Gemini“
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-Lizenzen manuell rückgängig machen

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.

Zu „Administrator für Gemini“
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 Gemini Code Assist-Lizenzen zu entziehen.

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 IAM-Richtlinie

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-Lizenzen übertragen

Gemini Code Assist-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-Lizenzen werden einzelnen Nutzern zugewiesen, nicht Organisationen oder Projekten. So können einzelne Nutzer Gemini Code Assist in mehreren Organisationen verwenden.

Alle von Gemini Code Assist generierten Protokolle 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.

Sie haben folgende Möglichkeiten, die standortübergreifende Nutzung von Gemini Code Assist in einem Projekt zu verhindern:

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 Workforce Identity-Föderation.