אנחנו מגבילים את מספר הבקשות ל-API ומקצים מכסות כדי להגן על המערכת מפני קבלת יותר נתונים ממה שהיא יכולה לטפל בהם, וכדי להבטיח חלוקה שווה של משאבי המערכת. המגבלות והמכסות עשויות להשתנות.
הגבלות קצב
מגבלות הקצב של ה-API קובעות את מספר הבקשות שאפשר לשלוח ל-Google Marketing Platform Admin API. מגבלות הקצב נאכפות וממולאות מחדש באופן אוטומטי במרווחי זמן של 60 שניות (דקה אחת). המשמעות היא שאם הפרויקט שלכם מגיע למגבלת הקצב המקסימלית בכל שלב במהלך 60 שניות, תצטרכו להמתין עד שהמכסה תתמלא מחדש לפני שתוכלו לשלוח בקשות נוספות בקבוצה הזו. אם הפרויקט חורג ממגבלת הקצב, תופיע הודעת השגיאה 403 עם הסיבה rateLimitExceeded
. כדי לפתור את השגיאה הזו, צריך להמתין דקה ולנסות שוב את הבקשה. המכסה אמורה להתאפס בתחילת התקופה הבאה.
מספר הבקשות היומיות המקסימלי ל-API מוגבל באופן טבעי על ידי מגבלות הקצב של ה-API. בשלב זה אין מכסה שימוש יומית מפורשת ל-Google Marketing Platform Admin API.
מכסות בפרויקטים ב-Cloud
מגבלות הקצב של ה-API חלות על כל פרויקט בנפרד.
במסוף Cloud מוצגות המכסות של פרויקט ב-Cloud: https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas.
בהמשך מפורטות מכסות ברירת המחדל של Google Marketing Platform Admin API, שרוב המשתמשים יראו במסוף שלהם.
שם המכסה | מגבלה |
---|---|
בקשות בדקה | 1,200 |
בקשות בדקה לכל משתמש | 600 |
פעולות כתיבה בדקה | 300 |
פעולות כתיבה בדקה לכל משתמש | 120 |
כל בקשה ל-Google Marketing Platform Admin API צורכת מכסות של Requests per minute
,Requests per minute per user
. בקשות לכל שיטה שמשנה את ההגדרות של חשבון Google Marketing Platform בכל צורה שהיא (שיטות create
, patch
, delete
, archive
ו-update
) צורכות גם מכסות של Writes per minute
ו-Writes per minute per user
.
במאמר הגדרת מכסה לשימוש ב-API מוסבר איך להגביל את מספר הבקשות ל-API לכל משתמש.