הגדרת פרויקט ב-Google API Console עבור Google Ads API

כדי לאמת ולתת הרשאה למשתמשים ב-Google Ads, נדרשים פרטי כניסה לגישה לשרתי OAuth2 של Google. פרטי הכניסה האלה מזהים את האפליקציה שלכם ב-Google, ומאפשרים לכם ליצור אסימוני OAuth לניהול המשתמשים ב-Google Ads. את הגישה לפרטי הכניסה של Google OAuth2 מנהלים דרך Google API Console.

אימות OAuth של Google

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

האימות הזה הוא עצמאי ובנוסף לכל בדיקה שמתבצעת כחלק מתהליך האישור של קוד מפתח למפתח. הוא נדרש כי היקף הרשאות הגישה של Google Ads API הוא רגיש.

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

מומלץ לבצע את תהליך האימות של Google OAuth לכל האפליקציות בהקדם האפשרי כדי למנוע שיבושים בעסק.

יצירת פרויקט

עוברים אל מסוף Google API. לוחצים על Create project, מזינים שם ולוחצים על Create.

הפעלת Google Ads API בפרויקט

כדי להפעיל את Google Ads API בפרויקט, פועלים לפי השלבים הבאים:

1. פותחים את API Library במסוף Google API. אם מתבקשים, בוחרים את הפרויקט או יוצרים פרויקט חדש. בספריית ה-API מפורטים כל ממשקי ה-API הזמינים, שמקובצים לפי משפחת מוצרים ופופולריות.

2. אם Google Ads API לא מופיע ברשימה, מחפשים אותו.

3. בוחרים ב-Google Ads API ולוחצים על הלחצן Enable.

בחירת סוג משתמש וסטטוס פרסום

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

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

אם לא תשלימו את אימות OAuth של Google, יהיו לכך השלכות הבאות, ללא קשר לסוג המשתמש או לסטטוס הפרסום של הפרויקט:

• במהלך תהליך ההרשאה, המשתמשים מקבלים מסך ממשק משתמש לא מאומת.

• אתם יכולים להעניק הרשאה רק ל-100 משתמשים.

הגדרת מסך ההסכמה של OAuth

1. פותחים את הדף Consent Screen ובוחרים את הפרויקט בתפריט הנפתח בחלק העליון של הדף.

2. בוחרים את User Type ולוחצים על CREATE.

3. ממלאים את הטופס של מסך ההסכמה. אם צריך, אפשר לערוך את הפרטים האלה בהמשך. בסיום, לוחצים על שמירה והמשך.

4. בדף הבא, לוחצים על ADD OR REMOVE SCOPES (הוספה או הסרה של היקפי גישה).

   • גוללים למטה ומזינים את הטקסט הבא בשדה שמתחת להוספת היקפי גישה באופן ידני:

     https://www.googleapis.com/auth/adwords
     

   • לוחצים על הוספה לטבלה.

   • מוסיפים את כל ההיקפים האחרים שהפרויקט יבקש ולוחצים על UPDATE.

   • לוחצים על שמור והמשך.

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

6. בודקים את דף הסיכום ולוחצים על BACK TO DASHBOARD.

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

בחירת סוג האפליקציה

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

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

פרטים נוספים זמינים במסמכי התיעוד של OAuth ב-Google Identity Platform לאפליקציות למחשב או לאפליקציות אינטרנט.

יצירת מזהה לקוח וסוד לקוח

אחרי שתקבעו את סוג האפליקציה, עליכם לפעול לפי ההוראות הבאות כדי ליצור את מזהה הלקוח ואת הסוד של הלקוח ב-OAuth2:

1. פותחים את דף פרטי הכניסה. בוחרים פרויקט שנוצר בעבר או יוצרים פרויקט חדש.

2. במסך Credentials (פרטי כניסה), לוחצים על CREATE CREDENTIALS (יצירת פרטי כניסה) ובוחרים באפשרות OAuth client ID (מזהה לקוח OAuth).

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

      1. בוחרים את סוג המשתמש ולוחצים על CREATE.

      2. ממלאים את הטופס הראשוני. אם צריך, אפשר לערוך את הפרטים האלה בהמשך. בסיום, לוחצים על שמירה.

   2. כדי להמשיך, עוברים אל Credentials > CREATE CREDENTIALS > OAuth client ID.

3. בוחרים את סוג האפליקציה: אפליקציה למחשב או אפליקציית אינטרנט, בהתאם לתרחיש לדוגמה.

4. נותנים שם לקבוצה ולוחצים על יצירה.

5. אם סוג הלקוח הוא אפליקציית אינטרנט, צריך להוסיף לפחות URI אחד מורשה להפניה אוטומטית.

   לבדיקה מקומית שתואמת לתצורת ברירת המחדל בדוגמאות לספריות הלקוח שלנו, צריך להשתמש ב-http://127.0.0.1.

   בלקוחות של אפליקציות למחשב, עדיין תשתמשו בהפניית IP ל-loopback, אבל ה-URI לא מוגדר במפורש במסוף Cloud.

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