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

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

כניסה לדף הסקירה הכללית של Google Ads API במסוף Cloud

רמות הגישה

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

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

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

בדיקת גישה

אחרי שתפעילו את Google Ads API, הפרויקט שלכם ב-Google Cloud יקבל גישת בדיקה. זה אומר שהפרויקט יכול לשלוח בקשות ל-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. לוחצים על הכפתור בקשת גישה כדי לבקש גישה ברמת Explorer.

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

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

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

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

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

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

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

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

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

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

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

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

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

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