Abos für Gemini Enterprise erwerben und Lizenzen zuweisen

Auf dieser Seite wird beschrieben, wie Sie Gemini Enterprise-Abos abschließen und Nutzerlizenzen verwalten.

Die Einrichtung des Zugriffs umfasst in der Regel die folgenden Phasen:

1. Beschaffen: Ein Abo für eine Produktversion für Ihr Abrechnungskonto kaufen.
2. Zuweisen: Weisen Sie Lizenzen aus dem Abo bestimmten Projekten und Standorten zu.
3. Zuweisen: Weisen Sie die verteilten Lizenzen einzelnen Nutzern zu.

Lizenzen

Um sich bei der Gemini Enterprise-App anzumelden, benötigen Nutzer eine Lizenz, die manuell oder automatisch zugewiesen werden kann.

• Manuell zugewiesene Lizenzen:Sie können Nutzer über ihre E‑Mail-Adressen hinzufügen.

• Automatisch zugewiesene Lizenzen:Sie können ein Abo so konfigurieren, dass Gemini Enterprise einem Nutzer automatisch eine Lizenz zuweist, wenn er zum ersten Mal auf die Benutzeroberfläche von Gemini Enterprise oder Gemini Notebook Enterprise zugreift.

Hinweis: Die Lizenzen gelten für ein bestimmtes Google Cloud -Projekt und einen bestimmten Standort. Wenn Nutzer beispielsweise Zugriff auf eine Gemini Enterprise-App in einem Google Cloud -Projekt benötigen, das sowohl in den USA als auch global verfügbar ist, benötigen Sie innerhalb desselben Google Cloud -Projekts zwei separate Lizenzen für diese beiden Standorte.

Abos

Um Lizenzen zu erhalten, benötigen Sie zuerst ein Abo für eine Gemini Enterprise-Version. Abos gelten für ein bestimmtes Rechnungskonto. Informationen zu den verfügbaren Versionen finden Sie unter Versionen von Gemini Enterprise vergleichen.

Für Gemini Enterprise können Sie entweder ein Monats- oder ein Jahresabo abschließen und die Abos so einstellen, dass sie automatisch verlängert werden.

Sie können Abos für die Versionen Gemini Enterprise Standard, Gemini Enterprise Plus und Gemini Enterprise Pay-as-you-go über dieGoogle Cloud Console erwerben.

Limits für die Anzahl der Nutzungslizenzen für Abos

Wenn Sie ein sitzplatzbasiertes Abo direkt über dieGoogle Cloud -Konsole kaufen oder ändern, gelten automatische Obergrenzen für die Anzahl der Arbeitsplätze, die von Ihrem Cloud-Rechnungskontotyp abhängen:

• Selfservice-Konten (oder Onlinekonten) und weiterverkaufte Rechnungskonten:Bei der Verwaltung von Abos über die Google Cloud -Konsole sind maximal 25 Arbeitsplätze pro Konto möglich.
• Rechnungskonten mit monatlicher Abrechnung oder Offlinekonten:Auf maximal 1.000 Lizenzen pro Konto begrenzt.

Wenn Ihre Organisation mehr Arbeitsplätze benötigt oder Sie beim Hinzufügen von Lizenzen zu einem bestehenden Abo die Fehlermeldung zum maximalen Arbeitsplatzlimit erhalten, wenden Sie sich an Ihren Google Cloud Vertriebsmitarbeiter oder Account Manager, um zusätzliche Lizenzen über eine Offlinebestellung zu erwerben oder eine Ausnahme von der Zulassungsliste zu beantragen.

Abostatus

Ein Abo kann einen der folgenden Status haben:

Bundesland	Beschreibung
Nicht gestartet	Sie haben das Abo gekauft, es ist aber noch nicht aktiv. Sie können Lizenzen aus diesem Abo auf Projekte verteilen. Nutzer, denen diese Lizenzen zugewiesen sind, haben jedoch erst Zugriff auf Gemini Enterprise, wenn das Abo aktiv wird. Weitere Informationen finden Sie unter Lizenzen verteilen.
Aktiv	Das Abo ist aktiv und Nutzer mit einer Lizenz für dieses Abo können auf Gemini Enterprise zugreifen.
Wird deaktiviert	Das Abo wird gerade deaktiviert und die Lizenzen werden vorzeitig gekündigt. Nutzer mit Lizenzen in diesem Abo haben weiterhin eine Woche lang Zugriff auf Gemini Enterprise. Nach dieser Woche wechseln die Lizenzen in den Status „Abgelaufen“. Weitere Informationen finden Sie unter Vorzeitige Kündigung verarbeiten.
Abgelaufen	Nutzer mit Lizenzen in diesem Abo verlieren den Zugriff auf Gemini Enterprise, wenn die Laufzeit des Abos endet oder wenn Lizenzen nach einer vorzeitigen Kündigung vom Deaktivierungsstatus in den Status „Abgelaufen“ übergehen.

