ה-API של Search Ads 360 דורש מכל הבקשות לציין אסימון גישה מסוג OAuth 2.0 לצורך אימות. אפשר לפעול לפי כל תהליך עבודה רגיל של אימות OAuth 2.0 כדי ליצור את האסימון ולהעביר אותו ל-Search Ads 360 API. מומלץ להשתמש בתהליך העבודה שמתואר בהמשך, כי הוא מתאים להעלאות המרות אוטומטיות לחלוטין ולהורדת דוחות.
לחלופות לתהליך העבודה שמתואר בהמשך, יש לעיין במאמר שימוש ב-OAuth 2.0 לאפליקציות מותקנות או שימוש ב-OAuth 2.0 לאפליקציות בשרת לשרת. אם משתמשים בתהליך עבודה חלופי, צריך לציין את הערך הבא בתור הפרמטר scope
כשמבקשים קוד הרשאה של OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
אם עוקבים אחר הנתיב של השרת לשרת, מוסיפים את חשבון השירות כמשתמש ב-Search Ads 360.
תהליך העבודה המומלץ להרשאה
- נכנסים אל Google API Console ובוחרים את הפרויקט שלכם.
אם עדיין לא יצרת פרויקט Google Cloud Console ופרטי כניסה ל-OAuth, עליך לפעול לפי ההוראות שבקטע יצירת פרויקט ב-Google API Console ופרטי כניסה ל-OAuth עבור הלקוח שלך.
כדי למצוא את מזהה הלקוח והסוד של OAuth בפרויקט, יש לבצע את הפעולות הבאות:
- פותחים את דף פרטי הכניסה.
- בעמודה שם לוחצים על השם של לקוח OAuth.
- מזהה הלקוח והסוד מופיעים בדף.
- פותחים דפדפן אינטרנט ונכנסים אל Google
באמצעות חשבון Google שיש לו הרשאה
לנתונים ב-Search Ads 360.
זהו חשבון Google שבו ישתמש לקוח ה-API שלך כדי לבצע אימות באמצעות Search Ads 360. אם בעל חשבון Google יעזוב את החברה ויסיר את הגישה ל-Search Ads 360 מהחשבון, תצטרך לחזור על תהליך העבודה של ההרשאה הזו ולציין חשבון Google אחר.
- כדי לקבל אסימון רענון, צריך להפעיל את הסקריפט של Search Ads 360 באופן הבא:
sa360Api.py --login
הסקריפט מנחה אותך בתהליך השימוש בסוד ובמזהה הלקוח של OAuth כדי לקבל אסימון רענון. אסימון הרענון חל רק על חשבון Google שאליו נכנסת במהלך השלב הקודם.
כחלק מהתהליך, הסקריפט יוצר כתובת URL ומורה לכם להיכנס לכתובת ה-URL בדפדפן אינטרנט.
-
כאשר הדפדפן מבקש ממך להעניק הרשאת גישה ללקוח OAuth לנתוני Search Ads 360, יש לוודא שחשבון Google שאליו נכנסת קודם לכן מופיע. (אם נכנסת לכמה חשבונות Google, יכול להיות שיוצג לך חשבון אחר).
בסיום התהליך, הסקריפט
sa360Api.py
יפיק מחרוזת מופרדת בפסיקים. הערך הראשון הוא מספר הלקוח שסיפקת, הערך השני הוא סוד הלקוח שסיפקת והערך השלישי הוא אסימון הרענון. בפלט לדוגמה הבא, אסימון הרענון מופיע בטקסט מודגש:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
- שמירת מזהה הלקוח, סוד הלקוח ואסימון הרענון במסד נתונים עורפי או מיקום מאובטח אחר שניתן לגשת אליו.
יש להשאיר את המחרוזת המלאה מופרדת בפסיקים במיקום נוח אם בכוונתך להשתמש ב-
sa360Api.py
כדי לשלוח בקשות JSON לדוגמה אל Search Ads 360 API. כל המחרוזת תועבר כפרמטר בכל פעם שתפעיל את הסקריפט. - מוסיפים לאפליקציה קוד שמבצע את הפעולות הבאות:
- כדי לקבל אסימון גישה חדש ל-OAuth 2.0, יש להשתמש במזהה הלקוח, בסוד הלקוח ובאסימון הרענון.
- שולחים בקשות ל-Search Ads 360 API באמצעות אסימון הגישה החדש.
אם משתמשים בספריות לקוח, בקטע הבא, הגדרת האפליקציה שלך, מוסבר איך להוסיף את קוד ההרשאה הזה לאפליקציה שלך.
אם לא משתמשים באחת מספריות הלקוח, יש לעיין במאמר שימוש ב-OAuth 2.0 לאפליקציות מותקנות כדי לקבל הצעות להשגת אסימון גישה חדש.