ניהול סקירה קולית של מחברת (API)

אחרי שיוצרים את תיקיית ה-Notebook ומוסיפים לה מקורות נתונים, אפשר ליצור סקירה קולית של תיקיית ה-Notebook באמצעות תכנות. בכל רגע נתון, מחברת נתונה יכולה לכלול רק סקירה קולית אחת. בדף הזה מוסבר איך ליצור ולמחוק סקירות קוליות.

ההבדל בין סקירה קולית לבין פודקאסט

ההבדלים בין סקירה קולית לבין פודקאסט:

  • סקירה קולית צריכה להיות משויכת ל-Notebook עם מקורות נתונים שנוספו אליו. לעומת זאת, אפשר ליצור פודקאסט בלי מחברת Gemini Notebook Enterprise, בלי רישיון ל-Gemini Enterprise או בלי מאגר נתונים. כדי ליצור פודקאסט, צריך רק פרויקט מופעל Google Cloudותפקיד משתמש ב-Podcast API.
  • כדי ליצור סקירה קולית, קוראים לשיטה notebooks.audioOverview. כדי ליצור פודקאסט, צריך להפעיל את method ‏podcasts – API עצמאי.

יצירת סקירה קולית

כדי ליצור סקירה קולית של התוכן ב-Notebook, קוראים לשיטה notebooks.audioOverviews.create. מכיוון שאפשר ליצור רק סקירה באודיו אחת לכל מחברת, השיטה הזו תצליח רק אם אין במחברת סקירה באודיו.

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"
  }

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור מרובה בארה"ב
    • ‫eu לאזור עם מספר אזורים באיחוד האירופי
    • global למיקום הגלובלי
    מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
  • LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, כמו global. מידע נוסף מופיע במאמר מיקומים.
  • ‫NOTEBOOK_ID: המזהה הייחודי של המחברת.
  • ‫SOURCE_ID: המזהה של המקור שעל בסיסו רוצים ליצור את סקירת האודיו. ‫sourceIdsfield הוא מערך אופציונלי. אם לא מציינים מזהי מקור, נעשה שימוש בכל המקורות במחברת. מידע על מזהה המקור זמין במאמר בנושא הוספה וניהול של מקורות נתונים ב-Notebook (API).
  • ‫EPISODE_FOCUS: מחרוזת שמתארת אילו נושאים או תכנים צריך להדגיש בסקירה הכללית של האודיו.
  • ‫LANGUAGE_CODE: קוד השפה שבה נשלחה הבקשה לקבלת סקירה כללית של האודיו.

אם הבקשה מצליחה, אמורה להתקבל תגובת JSON שדומה לזו. התשובה הזו מראה שיצירת הסקירה הקולית נמצאת בתהליך.

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

יצירת הסקירה הקולית נמשכת כמה דקות.

איך מאמתים סקירה קולית שנוצרה

כדי לאמת את הסקירה הקולית שנוצרה:

  1. פותחים את הנוטבוק. מידע נוסף זמין במאמר בנושא גישה למחברת שנוצרה.

  2. במחברת Studio, לוחצים על טעינה כדי לטעון את השיחה. טעינת הסקירה הכללית יכולה לקחת כמה רגעים.

    ב-Studio, אתם יכולים לנהל את הסקירה הקולית באמצעות פעולות כמו שינוי מהירות ההפעלה, הורדה או מחיקה של קובץ הסקירה הקולית.

מחיקת סקירה קולית

כדי למחוק סקירה קולית קיימת, צריך להפעיל את שיטת notebooks.audioOverviews.delete.

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" \

מחליפים את מה שכתוב בשדות הבאים:

  • ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
    • ‫us לאזור מרובה בארה"ב
    • ‫eu לאזור עם מספר אזורים באיחוד האירופי
    • global למיקום הגלובלי
    מידע נוסף זמין במאמר בנושא הגדרת מאגר נתונים במספר אזורים.
  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .
  • LOCATION: המיקום הגיאוגרפי של מאגר הנתונים, כמו global. מידע נוסף מופיע במאמר מיקומים.
  • ‫NOTEBOOK_ID: המזהה הייחודי של המחברת.

אם הבקשה מצליחה, אמור להתקבל JSON ריק.