Hinweis

Bevor Sie mit den Verfahren auf dieser Seite beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

• Führen Sie alle Aufgaben aus, die unter Gemini Enterprise einrichten beschrieben sind. Dazu zählen:

  • Einrichtung eines Rechnungskontos für Ihr Projekt
  • Weisen Sie allen Nutzern, denen Sie eine Lizenz für Gemini Enterprise zuweisen, mindestens die Rolle „Gemini Enterprise-Nutzer“ zu.

• Prüfen Sie, ob für Ihr Google Cloud -Projekt die Abrechnung aktiviert ist. Weitere Informationen finden Sie unter Prüfen, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.

  Hinweis :Das Gemini Enterprise Pay-as-you-go-Abo ist nur für Konten mit Rechnungsstellung verfügbar. Weitere Informationen finden Sie unter Cloud-Rechnungskontotypen.

• Prüfen Sie, ob Sie die erforderlichen IAM-Rollen und ‑Berechtigungen haben:

  • Die Rolle Gemini Enterprise Admin.

  • Wenn Sie die Abrechnung für Ihre Organisation verwalten, benötigen Sie die folgenden Rollen, um Gemini Enterprise-Abos und Beschaffungsaufträge zu verwalten.

    • Rechnungskontoadministrator (roles/billing.admin)
    • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

    Alternativ können Sie für eine detaillierte IAM-Steuerung anstelle der Rolle Billing Account Administrator (Administrator des Abrechnungskontos) eine benutzerdefinierte Rolle mit den folgenden Berechtigungen verwenden:

    Dienst	Berechtigungen
    Discovery Engine	discoveryengine.billingAccountLicenseConfigs.distribute discoveryengine.billingAccountLicenseConfigs.get discoveryengine.billingAccountLicenseConfigs.list discoveryengine.billingAccountLicenseConfigs.retract discoveryengine.licenseConfigs.create discoveryengine.licenseConfigs.get discoveryengine.licenseConfigs.list discoveryengine.licenseConfigs.update discoveryengine.projects.get discoveryengine.projects.provision discoveryengine.projects.reportConsentChange discoveryengine.userStores.batchUpdateUserLicenses discoveryengine.userStores.listUserLicenses
    Nutzerbeschaffung	consumerprocurement.orders.get consumerprocurement.licensePools.assign consumerprocurement.licensePools.unassign consumerprocurement.licensePools.enumerateLicensedUsers
    Resource Manager	resourcemanager.projects.get resourcemanager.projects.list
    Service Usage	serviceusage.services.get serviceusage.services.list

Abo abschließen

Wenn Sie Lizenzen erhalten möchten, kaufen Sie ein Abo für eine Gemini Enterprise-Version für Ihr Rechnungskonto. Das Abo bietet einen Pool von Lizenzen, die Sie für jedes Projekt verwenden können, das mit diesem Rechnungskonto verknüpft ist. Sie können sie auf Projekte verteilen und Nutzern zuweisen.

Standard und Plus

So abonnieren Sie Gemini Enterprise Standard oder Plus:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten > Abo erstellen.

3. Klicken Sie für die Version Gemini Enterprise Standard oder Gemini Enterprise Plus auf Abonnieren.

4. Konfigurieren Sie die Abrechnungsdetails:

   1. Wählen Sie aus dem Drop-down-Menü das Rechnungskonto aus.
   2. Geben Sie einen Abonamen ein.
   3. Geben Sie die Anzahl der Lizenzen ein, die Sie für die Version benötigen.

5. Wählen Sie den Abozeitraum aus.

6. Wenn das Abo automatisch verlängert werden soll, wählen Sie Abo automatisch verlängern aus.

7. Konfigurieren Sie die Verteilungsdetails:

   1. Wählen Sie im Drop-down-Menü Projekt auswählen Ihr Projekt aus.
   2. Wählen Sie für Ihr Abo einen Standorttyp aus. Wenn Sie Ihre Daten nicht aus Compliance- oder regulatorischen Gründen an den multiregionalen Standorten USA oder EU platzieren müssen, empfiehlt Google für maximale Verfügbarkeit und niedrige Latenz den globalen Standort.

