כדי לאמת ולאשר משתמשי Google Ads, נדרשים פרטי כניסה לשרתי OAuth2 של Google. פרטי הכניסה האלה מזהים את האפליקציה שלכם ב-Google, ומאפשרים לכם ליצור אסימוני OAuth לניהול משתמשי Google Ads. הגישה לפרטי הכניסה של Google OAuth2 מנוהלת מ-Google API Console.
כדאי לצפות בסרטון הזה עם כמה שיטות מומלצות לפרויקטים ב-Cloud
אימות 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 בפרויקט, פועלים לפי השלבים הבאים:
פותחים את ספריית ה-API במסוף Google API. אם מתבקשים, בוחרים את הפרויקט או יוצרים פרויקט חדש. בספריית ה-API מפורטים כל ממשקי ה-API הזמינים, בקיבוץ לפי משפחת המוצרים והפופולריות.
אפשר להשתמש בחיפוש כדי למצוא את Google Ads API אם הוא לא מופיע ברשימה.
בוחרים את Google Ads API ולוחצים על הלחצן Enable (הפעלה).
בחירת סוג משתמש וסטטוס פרסום
אחרי שמפעילים את ה-API, צריך לציין את סוג המשתמש ואת סטטוס הפרסום של הפרויקט. בטבלה הבאה מפורטים כמה מאפיינים מרכזיים ומגבלות של כל שילוב של ההגדרות האלה. לפרטים נוספים, קראו את מאמרי העזרה של Google Cloud Platform.
סוג משתמש | סטטוס פרסום | מגבלות |
---|---|---|
פנימי | בדיקה |
|
חיצוני | בדיקה |
|
פנימי | סביבת ייצור |
|
חיצוני | סביבת ייצור |
|
אם לא משלימים את אימות OAuth של Google, התוצאות הבאות, ללא קשר לסוג המשתמש או לסטטוס הפרסום של הפרויקט:
בתהליך ההרשאה מוצג למשתמשים מסך של ממשק משתמש לא מאומת.
אפשר לאשר עד 100 משתמשים בלבד.
הגדרת מסך ההסכמה של OAuth
פותחים את הדף Consent Screen ובוחרים את הפרויקט בתפריט הנפתח שבחלק העליון של הדף.
בוחרים את סוג המשתמש ולוחצים על יצירה.
ממלאים את הטופס למסך ההסכמה. אפשר לערוך את המידע הזה מאוחר יותר לפי הצורך. לסיום, לוחצים על שמירה והמשך.
בדף הבא לוחצים על הוספה או הסרה של היקפים.
גוללים למטה ומזינים את הערכים הבאים בשדה Add Manually adds (הוספה ידנית של היקפים):
https://www.googleapis.com/auth/adwords
לוחצים על הוספה לטבלה.
מוסיפים את כל היקפי ההרשאות שהפרויקט יבקש, ולוחצים על עדכון.
לוחצים על שמור והמשך.
אם אתם לא מתכננים לפרסם את הפרויקט באופן מיידי, אתם צריכים להוסיף את כתובת האימייל של כל חשבון משתמש שבו תשתמשו לבדיקה, ואז ללחוץ על שמירה והמשך.
לעיין בדף הסיכום וללחוץ על חזרה למרכז השליטה.
אחרי שבדקתם את האפליקציה ואת תהליך ההרשאה, תוכלו לחזור ללוח הבקרה וללחוץ על Publish APP כדי לשנות את סטטוס הפרסום מ-Testing ל-InProduction.
צריך לבחור סוג אפליקציה
ב-Google Ads API יש שתי אפשרויות לסוגי אפליקציה: מחשב או אתר. תוכלו להיעזר בטבלה הבאה כדי לקבוע איזה סוג הכי מתאים לאפליקציה שרוצים ליצור:
בחירת סוג האפליקציה הזה | אם ... |
---|---|
אפליקציה למחשב |
|
אפליקציית אינטרנט |
|
פרטים נוספים זמינים במאמרי העזרה של Google Identity Platform בנושא OAuth של אפליקציות למחשב או אפליקציות אינטרנט.
יצירת מזהה לקוח וסוד לקוח
אחרי שמחליטים מה סוג האפליקציה, פועלים לפי ההוראות הבאות כדי ליצור את מזהה הלקוח וסוד הלקוח של OAuth2:
פותחים את הדף 'פרטי כניסה'. בוחרים פרויקט שנוצר בעבר או יוצרים פרויקט חדש.
במסך Credentials, לוחצים על CREATE CREDENTIALS ואז על OAuth Client ID.
אם לא הגדרתם בעבר מסך הסכמה ל-OAuth לפרויקט הזה, תתבקשו לעשות זאת עכשיו. לוחצים על CONFIGURE CONSENT screen (הגדרת מסך ההסכמה).
בוחרים את סוג המשתמש ולוחצים על יצירה.
ממלאים את הטופס הראשוני. אפשר לערוך את המידע הזה מאוחר יותר לפי הצורך. בסיום, לוחצים על Save.
כדי להמשיך, חוזרים אל Credentials > CREATE CREDENTIALS > OAuth client ID.
בוחרים באפשרות Desktop app או Web application כסוג האפליקציה, בהתאם לתרחיש לדוגמה שלכם.
נותנים לו שם ולוחצים על יצירה.
אם סוג הלקוח הוא Web application, צריך להוסיף לפחות מזהה URI מורשה אחד להפניה אוטומטית.
כדי לבצע בדיקה מקומית שתואמת להגדרות ברירת המחדל בדוגמאות של ספריית הלקוח שלנו, צריך להשתמש ב-
http://127.0.0.1
.בלקוחות של אפליקציית מחשב עדיין תשתמשו בהפניה לכתובת URL אחרת מסוג לולאה חוזרת, אבל ה-URI לא מוגדר באופן מפורש במסוף Cloud.
מעתיקים את ה-Client ID ואת סוד הלקוח לדף האישור מהלוח, כי תצטרכו אותם כשתגדירו את ספריית הלקוח. תוכלו גם לחזור לדף של פרטי הכניסה מאוחר יותר כדי לאחזר את הפרטים האלה.