פתרון בעיות

בדף הזה מוסבר איך לפתור בעיות ב-Video Stitcher API. השגיאות שמוצגות בדף הזה ספציפיות ל-Video Stitcher API. מידע על שגיאות כלליות בממשקי Google API זמין בדף Errors של Cloud APIs.

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

לא ניתן לאחזר פלייליסט כשיוצרים סשן

הבעיה הבאה מתרחשת כש-Video Stitcher API לא מצליח לאחזר את מניפסט הסרטון מ-sourceUri שצוין.

{
  "error": {
    "code": 404,
    "message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
    "status": "NOT_FOUND",
  }
}

כדי לפתור את הבעיה, פועלים לפי השלבים הבאים:

  1. מוודאים שכתובות ה-URL שצוינו sourceUri מקשרות למניפסט וידאו תקין.

    • שימוש ב-curl עם sourceUri. אם המניפסט מיועד להיות נגיש לכולם, צריך לוודא שאפשר להגיע לכתובת ה-URL באופן ציבורי.
    • אם הערך של sourceUri נכון ומניפסט הסרטון דורש חתימה על כתובת ה-URL, עוברים לשלב הבא.

  2. מוודאים שמפתח ה-CDN נרשם ב-Video Stitcher API באותו אזור שבו נשלחה הבקשה.

  3. אם אתם חושדים שהמפתח הפרטי ששימש לחתימה על כתובת ה-URL שגוי, כדאי לעדכן את מפתח ה-CDN הרשום במפתח הפרטי הנכון.

מפתח ה-CDN מיושן

אם נרשם או עודכן לאחרונה מפתח CDN וממשק Video Stitcher API לא התחיל לחתום על כתובות URL באמצעות ההגדרה החדשה, צריך לבצע את השלבים הבאים כדי לאבחן את הבעיה:

  1. אם מפתח ה-CDN נרשם לאחרונה ב-Video Stitcher API, צריך להמתין לפחות 5 דקות כדי שהעדכון יתעדכן. אם הבעיה נמשכת, עוברים לשלב הבא.

  2. מוודאים שרק מפתח CDN אחד רשום לשם מארח אחד באזור. אם נרשמו כמה מפתחות CDN עם אותו שם מארח, Video Stitcher API יבחר אחד ממפתחות ה-CDN כדי לחתום על כתובת ה-URL.

לא נוספו מודעות במהלך שידור חי

אם לא הוחדרו מודעות במהלך שידור חי, אפשר לבצע את השלבים הבאים כדי לאבחן את הבעיה:

  1. מוודאים שהשידורים החיים במקור הכניסו הפסקות למודעות בקובץ המניפסט. סמני המודעות הבאים צריכים להופיע במניפסט של סרטון השידור החי כדי לציין ל-Video Stitcher API להחליף את פלחי סרטון המקור בפלחי מודעות.

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

    • אם סמני המודעות גלויים בבירור בקובץ המניפסט של המקור, ממשיכים לשלב הבא.

  2. מוודאים שתג המודעה שצוין מחזיר תגובת VAST לא ריקה.

    • מעתיקים את תג המודעה לסרגל הכתובות של דפדפן אינטרנט (לדוגמה, Chrome) ומוודאים שהוא מחזיר תגובת VAST לא ריקה. זו תגובת VAST ריקה:

      <VAST version="3.0"/>

    • אם מוחזרת תגובת VAST ריקה, הבעיה היא בתג המודעה. מוודאים שתג המודעה מוגדר בצורה נכונה בשרתי המודעות.

    • אם התגובה של VAST מאוכלסת, משתמשים ב-curl כדי לבקש את תג המודעה. חלק משרתי המודעות דורשים לספק את User-Agent הכותרת. מנסים את הפקודה curl הבאה:

      curl AD_TAG_URI

    • אם הפקודה curl מחזירה תגובת VAST ריקה, מוסיפים את הכותרת User-Agent לפקודה curl:

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI

    • אם מוחזרת תגובת VAST עם נתונים, הבעיה היא שצריך להעביר את הכותרת User-Agent אל Video Stitcher API כשיוצרים את הסשן בשידור חי. ‫Video Stitcher API משתמש בכותרת הזו כשמריצים את תג המודעה כדי לאחזר מודעות.

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

    • אם הבעיות בתג המודעה של הלקוח נפתרו, אבל המודעות לא הוכנסו, ממשיכים לשלב הבא.

  3. בדיקת הסשן הפעיל. אם הפעלתם את המודעות בסשן הרלוונטי והן מוצגות משרתי המודעות, צריך לעבור לשלב הבא.

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

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

לא נוספו מודעות בסשן VOD

  1. מוודאים שתג המודעה שצוין מחזיר תגובת VAST או VMAP לא ריקה. משתמשים בתג המודעה שסופק לפי ההוראות הבאות:

    • מעתיקים את תג המודעה לסרגל הכתובות של דפדפן אינטרנט (לדוגמה, Chrome) ומוודאים שהוא מחזיר תגובה לא ריקה של VAST,‏ VMAP או SmartXML. זוהי תגובת VAST ריקה:

    • מציבים את תג המודעה בדפדפן אינטרנט (למשל, Chrome,‏ Firefox וכו') בשורת הכתובת ומאמתת שהיא מחזירה תגובה לא ריקה של VAST,‏ VMAP או SmartXML. תגובת VAST ריקה נראית כך:

      <VAST version="3.0"/>

      זו תגובת VMAP ריקה:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>

    • אם מוחזרת תגובת VAST ריקה, הבעיה היא בתג המודעה. מוודאים שתג המודעה מוגדר בצורה נכונה בשרתי המודעות.

    • אם התגובה של VAST מאוכלסת, משתמשים ב-curl כדי לבקש את תג המודעה. חלק משרתי המודעות דורשים לספק את User-Agent הכותרת. מנסים את הפקודה curl הבאה:

      curl AD_TAG_URI

    • אם הפקודה curl מחזירה תגובת VAST ריקה, מוסיפים את הכותרת User-Agent לפקודה curl:

      curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI

    • אם מוחזרת תגובת VAST או VMAP עם נתונים, הבעיה היא שצריך להעביר את כותרת User-Agent אל Video Stitcher API כשיוצרים את סשן ה-VOD. ‫Video Stitcher API משתמש בכותרת הזו כשמריצים את תג המודעה כדי לאחזר מודעות.

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

    • אם הבעיות בתג המודעה של הלקוח נפתרו, אבל המודעות לא הוכנסו, ממשיכים לשלב הבא.

  2. בודקים את סשן ה-VOD. אם הפעלתם את המודעות בסשן הרלוונטי והן מוצגות משרתי המודעות, צריך לעבור לשלב הבא.

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

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