Crea 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.

Cómo crear una lista

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

Tienes dos opciones para crear esta pizarra. Puedes crear una cortinilla predeterminada de la red en tu cuenta de Ad Manager o crear cortinillas con la API de Video Stitcher.

Crea una cortinilla en Ad Manager

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

Crea una cortinilla con la API de Video Stitcher

Para crear una cortinilla 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: Es 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 pizarra. Usa una de las regiones compatibles.
  Cómo 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 pizarra. 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 tu red de Ad Manager. Puedes encontrarlo en la Configuración global de la cuenta del publicador.
  Importante: Debes incluir el objeto gamSlate para usar la pizarra con Google Ad Manager (GAM).

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática 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: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de 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 hacer 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.

Verifica el resultado

Usa el método projects.locations.operations.get para verificar si se creó la pizarra. 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: Es 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.
  Cómo 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: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática 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: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de 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. Consulta la documentación de referencia de la configuración activa para ver los campos opcionales (como los encabezados personalizados).

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

• PROJECT_NUMBER: Es 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.
  Cómo 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 activa. 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 transmisión en vivo. La API de Video Stitcher debe poder acceder a este. La URL debe ser de acceso público o, si la firma de URL está habilitada para la CDN, se debe proporcionar 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

  es la URL de los metadatos del anuncio recuperados de los servidores de anuncios. Para la integración de Ad Manager, esta 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 las siguientes 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 cortinilla de video que se usará en ausencia de anuncios unidos.
  Nota: Si creaste una cortinilla de video predeterminada de la red con Ad Manager, quita el campo defaultSlate de la solicitud para usar la cortinilla de video predeterminada de la red.
• NETWORK_CODE: Es el identificador numérico de tu red de Ad Manager. Puedes encontrarlo en la Configuración global de la cuenta del publicador.
• AD_TRACKING: El comportamiento de seguimiento de anuncios de tu transmisión Para las integraciones del SDK de IMA, usa CLIENT. Para el seguimiento de anuncios del servidor, usa SERVER. 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 haber configurado la variable de entorno GOOGLE_APPLICATION_CREDENTIALS a la ruta para el archivo de clave privada 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 haber configurado la variable de entorno GOOGLE_APPLICATION_CREDENTIALS a la ruta para el archivo de clave privada 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 hacer un seguimiento del progreso. Para obtener más información, consulta Cómo verificar 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: Es 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 activa. Usa una de las regiones compatibles.
  Cómo 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: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática 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: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de 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 CUSTOM_ASSET_KEY que se muestra. En un paso posterior, enviarás estos valores al SDK de anuncios multimedia interactivos (IMA).