Abos für Gemini Enterprise erwerben und Lizenzen zuweisen

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

Zum Einrichten des Zugriffs führen Sie in der Regel die folgenden Schritte aus:

1. Beschaffen: Kaufen Sie ein Abo für eine Produktversion für Ihr Rechnungskonto.
2. Verteilen: 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. Sie können Nutzern Lizenzen manuell oder automatisch zuweisen.

• Manuell zugewiesene Lizenzen: Sie können Nutzer über deren 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 einemGoogle Cloud -Projekt benötigen, das sowohl in den USA als auch global verfügbar ist, benötigen Sie innerhalb desselbenGoogle 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. Sie können diese Abos so einrichten, dass sie automatisch verlängert werden.

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

Anzahl der Nutzungslizenzen für Abos

Wenn Sie ein nutzerbasiertes Abo direkt über dieGoogle Cloud -Konsole kaufen oder ändern, wird in der Konsole eine automatische Obergrenze für die Anzahl der Nutzerlizenzen erzwungen. Die maximale Anzahl von Nutzerlizenzen hängt von Ihrem Cloud-Rechnungskonto ab.

Wenn Ihre Organisation mehr Arbeitsplätze benötigt oder wenn Sie beim Hinzufügen von Lizenzen zu einem bestehenden Abo die Fehlermeldung erhalten, dass die maximale Anzahl von Arbeitsplätzen erreicht ist, wenden Sie sich an Ihren Vertriebsmitarbeiter oder Account Manager bei Google Cloud , um zusätzliche Lizenzen über eine Offlinebestellung zu erwerben oder eine Ausnahme für die 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. Wenn Sie diese Lizenzen jedoch Nutzern zuweisen, können sie erst auf Gemini Enterprise zugreifen, wenn das Abo aktiv ist. Weitere Informationen finden Sie unter Lizenzen verteilen.
Aktiv	Das Abo ist aktiv und Nutzer mit einer Lizenz in diesem Abo können auf Gemini Enterprise zugreifen.
Wird deaktiviert	Das Abo wird deaktiviert und die zugehörigen Lizenzen enden vorzeitig. Nutzer mit Lizenzen in diesem Abo können während eines Kulanzzeitraums von einer Woche weiterhin auf Gemini Enterprise zugreifen. Nach dieser Woche wechseln die Lizenzen in den Status „Abgelaufen“. Weitere Informationen finden Sie unter Vorzeitige Beendigung verarbeiten.
Abgelaufen	Nutzer mit Lizenzen in diesem Abo verlieren den Zugriff auf Gemini Enterprise, wenn die Abolaufzeit endet oder wenn Lizenzen nach vorzeitigem Ende des Abos vom Status „Deaktiviert“ in den Status „Abgelaufen“ übergehen.

Hinweis

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

• Alle Aufgaben unter Gemini Enterprise einrichten abschließen. Dazu zählen:

  • Rechnungskonto für Ihr Projekt einrichten
  • Weisen Sie allen Nutzern, die eine Lizenz für Gemini Enterprise erhalten sollen, mindestens die Rolle „Gemini Enterprise User“ zu.

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

  Hinweis: Wenn Ihr Projekt mit einem Selfservice-Cloud-Rechnungskonto (online) verknüpft ist, bezahlen Sie die Gemini Enterprise-Nutzung mit Pay as you go mit Prepaid-Guthaben. Wenn in Ihrem Rechnungskonto noch kein Prepaid-Guthaben eingerichtet ist, müssen Sie Guthaben kaufen, um ein Abo abzuschließen. Wenn Ihr Projekt mit einem Cloud-Rechnungskonto mit monatlicher Rechnungsstellung verknüpft ist, wird die Nutzung auf Ihrer monatlichen Rechnung abgerechnet.

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

    • Billing Account Administrator (roles/billing.admin)
    • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

    Alternativ können Sie IAM-Berechtigungen detailliert steuern, indem Sie anstelle der Rolle Billing Account Administrator 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, müssen Sie ein Abo für eine Gemini Enterprise-Version für Ihr Rechnungskonto abschließen. Das Abo bietet einen Pool von Lizenzen, die Sie mit jedem Projekt verwenden können, das mit diesem Rechnungskonto verbunden ist. Sie können die Lizenzen auf Projekte verteilen und Nutzern zuweisen.

Standard und Plus

So abonnieren Sie Gemini Enterprise Standard oder die Plus-Version:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

3. Klicken Sie auf Abo erstellen.

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

5. Konfigurieren Sie die Abrechnungsdetails:

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

6. Wählen Sie einen Abozeitraum aus.

7. Wenn das Abo automatisch verlängert werden soll, klicken Sie das Kästchen Abo automatisch verlängern an.

