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

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

אימות OAuth של Google

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

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

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

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

יצירת פרויקט

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   2. חוזרים אל Credentials > ליצירת קריטריונים > מזהה הלקוח ב-OAuth כדי להמשיך.

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

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

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

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

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

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