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