Mit der Video Stitcher API erstellen Sie jedes Mal eine Live-Sitzung, wenn Sie die Wiedergabe eines Livestreams starten, in dem von Google Ad Manager bereitgestellte Anzeigen während Werbeunterbrechungen dynamisch eingefügt werden. Die Antwort enthält die Wiedergabe-URL und die Konfiguration der Livesitzung.
In diesem Dokument wird beschrieben, wie Sie eine Live-Sitzung erstellen und verwalten. Weitere Informationen finden Sie in der REST-Dokumentation.
Hinweise
- Live-Konfiguration erstellen Für die Integration mit Google Ad Manager muss das
gamLiveConfig
-Objekt festgelegt sein. - Wenn Sie ein Slate angeben, muss das
gamSlate
-Objekt für das Slate festgelegt sein, das Sie registrieren.
Livesitzung erstellen
Wenn Sie eine Livesitzung direkt über die API erstellen möchten, verwenden Sie die Methode projects.locations.liveSessions.create
.
Das Feld liveConfig
ist das einzige Pflichtfeld im JSON-Text. Sie können die folgenden optionalen Parameter pro Livesitzung festlegen oder überschreiben (wie im folgenden REST-Beispiel gezeigt):
manifestOptions
: Gibt an, welche Video-Renditionen im Manifest für das zusammengefügte Video generiert werden und in welcher Reihenfolge. Weitere Informationen finden Sie in der Dokumentation zu Manifestoptionen.adTracking
: Wählen Sie entweder clientseitiges oder serverseitiges Anzeigen-Tracking aus. Dadurch wird der Wert in der Live-Konfiguration für die Sitzung überschrieben.targetingParameters
: Ein Google Ad Manager-Anzeigen-Tag kann Targeting-Parameter enthalten, die pro Sitzung aktualisiert werden können. Geben Sie in diesem Feld eine Zuordnung an, z. B. um das Makro[my_key]
durch den Stringmy_value
zu ersetzen (siehe REST-Beispiel).
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihre Google Cloud Projektnummer, die sich auf der Seite IAM-Einstellungen im Feld Projektnummer befindetLOCATION
: Der Standort, an dem die Sitzung erstellt werden soll. Verwenden Sie eine der unterstützten Regionen.Standorte 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 eine JSON-Antwort ähnlich wie diese 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 C#-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API C# API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Go-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Go API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Java-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Java API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Node.js-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Node.js API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
PHP
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der PHP-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API PHP API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Python-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Python API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Ruby-Einrichtungsanleitung in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Video Stitcher API Ruby API-Referenzdokumentation.
Richten Sie zur Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. 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. Eine Sitzung läuft ab, wenn die playUri
in den letzten 5 Minuten nicht angefordert wurde.
Mit der zurückgegebenen STREAM_ID
können Sie die Livesitzung prüfen.
Von Google Ad Manager aktivierte Livesitzungen prüfen
Wenn Sie Details zu Anzeigen-Tags für Sitzungen aufrufen möchten, verwenden Sie die Überprüfung der Streamingaktivitäten in Ad Manager, um Details zu Anzeigenanfragen zu sehen. Mit STREAM_ID
können Sie Fehler in der Streamsitzung beheben. Informationen zum Abrufen der STREAM_ID
für eine Livesitzung finden Sie unter Sitzung abrufen.