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

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

רמות הגישה

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

רמת גישה יש גישה ל… מגבלת הפעולה היומית1 איך שולחים בקשת הצטרפות כמה זמן נמשך בדרך כלל תהליך הבדיקה?
רמת הגישה לחשבון הבדיקה חשבונות בדיקה ‫15,000 פעולות ביום הוראות
רמת הגישה של Explorer חשבונות בדיקה וחשבונות הפקה ‫2,880 פעולות ביום לחשבונות פעילים
‫15,000 פעולות ביום לחשבונות בדיקה 		הוראות
רמת גישה בסיסית חשבונות בדיקה וחשבונות הפקה ‫15,000 פעולות ביום גם בחשבונות בדיקה וגם בחשבונות ייצור הוראות 2 ימי עסקים
רמת גישה רגילה חשבונות בדיקה וחשבונות הפקה מספר בלתי מוגבל של פעולות ביום גם בחשבונות בדיקה וגם בחשבונות הפקה הוראות 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 Ads – בחשבונות בדיקה לא מוצגות מודעות.

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

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

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

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

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

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

    גישה אל API Center

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

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

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

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

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

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

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

הקודם
קוד מפתח
הבא
גיליון תעריפים