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 generieren. Ein bestimmtes 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 hingegen ohne NotebookLM Enterprise-Notebook, Gemini Enterprise-Lizenz oder Datenspeicher generiert werden. Zum Erstellen eines Podcasts benötigen Sie lediglich ein aktiviertes Google Cloud Projekt und die Rolle „Podcast API User“.
  • Rufen Sie zum Erstellen einer Audio-Zusammenfassung die Methode notebooks.audioOverview auf. Rufen Sie zum Erstellen eines Podcasts die Methode podcasts auf, eine eigenständige API.

Audio-Zusammenfassung erstellen

Rufen Sie die notebooks.audioOverviews.create Methode auf, um eine Audio-Zusammenfassung für die Inhalte in Ihrem Notebook zu generieren. Da Sie nur eine Audio-Zusammenfassung pro Notebook haben können, ist diese Methode nur erfolgreich, wenn das Notebook keine vorhandene 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 generieren möchten. Das sourceIdsfield ist 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 Generierung der Audio-Zusammenfassung in Bearbeitung ist.

      {
    "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-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. Das Laden der Zusammenfassung dauert einige Augenblicke.

      Im Studio können Sie Ihre Audio-Zusammenfassung mit Aufgaben wie dem Ändern der Wiedergabegeschwindigkeit und dem Herunterladen oder Löschen der Audio-Zusammenfassungsdatei verwalten.

    Audio-Zusammenfassung löschen

    Rufen Sie die notebooks.audioOverviews.delete Methode auf, um eine vorhandene Audio-Zusammenfassung zu löschen.

    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, sollte eine leere JSON-Antwort zurückgegeben werden.