Konfiguration für eine VOD-Sitzung erstellen

Für die Ad Manager-Integration müssen Sie ein Anzeigen-Tag für das VOD erstellen. Sitzung. Außerdem musst du eine VOD-Konfiguration erstellen. Video Stitcher API registriert diese Konfiguration bei Ad Manager.

Anzeigen-Tag in Ad Manager erstellen

Führen Sie in Ihrem Ad Manager-Konto die folgenden Schritte aus:

1. Fügen Sie einen neuen Anzeigenblock hinzu.
2. Aktivieren Sie Anzeigenregeln.

3. Erstellen Sie eine neue Anzeigenregel. Bei diesem Schritt suchen Sie nach dem Bereich Targeting > im Bereich „Inventar“ in der in Ad Manager. Wählen Sie den neuen Anzeigenblock aus dem vorherigen Schritt aus.

4. Erstellen Sie ein gültiges Anzeigen-Tag. Folgen Sie dazu der Anleitung unter Tags für Video- und Audioanzeigen erstellen, wobei Sie die folgenden Änderungen vornehmen:

   • Wähle als Art des Player SDK Google IMA SDK aus.
   • Fügen Sie dem Tag den Parameter ad_rule=1 hinzu, zum Beispiel &ad_rule=1 am Ende.
   • Parameter vid_d=vod-asset-duration-in-secs hinzufügen am Tag hinzufügen (z. B. &vid_d=1800 für 30 Minuten am Ende hinzufügen) VOD-Asset).
   • Ändern Sie den Parameter output=vast in output=xml_vmap1. Das Video Die einzige VMAP-Spezifikation (Multiple Ad Playlist) ist die einzige unterstützte Ausgabe. Typ.

VOD-Konfiguration erstellen

Hinweis: Erstelle keine VOD-Konfiguration, wenn deine Zielplattform das IMA SDK auf Chromecast ist. Überspringen Sie den folgenden Schritt.

Verwenden Sie zum Erstellen der Konfiguration die Methode projects.locations.vodConfigs.create. Optionale Felder wie benutzerdefinierte Header findest du in der Referenzdokumentation zur VOD-Konfiguration.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; Sie befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer
• LOCATION: Speicherort, an dem die VOD-Konfiguration erstellt werden soll. Verwende eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID: eine benutzerdefinierte Kennung für die VOD-Konfiguration. Diese ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe, das letzte Zeichen ein Buchstabe oder eine Zahl sein und der Parameter die gesamte ID maximal 63 Zeichen lang ist.
• VOD_URI: der URI des zu verbindenden Mediums. Dieser URI muss entweder auf eine MPEG-DASH-Manifestdatei (MPD) oder eine HLS-Manifestdatei (M3U8) verweisen. Verwenden Sie öffentlichen URI oder einen nicht signierten URI, für den Sie einen CDN-Schlüssel registriert haben.
  Hinweis: Sie können diese Manifestdateien mit der Transcoder API erstellen. Weitere Informationen finden Sie unter VOD-Quelldateien erstellen . Du musst die Manifestdateien öffentlich zugänglich machen, damit die Video Stitcher API darauf zugreifen kann.
• AD_TAG_URI

  ist die URL für Anzeigenmetadaten von Ad-Servern abgerufen werden; für die Ad Manager-Integration muss ein gültiger Ad Manager-Videoanzeigen-Tag. Um ein gültiges Anzeigen-Tag abzurufen, befolgen Sie die Schritte oben Bereich Anzeigen-Tag in Ad Manager erstellen.
• NETWORK_CODE: die numerische Kennung für Ihr in Ihrem Ad Manager-Netzwerk. finden Sie dies in der Globale Einstellungen für das Publisher-Konto

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

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

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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
}

Mit diesem Befehl wird ein Vorgang mit langer Ausführungszeit erstellt, den Sie abfragen können, um den Fortschritt zu verfolgen. Kopieren Sie die zurückgegebene OPERATION_ID, Dies ist der letzte Teil des Felds name, der im nächsten Abschnitt verwendet wird.

Ergebnis prüfen

Verwenden Sie den projects.locations.operations.get. um zu prüfen, ob die VOD-Konfiguration erstellt wurde. Wenn die Antwort "done: false" enthält, wiederholen Sie den Befehl, bis die Antwort "done: true" enthält.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; Sie befindet sich in den IAM-Einstellungen im Feld Projektnummer. Seite
• LOCATION: Speicherort der Daten; verwenden Sie eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID: die Kennung für den Vorgang

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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"
  }
}

Prüfen Sie, ob der Status auf READY gesetzt ist. Ist dies nicht der Fall, warten Sie einige Sekunden und senden Sie die Anfrage noch einmal.

Weitere Informationen zu VOD-Konfigurationen findest du unter VOD-Konfiguration erstellen und verwalten