מיכסה

הקצאת המכסה של Display & Video 360 API מגבילה את הקצב שבו פרויקט יכול לשלוח בקשות ל-API.

כדי להשתמש טוב יותר במכסת ה-API שלכם ב-Display & Video 360, מומלץ לפעול לפי השיטות המומלצות הבאות.

שליחת בקשות לכמה מפרסמים בו-זמנית

הקצאת המכסה של Display & Video 360 API מוגדרת לכל פרויקט ולכל מפרסם. מגבלות המכסה של הפרויקט הבקשות שבוצעו על ידי פרויקט. הקצאת המשאבים למפרסם מגבילה את הבקשות שפרויקט יכול לשלוח למפרסם.

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

שימוש בפרמטרים של שאילתה list

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

השיטות list כוללות שלושה פרמטרים עיקריים:

• ‫pageSize מגדיר את מספר המשאבים שאפשר להחזיר באמצעות הבקשה. גודל הדף שמוגדר כברירת מחדל תלוי בשיטה. כדי להציג יותר משאבים לכל בקשה, מגדירים את הערך הכי גבוה.
• filter מגביל את המשאבים שמופיעים ברשימה לפי הקריטריונים שצוינו. מגדירים את הערך הזה ל-list רק אם רוצים להציג קבוצת משנה של משאבים. מידע נוסף זמין במאמר סינון בקשות של רשימות.
• ‫orderBy מסדר את המשאבים שמופיעים ברשימה לפי המאפיין שצוין. כדי לאחזר את התקרה או הרצפה של רשימת המשאבים עם פחות בקשות, צריך להגדיר את הערך הזה ל-‎ ‎.

שימוש בפונקציות גורפות ובפונקציות שחלות על כל המשאבים

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

מידע נוסף על השיטות האלה זמין במאמר בקשות בכמות גדולה.

מזהי מטמון

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

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

שימוש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff)

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

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

בדוגמאות הקוד להורדת SDF נעשה שימוש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) עם ספריות הלקוח שלנו. דוגמה לזרימת השהיה מעריכית לפני ניסיון חוזר:

• מאחזרים את האובייקט Operation באמצעות בקשת get.
  • אם הערך של done הוא False, המשימה עדיין פועלת.
  • ממתינים 5 שניות + מספר אקראי של שניות, ואז מנסים לשלוח שוב את הבקשה.
• מאחזרים את הפעולה.
  • אם הערך של done הוא False, המשימה עדיין פועלת.
  • ממתינים 10 שניות + מספר אקראי של שניות, ואז מנסים לשלוח שוב את הבקשה.
• מאחזרים את הפעולה.
  • אם הערך של done הוא False, המשימה עדיין פועלת.
  • ממתינים 20 שניות + מספר אקראי של שניות, ואז מנסים לשלוח שוב את הבקשה.
• מאחזרים את הפעולה.
  • אם הערך של done הוא False, המשימה עדיין פועלת.
  • ממתינים 40 שניות + מספר אקראי של שניות, ואז מנסים לשלוח שוב את הבקשה.
• מאחזרים את הפעולה.
  • אם הערך של done הוא False, המשימה עדיין פועלת.
  • ממתינים 80 שניות + מספר שניות אקראי, ואז מנסים לשלוח שוב את הבקשה.
• ממשיכים בדפוס הזה עד ש-done הוא true או עד שמגיעים לזמן מקסימלי.