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