הצטרפות ל-Display & Video 360 Seller API
יש כמה שלבים חשובים להטמעה של Display & Video 360 Seller API. DV360 Seller API הוא Google Cloud API שמבוסס על רשימת היתרים, והוא משתמש ב-OAuth 2.0 לאימות ולהרשאה.
תהליך הוספת האתרים לרשימת ההיתרים מתבצע על ידי צוות Display & Video 360 Seller API.
שלבי ההצטרפות:
- נרשמים לחשבון Google בכתובת https://console.cloud.google.com/.
- החשבון הזה ישמש לניהול אסימוני גישה ללקוח הייצור שלכם. לא משתמשים בחשבון Gmail אישי.
- החשבון לא יכול להיות קבוצת Google.
- אם אתם משתמשים בפרויקט קיים ב-Google Cloud: החשבון צריך להיות אדמין של הפרויקט.
- כדי להוסיף את החשבון לרשימת ההיתרים, צריך לפנות לצוות של Google DV360 ולציין את פרטי החשבון.
- ממתינים לאישור שהחשבון הופעל.
- אופציונלי ולא חוסם: אפשר לשלוח בקשה לבדיקת אימות OAuth לאפליקציה כדי לקבל גישה להיקף
https://www.googleapis.com/auth/doubleclickbidmanager. - במסוף Google Cloud, עוברים אל APIs & Services > Library > Private. אמור להופיע DV360 Seller API בפרויקט.
- מפעילים את DV360 Seller API.
- עוברים אל APIs & Services > Credentials > Create Credentials > Service Account Key (ממשקי API ושירותים > אמצעי אימות > יצירת אמצעי אימות > מפתח חשבון שירות). פועלים לפי הוראות ההגדרה שמפורטות במסמכי התיעוד בנושא חשבון שירות של OAuth 2.0.
מגדירים חשבון שירות:
הערה: אם אתם רוצים לעשות שימוש חוזר בחשבון שירות קיים, למשל חשבון שמשמש ל-DV360 Reporting API, אתם יכולים להודיע לנו על כך.בדרך כלל, אימות והרשאה (שמכונים ביחד 'אימות') של Google Cloud API מתבצעים באמצעות חשבון שירות. חשבון שירות מאפשר לקוד לשלוח פרטי כניסה של אפליקציה ישירות ל-Cloud API. חשבון שירות, כמו חשבון משתמש, מיוצג על ידי כתובת אימייל. אבל בניגוד לחשבון משתמש, חשבון שירות שייך רק לאפליקציה, ואפשר להשתמש בו רק כדי לגשת לממשק ה-API שעבורו הוא נוצר. לדוגמה, נראה איך יוצרים פרטי כניסה לחשבון שירות באמצעות מסוף Google Cloud Platform.
שימוש במסוף Google Cloud
בדף API Manager→Credentials במסוף Google Cloud, בוחרים באפשרות Create credentials→Service account key (יצירת פרטי כניסה→מפתח של חשבון שירות).
לאחר מכן, בתפריט הנפתח Service account (חשבון שירות), בוחרים באפשרות New service account (חשבון שירות חדש).
מקלידים 'שם' לחשבון השירות. השם הזה ישמש כשם ברירת המחדל של 'מזהה חשבון השירות' (משמאל לסימן '@' בכתובת מזהה חשבון השירות שנוצר), אבל אפשר לשנות את השם הזה של מזהה חשבון השירות אם רוצים. השמות האלה יכולים להיות שרירותיים, מה שחשוב הוא שתזכרו אותם. בקטע 'סוג מפתח', מומלץ להשאיר את הערך 'JSON'. לוחצים על 'יצירה', ומסוף GCP ייצור מפתח 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" }
חשוב לשמור את קובץ ה-JSON הזה במקום בטוח, כי הוא מכיל את המפתח הפרטי שלכם (והקובץ הזה הוא העותק היחיד של המפתח). תצטרכו להפנות לקובץ המפתח של חשבון השירות הזה בקוד שלכם כשאתם רוצים לשלוח פרטי כניסה ל-Google Cloud Platform API.
- פונים לצוות של DV360 עם פרטי חשבון השירות שיצרתם (במיוחד כתובת האימייל בחשבון השירות). זהו השלב השני של רשימת ההיתרים לאישור הרשאה.
- אחרי שחשבון השירות מקבל הרשאה לקרוא ל-API, אפשר לעיין במסמכי התיעוד של DV360 Seller API. כדי לקבל אסימון אימות באופן ידני, אפשר לעיין בהוראות במאגר הכלים של oauth2l (באמצעות מפתח חשבון השירות בפורמט JSON שהורדתם). הוראות מפורטות לגבי קבלת אסימוני OAuth באופן פרוגרמטי זמינות במסמכי התיעוד של Google Cloud בנושא אימות.
חשוב: היקף ההרשאות של OAuth צריך להיות https://www.googleapis.com/auth/doubleclickbidmanager