8. Klicken Sie auf Erstellen > Bestätigen.

Pay as you go

Bei einem „Pay-as-you-go“-Abo zahlen Sie monatlich für die Nutzung zu den in Überschreitungen aufgeführten Preisen. Sie können das Abo mit jedem Projekt verwenden, das mit Ihrem Rechnungskonto verbunden ist.

Hinweis: Ein „Pay as you go“-Abo ist nur für Cloud-Rechnungskonten mit monatlicher Abrechnung verfügbar. Weitere Informationen finden Sie unter Cloud-Rechnungskontotypen.

So abonnieren Sie die Pay-as-you-go-Version von Gemini Enterprise:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten > Abo erstellen.

3. Klicken Sie bei der Version Gemini Enterprise mit Pay as you go auf Abonnieren.

4. Konfigurieren Sie die Abrechnungsdetails:

   1. Geben Sie einen Abonamen ein.
   2. Geben Sie die Anzahl der Lizenzen ein, die Sie für die Version benötigen.

5. Konfigurieren Sie die Verteilungsdetails:

   1. Wählen Sie im Drop-down-Menü Projekt auswählen Ihr Projekt aus.
   2. Wählen Sie für Ihr Abo einen Standorttyp aus. Wenn Sie Ihre Daten nicht aus Compliance- oder regulatorischen Gründen an den multiregionalen Standorten USA oder EU platzieren müssen, empfiehlt Google für maximale Verfügbarkeit und niedrige Latenz den globalen Standort.

6. Klicken Sie auf Erstellen > Bestätigen.

Abos verwalten

In diesem Abschnitt wird beschrieben, wie Sie Gemini Enterprise-Abos aufrufen, aktualisieren, verteilen und zurückfordern.

Abodetails ansehen

So rufen Sie die Details Ihrer Gemini Enterprise-Abos auf:

Console

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten.

3. Wählen Sie aus dem Drop-down-Menü das Rechnungskonto aus.

4. Klicken Sie in der Tabelle Gemini-Abos auf den Namen Ihres Abos.

REST

Führen Sie den folgenden Befehl aus, um Abodetails abzurufen:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs"

Ersetzen Sie Folgendes:

• PROJECT_NUMBER: Die Projektnummer, für die Sie die Rolle „Service Usage Consumer“ haben.
• BILLING_ACCOUNT_ID: ID Ihres Google Cloud Rechnungskontos.

Beispielausgabe:

{
  "billingAccountLicenseConfigs": [{
    "name": "billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID",
    "licenseCount": "2",
    "licenseConfigDistributions": {"projects/PROJECT_NUMBER/locations/global/licenseConfigs/LICENSE_CONFIG_ID": "1"
    },
    "subscriptionName": "subscriptions/SUBSCRIPTION_NAME",
    "subscriptionTier": "SUBSCRIPTION_TIER",
    "subscriptionTerm": "SUBSCRIPTION_TERM",
    "startDate": ...,
    "endDate": ...,
    "state": "ACTIVE",
    "procurementEntitlementId": "...",
    "subscriptionDisplayName": "...",
    "geminiBundle": true
  }]
}

Aboeinstellungen aktualisieren

Nachdem Sie ein Abo erstellt haben, können Sie die Einstellungen aktualisieren, z. B. die Anzahl der Lizenzen oder die automatische Verlängerung.

Die Methode zum Hinzufügen weiterer Lizenzen hängt davon ab, wie Sie Ihr Abo ursprünglich erworben haben:

• Wenn Sie Ihr Abo über die Google Cloud -Konsole erworben haben, können Sie weitere Lizenzen direkt in der Google Cloud -Konsole hinzufügen. Folgen Sie dazu der Anleitung in diesem Abschnitt.
• Wenn Sie den Kauf über ein Offline-Bestellformular getätigt haben, müssen Sie das Bestellformular mit der neuen Anzahl von Lizenzen aktualisieren. Wenden Sie sich an Ihren Google Account Manager, um das Bestellformular aktualisieren zu lassen.

Hinweis:Wenn Sie die Anzahl der Abositzplätze in der Google Cloud -Konsole aktualisieren, gelten je nach Art Ihres Rechnungskontos maximale Sitzplatzlimits (bis zu 25 Sitzplätze für Selfservice-Rechnungskonten (oder Onlinekonten) und Rechnungskonten mit Weiterverkauf und bis zu 1.000 Sitzplätze für Rechnungskonten mit Rechnungsstellung (oder Offlinekonten)). Weitere Informationen finden Sie unter Limits für die Anzahl der Abositzplätze.

