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

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

כדאי לצפות בסרטון הזה כדי ללמוד על כמה שיטות מומלצות לעבודה עם פרויקטים ב-Cloud

אימות 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, מזינים שם ולוחצים על Create.

נקודה חשובה: אם הפעלתם את החיוב ב-Google Cloud, צריך לבחור חשבון לחיוב לפרויקט החדש.

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

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

כך מפעילים את Google Ads API בפרויקט:

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

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

3. בוחרים את Google Ads API ולוחצים על הלחצן הפעלה.

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

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

   • גוללים למטה ומזינים את הפקודה הבאה בשדה Manual addscopes:

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

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

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

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

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

6. בודקים את דף הסיכום ולוחצים על חזרה למרכז הבקרה.

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

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

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

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

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

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

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

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

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

2. במסך Credentials, לוחצים על CREATE CREDENTIALS ובוחרים באפשרות OAuth לקוח ID.

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

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

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

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

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

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

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

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

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

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

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