מגבלת שימוש

מגבלות השימוש מגינות על התשתית של 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 ומשנים את תהליך העבודה כדי להתאים בצורה טובה יותר לבקשות של מפרסמים שונים, או באופן כללי להאט את קצב שליחת הבקשות.

לא ניתן להגיש בקשה להגדלת מכסה של Display & Video 360 API.