Wenn Ihr bestehendes Abo diese Grenzwerte überschreitet (z. B. wenn es ursprünglich über eine vertriebsorientierte Offlinebestellung bereitgestellt wurde), kann der Versuch, weitere Lizenzen direkt über die Google Cloud -Konsole hinzuzufügen, zu einem Fehler aufgrund des Lizenzlimits führen. Wenden Sie sich an Ihren Google Cloud Vertriebsmitarbeiter oder Account Manager, um die Anzahl der Lizenzen anzupassen oder eine Ausnahme auf der Zulassungsliste zu beantragen.

So aktualisieren Sie die Anzahl der Lizenzen, wenn Sie über dieGoogle Cloud Console gekauft haben:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten.

3. Klicken Sie in der Tabelle Gemini-Abos auf das Abo, das Sie aktualisieren möchten.

4. Klicken Sie neben Abodetails auf Bearbeiten.

5. Aktualisieren Sie die Anzahl der Lizenzen oder aktivieren bzw. deaktivieren Sie die automatische Verlängerung.

6. Klicken Sie auf Senden.

Abo kündigen

Wenn Sie ein Gemini Enterprise-Abo kündigen möchten, müssen Sie die automatische Verlängerung deaktivieren. Ihr Abo bleibt bis zum Ende der Abolaufzeit aktiv und es können bis dahin Gebühren anfallen. Weitere Informationen zu Ihrem Abo

So kündigen Sie Ihr Abo:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten.

3. Klicken Sie in der Tabelle Gemini-Abos auf den Namen Ihres Abos, um die Abo-Detailseite zu öffnen.

4. Klicken Sie auf Bearbeiten.

5. Entfernen Sie im Bereich Abo bearbeiten das Häkchen aus dem Kästchen Abo automatisch verlängern.

6. Klicken Sie auf Senden.

Lizenzen verteilen

Wenn Sie die abonnierten Lizenzen nicht auf ein Projekt verteilt haben, beispielsweise wenn Sie das Abo offline erworben haben oder die Lizenzverteilung fehlgeschlagen ist, gehen Sie so vor:

Hinweis:Ein Gemini Enterprise Standard- oder Plus-Abo gewährt auch Zugriff auf die Gemini Code Assist Standard-Funktionen in unterstützten IDEs. Sie müssen diese Lizenzen separat auf den Administratorseiten für Gemini Code Assist zuweisen. Weitere Informationen finden Sie unter Gemini Code Assist einrichten.

Diese Funktion ist nicht in den Versionen „Business“ oder „Frontline“ enthalten. Weitere Informationen zu den in den einzelnen Stufen enthaltenen Funktionen finden Sie unter Versionen von Gemini Enterprise vergleichen.

Console

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten.

3. Wählen Sie aus dem Drop-down-Menü das Rechnungskonto aus.

4. Klicken Sie in der Tabelle Gemini-Abos auf den Namen Ihres Abos.

5. Klicken Sie oben auf der Seite auf Lizenz verteilen. Eine Liste mit den vorhandenen Lizenzverteilungen und Statistiken zu verbleibenden und Gesamtsitzplätzen wird angezeigt.

6. So weisen Sie einem Projekt Lizenzen zu:

   1. Klicken Sie auf die Projektauswahl, um ein Projekt auszuwählen. Die Auswahl unterstützt die automatische Vervollständigung.
   2. Hinweis: Wenn Sie die Discovery Engine API für das ausgewählte Projekt nicht aktiviert haben, wird ein Dialogfeld angezeigt, in dem Sie aufgefordert werden, sie zu aktivieren.
   3. Wählen Sie einen Standort aus.
   4. Geben Sie die Anzahl der zuzuweisenden Lizenzen ein.
   5. Wiederholen Sie diese Schritte, wenn Sie Lizenzen auf mehrere Projekte oder Standorte verteilen möchten.

7. Klicken Sie auf Senden.

8. Sehen Sie sich im Bestätigungsdialogfeld die Zusammenfassung der Änderungen an und klicken Sie auf Bestätigen.

REST

Führen Sie den folgenden Befehl aus, um Lizenzen an ein oder mehrere Projekte zu verteilen:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "projectNumber": "TARGET_PROJECT_NUMBER",
    "location": "LOCATION",
    "licenseCount": LICENSE_COUNT,
    "licenseConfigId": "LICENSE_CONFIG_ID"
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:distributeLicenseConfig"

Ersetzen Sie Folgendes:

