פתרון בעיות

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

בדיקת היסודות

  1. כדאי לעיין במדריך בנושא דרישות סף. עליך לוודא שיש לך גישה אל תצוגה ו Video 360 ופרויקט API שהוגדר כראוי.
  2. אם התשובה שלך מכילה שגיאות HTTP, חשוב לבדוק אותן בקפידה ולוודא שהבקשה נשלחת לשירות ול-API הנכונים.
  3. קוראים את המדריך להרשאות. צריך לוודא שהבקשה כוללת את פרטי הכניסה הנחוצים של OAuth 2.0.

  4. מוודאים שאתם משתמשים בפרטי הכניסה הנכונים. לצפייה לפרטים על יצירת תוכן מסוג Set up Your Application guide (הגדרת המדריך לאפליקציות) פרטי כניסה לאימות. אפשר גם להעביר את אסימון הגישה אל נקודת הקצה (endpoint) של Tokeninfo של Google OAuth2 API כדי לאמת שהיא שהונפקו לפרויקט ה-API הנכון ומורשים להיקפים הנכונים:

    POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}

200 OK

{
 "issued_to": "{API_PROJECT_CLIENT_ID}",
 "audience": "...",
 "scope": "{API_SCOPES}",
 "expires_in": ...
}

הסבר על השגיאות

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

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

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

מחקר שגיאות

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

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

  3. אם תיתקלו בשגיאות שאינן מתועדות, דווחו לנו על כך.

זיהוי שורש הבעיה

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

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

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

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

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

קבלת עזרה

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

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

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

איך פותרים את הבעיה

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