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 bestimmtes Notebook kann jeweils nur eine Audio-Übersicht haben. Auf dieser Seite wird beschrieben, wie Sie Audio-Zusammenfassungen erstellen und löschen.

Unterschied zwischen einer Audio-Zusammenfassung und einem Podcast

Audio-Zusammenfassungen unterscheiden sich in folgenden Punkten von Podcasts:

  • Eine Audio-Zusammenfassung muss einem Notebook mit hinzugefügten Datenquellen zugeordnet sein. Ein Podcast kann hingegen ohne Gemini Notebook Enterprise-Notebook, Gemini Enterprise-Lizenz oder Datenspeicher generiert werden. Zum Erstellen eines Podcasts benötigen Sie lediglich ein aktiviertes Google CloudProjekt und die Rolle „Podcast API User“.
  • Rufen Sie zum Erstellen einer Audio-Zusammenfassung die Methode notebooks.audioOverview auf. Wenn Sie einen Podcast erstellen möchten, rufen Sie die Methode podcasts auf, eine eigenständige API.

Audio-Zusammenfassung erstellen

Rufen Sie die Methode notebooks.audioOverviews.create auf, um eine Audio-Zusammenfassung für die Inhalte in Ihrem Notebook zu erstellen. Da Sie nur eine Audio-Zusammenfassung pro Notebook haben können, ist diese Methode nur erfolgreich, wenn für das Notebook noch keine Audio-Zusammenfassung vorhanden ist.

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übersicht 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übersicht hervorgehoben werden müssen.
  • LANGUAGE_CODE: Der Sprachcode, in dem die Audioübersicht 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 überprüfen

    So überprüfen Sie die generierte Audioübersicht:

    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 einige Augenblicke, bis die Übersicht geladen ist.

      Im Studio können Sie Ihre Audio-Zusammenfassung verwalten, z. B. die Wiedergabegeschwindigkeit ändern oder die Audio-Zusammenfassungsdatei 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.