עדכון המדיניות בנושא שימוש במשאבים של Google Ads API

יום רביעי, 1 במאי 2024

מה משתנה?

אנחנו מעדכנים את המדיניות של Google Ads API בנושא שימוש במשאבים, כדי לווסת (throttle) דפוסים של שאילתות GoogleAdsService.Search ו-GoogleAdsService.SearchStream שצורכים כמויות מוגזמות של משאבי API. אם מבנה שאילתה מסוים מוגבל, שירותים, שיטות ומבני שאילתות אחרים ימשיכו לפעול ללא שינוי.

החל מהשבוע של 17 ביוני 2024, ורק לגבי מבני השאילתות שמווסתים, הבקשות יושפעו באופן הבא:

  • אם אתם משתמשים בגרסה v17 או בגרסה ישנה יותר של ה-API, תוצג לכם השגיאה QuotaError.RESOURCE_EXHAUSTED.
  • אם אתם משתמשים ב-API בגרסה 18 ואילך, תוצג לכם השגיאה QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION או QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, בהתאם למשך הזמן של צריכת המשאבים המוגזמת – לפרק זמן קצר (כמה דקות) או לפרק זמן ארוך.

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

מה הסיבה לשינוי?

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

מה עליי לעשות?

לפני 17 ביוני 2024, צריך לעדכן את האפליקציות כך שיבצעו את הפעולות הבאות:

  • טיפול בקודי השגיאה החדשים כשמבצעים קריאות ל-GoogleAdsService::Search or GoogleAdsService::SearchStream
    • אם אתם משתמשים בגרסה v17 או בגרסה קודמת של Google Ads API, אתם צריכים לטפל בשגיאות מסוג QuotaError.RESOURCE_EXHAUSTED.
    • אם אתם משתמשים בגרסה v18 או בגרסה עדכנית יותר של ה-API, טפלו בשגיאות QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ו-QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • אם אחד או יותר ממבני השאילתות של הדיווח מוגבלים, צריך לבדוק ולתקן את מבנה השאילתה. הנה כמה דרכים לשפר את ביצועי השאילתות:
    • להריץ את השאילתה בתדירות נמוכה יותר.
    • להשתמש בתצוגה או במבנה שאילתה פחות יקרים.

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

  • [אופציונלי] משלבים את המדד החדש query_resource_consumption במערכות המעקב כדי לזהות שאילתות חדשות ויקרות ולטפל בהן.

איך אפשר לקבל עזרה?

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

– דיוויד סטיבנס, מנהל מוצר של Google Ads API

תוויות: google-ads-api