רמות גישה ושימוש מותר

לכל קוד מפתח של Google Ads API מוקצות רמת גישה ו'שימוש מותר'. רמת הגישה קובעת אם אפשר לבצע שינויים בחשבונות פעילים ואת מספר הפעולות והבקשות שאפשר לבצע מדי יום. השימוש המותר קובע באילו תכונות ספציפיות של Google Ads API מותר להשתמש עם קוד המפתח.

רמות הגישה

בטבלה מפורטות ארבע רמות גישה שונות של קוד מפתח, לפי הסדר. אם עדיין אין לכם גישה ל-Google Ads API, תוכלו להירשם כדי לקבל קוד מפתח עם רמת הגישה 'גישה לחשבון בדיקה'. כדי להעלות את רמת הגישה, תצטרכו לבצע כמה שלבים נוספים בבקשה.

רמת גישה יש גישה ל… מגבלת הפעולה היומית1 איך שולחים בקשת הצטרפות כמה זמן נמשך בדרך כלל תהליך הבדיקה?
בדיקת רמת הגישה לחשבון חשבונות בדיקה ‫15,000 פעולות ביום הוראות
רמת הגישה של Explorer חשבונות בדיקה וחשבונות פעילים ‫2,880 פעולות ביום לחשבונות פעילים
‫15,000 פעולות ביום לחשבונות בדיקה 		הוראות
רמת גישה בסיסית חשבונות בדיקה וחשבונות הפקה ‫15,000 פעולות ביום גם בחשבונות בדיקה וגם בחשבונות ייצור הוראות ‫5 ימי עסקים
רמת גישה רגילה חשבונות בדיקה וחשבונות הפקה מספר בלתי מוגבל של פעולות ביום בחשבונות בדיקה ובחשבונות פעילים הוראות 10 ימי עסקים

‫1 'לכל יום' מבוסס על תקופה של 24 שעות שמתחילה בכל פעם מחדש, שבה בוצעו בקשות ל-API עם קוד המפתח שלכם. אם האפליקציה חורגת ממגבלת הבקשות לרמת הגישה שלה ב-24 השעות האחרונות, היא תקבל שגיאה.

בדיקת רמת הגישה לחשבון

אחרי שתשלימו את ההרשמה הראשונית ל-Google Ads API, תקבלו קוד מפתח עם רמת הגישה'חשבון בדיקה'. המשמעות היא שקוד המפתח יכול לשלוח בקשות ל-Google Ads API רק לחשבונות בדיקה.

איך מגישים בקשה לרמת גישה לחשבון בדיקה

כדי לקבל באופן אוטומטי גישה ברמת חשבון בדיקה, צריך להשלים את ההרשמה ל-Google Ads API בממשק האינטרנט של Google Ads.

רמת הגישה של Explorer

אחרי שתשלימו את ההרשמה הראשונית ל-Google Ads API, יכול להיות שבמקרים מסוימים Google תשדרג באופן אוטומטי את קוד המפתח שלכם מרמת הגישה לחשבון בדיקהלרמת הגישה ל-Explorer. ברמת הגישה ל-Explorer, קוד המפתח יכול לשלוח בקשות ל-Google Ads API גם לחשבונות בדיקה וגם לחשבונות פעילים. חשבונות פעילים הם חשבונות שמוצגות בהם מודעות אמיתיות ופעילות של Google – בחשבונות בדיקה לא מוצגות מודעות.

רמת הגישה Explorer מאפשרת ל קוד מפתח לבצע עד 2,880 פעולות ביום בחשבונות פעילים. זה מספיק לרוב המפתחים כדי להתחיל להשתמש ב-API ולבנות אוטומציה בסיסית.

רמת הגישה 'משתמש עם הרשאת צפייה' מגבילה את הגישה לתכונות הבאות. אם אתם צריכים להשתמש בתכונות האלה, אתם צריכים להגיש בקשה לרמת גישה בסיסית או לרמת גישה רגילה.

פונקציונליות מוגבלת שירותים ושיטות מוגבלים
יצירת חשבון CustomerService.CreateCustomerClient
ניהול משתמשים CustomerUserAccessInvitationService
CustomerUserAccessService
תכנון KeywordPlanService
KeywordPlanIdeaService
KeywordPlanCampaignService
KeywordPlanCampaignKeywordService
KeywordPlanAdGroupService
KeywordPlanAdGroupKeywordService
AudienceInsightsService
KeywordPlanIdeaService
ReachPlanService
חיוב ותשלום בחשבון PaymentsAccountService
BillingSetupService
AccountBudgetProposalService
InvoiceService

איך שולחים בקשה לרמת גישה של חוקר

משלימים את ההרשמה ל-Google Ads API בממשק האינטרנט של Google Ads. במקרים מסוימים, Google עשויה לשדרג אוטומטית את קוד המפתח שלכם לרמת גישה של Explorer אחרי שתשלימו את ההרשמה.

רמת גישה בסיסית

רמת הגישה הבסיסית מאפשרת לקוד המפתח לשלוח בקשות ל-Google Ads API גם מחשבונות בדיקה וגם מחשבונות פעילים. חשבונות פעילים הם חשבונות שמוצגות בהם מודעות אמיתיות של Google Ads. בחשבונות בדיקה לא מוצגות מודעות.

