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

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

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

סקירת שמע שונה מפודקאסט בדרכים הבאות:

  • סקירה קולית צריכה להיות משויכת ל-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 הוא מערך אופציונלי; אם לא תציין מזהי מקור, כל המקורות במחברת ייעשה בהם שימוש. למידע על מזהה מקור, ראה הוספה וניהול של מקורות נתונים במחברת (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 ריק.