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 zusammengefügt werden. Die Antwort enthält die Wiedergabe-URL und die Konfiguration der Livesitzung.
Auf dieser Seite wird beschrieben, wie Sie eine Livesitzung erstellen und verwalten, die in Google Ad Manager nicht aktiviert ist. Weitere Informationen zu diesen Arten von Livesitzungen finden Sie unter Mit Google Ad Manager aktivierte Livesitzung verwalten.
Hinweise
Livesitzung erstellen
Verwenden Sie zum Erstellen einer Livesitzung die Methode projects.locations.liveSessions.create
.
Wenn Sie eine Livesitzung erstellen, sind die folgenden Felder optional:
adTagMacros
: Eine Liste der Schlüssel/Wert-Paare zum Ersetzen des Anzeigen-Tag-Makros. Weitere Informationen finden Sie im Abschnitt Anzeigen-Tag-Makros.manifestOptions
: gibt an, welche Videowiedergaben im Manifest für zusammengefügte Videos generiert werden und in welcher Reihenfolge die Wiedergaben erfolgen. Weitere Informationen finden Sie in der Dokumentation zu Manifestoptionen.
REST
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
PROJECT_NUMBER
: Die Nummer Ihres Google Cloud-Projekts. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION
: 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 in etwa folgende JSON-Antwort 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 Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
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 Antwort ist ein Livesitzungsobjekt. playUri
ist die URL, die das Clientgerät verwendet, um den zusammengefügten Anzeigenstream für diese Livesitzung abzuspielen.
Die Video Stitcher API generiert für jede Anfrage eine eindeutige Sitzungs-ID. Eine Sitzung läuft ab, wenn playUri
nicht innerhalb der letzten 5 Minuten angefordert wird.
Eine Anzeige muss codiert werden, bevor sie in eine Live-Sitzung eingebunden werden kann. Wenn Sie eine Sitzung für ein Video mit Anzeigen-Stitching erstellen, ermittelt die Video Stitcher API, ob die Anzeige bereits aus einer vorherigen Sitzung codiert wurde. Die API sucht nur nach codierten Anzeigen, die in Sitzungen erstellt werden, die mit Ihrem Google Cloud-Projekt verknüpft sind. Weitere Informationen zu diesem Vorgang finden Sie in der Übersicht.
Wenn Sie eine Sitzung im Namen der Geräte Ihrer Kunden erstellen, können Sie die folgenden Parameter mithilfe von 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 zu Anzeigenmetadaten. Beachten Sie, dass die IP-Adresse des Clients möglicherweise nicht mit der IP-Adresse der Geräte Ihrer Kunden übereinstimmt, wenn Sitzungen für die Geräte Ihrer Kunden generiert werden.
Anzeigen-Tag-Makros
Ein Anzeigen-Tag kann Makros enthalten, die für jede Sitzung ein anderes Anzeigen-Tag erzeugen können. Makros werden im Anzeigen-Tag durch eckige Klammern gekennzeichnet, wie im folgenden Beispiel veranschaulicht:
AD_TAG_URI¯o=[my-key]
adTagUri
wird in der Live-Konfiguration definiert.
Wenn Sie den Wert im Anzeigen-Tag-Makro ersetzen möchten, geben Sie im Feld adTagMacros
eine Zuordnung 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 Livesitzung abzurufen.
REST
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
PROJECT_NUMBER
: Die Nummer Ihres Google Cloud-Projekts. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION
: 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 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:
{ "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 Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
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.
Beispiel für eine Playlist mit zusammengefügten Anzeigen
Hier sehen Sie eine Beispiel-Live-Playlist aus einer Quelle vor dem Anzeigen-Stitching:
#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
Im Folgenden sehen Sie ein Beispiel für eine Live-Playlist mit einer Quelle nach dem Anzeigen-Stitching:
#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
Wenn das Kunden-Anzeigen-Tracking aktiviert ist, ist der Player für die Auslösung von Anzeigen-Tracking-Ereignissen verantwortlich. Die von der Video Stitcher API bereitgestellten Anzeigenmetadaten enthalten Informationen zum Anzeigen-Tracking und zu Companion-Anzeigen. Die Video Stitcher API parst diese Informationen aus der Anzeigen-Tag-Antwort.
URI für HLS-Anzeigenmetadaten aus dem Manifest abrufen
In einem HLS-Wiedergabemanifest 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.
Hier sehen Sie ein Beispiel für ein HLS-Metadaten-Tag mit zeitlicher Festlegung:
#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 das decodierte X-VAST-META
:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
URI für DASH-Anzeigenmetadaten aus dem Manifest abrufen
In einem DASH-Manifest enthält jeder kombinierte Anzeigenzeitraum eine VAST-Anzeige und der zugehörige Anzeigenmetadaten-URI kann aus dem EventStream
-Tag extrahiert werden. AdMetadataURI
ist im Attribut messageData
des Elements Event
codiert. Event
ist ein Element im Tag EventStream
mit einem schemeIdUri
von urn:videostitcher:admetadata:202008
.
Hier sehen Sie ein Beispiel für ein DASH-Ereignisstream-Tag:
<EventStream schemeIdUri="urn:videostitcher:admetadata:202008" timescale="1000">
<Event duration="5000" messageData="eyJBZE1ldGFkYXRhVXJpIjogImh0dHBzOi8vZXhhbXBsZS5jb20vdjFhbHBoYS9wcm9qZWN0cy8xMjMvbG9jYXRpb25zL3VzLWNlbnRyYWwxL2xpdmVTZXNzaW9ucy9hYmMzMjEvYWRNZXRhZGF0YS9pZDEyMyJ9"></Event>
</EventStream>
Decodieren Sie messageData
mit base64 in JSON.
Das folgende Beispiel zeigt das decodierte messageData
:
{
"AdMetadataUri": "https://example.com/v1/projects/123/locations/us-central1/liveSessions/abc321/adMetadata/id123"
}
Anzeigen-Tracking-Ereignisse abrufen und verarbeiten
Wenn Sie AdMetadataURI
abgerufen haben, können Sie Anzeigenmetadaten abrufen.
Im folgenden Beispiel sehen Sie 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 Anzeigenvideos anfordernhttps://example.com/impression
zu Beginn des Anzeigenvideos anfordernhttps://example.com/pause
immer dann anfordern, wenn der Nutzer das Anzeigenvideo pausierthttps://example.com/firstQuartile
mit einer Länge von 2,5 Sekunden für das Anzeigenvideo anfordern
Live-Sitzungen prüfen
In diesem Abschnitt wird beschrieben, wie Live-Sitzungen und die Anzeigen-Tag-Details für eine bestimmte Live-Sitzung überprüft werden. Weitere Informationen finden Sie in der REST-Dokumentation.
Die Video Stitcher API sendet Anfragen an Anzeigenanbieter, die in den Anzeigen-Tags im Text einer Livesitzungsanfrage angegeben sind. Anfrage- und Antwortmetadaten für diese Anfragen werden 14 Tage lang gespeichert und können in der Livesitzung eingesehen werden.
Die Video Stitcher API erstellt die Anzeigen-Tag-Details so:
- Die angeforderte Anzeigen-Tag-URL in einer bestimmten Werbeunterbrechung oder das Standard-Anzeigen-Tag, falls keins angegeben ist
- Die konfigurierten Anzeigen-Tag-Makros aus der Live-Sitzungsanfrage
- Zusätzliche Nutzermetadaten
Diese Informationen geben zusammen mit dem Text und den Metadaten der Antwort Einblicke in das Verhalten der Video Stitcher API.
Anzeigen-Tag-Details auflisten
Verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.list
, um die Details des Anzeigen-Tags 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
: Die Nummer Ihres Google Cloud-Projekts. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION
: 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 ihn, um die Details zu einem einzelnen Anzeigen-Tag abzurufen.
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Video Stitcher API-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
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.
Details zum Anzeigen-Tag abrufen
Um die Details zu einem einzelnen Anzeigen-Tag in einer Livesitzung abzurufen, verwenden Sie die Methode projects.locations.liveSessions.liveAdTagDetails.get
.
Im folgenden Beispiel sehen Sie, wie in einer Livesitzung ein einzelnes Anzeigen-Tag-Detail 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
: Die Nummer Ihres Google Cloud-Projekts. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.LOCATION
: 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
: die 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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der C# API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Go API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Java API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Node.js API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der PHP API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Python API-Referenzdokumentation zur Video Stitcher API.
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: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Ruby API-Referenzdokumentation zur Video Stitcher API.
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.