• PROJECT_NUMBER: die Projektnummer, für die Sie die Rolle „Service Usage Consumer“ haben
• ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
• us für die Multiregion „USA“
• eu für die Multiregion „EU“
• global für den Standort „Global“

Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.

LOCATION: die Multiregion Ihres Datenspeichers: global, us oder eu

TARGET_PROJECT_NUMBER: die Projektnummer, für die Sie Lizenzen zuweisen möchten.

LICENSE_COUNT: Die Anzahl der zu verteilenden Lizenzen.

BILLING_ACCOUNT_ID: ID Ihres Google Cloud Rechnungskontos.

BILLING_ACCOUNT_LICENSE_CONFIG_ID: Suchen Sie in den Abo-Details nach der Lizenzkonfigurations-ID des Rechnungskontos.

Optional LICENSE_CONFIG_ID: Die ID einer vorhandenen Lizenzkonfiguration auf Projektebene. Sie finden diese ID im Feld licenseConfigDistributions, wenn Sie die Abo-Details aufrufen.

Hinweis :Wenn Sie die LICENSE_CONFIG_ID in dieser API-Anfrage weglassen, wird für die angegebene Projektnummer und den angegebenen Standort eine neue Lizenzkonfiguration erstellt. Wenn Sie eine vorhandene Lizenzkonfiguration aktualisieren möchten, müssen Sie die LICENSE_CONFIG_ID

angeben.

Nicht zugewiesene Lizenzen in einem Abo zurückfordern

In diesem Abschnitt wird beschrieben, wie Sie nicht zugewiesene Lizenzen aus einem Projekt zurückfordern, damit sie im Rechnungskonto für die Weiterverteilung an andere Projekte verfügbar sind.

Console

Hinweis :Sie können diese Aktion nur einmal pro Kalendertag ausführen.

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Abos verwalten.

3. Wählen Sie aus dem Drop-down-Menü das Rechnungskonto aus.

4. Klicken Sie in der Tabelle Gemini-Abos auf den Namen Ihres Abos.

5. Klicken Sie oben auf der Seite auf Lizenz verteilen. Mit dieser Schaltfläche wird das Verwaltungsformular für alle Zuweisungen geöffnet.

6. Suchen Sie in der Liste der Zuweisungen nach der Zeile für das Projekt und den Standort, für die Sie Lizenzen zurückfordern möchten.

7. Wählen Sie eine der folgenden Aktionen aus:

   • So verringern Sie die Anzahl der Lizenzen: Verringern Sie die Anzahl im Eingabefeld für die Lizenz.
   • So geben Sie Lizenzen vollständig zurück: Bewegen Sie den Mauszeiger auf die Zeile, um die Schaltfläche „Löschen“ aufzurufen, und klicken Sie dann auf Löschen.

8. Klicken Sie auf Senden.

9. Prüfen Sie im Bestätigungsdialogfeld die Zusammenfassung der Änderungen (in der alle zurückgeforderten Lizenzen aufgeführt sind) und klicken Sie auf Bestätigen.

REST

Hinweis :Sie können diese Aktion nur einmal pro Tag ausführen.

Führen Sie den folgenden Befehl aus, um Abolizenzen zurück zum Rechnungskonto für die Weiterverteilung zu übertragen:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  -d '{
    "licenseConfig": "projects/TARGET_PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID",
    "licenseCount": LICENSE_COUNT
  }' \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/billingAccounts/BILLING_ACCOUNT_ID/billingAccountLicenseConfigs/BILLING_ACCOUNT_LICENSE_CONFIG_ID:retractLicenseConfig"

Ersetzen Sie Folgendes:

• PROJECT_NUMBER: die Projektnummer, für die Sie die Rolle „Service Usage Consumer“ haben
• ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
• us für die Multiregion „USA“
• eu für die Multiregion „EU“
• global für den Standort „Global“

Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.

LOCATION: die Multiregion Ihres Datenspeichers: global, us oder eu

TARGET_PROJECT_NUMBER: die Projektnummer, aus der Sie Lizenzen zurückfordern möchten.

LICENSE_COUNT: Die Anzahl der zurückzufordernden Lizenzen.

BILLING_ACCOUNT_ID: ID Ihres Google Cloud Rechnungskontos.

BILLING_ACCOUNT_LICENSE_CONFIG_ID: Suchen Sie in den Abo-Details nach der Lizenzkonfigurations-ID des Rechnungskontos.

LICENSE_CONFIG_ID: die Lizenzkonfigurations-ID einer vorhandenen Lizenzkonfiguration auf Projektebene.

Vorzeitige Kündigung bearbeiten

