מגבלת שימוש

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

מגבלות מכסות על בקשות API

ב-Display & Video 360 API יש שני סוגים של מגבלות:

  • מגבלות המכסות הכוללות, שכל הבקשות הרלוונטיות נספרות כנגדן.
  • מגבלות מכסה לכתיבה, שכל הבקשות הרלוונטיות שנשלחות לשיטות הכתיבה נספרות כנגדן. שיטות כתיבה מוגדרות כשיטות – כמו create,‏ patch,‏ delete או bulkEdit – שמשנה משאבים. חשוב לדעת ששיטות מסוימות צורכות יותר מכסה של כתיבה מאשר שיטות אחרות.

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

מגבלת מכסה ברמת הפרויקט

כל המשאבים והשיטות של Display & Video 360 API משתפים את מכסות ברירת המחדל הבאות:

  • סה"כ בקשות לדקה לכל פרויקט: 1500
  • בקשות כתיבה לדקה לכל פרויקט: 700

מגבלות על מכסות בקשות ספציפיות למפרסמים

שיטות שמציינות מזהה מפרסם בכתובת ה-URL של הבקשה נספרות במכסות נוספות 'לכל מפרסם לכל פרויקט'.

כל הבקשות עם מזהה מפרסם שצוין בנתיב של כתובת ה-URL שלהן – כמו בקשות לשירותים advertisers.lineItems,‏ advertisers.creatives או advertisers.channels – ייכללו במכסות הבאות:

  • סה"כ בקשות לדקה לכל מפרסם לכל פרויקט: 300
  • בקשות לכתיבה לדקה לכל מפרסם לכל פרויקט: 150

שיטות שמתמקדות בכתיבה

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

בקשות שנשלחות לשיטות שמתמקדות בכתיבה נספרות כ-5 שאילתות כתיבה במסגרת החישוב של ניצול המכסה של בקשות הכתיבה. לדוגמה, 100 בקשות כתיבה רגילות ו-21 בקשות כתיבה עתירות (אף אחת מהן לא מציינת מפרסם) שנשלחות תוך דקה ייחשבו כ-205 שאילתות כתיבה (100 + (21 * 5) = 205) ויחרגו מהמכסה הקיימת של בקשות כלליות, שמסתכם ב-200 שאילתות כתיבה לדקה.

השיטות הבאות נחשבות לשימוש אינטנסיבי בכתיבת נתונים:

חריגה ממגבלות המכסות

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

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

קוד הכנסה לקליק הודעה מה מומלץ לעשות?
429 RESOURCE_EXHAUSTED המשאבים מוצו (למשל, צריך לבדוק את המכסות). בודקים את השימוש במסוף Google API ומשנים את תהליך העבודה כדי לבצע בקשות במקביל עבור מפרסמים שונים, או להאט את קצב שליחת הבקשות באופן כללי.

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