הגדרת פרויקט ב-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 כדי שהמשתמשים לא יופיעו במסך של ממשק המשתמש לא מאומת. בהקשר הזה, אפליקציה מוגדרת ב-Google Cloud כמזהה לקוח ייחודי ב-OAuth 2.0.

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

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

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

יוצרים פרויקט

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

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

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

1. פותחים את ספריית ה-API במסוף 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. בוחרים את סוג המשתמש ולוחצים על יצירה.

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

4. בדף הבא לוחצים על הוספה או הסרה של היקפים.

   • גוללים למטה ומזינים את הערכים הבאים בשדה Add Manually adds (הוספה ידנית של היקפים):

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

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

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

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

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

6. לעיין בדף הסיכום וללחוץ על חזרה למרכז השליטה.

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

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

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

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

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

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

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

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

2. במסך Credentials, לוחצים על CREATE CREDENTIALS ואז על OAuth Client ID.

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

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

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

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

3. בוחרים באפשרות Desktop app או Web application כסוג האפליקציה, בהתאם לתרחיש לדוגמה שלכם.

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

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

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

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

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