Die Video Stitcher API sendet Anfragen an Anzeigenanbieter, die in den Anzeigen-Tags im Text einer Livesitzungsanfrage angegeben sind. Die Metadaten der Anfragen und Antworten für diese Anfragen werden 14 Tage lang gespeichert und können in der Live-Sitzung angesehen werden.
Die Video Stitcher API stellt die Anzeigen-Tag-Details wie folgt zusammen:
- Die angeforderte Anzeigen-Tag-URL in einer bestimmten Werbeunterbrechung (oder das Standard-Anzeigen-Tag, wenn keins angegeben ist)
- Die konfigurierten Anzeigen-Tag-Makros aus der Livesitzungsanfrage
- Zusätzliche Nutzermetadaten
Diese Informationen geben zusammen mit dem Text und den Metadaten der Antwort Einblick in das Verhalten der Video Stitcher API.
Auf dieser Seite wird beschrieben, wie Sie Live-Sitzungen und die Anzeigen-Tag-Details für eine bestimmte Live-Sitzung überprüfen. Weitere Informationen findest du in der REST-Dokumentation. Diese Seite gilt nicht für Livesitzungen, die für die Anzeigenbereitstellung in Google Ad Manager (GAM) erstellt wurden. Sie können die Endpunkte für Anzeigen-Tags und Stitch-Details für diese Sitzungen nicht verwenden. Details zu den Anzeigenanfragen finden Sie in der Überprüfung der Streamaktivität in Ad Manager.
Hinweise
Sie sollten sich mit den Schritten zum Erstellen einer Livesitzung mit der Video Stitcher API vertraut machen. Weitere Informationen finden Sie in der Anleitung.
Details zum Anzeigen-Tag auflisten
Verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.list
, um die Anzeigen-Tag-Details für eine Livesitzung aufzulisten.
Betrachten Sie die folgende Antwort für eine zuvor erstellte Livesitzung (einige Felder werden ausgelassen):
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", ... }
REST
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
PROJECT_NUMBER
: Ihre Google Cloud-Projektnummer, die sich auf der Seite IAM-Einstellungen im Feld Projektnummer befindetLOCATION
: der Standort der Sitzung. Verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: die ID für die Livesitzung
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "liveAdTagDetails" : [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID/liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID", "adRequests": [ { "uri": "REQUEST_URL", "requestMetadata": "AD_TAG_REQUEST_METADATA", "responseMetadata": "AD_TAG_RESPONSE_METADATA" } ] } ] }
Kopieren Sie den zurückgegebenen LIVE_AD_TAG_DETAILS_ID. Sie benötigen es, um die Details für ein einzelnes Anzeigen-Tag abzurufen.
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Go in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Java in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Node.js in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für PHP in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Python in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Ruby in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Details zum Anzeigen-Tag abrufen
Wenn Sie die Details zu einem einzelnen Anzeigen-Tag in einer Livesitzung abrufen möchten, verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.get
.
Im folgenden Beispiel sehen Sie, wie ein einzelnes Anzeigen-Tag-Detail für eine Live-Sitzung aufgerufen wird. Dabei wird der Name eines Anzeigen-Tag-Detailss verwendet, das von einer vorherigen Anfrage zurückgegeben wurde:
REST
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
PROJECT_NUMBER
: Ihre Google Cloud-Projektnummer, die sich auf der Seite IAM-Einstellungen im Feld Projektnummer befindetLOCATION
: der Standort der Sitzung. Verwenden Sie eine der unterstützten Regionen.Standorte anzeigenus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: die ID für die LivesitzungLIVE_AD_TAG_DETAILS_ID
: ID für die Details des Live-Anzeigen-Tags
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/liveAdTagDetails/LIVE_AD_TAG_DETAILS_ID", "adRequests": [ { "uri": "REQUEST_URL", "requestMetadata": "AD_TAG_REQUEST_METADATA", "responseMetadata": "AD_TAG_RESPONSE_METADATA" } ] }
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Go in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Java in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Node.js in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für PHP in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Python in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die 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 Einrichtungsanleitung für Ruby in der Video Stitcher API-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
Richten Sie für die Authentifizierung bei der Video Stitcher API Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.