Audio-Zusammenfassung Ihres Notebooks verwalten (API)

Nachdem Sie Ihr Notebook erstellt und Datenquellen hinzugefügt haben, können Sie programmatisch eine Audio-Zusammenfassung des Notebooks erstellen. Ein Notebook kann jeweils nur eine Audio-Zusammenfassung haben. Auf dieser Seite wird beschrieben, wie Sie Audio-Zusammenfassungen erstellen und löschen.

Unterschied zwischen einer Audio-Zusammenfassung und einem Podcast

Eine Audio-Zusammenfassung unterscheidet sich in folgenden Punkten von einem Podcast:

  • Eine Audio-Zusammenfassung muss mit einem Notebook verknüpft sein, dem Datenquellen hinzugefügt wurden. Ein Podcast kann dagegen ohne ein Gemini Notebook Enterprise-Notebook, eine Gemini Enterprise-Lizenz oder einen Datenspeicher generiert werden. Sie benötigen lediglich ein aktiviertes Google CloudProjekt und die Rolle „Podcast API User“.
  • Rufen Sie die Methode notebooks.audioOverview auf, um eine Audio-Zusammenfassung zu erstellen. Wenn Sie einen Podcast erstellen möchten, rufen Sie die Methode podcasts auf, eine eigenständige API.

Multiregionalen Endpunkt in den USA verwenden

Wenn sich Ihr Gemini Notebook Enterprise-Abo in der Multiregion „US“ befindet, können Sie die Anfragen auf dieser Seite an den multiregionalen Endpunkt „US“ (discoveryengine.us.rep.googleapis.com) senden. Ein multiregionaler Endpunkt verarbeitet Ihre Anfragen und beendet TLS innerhalb der Multiregion, sodass Ihre Anfragedaten während der Übertragung in den USA bleiben. Die Verwendung dieses Endpunkts ändert nichts am Speicherort Ihrer Notebooks. Weitere Informationen finden Sie im Sicherheitsleitfaden für Google Cloudunter Regionale und multiregionale API-Endpunkte – Übersicht.

Wenn Sie den multiregionalen Endpunkt für die USA verwenden möchten, nehmen Sie die folgenden Änderungen an jeder Anfrage-URL auf dieser Seite vor:

  1. Ersetzen Sie den Host ENDPOINT_LOCATION-discoveryengine.googleapis.com durch discoveryengine.us.rep.googleapis.com.

  2. Setzen Sie LOCATION auf us.

Der Rest der Anfrage bleibt unverändert. Informationen zum Auswählen der Multi-Region für Ihr Abo finden Sie unter Abo abschließen. Eine Liste der regionalen und multiregionalen Dienstendpunkte finden Sie im Virtual Private Cloud-Leitfaden unter Regionale und multiregionale Dienstendpunkte.

Audio-Zusammenfassung erstellen

Wenn Sie eine Audio-Zusammenfassung für die Inhalte in Ihrem Notebook erstellen möchten, rufen Sie die Methode notebooks.audioOverviews.create auf. Da Sie nur eine Audio-Zusammenfassung pro Notebook haben können, ist diese Methode nur erfolgreich, wenn das Notebook noch keine Audio-Zusammenfassung hat.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

Ersetzen Sie Folgendes:

  • 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.
  • PROJECT_NUMBER: die Nummer Ihres Google Cloud -Projekts
  • LOCATION: der geografische Standort Ihres Datenspeichers, z. B. global. Weitere Informationen finden Sie unter Gemini Enterprise-Standorte.
  • NOTEBOOK_ID: die eindeutige Kennung des Notebooks
  • SOURCE_ID: die ID der Quelle, auf deren Grundlage Sie die Audio-Zusammenfassung erstellen möchten. sourceIdsfield ist ein optionales Array. Wenn Sie keine Quell-IDs angeben, werden alle Quellen im Notebook verwendet. Informationen zur Quell-ID finden Sie unter Datenquellen zu einem Notebook hinzufügen und verwalten (API).
  • EPISODE_FOCUS: Ein String, der beschreibt, welche Themen oder Inhalte in der Audio-Zusammenfassung hervorgehoben werden müssen.
  • LANGUAGE_CODE: der Sprachcode, in dem die Audio-Zusammenfassung angefordert wurde.

    • Wenn die Anfrage erfolgreich ist, sollte eine JSON-Antwort ähnlich der folgenden zurückgegeben werden. Diese Antwort zeigt, dass die Audio-Zusammenfassung gerade erstellt wird.

      {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

    Das Erstellen einer Audio-Zusammenfassung dauert einige Minuten.

    Generierte Audio-Zusammenfassung prüfen

    So prüfen Sie die generierte Audio-Zusammenfassung:

    1. Öffnen Sie Ihr Notebook. Weitere Informationen finden Sie unter Auf das erstellte Notebook zugreifen.

    2. Klicken Sie im Studio Ihres Notebooks auf Laden, um die Unterhaltung zu laden. Es dauert einen Moment, bis die Übersicht geladen ist.

      Im Studio können Sie Ihre Audio-Zusammenfassung verwalten, z. B. die Wiedergabegeschwindigkeit ändern und die Datei mit der Audio-Zusammenfassung herunterladen oder löschen.

    Audio-Zusammenfassung löschen

    Rufen Sie zum Löschen einer vorhandenen Audio-Zusammenfassung die Methode notebooks.audioOverviews.delete auf.

    REST

    curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

    Ersetzen Sie Folgendes:

    • 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.
  • PROJECT_NUMBER: die Nummer Ihres Google Cloud -Projekts
  • LOCATION: der geografische Standort Ihres Datenspeichers, z. B. global. Weitere Informationen finden Sie unter Gemini Enterprise-Standorte.
  • NOTEBOOK_ID: die eindeutige Kennung des Notebooks

    • Wenn die Anfrage erfolgreich ist, sollten Sie ein leeres JSON-Objekt erhalten.