Mit der Video Stitcher API erstellen Sie jedes Mal eine Livesitzung, wenn Sie die Wiedergabe eines Livestreams starten, in dem Anzeigen während der Werbeunterbrechungen dynamisch eingefügt werden. Die Antwort enthält die Wiedergabe-URL und die Konfiguration der Livesitzung.
Auf dieser Seite wird beschrieben, wie Sie eine Live-Sitzung erstellen und verwalten, die nicht von Google Ad Manager unterstützt wird. Weitere Informationen zu diesen Arten von Live-Sitzungen finden Sie unter Von Google Ad Manager aktivierte Live-Sitzungen verwalten.
Hinweise
Livesitzung erstellen
Verwenden Sie zum Erstellen einer Live-Sitzung die Methode projects.locations.liveSessions.create
.
Wenn Sie eine Livesitzung erstellen, sind die folgenden Felder optional:
adTagMacros
: Eine Liste von Schlüssel/Wert-Paaren für den Makroersatz im Anzeigen-Tag. Weitere Informationen finden Sie im Abschnitt Anzeigen-Tag-Makros.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.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihre Google Cloud Projektnummer, die auf der Seite IAM-Einstellungen im Feld Projektnummer zu finden istLOCATION
: 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", "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", }
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 Antwort ist ein Livesitzungsobjekt. playUri
ist die URL, die das Clientgerät zum Abspielen des Streams mit eingefügten Anzeigen für diese Livesitzung verwendet.
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.
Eine Anzeige muss codiert werden, bevor sie in eine Live-Sitzung eingefügt werden kann. Wenn Sie eine Sitzung für ein Video mit eingefügten Anzeigen erstellen, wird mit der Video Stitcher API ermittelt, ob die Anzeige bereits in einer vorherigen Sitzung codiert wurde. Die API sucht nur nach codierten Anzeigen, die von Sitzungen erstellt wurden, die mit Ihrem Google Cloud -Projekt verknüpft sind. Weitere Informationen zu diesem Prozess finden Sie in der Übersicht.
Wenn Sie eine Sitzung im Namen der Geräte Ihrer Kunden generieren, können Sie die folgenden Parameter mit HTTP-Headern festlegen:
Parameter | HTTP-Header |
---|---|
CLIENT_IP |
x-forwarded-for |
REFERRER_URL |
referer |
USER_AGENT |
user-agent |
Sie können der vorherigen curl
-Anfrage die folgenden Header hinzufügen:
-H "x-forwarded-for: CLIENT_IP" \ -H "referer: REFERRER_URL" \ -H "user-agent: USER_AGENT" \
Wenn der x-forwarded-for
-Header nicht angegeben ist, verwendet die Video Stitcher API die IP-Adresse des Clients in Anfragen für Anzeigenmetadaten. Die IP-Adresse des Clients stimmt möglicherweise nicht mit der IP-Adresse der Geräte Ihrer Kunden überein, wenn Sitzungen im Namen der Geräte Ihrer Kunden generiert werden.
Makros für Anzeigen-Tags
Ein Anzeigen-Tag kann Makros enthalten, die für jede Sitzung ein anderes Anzeigen-Tag generieren. Makros werden im Anzeigen-Tag durch eckige Klammern gekennzeichnet, wie im folgenden Beispiel zu sehen ist:
AD_TAG_URI¯o=[my-key]
adTagUri
ist in der Live-Konfiguration definiert.
Wenn Sie den Wert im Anzeigen-Tag-Makro ersetzen möchten, geben Sie eine Zuordnung im Feld adTagMacros
an. Wenn Sie beispielsweise das Makro [my-key]
durch den String my-value
ersetzen möchten, müssen Sie Folgendes angeben:
{ ... "adTagMacros": { "my-key": "my-value" }, ... }
Wenn die Video Stitcher API die Anzeigenmetadaten anfordert, wird das folgende Anzeigen-Tag verwendet:
AD_TAG_URI¯o=my-value
Sitzung abrufen
Verwenden Sie die Methode projects.locations.liveSessions.get
, um die Live-Sitzung abzurufen.
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihre Google Cloud Projektnummer, die auf der Seite IAM-Einstellungen im Feld Projektnummer zu finden istLOCATION
: 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
SESSION_ID
: die Kennung für die Live-Sitzung
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": "ad-stitched-live-stream-uri", "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", }
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.
Beispiel für eine Playlist mit eingefügten Anzeigen
Das Folgende zeigt eine Beispiel-Live-Playlist der Quelle vor dem Zusammenfügen von Anzeigen:
#EXTM3U
#EXT-X-TARGETDURATION:10
#EXT-X-VERSION:4
#EXT-X-MEDIA-SEQUENCE:5
#EXTINF:10.010
segment_00005.ts
#EXTINF:10.010
segment_00006.ts
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2021-06-22T08:32:00Z",DURATION=60,SCTE35-OUT=0xF...
#EXTINF:10.010
segment_00007.ts
#EXTINF:10.010
segment_00008.ts
#EXT-X-DATERANGE:ID="2415919105",START-DATE="2021-06-22T08:39:20Z",SCTE35-IN=0xF...
#EXTINF:10.010
segment_00009.ts
Das Folgende zeigt eine Beispiel-Live-Playlist nach dem Zusammenfügen von Anzeigen:
#EXTM3U
#EXT-X-TARGETDURATION:10
#EXT-X-VERSION:4
#EXT-X-MEDIA-SEQUENCE:5
#EXTINF:10.010
segment_00005.ts
#EXTINF:10.010
segment_00006.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000
https://ads.us-west1.cdn.videostitcher.goog/ad-1/seg-1.ts
#EXTINF:5.000
https://ads.us-west1.cdn.videostitcher.goog/ad-1/seg-2.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000
https://ads.us-west1.cdn.videostitcher.goog/ad-2/seg-1.ts
#EXTINF:5.000
https://ads.us-west1.cdn.videostitcher.goog/ad-2/seg-2.ts
#EXT-X-DISCONTINUITY
#EXTINF:10.010
segment_00009.ts
Clientseitiges Anzeigen-Tracking verarbeiten
Wenn das Client-Anzeigen-Tracking aktiviert ist, ist der Player für das Auslösen von Anzeigen-Tracking-Ereignissen verantwortlich. Zu den Anzeigenmetadaten, die von der Video Stitcher API bereitgestellt werden, gehören Informationen zum Anzeigen-Tracking und zu Companion-Anzeigen. Die Video Stitcher API parst diese Informationen aus der Antwort des Ad-Tags.
HLS-Anzeigenmetadaten-URI aus Manifest abrufen
In einem HLS-Rendition-Manifest wird ein AdMetadataURI
im Attribut X-VAST-META
des Tags #EXT-X-DATERANGE
codiert. Das #EXT-X-DATERANGE
-Tag befindet sich vor dem ersten zusammengefügten Segment jeder Anzeige.
Das folgende Beispiel zeigt ein HLS-Tag für Zeitmetadaten:
#EXT-X-DATERANGE:ID="id123",START-DATE=2014-03-05T11:15:00Z,DURATION=15,X-VAST-META="eyJBZE1ldGFkYXRhVXJpIjogImh0dHBzOi8vZXhhbXBsZS5jb20vdjFhbHBoYS9wcm9qZWN0cy8xMjMvbG9jYXRpb25zL3VzLWNlbnRyYWwxL2xpdmVTZXNzaW9ucy9hYmMzMjEvYWRNZXRhZGF0YS9pZDEyMyJ9"
Der Wert eines X-VAST-META
-Attributs ist ein base64-codierter JSON-String. Nach der Decodierung können Sie die AdMetadataURI
aus dem JSON-Code extrahieren.
Das folgende Beispiel zeigt die decodierte X-VAST-META
:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
DASH-Anzeigenmetadaten-URI aus dem Manifest abrufen
In einem DASH-Manifest enthält jeder zusammengefügte Anzeigenzeitraum eine VAST-Anzeige. Der URI der Anzeigenmetadaten kann aus dem EventStream
-Tag extrahiert werden. AdMetadataURI
ist im Attribut messageData
des Elements Event
codiert. Event
ist ein Element innerhalb des Tags EventStream
mit einem schemeIdUri
von urn:videostitcher:admetadata:202008
.
Hier ein Beispiel für ein DASH-Ereignisstream-Tag:
<EventStream schemeIdUri="urn:videostitcher:admetadata:202008" timescale="1000">
<Event duration="5000" messageData="eyJBZE1ldGFkYXRhVXJpIjogImh0dHBzOi8vZXhhbXBsZS5jb20vdjFhbHBoYS9wcm9qZWN0cy8xMjMvbG9jYXRpb25zL3VzLWNlbnRyYWwxL2xpdmVTZXNzaW9ucy9hYmMzMjEvYWRNZXRhZGF0YS9pZDEyMyJ9"></Event>
</EventStream>
Verwenden Sie base64, um messageData
in JSON zu decodieren.
Das folgende Beispiel zeigt die decodierte messageData
:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
Anzeigen-Tracking-Ereignisse abrufen und verarbeiten
Nachdem Sie AdMetadataURI
erhalten haben, können Sie Anzeigenmetadaten abrufen.
Das folgende Beispiel zeigt die Anzeigenmetadaten:
{
"activityEvents": [
{
"type": "PAUSE",
"uri": "https://example.com/pause"
}
],
"progressiveEvents": [
{
"timeOffset": "0s",
"events": [
{
"type": "IMPRESSION",
"uri": "https://example.com/impression"
},
{
"type": "START",
"uri": "https://example.com/start"
}
]
},
{
"timeOffset": "2.500s",
"events": [
{
"type": "FIRST_QUARTILE",
"uri": "https://example.com/firstquartile"
}
]
}
],
"adDuration": "10s"
}
Im vorherigen Beispiel sollte der Client Folgendes tun:
https://example.com/start
zu Beginn des Videoanzeigen-Streams anfordernhttps://example.com/impression
zu Beginn des Videoanzeigen-Streams anfordernhttps://example.com/pause
anfordern, wenn der Zuschauer das Video der Anzeige pausiert- Anfrage
https://example.com/firstQuartile
nach 2,5 Sekunden des Werbevideos
Livesitzungen prüfen
In diesem Abschnitt wird beschrieben, wie Sie Live-Sitzungen und die Details des Anzeigen-Tags für eine bestimmte Live-Sitzung prüfen. Weitere Informationen finden Sie in der REST-Dokumentation.
Die Video Stitcher API sendet Anfragen an die in den Ad-Tags im Text einer Live-Sitzungsanfrage angegebenen Anzeigenanbieter. Anfrage- und Antwortmetadaten für diese Anfragen werden 14 Tage lang gespeichert und können durch Überprüfen der Live-Sitzung eingesehen werden.
Die Video Stitcher API setzt die Details des Anzeigen-Tags aus den folgenden Elementen zusammen:
- Die angeforderte Anzeigen-Tag-URL in einer bestimmten Werbeunterbrechung (oder das Standard-Anzeigen-Tag, falls keines angegeben ist)
- Die konfigurierten Anzeigen-Tag-Makros aus der Live-Sitzungsanfrage
- Zusätzliche Nutzermetadaten
Diese Informationen sowie der Textkörper und die Metadaten der Antwort geben Aufschluss über das Verhalten der Video Stitcher API.
Details zum Anzeigen-Tag auflisten
Verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.list
, um die Details des Anzeigen-Tags für eine Live-Sitzung aufzulisten.
Hier ist eine Beispielantwort für eine zuvor erstellte Live-Sitzung (einige Felder wurden ausgelassen):
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", ... }
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihre Google Cloud Projektnummer, die auf der Seite IAM-Einstellungen im Feld Projektnummer zu finden istLOCATION
: Der Standort Ihrer 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 Kennung für die Live-Sitzung
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese 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 sie, um die Details für ein einzelnes Anzeigen-Tag abzurufen.
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.
Details zum Anzeigen-Tag abrufen
Wenn Sie die Details für ein einzelnes Ad-Tag in einer Live-Sitzung abrufen möchten, verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.get
.
Im folgenden Beispiel wird gezeigt, wie Sie die Details eines einzelnen Anzeigen-Tags für eine Live-Sitzung mit dem Namen eines Anzeigen-Tag-Details aufrufen, der von einer vorherigen Anfrage zurückgegeben wurde:
REST
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_NUMBER
: Ihre Google Cloud Projektnummer, die auf der Seite IAM-Einstellungen im Feld Projektnummer zu finden istLOCATION
: Der Standort Ihrer 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 Kennung für die Live-SitzungLIVE_AD_TAG_DETAILS_ID
: die ID für die Details des Live-Anzeigentags
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/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 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.