8. Konfigurieren Sie die Verteilungsdetails:

   1. Geben Sie im Feld Projekt eine Projekt-ID ein und wählen Sie dann ein Projekt aus den übereinstimmenden Optionen aus. Aktivieren Sie die erforderlichen APIs, wenn Sie in der Console dazu aufgefordert werden.
   2. Wählen Sie für Ihr Abo einen Standort 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.

9. Klicken Sie auf Erstellen > Bestätigen.

Pay as you go

Bei einem „Pay as you go“-Abo zahlen Sie monatlich für das, was Sie verbrauchen. Weitere Informationen finden Sie unter Kontingente und Preise für die Pay-as-you-go-Version. Sie können das Abo mit jedem Projekt verwenden, das mit Ihrem Rechnungskonto verknüpft ist.

Hinweis: Wenn Ihr Projekt mit einem Selfservice-Cloud-Rechnungskonto (online) verknüpft ist, bezahlen Sie die Gemini Enterprise-Nutzung mit Pay as you go mit Prepaid-Guthaben. Wenn in Ihrem Rechnungskonto noch kein Prepaid-Guthaben eingerichtet ist, müssen Sie Guthaben kaufen, um ein Abo abzuschließen. Wenn Ihr Projekt mit einem Cloud-Rechnungskonto mit monatlicher Rechnungsstellung verknüpft ist, wird die Nutzung auf Ihrer monatlichen Rechnung abgerechnet.

So abonnieren Sie die Gemini Enterprise-Version mit „Pay as you go“:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

3. Klicken Sie auf Abo erstellen.

4. Klicken Sie für die Version Gemini Enterprise mit „Pay as you go“ auf Tarif erstellen.

5. Konfigurieren Sie die Abrechnungsdetails:

   1. Bestätigen Sie das Rechnungskonto oder wählen Sie es aus dem Drop-down-Menü aus.
   2. Geben Sie einen Abonamen ein.
   3. Geben Sie die Anzahl der „Pay as you go“-Lizenzen ein, die Sie für die Version benötigen.

6. Konfigurieren Sie die Verteilungsdetails:

   1. Geben Sie im Feld Projekt eine Projekt-ID ein und wählen Sie dann ein Projekt aus den übereinstimmenden Optionen aus. Aktivieren Sie die erforderlichen APIs, wenn Sie in der Console dazu aufgefordert werden.
   2. Wählen Sie für Ihr Abo einen Standort 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.

7. Klicken Sie auf Erstellen > Bestätigen.

8. Wenn Ihr Projekt mit einem Selfservice-Cloud-Rechnungskonto (online) verknüpft ist, wird das Fenster Guthaben kaufen geöffnet. Wählen Sie einen Betrag und eine Zahlungsmethode aus und schließen Sie den Kauf ab. Optional können Sie das automatische Aufladen einrichten.

   Wenn Sie noch kein Prepaidguthaben für das Rechnungskonto eingerichtet haben, müssen Sie Guthaben kaufen. Wenn Sie abbrechen, wird kein Abo erstellt und Google stellt Ihnen nichts in Rechnung. Weitere Informationen finden Sie unter Prepaid-Guthaben verwalten.

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 > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

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

REST

Führen Sie den folgenden Befehl aus, um Details zum Abo 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 oder ‑ID, die Sie für die Abrechnung und das Kontingent für diesen API-Aufruf verwenden. Sie benötigen die Rolle Service Usage Consumer für dieses Projekt.

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

Wie Sie weitere Lizenzen hinzufügen, hängt davon ab, wie Sie Ihr Abo ursprünglich erworben haben:

• Wenn Sie Ihr Abo über die Google Cloud Console erworben haben, können Sie weitere Lizenzen direkt in der Google Cloud Console 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 Lizenzanzahl aktualisieren. Wenden Sie sich an Ihren Google Account Manager, um das Bestellformular zu aktualisieren.

Hinweis: Wenn Sie die Anzahl der Nutzerlizenzen für Ihr Abo in der Google Cloud Console aktualisieren, wird in der Console eine maximale Anzahl von Nutzerlizenzen basierend auf Ihrem Cloud-Rechnungskonto erzwungen. Weitere Informationen finden Sie unter Beschränkungen für die Anzahl der Nutzerlizenzen für Abos.

Wenn Ihr bestehendes Abo dieses Limit überschreitet (z. B. wenn Sie es ursprünglich über eine vertriebsgesteuerte Offlinebestellung erworben haben), erhalten Sie möglicherweise eine Fehlermeldung, wenn Sie versuchen, weitere Lizenzen direkt über die Google Cloud Console hinzuzufügen. Wenden Sie sich an Ihren Vertriebsmitarbeiter oder Account Manager von Google Cloud , um die Anzahl Ihrer Lizenzen anzupassen oder eine Ausnahme für die Zulassungsliste zu beantragen.

