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