יצירת הגדרה אישית לסשן VOD

כדי להטמיע את השילוב עם Ad Manager, צריך ליצור תג מודעה לסשן של תוכן וידאו על פי דרישה (VOD). צריך גם ליצור הגדרה של VOD. ‫Video Stitcher API רושם את ההגדרה הזו ב-Ad Manager.

יצירת תג מודעה ב-Ad Manager

מבצעים את השלבים הבאים בחשבון Ad Manager:

1. הוספה של יחידת מודעות חדשה
2. הפעלת כללי מודעות.

3. יצירת כלל חדש להצגת מודעות. במסגרת השלב הזה, מאתרים את הקטע טירגוט > מלאי שטחי פרסום ב-Ad Manager. בוחרים את יחידת המודעות החדשה מהשלב הקודם.

4. כדי ליצור תג מודעה תקין, פועלים לפי השלבים במאמר בנושא יצירת תגי מודעות וידאו ואודיו עם השינויים הבאים:

   • בקטע Player SDK type (סוג ה-SDK של נגן המדיה), בוחרים באפשרות Google IMA SDK.
   • מוסיפים את הפרמטר ad_rule=1 לתג (לדוגמה, מוסיפים &ad_rule=1 בסוף).
   • מוסיפים את הפרמטר vid_d=vod-asset-duration-in-secs לתג (לדוגמה, מוסיפים &vid_d=1800 בסוף לנכס VOD של 30 דקות).
   • משנים את הפרמטר output=vast ל-output=xml_vmap1. המפרט של רשימת השמעה של כמה מודעות וידאו (VMAP) הוא סוג הפלט היחיד שנתמך.

יצירת הגדרה אישית של VOD

הערה: אל תיצרו הגדרת VOD אם פלטפורמת היעד שלכם היא IMA SDK ב-Chromecast. מדלגים על השלב הבא.

כדי ליצור את ההגדרה, משתמשים בשיטה projects.locations.vodConfigs.create. במאמרי העזרה בנושא הגדרות VOD מפורטים שדות אופציונליים (כמו כותרות מותאמות אישית).

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: המיקום שבו רוצים ליצור את הגדרות ה-VOD. צריך להשתמש באחד מהאזורים הנתמכים.
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫VOD_CONFIG_ID: מזהה מוגדר על ידי המשתמש להגדרות של VOD. המזהה יכול לכלול רק אותיות קטנות, מספרים ומקפים. התו הראשון חייב להיות אות, התו האחרון חייב להיות אות או מספר, והמזהה כולו יכול לכלול עד 63 תווים.
• ‫VOD_URI: ה-URI של המדיה לאיחוי. כתובת ה-URI הזו חייבת להפנות לקובץ מניפסט של MPEG-DASH ‏ (MPD) או לקובץ מניפסט של HLS ‏ (M3U8). משתמשים ב-URI ציבורי או ב-URI לא חתום שרשמתם עבורו מפתח CDN.
  הערה: אפשר להשתמש ב-Transcoder API כדי ליצור את קובצי המניפסט האלה. מידע נוסף זמין במאמר בנושא יצירת קובצי מקור של VOD. צריך להגדיר את קובצי המניפסט כגלויים לכולם כדי ש-Video Stitcher API יוכל לגשת אליהם.
• AD_TAG_URI

  כתובת ה-URL של מטא נתונים של מודעות שנשלפים משרתי מודעות. בשילוב עם Ad Manager, חובה להשתמש בתג מודעה תקף למודעות וידאו ב-Ad Manager. כדי לקבל תג מודעה תקין, פועלים לפי השלבים בקטע הקודם יצירת תג מודעה ב-Ad Manager.
• ‫NETWORK_CODE: המזהה המספרי של רשת Ad Manager שלכם. אפשר למצוא אותו ב ההגדרות הגלובליות של חשבון בעל האתר.

תוכן בקשת JSON:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

הפקודה הזו יוצרת פעולה ממושכת (LRO) שאפשר להריץ עליה שאילתה כדי לעקוב אחרי ההתקדמות. מעתיקים את OPERATION_ID שמוחזר, שהוא החלק האחרון בשדה name, כדי להשתמש בו בקטע הבא.

בדיקת התוצאה

כדי לבדוק אם נוצרה הגדרת ה-VOD, משתמשים בשיטה projects.locations.operations.get. אם התשובה מכילה את הערך "done: false", חוזרים על הפקודה עד שהתשובה מכילה את הערך "done: true".

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: מיקום הנתונים. צריך להשתמש באחד מהאזורים הנתמכים
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫OPERATION_ID: המזהה של הפעולה

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

בודקים שהמצב מוגדר ל-READY. אם לא, מחכים כמה שניות ושולחים את הבקשה שוב.

מידע נוסף על הגדרות VOD זמין במאמר בנושא יצירה וניהול של הגדרות VOD.