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.

Crear una cortinilla de video

Antes de crear la configuración en vivo, debes crear una cortinilla de video. El La API de Video Stitcher inserta un video de cortinilla de video predeterminado 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 lista 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.

Cómo crear una cortinilla de video 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 lista con la API de Video Stitcher, usa el 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.
  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. Copiar el valor devuelto OPERATION_ID, que es la última parte del campo name, que se usará en la siguiente sección.

Revisa 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 admitidas
  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 tiempo real

Para crear la configuración, usa el 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 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 de el manifiesto del video de transmisión en vivo. Se debe poder acceder a él a través de la API de Video Stitcher. 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

  la URL de los metadatos del anuncio. recuperados de servidores de anuncios; para la integración con Ad Manager, debe ser un Etiqueta de anuncio de video en vivo de Ad Manager. Para obtener una etiqueta de anuncio válida, siga 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 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 La configuración global de la cuenta de editor
• AD_TRACKING: el comportamiento del seguimiento de anuncios para 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 un operación de larga duración (LRO) que puedes consultar para seguir el progreso. Para obtener más información, consulta Revisa el resultado.

Obtén la configuración

Para obtener la configuración, usa 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 en tiempo real

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 los datos que se muestran. CUSTOM_ASSET_KEY En un paso posterior, enviarás estos valores al SDK de anuncios multimedia interactivos (IMA).