Bevor Sie Gemini Code Assist Standard und Enterprise verwenden können, 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 Konsole, 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 CLIx-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 Google Cloud direkt über die Konsole oder über Ihren Google Kontenbetreuer 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.
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 Standard- und Enterprise-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 und wählen Sie das Projekt aus, das mit Ihrem Rechnungskonto mit dem Gemini Code Assist Standard- oder Enterprise-Abo verknüpft ist.
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.
- 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
Wenn Sie Zuweisungen für Gemini Code Assist Standard- oder Enterprise-Lizenzen aufrufen möchten, verwenden Sie die billingAccounts.orders.licensePool.enumerateLicensedUsers
-Methode.
Sie benötigen die IAM-Berechtigung
consumerprocurement.licensePools.enumerateLicensedUsers
für das Abrechnungskonto, das den Lizenzpool enthält, dessen Lizenzzuweisungen Sie aufrufen möchten.Rufen Sie die Methode mit
cURL
auf: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 eines Projekts. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angewendet.
BILLING_ACCOUNT_ID
: die ID des mit dem Lizenzpool verknüpften Abrechnungskontos.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.
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.
API
Verwenden Sie die Methode billingAccounts.orders.licensePool.assign
, um Gemini Code Assist Standard- und Enterprise-Lizenzen zuzuweisen.
Sie benötigen die folgenden IAM-Berechtigungen für das Abrechnungskonto, 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
Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "usernames": [ USER_EMAILS ] }
Ersetzen Sie
USER_EMAILS
durch eine durch Kommas getrennte Liste der Nutzerkonten, denen die Lizenz zugewiesen wird, z. B."dana@example.com", "lee@example.com"
.Rufen Sie die Methode mit
cURL
auf: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 eines Projekts. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angewendet.
BILLING_ACCOUNT_ID
: die ID des mit dem Lizenzpool verknüpften Abrechnungskontos.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 Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
{}
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.
Die automatische Lizenzzuweisung wird nur in VS Code, IntelliJ und anderen unterstützten JetBrains-IDEs unterstützt: .
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.
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 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.
-
Nutzer mit der Berechtigung
cloudaicompanion.licenses.selfAssign
erhalten automatisch eine Lizenz, wenn sie zum ersten Mal in einem Projekt, das über ein Rechnungskonto bezahlt wird, auf Gemini Code Assist Standard oder Enterprise zugreifen. Dieses Rechnungskonto muss ein gültiges Abo haben, 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.
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.
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.
Sie benötigen die IAM-Berechtigung
consumerprocurement.licensePools.unassign
(Identity and Access Management) für das Rechnungskonto, das den Lizenzpool enthält, dessen Lizenz Sie trennen möchten.Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "usernames": [ USER_EMAILS ] }
Ersetzen Sie
USER_EMAILS
durch eine durch Kommas getrennte Liste der Nutzerkonten, denen die Lizenz zugewiesen ist, z. B."dana@example.com", "lee@example.com"
.Rufen Sie die Methode mit
cURL
auf: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 eines Projekts. Die Kontingentnutzung und die mit der API-Anfrage verbundenen Gebühren werden auf dieses Projekt angewendet.
BILLING_ACCOUNT_ID
: die ID des mit dem Lizenzpool verknüpften Abrechnungskontos.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 Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
{}
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 im Projekt verfügbar, in dem die Nutzung stattgefunden hat, und nicht beim 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 Nutzung 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.