לכל קוד מפתח של Google Ads API מוקצים רמת גישה ו'שימוש מותר'. רמת הגישה קובעת אם יש אפשרות להשפיע על חשבונות בסביבת הייצור ועל מספר הפעולות והבקשות שאפשר לבצע מדי יום. ההגדרה שימוש מותר קובעת באילו תכונות ספציפיות של Google Ads API מותר להשתמש בקוד המפתח.
רמות הגישה
יש שלוש רמות גישה שונות לפי הסדר בטבלה. אם עדיין אין לכם גישה ל-Google Ads API, תוכלו להתחיל בהרשמה כדי לקבל גישה לחשבון הבדיקה. אפשר להגדיל את רמת הגישה על ידי ביצוע כמה שלבים נוספים באפליקציה.
| רמת גישה | יכול לגשת... | מגבלת פעולות יומית1 | אישור |
|---|---|---|---|
| בדיקת הגישה לחשבון | חשבונות בדיקה | 15,000 פעולות ביום | הוראות |
| גישה בסיסית | חשבונות בדיקה וחשבונות ייצור | 15,000 פעולות ביום | הוראות |
| הרשאת גישה רגילה | חשבונות בדיקה וחשבונות ייצור | פעולות ללא הגבלה / יום | הוראות |
1 'ליום' מבוסס על פרק זמן של 24 שעות שבו לא נשלחו בקשות API באמצעות קוד המפתח שלכם. אם האפליקציה תחרוג ממגבלת רמת הגישה ב-24 השעות האחרונות, תופיע הודעת שגיאה.
בדיקת הגישה לחשבון
אחרי שתשלימו את ההרשמה הראשונית ל-Google Ads API, תקבלו קוד מפתח עם רמת הגישה לחשבון הבדיקה. כלומר, קוד המפתח יכול לשלוח בקשות של Google Ads API רק לחשבונות בדיקה.
הגשת בקשה לקבלת גישה לחשבון בדיקה
כדי לקבל באופן אוטומטי את רמת הגישה לחשבון הבדיקה, משלימים את ההרשמה ל-Google Ads API בממשק האינטרנט של Google Ads.
גישה בסיסית
גישה בסיסית מאפשרת לקוד המפתח לשלוח בקשות Google Ads API גם לחשבונות בדיקה וגם לחשבונות ייצור. חשבונות ייצור הם חשבונות שמציגים מודעות Google אמיתיות ופעילות. חשבונות בדיקה לא מציגים מודעות.
רמת גישה בסיסית מאפשרת לקוד המפתח לבצע עד 15,000 פעולות ביום. לרוב המפתחים זה מספיק.
הגשת בקשה לקבלת גישה בסיסית
אם יש לכם קוד מפתח ברמת גישה לחשבון בדיקה ואתם רוצים לבקש גישה לחשבון בסביבת הייצור, אתם צריכים למלא את טופס הבקשה לקבלת גישה בסיסית. חשוב לוודא שהשלמת את השלבים הבאים:
- ודאו שכבר יש לכם קוד מפתח עם רמת גישה לחשבון בדיקה.
- מוודאים שכתובת האימייל ליצירת קשר ב-API במרכז ה-API מעודכנת. אי אפשר להשלים את תהליך הבקשה בלי כתובת אימייל תקינה שנבדקת באופן קבוע. חשוב לוודא שכל חשבונות Google Ads הפעילים שלכם מקושרים לחשבון הניהול באמצעות אסימון ה-API.
הרשאת גישה רגילה
באמצעות גישה רגילה, קוד המפתח יכול לבצע מספר בלתי מוגבל של פעולות ביום ברוב השירותים. זה כולל, בין היתר,
GoogleAdsService Search ו-SearchStream. למידע נוסף על מגבלות וחריגים לגישה רגילה, ראו מכסות API.
רמת הגישה הרגילה ניתנת רק למפתחים שזקוקים לפעולות Google Ads API ללא הגבלה, כמו חברות גדולות או כלים שמשרתים משתמשים רבים.
ללא קשר לרמת הגישה, כל הפעולות ב-API כפופות למגבלות הקצב של יצירת הבקשות במערכת. במאמר סוגי השגיאות מוסבר איך לטפל בשגיאות שקשורות להגבלת קצב של יצירת בקשות.
הגשת בקשה לקבלת הרשאת גישה רגילה
אם יש לכם רמת גישה בסיסית ואתם רוצים להגיש בקשה לפעולות ללא הגבלה ב-Google Ads API, אתם צריכים למלא את טופס בקשת הגישה הרגילה.
אם הכלי שלכם הוא חיצוני, עליכם לתת לכלי גישת הדגמה (דמו). שימו לב שהכלי חייב לעמוד בדרישות של הפונקציונליות המינימלית הנדרשת.
שימוש מותר
השימוש המותר חל רק על אסימוני גישה בסיסיים ועל אסימוני גישה רגילים. השימוש המותר מוקצה בהתאם לשימוש המיועד ב-Google Ads API. ההרשאות האלה קובעות באילו תכונות של ה-API אפשר להשתמש באסימון, כפי שמפורט בטבלה הבאה:
| שימוש מותר | תיאור |
|---|---|
| יצירה / ניהול של מודעות | מספקים גישה לכל השירותים של ה-API ליצירה ולניהול של קמפיינים, קבוצות של מודעות, מודעות ומילות מפתח ב-Google Ads. |
| דיווח | יש לשלוח רק בקשות GoogleAdsService.Search או GoogleAdsService.SearchStream, או קריאות לקריאה בלבד. הנתון הזה מיועד למפתחים שמשתמשים רק ב-API
כדי לבקש נתונים סטטיסטיים.
|
| בדיקת מילות מפתח והמלצות | נותנים לאסימון גישה ל-RecommendationService, ל-KeywordPlanIdeaService ול-KeywordPlanService. האפשרות הזו משמשת רק בכלים שמחייבים הצעות כדי להקל על היצירה והניהול של קמפיינים ב-Google Ads. |
שינוי השימוש המותר
אם קיבלתם אישור לרמת גישה בסיסית או לרמת גישה רגילה, תוכלו למלא את הבקשה לעדכון השימוש המותר. צריך למלא את הבקשה אם רוצים לעדכן את השימוש המותר או להעניק ללקוחות גישה לכלי.