Wenn Sie die Video Stitcher API für Ihr Projekt aktivieren möchten, wenden Sie sich an Ihren Kundenbetreuer oder an den Vertrieb, um weitere Informationen zu erhalten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Konfiguration für ein Livestreamereignis erstellen

Für die Ad Manager-Integration müssen Sie eine Livekonfiguration für ein bestimmtes Livestreamereignis erstellen. Die Video Stitcher API registriert diese Konfiguration bei Ad Manager.

Anforderungen an das Quellmanifest

Die Video Stitcher API registriert die Konfiguration bei Ad Manager, indem sie das Quellmanifest parst. Das Quellmanifest muss je nach Format bestimmte Eigenschaften haben.

HLS

Mögliche Containerformate:
- MPEG-TS (gemuxt)
- nicht gemischte MPEG-TS-Dateien
- nicht gemuxt (FMP4)
Mindestens eine Wiedergabe im Manifest mit den folgenden (richtig ausgefüllten) Feldern:
- Codecs
- Bandbreite

MPEG-DASH

MPD@type auf dynamisch festgelegt (@type="dynamic")
MPD@profiles enthält das ISO-Live-Profil urn:mpeg:dash:profile:isoff-live:2011
Ein oder mehrere Zeiträume, die jeweils ein oder mehrere Anpassungssätze enthalten
Jedes Anpassungsset enthält eine oder mehrere Darstellungen
Die Darstellungen enthalten oder übernehmen eine SegmentTemplate mit der Kennung $Number$ oder $Time$
@segmentAlignment für alle Anpassungssätze auf „true“ festgelegt
Darstellungen dürfen nicht leer sein

Slate erstellen

Bevor Sie die Livekonfiguration erstellen, müssen Sie ein Slate erstellen. Die Video Stitcher API fügt ein standardmäßiges Slate-Video ein, wenn keine Anzeigen eingefügt werden können. Sie müssen das Slate-Video bei der Video Stitcher API registrieren, damit es angegeben wird, wenn keine Anzeigen ausgeliefert werden. Das Slate-Video kann eine beliebige MP4-Datei mit mindestens einem Audiotrack sein.

Sie haben zwei Möglichkeiten, dieses Slate zu erstellen. Sie können ein Standard-Netzwerk-Slate in Ihrem Ad Manager-Konto oder die Video Stitcher API erstellen.

Slate in Ad Manager erstellen

Um in Ihrem Ad Manager-Konto ein Standard-Netzwerk-Slate zu erstellen, führen Sie die Schritte unter Slate erstellen, um Contentlücken zu schließen aus und fahren Sie dann mit dem Abschnitt Livekonfiguration erstellen fort.

Slate mit der Video Stitcher API erstellen

Um ein Slate mit der Video Stitcher API zu erstellen, verwenden Sie die Methode projects.locations.slates.create.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer
LOCATION: der Standort, an dem das Slate erstellt werden soll. 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
SLATE_ID: Eine benutzerdefinierte Kennung für das Slate. Diese ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Zahl sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
SLATE_URL: der öffentliche URI für ein MP4-Video mit mindestens einem Audiotrack (Beispielvideo)
NETWORK_CODE: die numerische Kennung für dein Ad Manager-Netzwerk. Du findest sie in den globalen Einstellungen für das Publisher-Konto.
Wichtig:Du musst das Objekt gamSlate angeben, um das Slate mit Google Ad Manager (GAM) zu verwenden.

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

curl (Linux, macOS oder Cloud Shell)

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. 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'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_ID"

PowerShell (Windows)

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in 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:

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

Dieser Befehl erstellt einen Vorgang mit langer Ausführungszeit, den Sie abfragen können, um den Fortschritt zu verfolgen. Kopieren Sie die zurückgegebene OPERATION_ID, die der letzte Teil des Felds name ist, und verwenden Sie sie im nächsten Abschnitt.

Ergebnis prüfen

Mit der Methode projects.locations.operations.get können Sie prüfen, ob das Slate erstellt wurde. Wenn die Antwort "done: false" enthält, wiederholen Sie den Befehl, bis die Antwort "done: true" enthält.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: der 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 ID für den Vorgang

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

