Con la API de Video Stitcher, creas una sesión de video on demand (VOD) cada vez que insertas anuncios de forma dinámica antes de la entrega a los dispositivos cliente. Cuando creas una sesión, la respuesta incluye la URL de reproducción y la información sobre los anuncios que insertaste en el video.
En esta página, se describe cómo crear y administrar una sesión de VOD que no está habilitada por Google Ad Manager. Para obtener más información sobre estos tipos de sesiones de VOD, consulta Cómo administrar una sesión de VOD habilitada por Google Ad Manager.
Antes de comenzar
Crea una sesión
Para crear una sesión para un video con anuncios intercalados, usa el método projects.locations.vodSessions.create
.
Cuando creas una sesión de VOD, se requiere el siguiente campo:
adTracking
: Determina si se espera que el reproductor del cliente active eventos de reproducción y actividad, o si se espera que la API de Video Stitcher active eventos de reproducción en nombre del reproductor del cliente. Para obtener más información sobre el seguimiento de anuncios del cliente, consulta Administrar el seguimiento de anuncios de los clientes de VOD.En el ejemplo de esta sección, se usa el seguimiento de anuncios del servidor.
Cuando creas una sesión de VOD, los siguientes campos son opcionales:
adTagMacroMap
: Es una lista de pares clave-valor para el reemplazo de macros de etiquetas de anuncios. Consulta la sección macros de etiquetas de anuncios.manifestOptions
: Especifica qué representaciones de video se generan en el manifiesto de video unido y el orden de las representaciones. Consulta la documentación de las opciones de manifiesto.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación en la que se creará tu sesión. Usa una de las regiones compatibles.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
VOD_CONFIG_ID
: Es el identificador definido por el usuario para la configuración de VOD.
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID", "interstitials": { "sessionContent": { "duration": "60s" } }, "playUri": "PLAY_URI", # This is the ad-stitched VOD URI "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "assetId": "ASSET_ID", "adTracking": "SERVER", "vodConfig": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID" }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
La API de Video Stitcher genera un ID de sesión único para cada solicitud. Una sesión vence después de 4 horas.
Un anuncio debe codificarse antes de que se pueda unir a una sesión de VOD. Cuando creas una sesión para un video con anuncios insertados, la API de Video Stitcher determina si el anuncio ya se codificó en una sesión anterior. Si es así, la respuesta JSON indicará los eventos de corte publicitario. La API solo busca anuncios codificados creados por sesiones asociadas a tu proyecto de Google Cloud . Para obtener más información sobre este proceso, consulta la Descripción general.
Mira la respuesta JSON. Esta respuesta indica que no se unió un anuncio a la sesión. Si este es el caso, espera 5 minutos (para la codificación de anuncios) y, luego, vuelve a ejecutar el comando create session. La respuesta ahora debería ser similar a la siguiente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID", "interstitials": { "adBreaks": [ { "progressEvents": [ { "timeOffset": "0s", "events": [ { "type": "IMPRESSION", "uri": "https://securepubads.g.doubleclick.net/pcs/view..." }, { "type": "START", "uri": "https://pubads.g.doubleclick.net/pagead/interaction/..." }, ... ] }, ... ], "ads": [ { "duration": "10s", "activityEvents": [ { "type": "ERROR", "uri": "https://pubads.g.doubleclick.net/pagead/interaction/..." }, { "type": "CLICK_THROUGH", "uri": "https://pubads.g.doubleclick.net/pcs/click...", "id": "GDFP" }, ... ] } ], "endTimeOffset": "10s", "startTimeOffset": "0s" } ], "sessionContent": { "duration": "70s" } }, "playUri": "PLAY_URI", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "assetId": "ASSET_ID", "adTracking": "SERVER", "vodConfig": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID" }
La respuesta es un objeto de sesión de VOD que contiene los siguientes campos:
- Es un campo
name
que muestra elSESSION_ID
del VOD. Usa este ID para obtener información sobre la sesión. - Es un objeto
interstitials
que contiene metadatos sobre los anuncios que se insertaron (consulta los conceptos de metadatos de anuncios). - Es un campo
playUri
que muestra la URL que usa el dispositivo cliente para reproducir el activo de video condicionado.
Si generas una sesión en nombre de los dispositivos de tus clientes, configura los siguientes parámetros con encabezados HTTP:
Parámetro | Encabezado HTTP |
---|---|
CLIENT_IP |
x-user-ip |
REFERRER_URL |
referer |
USER_AGENT |
user-agent |
Puedes agregar los siguientes encabezados a la solicitud curl
anterior:
-H "x-user-ip: CLIENT_IP" \ -H "referer: REFERRER_URL" \ -H "user-agent: USER_AGENT" \
Macros de etiquetas de anuncios
Una etiqueta de anuncio puede contener macros, lo que puede generar una etiqueta de anuncio diferente para cada sesión. Las macros se indican con corchetes en la etiqueta del anuncio, como se ilustra en el siguiente ejemplo:
AD_TAG_URI¯o=[my-key]
El adTagUri
se define en la configuración de VOD.
Para sustituir el valor en la macro de la etiqueta del anuncio, proporciona una asignación en el campo adTagMacroMap
. Por ejemplo, si deseas reemplazar la macro [my-key]
por la cadena my-value
, debes proporcionar lo siguiente:
{ ... "adTagMacroMap": { "my-key": "my-value" }, ... }
Cuando la API de Video Stitcher solicita los metadatos del anuncio, usa la siguiente etiqueta de anuncio:
AD_TAG_URI¯o=my-value
Obtén una sesión
Para obtener la sesión de un video con anuncios intercalados, usa el método projects.locations.vodSessions.get
.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación de tu sesión. Usa una de las regiones admitidas.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: Es el identificador de la sesión de VOD.
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID", "interstitials": { "adBreaks": [ { "progressEvents": [ { "timeOffset": "0s", "events": [ { "type": "IMPRESSION", "uri": "https://securepubads.g.doubleclick.net/pcs/view..." }, { "type": "START", "uri": "https://pubads.g.doubleclick.net/pagead/interaction/..." }, ... ] }, ... ], "ads": [ { "duration": "10s", "activityEvents": [ { "type": "ERROR", "uri": "https://pubads.g.doubleclick.net/pagead/interaction/..." }, { "type": "CLICK_THROUGH", "uri": "https://pubads.g.doubleclick.net/pcs/click...", "id": "GDFP" }, ... ] } ], "endTimeOffset": "10s", "startTimeOffset": "0s" } ], "sessionContent": { "duration": "70s" } }, "playUri": "PLAY_URI", "sourceUri": "VOD_URI", "adTagUri": "AD_TAG_URI", "assetId": "ASSET_ID", "adTracking": "SERVER", "vodConfig": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID" }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Playlist de muestra con anuncios insertados
A continuación, se muestra una muestra de la playlist de VOD de origen antes de la inserción de anuncios:
#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-VERSION:4
#EXT-X-PLAYLIST-TYPE:VOD
#EXT-X-MEDIA-SEQUENCE:0
#EXTINF:6.000,
segment_01.ts
#EXTINF:6.000,
segment_02.ts
#EXTINF:6.000,
segment_03.ts
#EXTINF:6.000,
segment_04.ts
#EXTINF:6.000,
segment_05.ts
#EXTINF:6.000,
segment_06.ts
#EXT-X-ENDLIST
A continuación, se muestra un ejemplo de una playlist de VOD fuente después de la inserción de anuncios previos al video, durante el video y al final del video:
#EXTM3U
#EXT-X-VERSION:4
#EXT-X-TARGETDURATION:6
#EXT-X-PLAYLIST-TYPE:VOD
#EXT-X-DISCONTINUITY
#EXTINF:4.000,
https://ads.us-west1.cdn.videostitcher.goog/preroll_ad/seg_01.ts
#EXTINF:4.000,
https://ads.us-west1.cdn.videostitcher.goog/preroll_ad/seg_02.ts
#EXTINF:1.990,
https://ads.us-west1.cdn.videostitcher.goog/preroll_ad/seg_03.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000,
segment_01.ts
#EXTINF:6.000,
segment_02.ts
#EXT-X-DISCONTINUITY
#EXTINF:4.000,
https://ads.us-west1.cdn.videostitcher.goog/midroll_ad/seg_01.ts
#EXTINF:0.990,
https://ads.us-west1.cdn.videostitcher.goog/midroll_ad/seg_02.ts
#EXT-X-DISCONTINUITY
#EXTINF:6.000,
segment_03.ts
#EXTINF:6.000,
segment_04.ts
#EXTINF:6.000,
segment_05.ts
#EXTINF:6.000,
segment_06.ts
#EXT-X-DISCONTINUITY
#EXTINF:4.000,
https://ads.us-west1.cdn.videostitcher.goog/postroll_ad/seg_01.ts
#EXTINF:4.000,
https://ads.us-west1.cdn.videostitcher.goog/postroll_ad/seg_02.ts
#EXTINF:1.990,
https://ads.us-west1.cdn.videostitcher.goog/postroll_ad/seg_03.ts
#EXT-X-ENDLIST
Administra el seguimiento de anuncios del cliente
Cuando se habilita el seguimiento de anuncios del cliente, el reproductor es responsable de activar los eventos de seguimiento de anuncios. Puedes encontrar información de seguimiento del cliente en el objeto de anuncios intersticiales que se muestra cuando se crea la sesión de VOD.
El objeto de anuncios intersticiales incluye información de seguimiento de anuncios y metadatos de los anuncios complementarios analizados a partir de las solicitudes de etiquetas de anuncios. Para inspeccionar qué anuncios se unen, consulta Inspecciona sesiones de VOD.
Anuncios intersticiales
La información de seguimiento de anuncios se agrupa por pausas publicitarias en el objeto interstitials
.
Las pausas publicitarias pueden tener eventos de progreso que especifican el URI del evento y el desplazamiento temporal en relación con la hora de inicio de la pausa para cada evento que se haya activado. Para obtener más detalles sobre los eventos de progreso, consulta la documentación de referencia de ProgressEvent
.
Las pausas publicitarias también pueden tener eventos de actividad y anuncios complementarios. Para obtener más detalles sobre los anuncios complementarios, consulta la documentación de referencia de CompanionAds
.
A continuación, se muestra un ejemplo de intersticiales:
{
"adBreaks": [
{
"progressEvents": [
{
"timeOffset": "0s",
"events": [
{
"type": "IMPRESSION",
"uri": "https://example.com/impression"
},
{
"type": "START",
"uri": "https://example.com/start"
}
]
},
{
"timeOffset": "1.250s",
"events": [
{
"type": "FIRST_QUARTILE",
"uri": "https://example.com/firstquartile"
}
]
}
],
"ads": [
{
"duration": "5s",
"activityEvents": [
{
"type": "PAUSE",
"uri": "https://example.com/pause"
}
],
"companionAds": {
"required": "all",
"companions": [
{
"width": 200,
"height": 100,
"staticResource": {
"uri": "https://example.com/static.png",
"creativeType": "image/png"
}
}
]
}
},
{
"duration": "10s"
}
],
"startTimeOffset": "0s",
"endTimeOffset": "15.000s"
}
],
"sessionContent": {
"duration": "120.000s"
}
}
En el ejemplo anterior, hay una pausa publicitaria previa al video con dos anuncios unidos en un activo de VOD. El primer anuncio dura 5 segundos y el segundo, 10 segundos. La duración total del video unido es de 120 segundos, según se identifica en el campo duration
de sessionContent
.
Cuando el cliente recibe este objeto, debe hacer lo siguiente:
- Realiza una solicitud a
https://example.com/start
al comienzo de la pausa publicitaria. - Realiza una solicitud a
https://example.com/impression
al comienzo de la pausa publicitaria. - Realiza una solicitud a
https://example.com/pause
cada vez que el usuario pause el video durante el primer anuncio. - Realiza una solicitud a los 1.25 segundos del primer anuncio.
https://example.com/firstQuartile
- Carga el anuncio complementario
https://example.com/static.png
durante el primer anuncio.
Inspecciona sesiones de VOD
En esta sección, se describe cómo inspeccionar los detalles de la etiqueta del anuncio y los detalles de la unión para una sesión de VOD determinada. Para obtener más detalles, consulta la documentación de REST para VodAdTagDetail
y VodStitchDetail
.
El campo adTagUri
, definido en la configuración de VOD para la sesión de VOD, especifica la URL desde la que se recuperan los metadatos del anuncio. La API de Video Stitcher también incluye metadatos del usuario cuando realiza la solicitud.
El extremo /vodAdTagDetails
contiene la siguiente información:
- etiqueta de anuncio resuelta
- Metadatos del usuario
- cuerpo y encabezados de la solicitud
- Cuerpo y encabezados de la respuesta
El extremo /vodStitchDetails
contiene la siguiente información:
- ID de la pausa publicitaria
- ID del anuncio
- Compensación de tiempo del anuncio (en segundos)
- Motivo por el que no se insertó el anuncio
- Metadatos de medios del anuncio
Enumera los detalles de la etiqueta del anuncio
Para enumerar los detalles de las etiquetas de anuncios de una sesión de VOD, usa el método projects.locations.vodSessions.vodAdTagDetails.list
.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación de tu sesión. Usa una de las regiones admitidas.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: ID de la sesión de VOD
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "vodAdTagDetails" : [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID/vodAdTagDetails/VOD_AD_TAG_DETAILS_ID", "adRequests": [ { "uri": "REQUEST_URL", "requestMetadata": "AD_TAG_REQUEST_METADATA", "responseMetadata": "AD_TAG_RESPONSE_METADATA" } ] } ] }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
La respuesta devuelve una lista de objetos VodAdTagDetail
. Cada VodAdTagDetail
representa los metadatos de recuperación de anuncios de una etiqueta de anuncio, y cada AdRequest
representa los metadatos de la solicitud de anuncio de una sola solicitud de anuncio.
Resultados adicionales
La respuesta curl
puede incluir un nextPageToken
, que puedes usar para recuperar resultados adicionales:
{ "vodAdTagDetails": [ ... ], "nextPageToken": "NEXT_PAGE_TOKEN" }
Puedes enviar otra solicitud de curl
, que incluya el valor de NEXT_PAGE_TOKEN
, para enumerar los objetos adicionales. Agrega lo siguiente a la URL en la llamada a la API anterior:
?pageToken=NEXT_PAGE_TOKEN
Obtén detalles de la etiqueta de anuncio
Para obtener los detalles de un solo objeto VodAdTagDetail
en una sesión de VOD, usa el método projects.locations.vodSessions.vodAdTagDetails.get
.
En el siguiente ejemplo, se muestra cómo ver el detalle de una sola etiqueta de anuncio para una sesión de VOD con el nombre de un detalle de etiqueta de anuncio que se devolvió en una solicitud anterior:
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación de tu sesión. Usa una de las regiones admitidas.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: ID de la sesión de VODVOD_AD_TAG_DETAILS_ID
: ID de los detalles de la etiqueta de anuncio de VOD
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID/vodAdTagDetails/VOD_AD_TAG_DETAILS_ID", "adRequests": [ { "uri": "REQUEST_URL", "requestMetadata": "AD_TAG_REQUEST_METADATA", "responseMetadata": "AD_TAG_RESPONSE_METADATA" } ] }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Enumera los detalles de la unión
Puedes ver información detallada sobre los anuncios que se unieron para cualquier sesión de VOD.
Para enumerar los detalles de la unión de una sesión de VOD, usa el método projects.locations.vodSessions.vodStitchDetails.list
.
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación de tu sesión. Usa una de las regiones admitidas.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: ID de la sesión de VOD
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "vodStitchDetails" : [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID/vodStitchDetails/VOD_STITCH_DETAILS_ID", "adStitchDetails": [ { "adBreakId": "AD_BREAK_ID", "adId": "AD_ID", "adTimeOffset": "AD_TIME_OFFSET", "skipReason": "SKIP_REASON", "media": "MEDIA_OBJECT" }, { "adBreakId": "my-other-ad-break-id", "adId": "my-other-ad-id", "adTimeOffset": "my-other-ad-time-offset", "skipReason": "my-other-skip-reason", "media": "my-other-media-object" } ] } ] }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
La respuesta devuelve una lista de objetos VodStitchDetail
. Cada objeto VodStitchDetail
representa el detalle de la unión de una etiqueta de anuncio, y cada objeto adStitchDetails
representa el detalle de la unión de un solo anuncio.
La respuesta de curl
puede incluir un nextPageToken
, que puedes usar para recuperar resultados adicionales.
Obtener detalles de la unión de la etiqueta de anuncio
Para obtener los detalles de la unión de una sola etiqueta de anuncio para una sesión de VOD, usa el método projects.locations.vodSessions.vodStitchDetails.get
.
En el siguiente ejemplo, se muestra cómo ver el detalle de una sola unión de etiquetas del anuncio para una sesión de VOD con el nombre de un detalle de la etiqueta del anuncio de unión que se devolvió en una solicitud anterior:
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER
: Tu número de Google Cloud proyecto, que se encuentra en el campo Número de proyecto de la página Configuración de IAMLOCATION
: Es la ubicación de tu sesión. Usa una de las regiones admitidas.Mostrar ubicacionesus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
SESSION_ID
: ID de la sesión de VODVOD_STITCH_DETAILS_ID
: Es el ID de los detalles de la unión de VOD.
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodSessions/SESSION_ID/vodStitchDetails/VOD_STITCH_DETAILS_ID", "adStitchDetails": [ { "adBreakId": "AD_BREAK_ID", "adId": "AD_ID", "adTimeOffset": "AD_TIME_OFFSET", "skipReason": "SKIP_REASON", "media": "MEDIA_OBJECT" } ] }
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher C#.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Go.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Java.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Node.js.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher PHP.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Python.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido de la API de Video Stitcher con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Video Stitcher Ruby.
Para autenticarte en la API de Video Stitcher, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.