מגבלות

בדף הזה מפורטות מכסות ומגבלות שונות שספציפיות לממשק ה-API לניהול של AdSense. ההגבלות האלה חלות בנוסף למגבלות ספציפיות למוצר (כמו מספר הערוצים בכל חשבון) שחלות על AdSense באופן כללי.

מכסות ברמת ה-API

כל הבקשות שנשלחות ל-AdSense Management API נספרות במסגרת המכסות הכלליות לקצב הבקשות, ללא קשר לסוג הבקשה.

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

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

תיאור	ערך של Gpa education	הערות
שאילתות בדקה למשתמש ולפרויקט יחיד	100	לא רלוונטי
שאילתות בדקה לכל המשתמשים המשתמשים בפרויקט יחיד	500	לא רלוונטי
שאילתות ביום	10,000	המכסות היומיות מתאפסות בסביבות חצות לפי שעון החוף המערבי של ארה"ב.

מגבלות על גודל הדוח

הגודל המקסימלי של דוחות שנוצרו על ידי AdSense Management API הוא בהתאם לפורמט הפלט:

• דוחות JSON (למשל, באמצעות השיטה accounts.reports.generate) מוגבלים ל-100,000 שורות לכל היותר. דוחות גדולים יותר ייחתכו, אבל התשובה כוללת שדה totalMatchedRows שכולל את הגודל של הדוח המלא, שבו אפשר להשתמש כדי לזהות אם התרחש חיתוך.
• דוחות CSV (למשל, לפי השיטה accounts.reports.generateCsv) מוגבלים ל-1,000,000 שורות לכל היותר. דוחות גדולים יותר ייחתכו.

מכסת השורות בדוח

כמו כן, AdSense Management API מחיל הגבלות על הכמות הכוללת של נתוני הדיווח שניתן לאחזר במהלך תקופות יומיות או קצרות יותר, כדי למנוע שימוש לרעה. חריגה מהמגבלות האלה תגרום לדחייה של הבקשה עם שגיאת HTTP 429 יותר מדי בקשות, עם ההודעה "חריגה ממכסת השורות בדוח".

מגבלות נוספות של בקשות

פרמטרים שונים של בקשות קובעים כמה נתונים יוחזרו לבקשה (לדוגמה, page_size לבקשות שמאפשרות חלוקה לדפים, או הפרמטר limit לבקשות ליצירת דוחות). אם הפרמטרים האלה לא מוגדרים, ערך ברירת המחדל הוא תמיד הערך המקסימלי המותר. אם מציינים ערך גבוה יותר, הבקשה תידחה ותוצג השגיאה "בקשה שגויה" ב-HTTP 400.