Wenn Sie zwischen verschiedenen Abotypen migrieren oder ein Problem mit Ihrem Abrechnungskonto vorliegt, kann ein Abo früher als geplant enden.

Um einen reibungslosen Übergang zu gewährleisten und Dienstunterbrechungen zu vermeiden, bieten wir eine einwöchige (siebentägige) Kulanzfrist an, in der betroffene Lizenzen deaktiviert werden, bevor sie vollständig ablaufen. Während dieses Kulanzzeitraums können Sie den Dienst weiterhin nutzen, während Sie zu einem neuen Abo wechseln.

Damit Ihre Nutzer weiterhin Zugriff haben, übertragen Sie ihre Lizenzen entweder automatisch oder manuell auf ein neues, aktives Abo.

Die folgende Abbildung zeigt ein Beispiel für die Deaktivierung einer Lizenz in derGoogle Cloud -Konsole:

Nutzerlizenzen verwalten

In diesem Abschnitt wird beschrieben, wie Sie Lizenzen ansehen, Nutzerdaten exportieren und Lizenzen für einzelne Nutzer zuweisen, übertragen und entfernen.

Lizenzen abrufen

So rufen Sie die Lizenzen und die zugewiesenen Nutzer auf:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Nutzer verwalten.

3. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

Nutzerdaten exportieren

Die Tabelle „Nutzer“ in der Google Cloud Console unterstützt keine Sortierung oder Filterung. Wenn Sie Ihre Nutzerdaten sortieren, filtern oder analysieren möchten, können Sie bis zu 1.000.000 Nutzerdatensätze in eine CSV-Datei (Datei mit durch Kommas getrennten Werten) exportieren.

Die exportierte CSV-Datei enthält die folgenden Spalten.

Spaltenname	Beschreibung
user_principal	Die E-Mail-Adresse des Nutzers.
license_config	Der vollständige Google Cloud Ressourcenname des dem Nutzer zugewiesenen Abos (z. B. projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). Die Lizenzkonfigurations-ID entspricht der dem Nutzer zugewiesenen Gemini Enterprise-Version (z. B. Standard oder Plus).
assignment_time	Der Zeitstempel (in UTC), als ein Administrator die Lizenz zugewiesen hat.
last_login_time	Der Zeitstempel (in UTC), zu dem sich der Nutzer zuletzt angemeldet hat.
license_assignment_state	Der Status der Lizenzzuweisung. Folgende Werte sind verfügbar: ASSIGNED: Dem Nutzer ist eine Lizenz zugewiesen. NO_LICENSE: Der Nutzer hat keine Lizenz, weil ein Administrator keine zugewiesen oder eine vorhandene Lizenz entfernt hat. BLOCKED: Eine Richtlinie oder ein Administrator verhindert, dass der Nutzer eine Lizenz erhält.

So exportieren Sie Nutzerdaten in eine CSV-Datei:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Nutzer verwalten auf.

   Nutzer verwalten

2. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

3. Klicken Sie im Bereich Nutzer auf Alle Nutzer exportieren.

   Je nach Größe der Tabelle „Nutzer“ kann der Exportvorgang bis zu 2, 5 Minuten dauern. Während dieser Zeit wird in der Console ein Ladestatus angezeigt. Wenn der Export abgeschlossen ist, wird die CSV-Datei in das Standard-Downloadverzeichnis Ihres Browsers heruntergeladen.

Probleme beim Exportieren beheben

In der folgenden Tabelle sind häufige Probleme beim Exportieren von Nutzerdaten und ihre Lösungen aufgeführt.

Problem	Lösung
Die Schaltfläche Alle Nutzer exportieren ist ausgeblendet.	Achten Sie darauf, dass der ausgewählten Multi-Region Nutzer mit zugewiesenen Lizenzen zugeordnet sind. Wenn keine Nutzer zugewiesen sind, wird die Schaltfläche Alle Nutzer exportieren nicht angezeigt.
Die Exportanfrage schlägt mit einem Fehler aufgrund von Überschreitung des Limits fehl	Wenn Ihre Nutzerliste das Exportlimit von 1.000.000 Nutzern überschreitet, wird die Exportanfrage von der Google Cloud -Konsole abgelehnt und es wird eine Fehlermeldung angezeigt, dass das Limit überschritten wurde.
Die Exportanfrage schlägt mit dem Fehler „Berechtigung verweigert“ fehl	Prüfen Sie, ob Ihrem Konto die Rolle Gemini Enterprise-Administrator zugewiesen ist. Sie enthält die erforderliche Berechtigung discoveryengine.userStores.listUserLicenses.

