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