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