Mit der Video Stitcher API erstellen Sie bei jedem Start eine Livesitzung. Wiedergabe eines Livestreams, in dem von Google Ad Manager ausgelieferte Anzeigen die in Werbeunterbrechungen dynamisch zusammengefügt werden. Die Antwort gibt die Wiedergabe-URL an. und die Konfiguration der Livesitzung.
In diesem Dokument wird beschrieben, wie Sie eine Livesitzung erstellen und verwalten. Weitere Informationen finden Sie unter in der REST-Dokumentation
Hinweise
- Live-Konfiguration erstellen Für die Integration mit
in Google Ad Manager muss der
gamLiveConfig
festgelegt ist. - Achten Sie beim Angeben eines Slates darauf, dass das Objekt
gamSlate
ist auf dem Slate angegeben, das Sie registrieren.
Livesitzung erstellen
Um eine Livesitzung direkt über die API zu erstellen, verwenden Sie den
projects.locations.liveSessions.create
-Methode.
Das Feld liveConfig
ist das einzige Pflichtfeld im JSON-Text. Sie können
oder die folgenden optionalen Parameter pro Live-Sitzung überschreiben (siehe
folgendes REST-Beispiel:
manifestOptions
: gibt an, welche Videowiedergaben die im Manifest für zusammengefügte Videos generiert wurden, und in der Reihenfolge der Wiedergaben. die Dokumentation zu den Manifestoptionen aufrufenadTracking
: Wählen Sie entweder clientseitiges Anzeigen-Tracking oder serverseitiges Anzeigen-Tracking Dadurch wird der Wert in der Live-Konfiguration für die SitzungtargetingParameters
: ein Google Ad Manager-Anzeigen-Tag kann enthalten Targeting-Parameter, die aktualisiert werden können pro Sitzung in diesem Feld eine Zuordnung bereitstellen, z. B. um das[my_key]
-Makro mit dem Stringmy_value
, siehe REST-Beispiel)
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihr Google Cloud-Projekt Die Nummer finden Sie in den IAM-Einstellungen im Feld Projektnummer. SeiteLOCATION
: der Ort, an dem Ihr erstellt werden soll Sitzung; eine der unterstützten Regionen verwendenStandorte anzeigenus-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:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API C# API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Go API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Java API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Node.js API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für PHP in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API PHP API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Python API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Video Stitcher API-Kurzanleitung mit Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Ruby API Referenzdokumentation.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei der Video Stitcher API zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Die Video Stitcher API generiert für jede Anfrage eine eindeutige Sitzungs-ID. A
Sitzung läuft ab, wenn playUri
nicht innerhalb der letzten 5 Minuten angefordert wird.
Sie können die zurückgegebene STREAM_ID
für Folgendes verwenden:
Livesitzung überprüfen.
Von Google Ad Manager aktivierte Live-Sitzungen prüfen
Um Details zu den Anzeigen-Tags für Sitzungen zu sehen, verwenden Sie den
Überwachung der Streamingaktivitäten in Ad Manager und
finden Sie Details zu Anzeigenanfragen. Sie können die STREAM_ID
verwenden
um Fehler in der Streamsitzung zu beheben. STREAM_ID
für
findest du unter Eine Übung buchen.