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

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

רמות הגישה

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שימוש מותר

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

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

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