curl (Linux, macOS oder Cloud Shell)

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: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in 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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

Live-Konfiguration erstellen

Verwenden Sie zum Erstellen der Konfiguration die Methode projects.locations.liveConfigs.create.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer
LOCATION: der Standort, an dem die Live-Konfiguration erstellt werden soll. 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
LIVE_CONFIG_ID: Eine benutzerdefinierte Kennung für die Live-Konfiguration. Diese ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Zahl sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
SOURCE_LIVESTREAM_URI: Die Quell-URL des Videomanifests für den Livestream. Diese muss für die Video Stitcher API zugänglich sein. Die URL muss entweder öffentlich zugänglich sein oder, wenn die URL-Signatur für das CDN aktiviert ist,ein registrierter CDN-Schlüssel für die Video Stitcher API bereitgestellt wurde. Wenn Sie mit der Live Stream API einen Test-Livestream erstellt haben, ist dies der URI zur Datei main.m3u8 oder main.mpd im Cloud Storage-Bucket.
AD_TAG_URI: (Fügen Sie diesen Wert in den Block für „JSON-Code anfordern“ unten ein.) Die URL für von Ad-Servern abgerufene Anzeigenmetadaten. Für die Ad Manager-Integration muss dies ein gültiges Tag für Live-Videoanzeigen sein. Führen Sie die Schritte unter Tags für Video- und Audioanzeigen generieren mit den folgenden Änderungen aus, um ein gültiges Anzeigen-Tag zu erhalten:
- Aktivieren Sie unter Live-Traffic die Option „Live-Traffic“.
- Wählen Sie für den Player SDK-Typ die Option Google IMA SDK aus.
- Fügen Sie dem Tag den Parameter ad_rule=0 hinzu, z. B. &ad_rule=0 am Ende.
SLATE_ID: die ID des Slates, das verwendet werden soll, wenn keine zusammengefügten Anzeigen vorhanden sind
Hinweis:Wenn Sie mit Ad Manager ein Standard-Slate für das Netzwerk erstellt haben, entfernen Sie das Feld defaultSlate aus der Anfrage, um das Standard-Slate für das Netzwerk zu verwenden.
NETWORK_CODE: Die numerische Kennung Ihres Ad Manager-Netzwerks. Sie finden sie in den globalen Einstellungen des Publisher-Kontos.
AD_TRACKING: Das ist das Anzeigen-Tracking-Verhalten für Ihren Stream. Verwenden Sie CLIENT für IMA SDK-Integrationen. Sie können diesen Wert auch später pro Sitzung überschreiben.

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

curl (Linux, macOS oder Cloud Shell)

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": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

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": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

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/liveConfigs?liveConfigId=LIVE_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/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

Die Video Stitcher API registriert die Konfiguration in Ihrem Ad Manager-Konto asynchron. Dies kann einige Minuten dauern.

Dieser Befehl erstellt einen Vorgang mit langer Ausführungszeit, den Sie abfragen können, um den Fortschritt zu verfolgen. Weitere Informationen finden Sie unter Ergebnis prüfen.

Konfiguration abrufen

Verwenden Sie die Methode projects.locations.liveConfigs.get, um die Konfiguration abzurufen.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer
LOCATION: der Speicherort der Live-Konfiguration. 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
LIVE_CONFIG_ID: die benutzerdefinierte Kennung für die Live-Konfiguration

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

curl (Linux, macOS oder Cloud Shell)

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/liveConfigs/LIVE_CONFIG_ID"

PowerShell (Windows)

Hinweis: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in 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/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

Suchen Sie das Feld customAssetKey und kopieren Sie den zurückgegebenen CUSTOM_ASSET_KEY-Wert. Sie senden diese Werte in einem nachfolgenden Schritt an das Interactive Media Ads (IMA) SDK.

Zurück

CDN-Schlüssel für Media CDN einrichten

Weiter

Damit Ihre Clientanwendung mit Google Ad Manager funktioniert