להגדרת הרשאה

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

לחלופות לתהליך העבודה שמתואר בהמשך, ראו שימוש ב-OAuth 2.0 לאפליקציות מותקנות או שימוש ב-OAuth 2.0 לאפליקציות משרת לשרת. אם משתמשים בתהליך עבודה חלופי, צריך לציין את הערך הבא כפרמטר scope כשמבקשים קוד הרשאה מסוג OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
אם פועלים לפי המסלול 'שרת לשרת', צריך להוסיף את חשבון השירות כמשתמש ב-Search Ads 360.

תהליך העבודה המומלץ להרשאה

1. נכנסים ל-Google API Console ובוחרים את הפרויקט.

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

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

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

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

3. כדי לקבל אסימון רענון, מפעילים את סקריפט כלי השירות של Search Ads 360 באופן הבא:

   sa360Api.py --login

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

   כחלק מהתהליך הזה, הסקריפט יוצר כתובת URL ומורה לך להיכנס לכתובת ה-URL בדפדפן אינטרנט.

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

   בסוף התהליך, סקריפט sa360Api.py יוצר פלט של מחרוזת שמפרידה אותה באמצעות פסיק. הערך הראשון הוא מזהה הלקוח שסיפקתם, הערך השני הוא סוד הלקוח שסיפקתם והערך השלישי הוא אסימון הרענון. בפלט לדוגמה הבא, אסימון הרענון מופיע בטקסט מודגש:
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

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

   אם מתכננים להשתמש ב-sa360Api.py כדי לשלוח בקשות JSON לדוגמה ל-Search Ads 360 API, צריך לשמור את כל המחרוזת שמופרדת בפסיקים במיקום נוח. צריך להעביר את המחרוזת כולה כפרמטר בכל פעם שמפעילים את הסקריפט.

6. מוסיפים לאפליקציה קוד שמבצע את הפעולות הבאות:
   1. משתמשים במזהה הלקוח, בסוד הלקוח ובאסימון הרענון כדי לקבל אסימון גישה חדש מסוג OAuth 2.0.
   2. שולחים בקשות ל-Search Ads 360 API באמצעות אסימון הגישה החדש.

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

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