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

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

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

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

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

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

1. פותחים את דף פרטי הכניסה במסוף Google API.

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

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

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

5. בקטע Authorized redirect URIs, מוסיפים שורה עם: https://developers.google.com/oauthplayground

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

7. בדף Client ID, בודקים את מזהה הלקוח ואת סוד הלקוח. תצטרכו אותם בשלב הבא.

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

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

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

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

2. לוחצים על סמל גלגל השיניים בפינה השמאלית העליונה ומסמנים את התיבה Use your own OAuth credentials (אם היא לא מסומנת).

3. ודא ש:

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

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

   

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

   

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

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

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

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

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

8. בכרטיסייה Step 2 - Exchange authorization code for tokens, אמור להופיע Authorization code. לוחצים על Exchange authorization code for tokens.

   

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

   

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

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

הסרת OAuth2 Playground ממזהה הלקוח

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

1. נכנסים לדף Credentials במסוף Google API.

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

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

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

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