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 „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 zur 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-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:

1. 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

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

   Gemini für Google Cloud aufrufen

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

4. 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.

5. Klicken Sie auf Speichern.

Gemini Code Assist-Lizenzzuweisungen ansehen

Wählen Sie eine der folgenden Optionen aus:

Console

1. 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

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

   Gemini für Google Cloud aufrufen

3. 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.

4. 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 die 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": "[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 es keine Gemini Code Assist-Lizenzzuweisungen gibt oder die ORDER_ID ungültig ist, wird licensedUsers im folgenden Format zurückgegeben:

{}

Einzelnen Nutzern manuell Gemini Code Assist-Lizenzen zuweisen

Wählen Sie eine der folgenden Optionen aus:

Console

1. 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

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

   Gemini für Google Cloud aufrufen

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

4. Achten Sie darauf, dass Sie für dieses Gemini Code Assist-Abo Lizenzzuweisung auf Lizenzen manuell zuweisen festlegen. 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 Abrechnungskonto auf Lizenzen manuell zuweisen umstellen, wird die automatische Lizenzzuweisung nach der Änderung deaktiviert. Vorhandene Lizenzzuweisungen bleiben davon jedoch unberührt.

5. 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.

6. Wählen Sie Lizenzen zuweisen aus.

7. 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-Lizenzen zuzuweisen.

Zum Ausführen dieser Aufgabe benötigen Sie 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": [
            "[e-mail]",
            "[e-mail]"
  ]
}

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.

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

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.

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

   Gemini für Google Cloud aufrufen

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. Vorhandene Lizenzzuweisungen bleiben davon jedoch unberührt.

4. 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.

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 zum ersten Mal in einem Projekt auf Gemini Code Assist zugreifen, das über ein Abrechnungskonto bezahlt wird, das ein gültiges Abo hat, das für die automatische Lizenzzuweisung konfiguriert ist und über verfügbare Lizenzen verfügt, die von Ihren Abos im Abrechnungskonto abgedeckt sind.

So deaktivieren Sie die automatische Lizenzzuweisung:

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

   Gemini für Google Cloud aufrufen

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

3. Wählen Sie Lizenzverwaltung und dann Automatische Lizenzzuweisung verwalten 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-Lizenzen manuell rückgängig machen

Wählen Sie eine der folgenden Optionen aus:

Console

1. 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

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

   Gemini für Google Cloud aufrufen

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 Lizenzen widerrufen möchten, und wählen Sie dann Lizenz widerrufen aus.

6. Wählen Sie Bestätigen aus.

API

Wenn Sie Gemini Code Assist-Lizenzen widerrufen möchten, verwenden Sie die billingAccounts.orders.licensePool.unassign-Methode.

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": [
            "[e-mail]",
            "[e-mail]"
  ]
}

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 nutzen.

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.

Sie haben folgende Möglichkeiten, um 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 Mitarbeiteridentitätsföderation.