Nutzern Lizenzen zuweisen

In diesem Abschnitt wird beschrieben, wie Sie neuen Nutzern Lizenzen automatisch oder manuell zuweisen. Sie können einem neuen Nutzer jederzeit eine Lizenz zuweisen. Sobald eine Lizenz zugewiesen wurde, kann der Nutzer sofort auf Gemini Enterprise zugreifen.

Nutzer hinzufügen und automatisch Lizenzen zuweisen

So weisen Sie Nutzern automatisch Lizenzen zu, wenn sie sich bei der Gemini Enterprise App anmelden:

Hinweis :Ihr Abo muss ausreichend Lizenzen für die maximale Anzahl an Nutzern enthalten, die Gemini Enterprise voraussichtlich verwenden werden.

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Nutzer verwalten.

3. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

4. Wählen Sie Lizenzen automatisch zuweisen und dann das Abo aus.

   Jedes Mal, wenn sich ein Nutzer ohne manuell zugewiesene Lizenz anmeldet, weist Gemini Enterprise ihm automatisch eine Lizenz aus diesem Abo zu. Wenn im Abo keine Lizenzen mehr verfügbar sind, wird Nutzern in Gemini Enterprise eine Meldung angezeigt, dass sie keinen Zugriff haben.

   Weitere Informationen zu Abos finden Sie im Abschnitt Abos.

Nutzer hinzufügen und manuell Lizenzen zuweisen

Wenn Sie bestimmten Nutzern Zugriff auf Gemini Enterprise gewähren möchten, können Sie ihnen aus einem aktiven Abo manuell Lizenzen zuweisen.

Console

So weisen Sie Nutzern manuell Lizenzen zu:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

   Gemini Enterprise

2. Klicken Sie auf Nutzer verwalten.

3. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

4. Klicken Sie auf Nutzer hinzufügen.

5. Auf der Seite Nutzer hinzufügen:

   1. Geben Sie die E‑Mail-Adressen der Nutzer ein. Verwenden Sie dieselbe E-Mail-Adresse, mit der sich die Nutzer bei der Gemini Enterprise-App anmelden.

   2. Wählen Sie das Abo aus, das Sie zuweisen möchten.

   3. Klicken Sie auf Senden.

REST

Führen Sie den folgenden Befehl aus, um Nutzern manuell Lizenzen zuzuweisen:

Wichtiger Begriff: In Gemini Enterprise wird der Begriff App im Zusammenhang mit APIs synonym zum Begriff Engine verwendet. Eine Gemini Enterprise-Engine ist eine generische Suchmaschine, bei der das Feld app_type auf APP_TYPE_INTRANET festgelegt ist.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         },
         {
            "userPrincipal":"USER_EMAIL_2",
            "licenseConfig":"projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/SUBSCRIPTION_ID"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":false
  }'

Ersetzen Sie Folgendes:

• PROJECT_ID: Die Projekt-ID.
• ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
• us für die Multiregion „USA“
• eu für die Multiregion „EU“
• global für den Standort „Global“

Weitere Informationen finden Sie unter Mehrere Regionen für den Datenspeicher angeben.

LOCATION: die Multi-Region Ihres Datenspeichers: global, us oder eu

USER_EMAIL: die E-Mail-Adresse des Nutzers, dem Sie die Lizenz zuweisen möchten

PROJECT_NUMBER: Die Nummer Ihres Projekts in Google Cloud .

SUBSCRIPTION_ID: die ID Ihres Gemini Enterprise-Abos.

Lizenzen aus abgelaufenen Abos übertragen

Wenn das Abo abgelaufen ist, können Nutzer sich nicht mehr bei Gemini Enterprise anmelden. Es gibt zwei Möglichkeiten, ihnen wieder eine Zugangsberechtigung zu gewähren:

• Vorhandene Nutzer mit abgelaufenen Lizenzen automatisch auf das Standardabo übertragen

• Vorhandene Nutzer manuell auf ein neues Abo übertragen

Hinweis :Wenn Sie einen Nutzer zuvor für den Zugriff auf eine Lizenz gesperrt haben, wird ihm innerhalb von 30 Minuten nach der Zuweisung der neuen Lizenz Zugriff auf Gemini Enterprise gewährt.

Nutzer automatisch auf ein aktives Abo übertragen

So übertragen Sie Nutzer automatisch auf ein aktives Abo:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Nutzer verwalten auf.

   Gemini Enterprise-Lizenz

2. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

3. Vergewissern Sie sich, dass Sie ein aktives Abo haben. Falls nicht, schließen Sie ein Abo ab.

