Cómo crear una configuración para un evento de transmisión en vivo

Para la integración de Ad Manager, debes crear una configuración en vivo para un evento de transmisión en vivo determinado. La API de Video Stitcher registra esta configuración con Ad Manager.

Requisitos del manifiesto de origen

La API de Video Stitcher registra la configuración con Ad Manager mediante el análisis del manifiesto de origen. El manifiesto de origen debe tener ciertas características según el formato.

HLS

• El formato del contenedor puede ser uno de los siguientes:
  • MPEG-TS con multiplexor
  • MPEG-TS sin combinación
  • FMP4 sin combinación
• Al menos una representación en el manifiesto con los siguientes campos (propagados de forma correcta):
  • códecs
  • bandwidth

MPEG‐DASH

• MPD@type se configuró como dinámico (@type="dynamic")
• MPD@profiles incluye el perfil ISO en vivo urn:mpeg:dash:profile:isoff-live:2011
• Uno o más Períodos, cada uno con uno o más Conjuntos de Adaptación
• Cada conjunto de adaptación contiene una o más representaciones.
• Las representaciones contienen o heredan un SegmentTemplate con el identificador $Number$ o $Time$.
• Se estableció @segmentAlignment como verdadero para todos los conjuntos de adaptación.
• Las representaciones no deben estar vacías

Cómo crear una lista

Antes de crear la configuración activa, debes crear una cortinilla de video. La API de Video Stitcher inserta un video de lista predeterminada cuando no se pueden insertar anuncios. Debes registrar un video de lista con la API de Video Stitcher para indicar la lista que se usará en caso de que no haya anuncios. El video de lista puede ser cualquier archivo MP4 con, al menos, una pista de audio.

Tienes dos opciones para crear esta lista. Puedes crear una lista de red predeterminada en tu cuenta de Ad Manager o puedes crear listas con la API de Video Stitcher.

Cómo crear una lista en Ad Manager

Para crear una lista de red predeterminada en tu cuenta de Ad Manager, sigue los pasos que se indican en Crea una lista para llenar brechas de contenido y, luego, ve a la sección Crea la configuración en vivo.

Crea una cortinilla de video con la API de Video Stitcher.

Para crear una lista con la API de Video Stitcher, usa el método projects.locations.slates.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_NUMBER: El número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM
• LOCATION: Es la ubicación en la que se creará tu lista. Usa una de las regiones compatibles.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: Es un identificador definido por el usuario para la lista. Este ID solo puede contener letras minúsculas, números y guiones. El primer carácter debe ser una letra, el último debe ser una letra o un número y el ID completo tiene un máximo de 63 caracteres.
• SLATE_URL: Es el URI público de un video MP4 con al menos una pista de audio (video de muestra).
• NETWORK_CODE: Es el identificador numérico de la red de Ad Manager. Puedes encontrarlo en la Configuración global de la cuenta de publicador.
  Importante: Debes incluir el objeto gamSlate para usar la lista con Google Ad Manager (GAM).

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien con Cloud Shell, que te permite acceder automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

PowerShell (Windows)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

Este comando crea una operación de larga duración (LRO) que puedes consultar para realizar un seguimiento del progreso. Copia el OPERATION_ID que se muestra, que es la última parte del campo name, para usarlo en la siguiente sección.

Comprueba el resultado

Usa el método projects.locations.operations.get para verificar si se creó la lista. Si la respuesta contiene "done: false", repite el comando hasta que la respuesta contenga "done: true".

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_NUMBER: El número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM
• LOCATION: Es la ubicación de los datos. Usa una de las regiones compatibles.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID: Es el identificador de la operación.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien con Cloud Shell, que te permite acceder automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell (Windows)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

Crea la configuración en vivo

Para crear la configuración, usa el método projects.locations.liveConfigs.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_NUMBER: El número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM
• LOCATION: Es la ubicación en la que se creará la configuración activa. Usa una de las regiones compatibles.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: Es un identificador definido por el usuario para la configuración en vivo. Este ID solo puede contener letras minúsculas, números y guiones. El primer carácter debe ser una letra, el último debe ser una letra o un número y el ID completo tiene un máximo de 63 caracteres.
• SOURCE_LIVESTREAM_URI: Es la URL de origen del manifiesto de video de la transmisión en vivo. La API de Video Stitcher debe poder acceder a ella. La URL debe ser de acceso público o, si la firma de URL está habilitada para la CDN, se proporcionó una clave de CDN registrada a la API de Video Stitcher. Si creaste una transmisión en vivo de prueba con la API de Live Stream, este es el URI del archivo main.m3u8 o main.mpd en el bucket de Cloud Storage.
• AD_TAG_URI: (Pega este valor en el bloque de código JSON de solicitud que aparece a continuación). Es la URL de los metadatos de anuncios recuperados de los servidores de anuncios. Para la integración de Ad Manager, debe ser una etiqueta de anuncio de video en vivo válida de Ad Manager. Para obtener una etiqueta de anuncio válida, sigue los pasos que se indican en Cómo generar etiquetas de anuncios de audio y video con estas modificaciones:
  • En Tráfico en vivo, habilita el tráfico en vivo.
  • En Tipo de SDK del reproductor, selecciona SDK de IMA de Google.
  • Agrega el parámetro ad_rule=0 a la etiqueta (por ejemplo, agrega &ad_rule=0 al final).
• SLATE_ID: Es el ID de la lista que se usará en caso de que no haya anuncios unidos.
  Nota: Si creaste una lista de red predeterminada con Ad Manager, quita el campo defaultSlate de la solicitud para usar la lista de red predeterminada.
• NETWORK_CODE: Es el identificador numérico de tu red de Ad Manager. Puedes encontrarlo en la Configuración global de la cuenta de publicador.
• AD_TRACKING: Es el comportamiento del seguimiento de anuncios de tu transmisión. Para las integraciones del SDK de IMA, usa CLIENT. También puedes anular este valor por sesión más adelante.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Asegúrate de establecer la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo de claves privadas de tu cuenta de servicio.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

Nota: Asegúrate de establecer la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta del archivo de claves privadas de tu cuenta de servicio.

Guarda el cuerpo de la solicitud en un archivo llamado request.json. Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

La API de Video Stitcher registra de forma asíncrona la configuración en tu cuenta de Ad Manager. Este proceso puede tardar unos minutos.

Este comando crea una operación de larga duración (LRO) que puedes consultar para realizar un seguimiento del progreso. Para obtener más información, consulta Cómo buscar el resultado.

Obtén la configuración

Para obtener la configuración, usa el método projects.locations.liveConfigs.get.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_NUMBER: El número de tu proyecto de Google Cloud, que se encuentra en el campo Número de proyecto de la página Configuración de IAM
• LOCATION: Es la ubicación de la configuración en vivo. Usa una de las regiones compatibles.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: Es el identificador definido por el usuario para la configuración activa.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien con Cloud Shell, que te permite acceder automáticamente a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

PowerShell (Windows)

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

Busca el campo customAssetKey y copia el objeto CUSTOM_ASSET_KEY que se muestra. Debes enviar estos valores al SDK de anuncios multimedia interactivos (IMA) en un paso posterior.