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