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

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

רמות הגישה

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

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

‫¹ 'לכל יום' מבוסס על תקופה של 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 – בחשבונות בדיקה לא מוצגות מודעות.

רמת הגישה 'חוקר' מאפשרת לקוד המפתח לבצע עד 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. בחשבונות בדיקה לא מוצגות מודעות.

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

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

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

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

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

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

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

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

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

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

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

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

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

שימוש מותר

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

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

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

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