מגרש משחקים של OAuth

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

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

קבלת מזהה לקוח וסוד לקוח

אזהרה: כדי להשתמש ב-OAuth2 Playground, עליך ליצור מזהה לקוח לאפליקציית אינטרנט. זהו סוג האפליקציה היחיד שפועל עם 'מגרש המשחקים של OAuth2'. למידע נוסף, ראו בחירת סוג אפליקציה.

אם אין לכם פרויקט קיים בענן:

1. פותחים את הדף Credentials Console של Google API.

2. בתפריט הנפתח של הפרויקט, בוחרים פרויקט קיים או יוצרים פרויקט חדש.

3. בדף Credentials, בוחרים באפשרות Create credentials ואז על OAuth client ID.

4. בקטע Application type, בוחרים באפשרות Web application.

5. בקטע URI מורשים להפניה אוטומטית, מוסיפים שורה עם: https://developers.google.com/oauthplayground

6. לוחצים על יצירה.

7. בדף Client ID (מזהה לקוח), מציינים את מזהה הלקוח ואת סוד הלקוח. יש צורך בהן בשלב הבא.

אם יש לכם פרויקט קיים בענן, תוכלו להשתמש בו שוב על ידי הגדרת מזהי ה-URI המורשים להפניה אוטומטית, כפי שמתואר למעלה.

יצירת אסימונים

אזהרה: המשתמש ב-Search Ads 360 שאליו נכנסתם בדפדפן קובע לאילו חשבונות תוכלו לגשת עם פרטי הכניסה של OAuth2 שיצרתם. לכן, כדאי לבצע את השלבים האלה בחלון פרטי או כשאתם לא מחוברים לחשבון Search Ads 360, כי סביר להניח שהמשתמש שאתם רוצים להשתמש בפרטי הכניסה שלו הוא לא אותו משתמש שאליו נכנסתם בזמן שבו קיבלתם את מזהה הלקוח והסוד.

1. נכנסים אל OAuth2 Playground, (הקישור הזה אמור לאכלס מראש חלק מערכי המפתח).

2. בפינה השמאלית העליונה, לוחצים על סמל גלגל השיניים ומסמנים את התיבה שימוש בפרטי הכניסה שלך ל-OAuth (אם היא עדיין לא מסומנת).

3. ודא ש:

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

4. מזינים את מזהה הלקוח ב-OAuth2 ואת סוד הלקוח ב-OAuth2 שקיבלתם למעלה.

   

5. בקטע שלב 1 – בחירה והרשאה של ממשקי API, לוחצים על Search Ads 360 Reporting API ברשימה ובוחרים את ההיקף שלו, https://www.googleapis.com/auth/doubleclicksearch. לאחר מכן לוחצים על Authorize APIs:

   

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

   אם קיבלתם את מזהה הלקוח והסוד רק לפני כמה דקות וקיבלתם הודעת שגיאה כמו שגיאה: redirect_uri_mismatch, יכול להיות שהשינויים שביצעתם לא הופצו. לוחצים על הלחצן 'הקודם' בדפדפן, ממתינים מספר דקות ומנסים שוב ללחוץ על Authorize APIs.
   אם קיבלתם הודעת שגיאה שהמפתח לא העניק לכם גישה אליה והאפליקציה נבדקת כרגע, תצטרכו להיכנס לדף מסך ההסכמה של OAuth בפרויקט ה-GCP, ולבצע אחת מהפעולות הבאות:

   • מפרסמים את האפליקציה.

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

7. תופיע הודעה שמציינת שהאפליקציה רוצה לנהל את הקמפיינים שלך ב-Search Ads 360. לוחצים על אישור כדי להמשיך.

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

   

9. אם הכול תקין, צריך למלא את אסימון הרענון ואת אסימון הגישה (יכול להיות שתצטרכו להרחיב מחדש את שלב 2 – החלפה של קוד ההרשאה לאסימונים):

   

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

11. הגדרה של ספריית לקוח ל-OAuth ב-Search Ads 360 Reporting API.

הסרת 'מגרש המשחקים של OAuth2' ממזהה הלקוח

עכשיו, אחרי שיש לכם אסימון רענון, אתם כבר לא צריכים ש-OAuth2 Playground ישמש כ-URI מורשה להפניה אוטומטית. כדי להסיר אותו מהרשימה של מזהי URI מורשים להפניה אוטומטית:

1. נכנסים לדף פרטי הכניסה למסוף Google API.

2. בוחרים את הפרויקט מהתפריט הנפתח של הפרויקט.

3. בדף Credentials, לוחצים על client ID name כדי לערוך.

4. מסירים את https://developers.google.com/oauthplayground ממזהי URI מורשים להפניה אוטומטית. שימו לב שצריך להשאיר לפחות URI אחד להפניה אוטומטית במקום.

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