התחלת השימוש ב-DV360 Exchange Reporting API והגדרת OAuth

DV360 Exchange Reporting API נחשף בתור Google Cloud שמבוסס על רשימת היתרים API שמשתמש ב-OAuth. תהליך רשימת ההיתרים מטופל ב-DV360 Exchange צוות Reporting API.

התהליך

אלו השלבים לתחילת העבודה עם DV360 Exchange Reporting API:

  1. נרשמים לחשבון Google ב-Google Cloud של Google.

    חשוב לזכור שהחשבון הזה ישמש לניהול אסימוני גישה של בסביבת הייצור, אז אל תשתמשו בחשבון Gmail האישי שלכם.

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

  3. אחרי שמקבלים הודעה על כך שהחשבון שלך מופיע ברשימת ההיתרים, צריך לשלוח בקשה ל-OAuth בדיקת אימות כדי לקבל את הגישה של האפליקציה להיקף של doubleclickbidmanager.

  4. נכנסים לחשבון במסוף Google Cloud.

    עוברים אל API & שירותים > ספרייה > פרטית. אתם אמורים לראות את זה ב-DV360 Exchange Reporting API רשום כאחד מה-API שזמין לכם. מפעילים את DV360 Exchange Reporting API.

  5. עוברים אל Credentials > (פרטי כניסה >) יצירת פרטי כניסה > מפתח לחשבון השירות. מבצעים את ההוראות ליצירת שירות. חשבון.

חשבון שירות

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

אלה השלבים ליצירת פרטי כניסה לחשבון שירות באמצעות Google Cloud המסוף:

  1. דרך מנהל API > בדף פרטי כניסה, בוחרים יוצרים פרטי כניסה ← מפתח לחשבון שירות.

  2. בוחרים באפשרות New service account (חשבון שירות חדש) בתפריט הנפתח Service account.

    מזינים Name (שם) לחשבון השירות הזה. השם הזה משמש כברירת המחדל למזהה חשבון השירות שלך, מימין ל-@ ב- שהופקה הכתובת של מזהה חשבון השירות.

    בקטע Key type, מומלץ להשאיר את הערך הזה בתור JSON. לוחצים על יוצרים כדי ליצור מפתח JSON כקובץ טקסט .json. כשמוצגת בקשה לעשות זאת, להוריד את הקובץ למחשב ולתיבת הדו-שיח יצירת חשבון שירות. מוצגת.

    מפתח JSON לדוגמה:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. יש לאחסן את קובץ ה-JSON באופן מאובטח, כי הוא מכיל את המפתח הפרטי שלך. הוא העותק היחיד של המפתח הזה. נדרשים פרטי הכניסה בקובץ הזה כשהקוד מבצע קריאות ל-API.

  4. פונים ל-DV360 עם הפרטים של חשבון השירות שיצרתם. ספציפית, את כתובת האימייל של חשבון השירות. זה חלק תהליך הוספה לרשימת ההיתרים לגישה ל-API.

אסימון גישה

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