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

‫DV360 Exchange Reporting API מספק לשותפים ב-Third-Party Exchange‏ (3PE) גישה פרוגרמטית לדוחות ביצועים מ-Display & Video 360.

‫DV360 Exchange Reporting API הוא ממשק Google Cloud API שמבוסס על רשימת היתרים ומשתמש ב-OAuth. תהליך הוספת אתרים לרשימת ההיתרים מתבצע על ידי צוות DV360 Exchange Reporting API.

התהליך

אלה השלבים להטמעה של DV360 Exchange Reporting API:

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

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

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

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

  4. נכנסים למסוף Google Cloud.

    עוברים אל API & Services > Library > Private. אמור להופיע DV360 Exchange Reporting API כאחד מממשקי ה-API שזמינים לכם. מפעילים את DV360 Exchange Reporting API.

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

חשבון שירות

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

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

  1. בדף API Manager > Credentials (המרכז לניהול ממשקי API > פרטי כניסה), בוחרים באפשרות Create credentials → Service account key (יצירת פרטי כניסה → מפתח לחשבון שירות).

  2. בתפריט הנפתח Service account, בוחרים באפשרות New service account.

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

    בקטע סוג המפתח, מומלץ להשאיר את הערך JSON. לוחצים על Create כדי ליצור מפתח JSON כקובץ טקסט .json. כשמוצגת בקשה, מורידים את הקובץ למחשב ומוצג דו-שיח Service account created (נוצר חשבון שירות).

    דוגמה למפתח 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, או להשתמש באחת מספריות הלקוח שלנו כדי לבצע אימות באופן פרוגרמטי.