So aktualisieren Sie die Lizenzanzahl oder die Verlängerungseinstellungen, wenn Sie Ihr Abo über die Google Cloud Console erworben haben:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

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

4. Klicken Sie auf der Seite Abodetails auf Bearbeiten.

5. Geben Sie im Bereich Abo bearbeiten einen neuen Wert in das Feld Anzahl der Lizenzen ein oder aktivieren bzw. deaktivieren Sie das Kästchen 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 Google kann Ihnen bis zu diesem Datum Gebühren in Rechnung stellen. Weitere Informationen zu Ihrem Abo finden Sie unter Abodetails ansehen.

So kündigen Sie Ihr Abo:

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

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

4. Klicken Sie auf der Seite Abodetails auf Bearbeiten.

5. Entfernen Sie im Bereich Abo bearbeiten das Häkchen aus dem Kästchen Automatische Verlängerung.

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 ein vorheriger Versuch, Lizenzen zu verteilen, fehlgeschlagen ist, gehen Sie so vor:

Console

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

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

4. Klicken Sie auf der Seite Abodetails auf Lizenzen verteilen.

   Der Bereich Lizenzen verteilen wird geöffnet. Hier sehen Sie die vorhandenen Projektlizenzzuweisungen sowie die Anzahl der verfügbaren Lizenzen und der Gesamtlizenzen.

5. So verteilen Sie Lizenzen auf ein Projekt:

   1. Geben Sie im Feld Projekt auswählen eine Projekt-ID ein und wählen Sie dann ein Projekt aus den übereinstimmenden Optionen aus.
   2. Wenn Sie in einem Dialogfeld aufgefordert werden, die Discovery Engine API für das ausgewählte Projekt zu aktivieren, klicken Sie darauf, um sie zu aktivieren.
   3. Wählen Sie im Drop-down-Menü Region eine Region aus.
   4. Geben Sie im Feld Anzahl der Lizenzen die Anzahl der zuzuweisenden Lizenzen ein.
   5. Optional: Wenn Sie Lizenzen weiteren Projekten oder Regionen zuweisen möchten, klicken Sie auf Lizenzverteilung hinzufügen und wiederholen Sie diese Schritte.
   Hinweis: Wenn Sie eine vorhandene Zeile löschen (Element löschen) oder die Anzahl im Feld Lizenzanzahl einer Zeile verringern, werden diese Lizenzen wieder freigegeben. Sie können Lizenzen nur einmal pro Tag zurückfordern. Weitere Informationen finden Sie unter Nicht zugewiesene Lizenzen in einem Abo zurückfordern.

6. Klicken Sie auf Senden.

7. Klicken Sie im Dialogfeld Lizenzverteilung bestätigen auf Senden.

REST

Führen Sie den folgenden Befehl aus, um Lizenzen auf 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 oder ‑ID, die Sie für die Abrechnung und das Kontingent für diesen API-Aufruf verwenden. Sie benötigen die Rolle Service Usage Consumer für dieses Projekt. Sie können TARGET_PROJECT_NUMBER verwenden, wenn Sie Discovery Engine für dieses Projekt aktiviert 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: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.

• TARGET_PROJECT_NUMBER: die Projektnummer, an die Sie Lizenzen verteilen 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 Abodetails 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 Abodetails aufrufen.

  Hinweis: Wenn Sie die LICENSE_CONFIG_ID in dieser API-Anfrage weglassen, erstellt die API eine neue Lizenzkonfiguration für die angegebene Projektnummer und den angegebenen Standort. 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 Verteilung auf andere Projekte verfügbar sind.

Hinweis: Wenn Sie eine Zeile aus der Tabelle zur Lizenzverteilung löschen (Element löschen) oder die Anzahl im Feld Anzahl der Lizenzen einer Zeile verringern, werden diese Lizenzen zurückgefordert. Sie können Lizenzen nur einmal pro Tag zurückfordern.

Console

1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise > Tarife und Abrechnung auf.

   Zu „Abos und Abrechnung“

2. Wählen Sie im Drop-down-Menü Ausgewähltes Rechnungskonto Ihr Rechnungskonto aus.

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

4. Klicken Sie auf der Seite Abodetails auf Lizenzen verteilen.

5. Suchen Sie in der Liste der Zuweisungen die Zeile für das Projekt und die Region, aus der Sie Lizenzen zurückfordern möchten.

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

   • Wenn Sie die Anzahl der Lizenzen verringern möchten, reduzieren Sie die Anzahl im Feld Anzahl der Lizenzen.
   • Wenn Sie alle Lizenzen aus der Zeile zurückfordern möchten, bewegen Sie den Mauszeiger auf die Zeile und klicken Sie dann auf Element löschen.

