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

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

רמות הגישה

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

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

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

בדיקת גישה

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

חשוב: למידע נוסף על יצירת חשבון בדיקה, אפשר לעיין במדריך לחשבון בדיקה.

הגשת בקשה לגישת בדיקה

מפעילים את Google Ads API בפרויקט ב-Google Cloud כדי לקבל באופן אוטומטי גישת בדיקה לפרויקט.

רמת הגישה 'חוקר'

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

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

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

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

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

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

1. עוברים אל דף הסקירה הכללית של Google Ads API בפרויקט ב-Google Cloud.
2. מוודאים שבדף מוצגת רמת הגישה הנוכחית שלכם כבדיקה.
3. לוחצים על הקטע שדרוג רמת הגישה כדי להרחיב אותו.
4. מוודאים שרמת הגישה הבאה מוצגת כחוקר.
5. לוחצים על הלחצן בקשת גישה כדי להגיש בקשה לרמת גישה של חוקר.

יכול להיות ש-Google תשדרג אוטומטית את רמת הגישה ל-API של הפרויקט ל'חוקר' אחרי שתשלחו את הבקשה.

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

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

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

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

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

1. עוברים אל דף הסקירה הכללית של Google Ads API בפרויקט Google Cloud.
2. מוודאים שרמת הגישה הנוכחית שמוצגת בדף היא חוקר.
3. לוחצים על הקטע שדרוג רמת הגישה כדי להרחיב אותו.
4. מוודאים שרמת הגישה הבאה מוצגת כבסיסית.
5. מוודאים שאין אזהרות שמציינות שלא השלמתם את אימות המותג בפרויקט. אם יש, פועלים לפי ההוראות כדי להשלים את אימות המותג לפני שממשיכים.
6. לוחצים על הלחצן בקשת גישה כדי לבקש רמת גישה בסיסית.

יכול להיות ש-Google תשדרג אוטומטית את רמת הגישה ל-API של הפרויקט ל'בסיסית' אחרי שתשלחו את הבקשה.

הרשאת גישה רגילה

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

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

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

1. עוברים אל דף הסקירה הכללית של Google Ads API בפרויקט ב-Google Cloud.
2. מוודאים שרמת הגישה הנוכחית שמוצגת בדף היא בסיסית.
3. לוחצים על הקטע שדרוג רמת הגישה כדי להרחיב אותו.
4. מוודאים שרמת הגישה הבאה מוצגת כרגילה.
5. לוחצים על הלחצן Start application (התחלת הבקשה) כדי להתחיל את הבקשה לרמת גישה רגילה.

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

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

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

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

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

שימוש מותר

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

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

שינוי השימוש המותר

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