4. Wählen Sie Lizenzen automatisch zuweisen und dann das aktive Abo aus.

5. Wählen Sie Abgelaufene Lizenz automatisch aktualisieren aus.

   Wenn sich ein Nutzer mit einer abgelaufenen Lizenz das nächste Mal anmeldet, gewährt Gemini Enterprise ihm automatisch eine Lizenz für das ausgewählte Abo.

Nutzer manuell auf ein aktives Abo übertragen

So übertragen Sie Nutzer manuell auf ein aktives Abo:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Nutzer verwalten auf.

   Gemini Enterprise-Lizenz

2. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

3. Vergewissern Sie sich, dass Sie ein aktives Abo haben. Falls nicht, schließen Sie ein Abo ab.

4. Wählen Sie die Nutzer aus und klicken Sie auf Andere Lizenz zuweisen.

5. Wählen Sie im Bereich Nutzer bearbeiten das Abo aus und klicken Sie auf Senden.

Lizenzen auflisten

Führen Sie den folgenden Befehl aus, um die Lizenzen und die zugewiesenen Nutzer aufzulisten:

Wichtiger Begriff: In Gemini Enterprise kann der Begriff App im Zusammenhang mit APIs synonym mit dem Begriff Engine verwendet werden. Eine Gemini Enterprise-Engine ist eine generische Suchmaschine, bei der das Feld app_type auf APP_TYPE_INTRANET festgelegt ist.

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store/userLicenses"

Ersetzen Sie Folgendes:

• PROJECT_ID: Die Projekt-ID.
• ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
• us für die Multiregion „USA“
• eu für die Multiregion „EU“
• global für den Standort „Global“

Weitere Informationen finden Sie unter Mehrere Regionen für den Datenspeicher angeben.

LOCATION: die Multi-Region Ihres Datenspeichers: global, us oder eu

Nutzer aus einer Lizenz entfernen

Sie können einem Nutzer jederzeit eine Lizenz entziehen. Wird eine Lizenz entfernt, verliert der Nutzer sofort den Zugriff auf Gemini Enterprise. So entfernen Sie Nutzer aus einer Lizenz:

Console

So entfernen Sie Nutzer über die Google Cloud Console aus einer Lizenz:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Nutzer verwalten auf.

   Gemini Enterprise-Lizenz

2. Wählen Sie die Multi-Region der vorhandenen Lizenz aus.

3. Wählen Sie in der Tabelle „Nutzer“ die gewünschten Nutzer aus.

4. Wählen Sie eine der folgenden Optionen aus, um Nutzer aus einer Lizenz zu entfernen:

   • Wenn Sie die Lizenz nur für die ausgewählten Nutzer entfernen möchten, klicken Sie auf Lizenzzuweisung aufheben.
   • Wenn Sie die Lizenz entfernen und die ausgewählten Nutzer auch aus dem Projekt löschen möchten, klicken Sie auf Zuweisung der Lizenz aufheben und Lizenz löschen.

5. Klicken Sie auf Bestätigen.

REST

Führen Sie den folgenden Befehl aus, um Nutzer aus einer Lizenz zu entfernen:

Wichtiger Begriff: In Gemini Enterprise wird der Begriff App im Zusammenhang mit APIs synonym zum Begriff Engine verwendet. Eine Gemini Enterprise-Engine ist eine generische Suchmaschine, bei der das Feld app_type auf APP_TYPE_INTRANET festgelegt ist.

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userStores/default_user_store:batchUpdateUserLicenses" \
  -d '{
   "inlineSource":{
      "userLicenses":[
         {
            "userPrincipal":"USER_EMAIL_1"
         },
         {
            "userPrincipal":"USER_EMAIL_2"
         }
      ],
      "updateMask": "userPrincipal,licenseConfig"
   },
   "deleteUnassignedUserLicenses":true
  }'

Ersetzen Sie Folgendes:

• PROJECT_ID: Die Projekt-ID.
• ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Geben Sie einen der folgenden Werte an:
• us für die Multiregion „USA“
• eu für die Multiregion „EU“
• global für den Standort „Global“

Weitere Informationen finden Sie unter Mehrere Regionen für den Datenspeicher angeben.

LOCATION: die Multi-Region Ihres Datenspeichers: global, us oder eu

USER_EMAIL: die E-Mail-Adresse des Nutzers, den Sie aus der Lizenz entfernen möchten

Nächste Schritte

• Häufig gestellte Fragen zu Gemini Enterprise-Lizenzen
• IAM-Rollen und -Berechtigungen