האופן שבו יוצרים ומגדירים פרויקט ב-Google API Console תלוי בתרחיש ההרשאה של OAuth 2.0 באפליקציה שלכם. בוחרים תרחיש הרשאה כדי להתאים אישית את המדריך הזה.
כדי ליצור פרטי כניסה ל-OAuth 2.0 ולהפעיל את Google Ads API באפליקציה, צריך פרויקט ב-Google API Console.
פרטי הכניסה האלה מאמתים ומאשרים את האפליקציה או את משתמשי Google Ads בשרתי Google, ומאפשרים לכם ליצור טוקנים של OAuth לשימוש בקריאות ל-API.
בוחרים פרויקט קיים או יוצרים פרויקט חדש ב-Google API Console.
כדי להגדיר פרויקט חדש, פועלים לפי ההוראות במדריך בנושא יצירת פרויקט ב-Google API Console. הפעלת החיוב בפרויקט היא אופציונלית. אם החיוב מופעל, בוחרים חשבון לחיוב עבור הפרויקט החדש. אין חיוב על השימוש ב-Google Ads API, אבל פרויקטים ב-Cloud כפופים למגבלות המכסה הרגילות של הפרויקט.
הפעלת Google Ads API בפרויקט
כדי להפעיל את Google Ads API בפרויקט, מבצעים את השלבים הבאים:
פותחים את API Library ב-Google API Console. אם מופיעה בקשה, בוחרים את הפרויקט או יוצרים פרויקט חדש. בספריית ה-API מפורטים כל ממשקי ה-API הזמינים, מקובצים לפי משפחת מוצרים ופופולריות.
אם Google Ads API לא מופיע ברשימה, משתמשים בחיפוש כדי למצוא אותו.
בוחרים באפשרות Google Ads API ולוחצים על הלחצן הפעלה.
שליחת בקשה לגישה ל-API
לאחר מכן, עוברים אל הדף 'סקירה כללית של Google Ads API' כדי לבדוק את רמת הגישה הנוכחית ל-API. אם רמת הגישה הנוכחית שלך ל-API היא Test, מרחיבים את הקטע שדרוג רמת הגישה. פועלים לפי ההוראות כדי להגיש בקשה לרמת הגישה Explorer.
אחרי שתשלימו את הבקשה, Google תבדוק אותה באופן אוטומטי וברוב המקרים תשדרג את הגישה שלכם לגישת Explorer.
מגדירים את מסך ההסכמה של OAuth
כשמשתמשים ב-OAuth 2.0 לאימות, Google מציגה למשתמש מסך הסכמה שכולל סיכום של הפרויקט, המדיניות והיקפי ההרשאות המבוקשים לגישה. הגדרת מסך ההסכמה ל-OAuth של האפליקציה קובעת מה מוצג למשתמשים ולבודקי האפליקציה, ורושמת את האפליקציה כדי שתוכלו לפרסם אותה בהמשך.
מגדירים מסך הסכמה ל-OAuth לאפליקציה ומוסיפים את https://www.googleapis.com/auth/adwords כהיקף הרשאות של OAuth.
שיקולים חשובים לגבי סוג המשתמש וסטטוס הפרסום
כשמגדירים את מסך ההסכמה ל-OAuth, חשוב לשים לב להגדרות סוג המשתמש וסטטוס הפרסום.
- סוג המשתמש: מגדיר אם האפליקציה מוגבלת למשתמשים בארגון שלכם (פנימי) או זמינה לכל משתמש Google (חיצוני). האפשרות פנימי זמינה רק אם הפרויקט שלכם הוא חלק מארגון Google Workspace.
- סטטוס הפרסום: קובע אם האפליקציה נמצאת במצב בדיקה (מוגבל למשתמשי בדיקה ספציפיים שמוסיפים) או במצב בשלב הייצור (זמינה לקהל שהוגדר על ידי סוג המשתמש, שעשוי לדרוש אימות אפליקציות על ידי Google).
כדי לקבל את ההחלטות הכי טובות לגבי האפליקציה, מומלץ לעיין בהסברים המפורטים ובהשלכות של ההגדרות האלה במסמכי התמיכה הרשמיים של Google Cloud:
חשוב להבין את ההגדרות האלה כדי לוודא שהמשתמשים הרצויים יוכלו לגשת לאפליקציה.
יצירת מזהה לקוח וסוד לקוח
יוצרים מזהה לקוח וסוד לקוח. אפשר לבחור באפשרות Desktop app או באפשרות אפליקציית אינטרנט בתור סוג האפליקציה. אחרי שיוצרים את לקוח OAuth 2.0, מורידים את קובץ ה-JSON של הלקוח בלחיצה על הלחצן Download JSON בתיבת הדו-שיח לאישור.