שגיאות ואזהרות

בדף הזה מתוארים הסוגים השונים של שגיאות ואזהרות שייתכן בזמן השימוש בתצוגה Video 360 API

שגיאות API

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

תגובת שגיאה לוקחת את הפורמט הבא וכוללת קוד תגובת HTTP: הודעת שגיאה והסטטוס של קוד RPC של Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

בהמשך מופיעה רשימה של שגיאות נפוצות ב-API, יחד עם הפעולה שמומלץ לבצע. אם הם מוחזרים:

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

קוד	הכנסה לקליק	מה מומלץ לעשות?
400	INVALID_ARGUMENT	יש בעיה בבקשה שלך. כדאי לקרוא את בשדה של ההודעה בתגובת השגיאה, ולשנות בהתאם לבקשה שלכם.
401	UNAUTHENTICATED	לא ניתן היה לאמת את הבקשה שלך כראוי. צריך לוודא שהשתמשת ב-OAuth תקין בבקשה שלכם. אפשר לקבל מידע נוסף בנושא הזה, כדאי לעיין מדריך לתחילת העבודה
403	PERMISSION_DENIED	אין לך את ההרשאות הנדרשות כדי להשלים את התהליך על הבקשה שלך. אימות שלחשבון המשתמש שלך יש את ההרשאות המתאימות לשותף הרלוונטי מפרסם.
404	NOT_FOUND	המשאב שניסית לאחזר לא יכול נמצא. עליך לוודא שהתעודה המזהה שבה השתמשת נכון ולסוג המשאב המאוחזר.
409	ABORTED	המשאב שניסית לשנות נמצא כרגע שונה במקום אחר. ממתינים כמה שניות ואז לנסות לשלוח שוב את הבקשה.
429	RESOURCE_EXHAUSTED	חרגת מהמגבלה מגבלת קצב או מכסת בקשות יומית. לבדוק את השימוש שלכם ב-API באמצעות Google API Console ולשנות את תהליך עבודה לצורך פעולה במסגרת המכסה הקיימת מגבלות בפועל. מידע נוסף זמין בדף שלנו במאמר אופטימיזציה של המכסה. אם לא ניתן להשלים את הפעולות במסגרת במכסה יומית, אתה יכול לבקש מכסה נוספת.
500	INTERNAL	אירעה שגיאה פנימית ב-API. כדאי להמתין כמה שניות ולאחר מכן לנסות שוב את הבקשה. אם השגיאה אם הבעיה נמשכת, פנו לתמיכה.
504	DEADLINE_EXCEEDED	השלמת הבקשה ב-API נמשכה יותר מדי זמן. צריך להמתין כמה שניות ואז לנסות לשלוח את הבקשה שוב. אם המיקום השגיאה נמשכת, לפנות לתמיכה.

שגיאות SDF

רשת המדיה ב-Video 360 API נעשה שימוש בשיטה אסינכרונית לצורך יצירה והורדה של קובצי נתונים מובְנים (SDF). בשביל זה הסיבה לכך, שגיאות שנזרקות במהלך יצירת SDF מוחזרות בקובץ ה-SDF המוכן של ההורדה. משימת הורדה של SDF שמסתיימת ב-error היא מסומן כ'בוצע', אבל מכיל שדה שגיאה מאוכלס במקום שם של משאב מדיה בשדה response, כמו בדוגמה החתוכה הבאה:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

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

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

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

אזהרות ללא חסימה

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

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

מניעה

ניתן להימנע מבעיות רבות שגורמות לאזהרות שאינן חוסמות, על ידי של הגדרות הפריט, כולל ההגדרות הבאות:

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

אם משכפלים הגדרות מפריט קיים, צריך לוודא הפריט הקיים לא מייצר אזהרות לא צפויות.

מעקב

בעיות שגורמות לאזהרות שאינן חוסמות עשויות להופיע בזמן שפריט מסוים נמצא בטיסה. כדי להבטיח שהפריטים מוצגים כמו שצריך, מומלץ לעקוב אחר את הפריטים הפעילים עבור אזהרות שנוצרו לאחרונה. ניתן לאחזר פריטים בכמות גדולה באמצעות הפונקציה advertisers.lineItems.list. אם המיקום פריט כלשהו מציג אזהרה לא צפויה, עליך לטפל בבעיה באופן מיידי, כדי לצמצם את ההשפעה על הצגת המודעות.

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