איסוף המידע הנדרש לבקשות של לקוחות
כדי ליצור סשן של שידור חי ב-Google Ad Manager, צריך להכין את הפרטים הבאים:
| שדה | תיאור |
|---|---|
projectNumber | Google Cloud מספר הפרויקט
(PROJECT_NUMBER)
שמשמש ליצירת סשנים עם Ad Manager. אפשר גם להשתמש במזהה הפרויקט. |
region |
המיקום
location
(LOCATION)
שבו ההגדרה של השידור החי רשומה.
|
liveConfigId | מזהה התצורה של השידור החי שמשמש לרישום האירוע של השידור החי ב-Video Stitcher API. בדוגמה הבאה מוצג הפורמט של שם המשאב המלא של ההגדרה:projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID LIVE_CONFIG_ID). חשוב לזכור שההגדרה צריכה להיות באותו המיקום שבו יוצרים את הביקור.
|
customAssetKey | מפתח הנכס המותאם אישית
(CUSTOM_ASSET_KEY)
שנוצר במהלך רישום ההגדרה של השידור החי. ערכת IMA SDK צריכה את הערך הזה כדי ליצור את השידור. |
networkCode | המזהה המספרי (NETWORK_CODE) של רשת Ad Manager שלכם. |
oAuthToken | אסימון OAuth לטווח קצר לחשבון השירות עם התפקיד Video Stitcher User. איך יוצרים טוקנים של OAuth לטווח קצר |
טבלה 1. מידע נדרש לגבי סשנים של שידורים חיים שמופעל בהם Ad Manager
יצירת טוקנים של OAuth לטווח קצר לצורך בדיקה
כדי ליצור אסימון OAuth לטווח קצר שמשויך לחשבון השירות עם התפקיד Video Stitcher User, פועלים לפי השלבים הבאים:
- מחליפים את
PATH_TO_YOUR_SERVICE_KEYבנתיב לקובץ ה-JSON שהורדתם למחשב המקומי.gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- שליפת אסימון ה-Bearer מסוג OAuth 2.0 מחשבון השירות:
gcloud auth print-access-token
מכיוון שזהו טוקן לזמן קצר, צריך ליצור אותו מחדש מעת לעת באמצעות הפקודה gcloud auth print-access-token ולשלוח את הטוקנים החדשים לאפליקציות הלקוח. בקטע הבא מפורט מידע נוסף על בניית שירות לייצור אסימונים לטווח קצר.
יצירת שירות כדי לספק מידע לאפליקציות הלקוח
יוצרים שירות שיכול לספק את המידע הנדרש להעברה ללקוח. כשהאפליקציה מבקשת מהשירות שלכם מידע על הפעלת שידור חי, השירות צריך להחזיר את המידע שמתואר בטבלה 1.
בפרט, השירות צריך להיות מסוגל לספק טוקנים של OAuth לאפליקציות לקוח בצורה מאובטחת. הגדרת השירות הזה באמצעות שני חשבונות שירות, שאחד מהם מתחזה לשני. חשבון שירות אחד מקבל את התפקיד Service Token Creator ויוצר אסימון OAuth לחשבון השירות שמקבל את התפקיד Video Stitcher User. לדוגמה:
- חשבון שירות 1: זהו חשבון השירות שמבצע את הקריאה. לחשבון הזה יש את ההרשאה Service Token Creator בחשבון שירות 2, והוא מתחזה לחשבון שירות 2 באפליקציות לקוח.
- חשבון שירות 2: זהו חשבון השירות שנושא את ההרשאות ויש לו את התפקיד Video Stitcher User כדי ליצור סשנים.
מידע על מתן אסימון OAuth מהשירות שלכם, כולל דוגמאות קוד של ספריות לקוח, זמין במאמר יצירת אסימון גישה לטווח קצר.