רמת הגישה הבסיסית מאפשרת לקוד המפתח לבצע עד 15,000 פעולות ביום. זה מספיק לרוב המפתחים.

איך שולחים בקשה לרמת גישה בסיסית

אם יש לכם קוד מפתח עם רמת גישה לחשבון בדיקה או גישת Explorer, אתם יכולים להגיש בקשה לרמת גישה בסיסית באופן הבא:

  1. בדפדפן האינטרנט, עוברים לכתובת https://ads.google.com/aw/apicenter. אם תתבקשו, נכנסים לחשבון הניהול ב-Google Ads.

    גישה אל API Center

  2. מוודאים שרמת הגישה היא חשבון בדיקה או משתמש מתחיל.

  3. חשוב לוודא שכתובת האימייל ליצירת קשר בנושא API במרכז ה-API מעודכנת. לא תוכלו להשלים את תהליך הבקשה בלי כתובת אימייל תקינה שאתם בודקים באופן קבוע. מוודאים שקישרתם את כל החשבונות הפעילים שלכם ב-Google Ads לחשבון הניהול ב-Google Ads באמצעות אסימון ה-API.

  4. לוחצים על החץ לתפריט הנפתח לצד רמת גישה ואז על הקישור בקשת גישה בסיסית.

השלמת אימות המותג של פרויקטים ב-Google Cloud

מערכת Google Ads API משתמשת בסטטוס אימות המותג של פרויקטים ב-Google Cloud שמשויכים לאסימון מפתח, בזמן שהיא בודקת את הבקשות לרמת גישה בסיסית. כדי לזרז את תהליך הבדיקה של בקשת הגישה הבסיסית, אפשר להשלים את תהליך אימות המותג בפרויקט בענן של Google. במקרים מסוימים, יכול להיות ש-Google תבקש מכם להשלים אימות מותג בפרויקטים שלכם ב-Google Cloud כתנאי מוקדם לעיבוד בקשת הגישה הבסיסית. במדריך לאימות מותגים יש מידע נוסף.

רמת גישה רגילה

רמת הגישה הרגילה מאפשרת לקוד המפתח לבצע מספר בלתי מוגבל של פעולות ביום ברוב השירותים. זה כולל, בין השאר, את GoogleAdsService Search ואת SearchStream. לפרטים נוספים על מגבלות וחריגים ברמת הגישה הרגילה, אפשר לעיין במכסות API.

הרשאת גישה רגילה ניתנת רק למפתחים שנדרשות להם פעולות ללא הגבלה ב-Google Ads API, כמו חברות גדולות או כלים שמשרתים משתמשים רבים.

איך שולחים בקשה לרמת גישה רגילה

אם יש לכם קוד מפתח עם רמת גישה בסיסית, אתם יכולים להגיש בקשה להרשאת גישה רגילה באופן הבא:

  1. בדפדפן האינטרנט, עוברים לכתובת https://ads.google.com/aw/apicenter. אם תתבקשו, נכנסים לחשבון הניהול ב-Google Ads.

    גישה אל API Center

  2. מוודאים שרמת הגישה היא בסיסית.

  3. חשוב לוודא שכתובת האימייל ליצירת קשר בנושא API במרכז ה-API מעודכנת. לא תוכלו להשלים את תהליך הבקשה בלי כתובת אימייל תקינה שאתם בודקים באופן קבוע. מוודאים שקישרתם את כל החשבונות הפעילים שלכם ב-Google Ads לחשבון הניהול ב-Google Ads באמצעות אסימון ה-API.

  4. לוחצים על החץ לתפריט הנפתח לצד רמת הגישה ולוחצים על הקישור בקשה לגישה רגילה.

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

מכסות ל-API ומגבלות קצב מערכת

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

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

שימוש מותר

השימוש המותר חל רק על קודי מפתח עם רמות גישה בסיסית ורגילה. הקצאת השימוש המותר מתבססת על השימוש המיועד ב-Google Ads API. ההרשאות האלה קובעות באילו תכונות של ה-API אפשר להשתמש בקוד מפתח, כפי שמפורט בטבלה הבאה:

שימוש מותר תיאור
יצירה או ניהול של מודעות מתן גישה לכל השירותים של ה-API ליצירה ולניהול של קמפיינים, קבוצות של מודעות, מודעות ומילות מפתח ב-Google Ads.
דיווח תבצע רק בקשות GoogleAdsService.Search או GoogleAdsService.SearchStream או שיחות לקריאה בלבד. המאמר הזה מיועד למפתחים שמשתמשים ב-API רק כדי לבקש נתונים סטטיסטיים.
מחקר מילות מפתח והמלצות צריך לאשר לקוד המפתח גישה אל RecommendationService,‏ KeywordPlanIdeaService ו-KeywordPlanService. הנתונים האלה משמשים רק כלים שזקוקים להצעות כדי לעזור ביצירה ובניהול של קמפיינים ב-Google Ads.

איך משנים את השימוש המותר

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

הקודם
קוד מפתח
הבא
אימות הפרטים העסקיים של החברה