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

לפרויקט בענן שלכם ב-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 כדי לקבל באופן אוטומטי גישת בדיקה לפרויקט.

רמת הגישה של Explorer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שימוש מותר

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

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

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