7. Klicken Sie auf Senden.

8. Lesen Sie im Dialogfeld Lizenzverteilung bestätigen die Warnung, dass Lizenzen nur einmal pro Tag zurückgezogen werden können, und klicken Sie dann auf Senden.

REST

Führen Sie den folgenden Befehl aus, um Abolizenzen zurück in das Rechnungskonto zu übertragen, um sie neu 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 '{
    "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 oder ‑ID, die Sie für die Abrechnung und das Kontingent für diesen API-Aufruf verwenden. Sie benötigen die Rolle Service Usage Consumer für dieses Projekt. Sie können TARGET_PROJECT_NUMBER verwenden, wenn Sie Discovery Engine für dieses Projekt aktiviert 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: Der multiregionale Standort Ihres Datenspeichers: global, us oder eu.

• TARGET_PROJECT_NUMBER: die Projektnummer, von der Sie Lizenzen zurückfordern möchten. Das ist das Projekt, in dem Sie die Lizenzen zugewiesen haben.

• LICENSE_COUNT: die Anzahl der Lizenzen, die zurückgefordert werden sollen.

• BILLING_ACCOUNT_ID: ID Ihres Google Cloud -Rechnungskontos.

• BILLING_ACCOUNT_LICENSE_CONFIG_ID: Suchen Sie in den Abodetails nach der Lizenzkonfigurations-ID des Rechnungskontos.

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

Vorzeitige Kündigung verarbeiten

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

Damit die Umstellung reibungslos verläuft und Dienstunterbrechungen vermieden werden, bieten wir einen einwöchigen Kulanzzeitraum (sieben Tage) an, in dem 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 eine deaktivierte Lizenz in derGoogle Cloud Console:

Nutzerlizenzen verwalten

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

Lizenzen abrufen

So rufen Sie die Lizenzen und die Nutzer auf, denen Sie sie zugewiesen haben:

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 Nutzertabelle in der Google Cloud Console unterstützt weder Sortieren noch Filtern. Wenn Sie Ihre Nutzerdaten sortieren, filtern oder analysieren möchten, können Sie bis zu 1.000.000 Nutzerdatensätze in eine CSV-Datei 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 für das zugewiesene Abo des Nutzers (z. B. projects/PROJECT_NUMBER/locations/LOCATION/licenseConfigs/LICENSE_CONFIG_ID). Die Lizenzkonfigurations-ID entspricht der Gemini Enterprise-Version (z. B. Standard oder Plus), die ein Administrator dem Nutzer zugewiesen hat.
assignment_time	Der Zeitstempel (in UTC), zu dem 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 ihm 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 Nutzertabelle kann der Export der Daten 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 den Standard-Download-Speicherort Ihres Browsers heruntergeladen.

Probleme beim Exportieren beheben

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

Problem	Lösung
Die Schaltfläche Alle Nutzer exportieren ist ausgeblendet.	Achten Sie darauf, dass Sie Nutzern in der ausgewählten Multiregion Lizenzen zugewiesen haben. Wenn keine Nutzer zugewiesene Lizenzen haben, wird die Schaltfläche Alle Nutzer exportieren nicht angezeigt.
Die Exportanfrage schlägt mit einem Fehler fehl, der auf eine Überschreitung des Limits hinweist.	Wenn Ihre Nutzerliste das Exportlimit von 1.000.000 Nutzern überschreitet, lehnt die Google Cloud -Konsole die Exportanfrage ab und zeigt eine Fehlermeldung an, dass das Limit überschritten wurde.
Die Exportanfrage schlägt mit dem Fehler „Berechtigung verweigert“ fehl.	Prüfen Sie, ob Ihr Konto die Rolle Gemini Enterprise Admin hat, die die erforderliche Berechtigung discoveryengine.userStores.listUserLicenses enthält.

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 zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.

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, die Zugangsberechtigung wiederherzustellen:

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

• Vorhandene Nutzer manuell auf ein neues Abo übertragen

Hinweis: Wenn Sie einem Nutzer zuvor den Zugriff auf eine Lizenz verweigert haben, gewährt Gemini Enterprise ihm innerhalb von 30 Minuten nach der Zuweisung der neuen Lizenz Zugriff.

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, erhält er von Gemini Enterprise 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 zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.

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

Nutzer aus einer Lizenz entfernen

Sie können einem Nutzer jederzeit eine Lizenz entziehen. Wenn Sie eine Lizenz entfernen, 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 zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.

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