מגרש משחקים של 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.
   • Access type מוגדר כ-Offline (כך מובטח שתקבלו אסימון רענון וגם אסימון גישה, במקום רק אסימון גישה).

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. בדף Credentials, לוחצים על client ID name כדי לערוך.

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

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