Crear una configuración para un evento de emisión en directo

Para integrar Ad Manager, debe crear una configuración en directo para un evento de emisión en directo concreto. La API Video Stitcher registra esta configuración en Ad Manager.

Crear una cartela

Antes de crear la configuración de la emisión en directo, debes crear una cartela. La API Video Stitcher inserta un vídeo de cartela predeterminado cuando no se pueden insertar anuncios. Debes registrar el vídeo de pizarra con la API Video Stitcher para indicar la pizarra que se debe usar cuando no haya anuncios. El vídeo de pizarra puede ser cualquier archivo MP4 que tenga al menos una pista de audio.

Tienes dos opciones para crear esta cartera. Puede crear una pizarra predeterminada en su cuenta de Ad Manager o crear pizarras con la API Video Stitcher.

Crear una pizarra en Ad Manager

Para crear una cartela de red predeterminada en su cuenta de Ad Manager, siga los pasos que se indican en Crear una cartela para llenar los espacios sin contenido y, a continuación, vaya a la sección Crear la configuración activa.

Crear una pizarra con la API Video Stitcher

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_NUMBER: tu número de proyecto; se encuentra en el campo Número de proyecto de la página Configuración de gestión de identidades y accesos. Google Cloud
• LOCATION: la ubicación en la que quieres crear tu pizarra. Usa una de las regiones admitidas.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• SLATE_ID: identificador de la pizarra definido por el usuario. Este ID solo puede contener letras minúsculas, números y guiones. El primer carácter debe ser una letra, el último carácter debe ser una letra o un número, y el ID completo puede tener un máximo de 63 caracteres.
• SLATE_URL: el URI público de un vídeo MP4 con al menos una pista de audio (vídeo de ejemplo)
• NETWORK_CODE: el identificador numérico de su red de Ad Manager. Puede encontrarlo en la sección Configuración global de la cuenta de editor.

Para enviar tu solicitud, despliega una de estas opciones:

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

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"

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

$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 siguiente:

{
  "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 (OLD) que puedes consultar para monitorizar el progreso. Copia el valor devuelto OPERATION_ID, que es la última parte del campo name, para usarlo en la siguiente sección.

Comprobar el resultado

Usa el método projects.locations.operations.get para comprobar si se ha creado la pizarra. Si la respuesta contiene "done: false", repite el comando hasta que la respuesta contenga "done: true".

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_NUMBER: tu número de proyecto; se encuentra en el campo Número de proyecto de la página Configuración de gestión de identidades y accesos. Google Cloud
• LOCATION: 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: el identificador de la operación

Para enviar tu solicitud, despliega una de estas opciones:

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

$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 siguiente:

{
  "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 de la emisión en directo

Para crear la configuración, usa el método projects.locations.liveConfigs.create. Consulta la documentación de referencia de la configuración en directo para ver los campos opcionales (como los encabezados personalizados).

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_NUMBER: tu número de proyecto; se encuentra en el campo Número de proyecto de la página Configuración de gestión de identidades y accesos. Google Cloud
• LOCATION: la ubicación en la que crear la configuración activa. Usa una de las regiones admitidas.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: identificador definido por el usuario de 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 carácter debe ser una letra o un número, y el ID completo puede tener un máximo de 63 caracteres.
• SOURCE_LIVESTREAM_URI: la URL de origen del manifiesto de vídeo de la emisión en directo. La API Video Stitcher debe poder acceder a este valor. La URL debe ser de acceso público o, si la firma de URLs está habilitada en la CDN,se debe haber proporcionado una clave de CDN registrada a la API Video Stitcher. Si has creado una emisión en directo de prueba con la Live Stream API, esta es la URI del archivo main.m3u8 o main.mpd del segmento de Cloud Storage.
• AD_TAG_URI

  la URL de los metadatos de los anuncios obtenidos de los servidores de anuncios. En el caso de la integración con Ad Manager, debe ser una etiqueta de anuncio de vídeo en directo de Ad Manager válida. Para obtener una etiqueta de anuncio válida, siga los pasos que se indican en el artículo Generar etiquetas de anuncio de vídeo y audio con estas modificaciones:
  • En Tráfico en directo, habilite el tráfico en directo.
  • En Tipo de SDK de reproductor, seleccione SDK de IMA de Google.
  • Añade el parámetro ad_rule=0 a la etiqueta (por ejemplo, añade &ad_rule=0 al final).
• SLATE_ID: ID de la cartela que se va a usar si no hay anuncios insertados.
• NETWORK_CODE: el identificador numérico de su red de Ad Manager. Puede encontrarlo en la sección Configuración global de la cuenta de editor.
• AD_TRACKING: el comportamiento del seguimiento de anuncios de tu emisión. En las integraciones del SDK de IMA, utilice CLIENT. Para el seguimiento de anuncios en el servidor, use SERVER. También puede anular este valor por sesión más adelante.

Para enviar tu solicitud, despliega una de estas opciones:

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

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"

@'
{
  "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

$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 siguiente:

{
  "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 Video Stitcher registra de forma asíncrona la configuración en tu cuenta de Ad Manager. Este proceso puede tardar un par de minutos.

Este comando crea una operación de larga duración (OLD) que puedes consultar para monitorizar el progreso. Para obtener más información, consulta Comprobar el resultado.

Obtener la configuración

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

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_NUMBER: tu número de proyecto; se encuentra en el campo Número de proyecto de la página Configuración de gestión de identidades y accesos. Google Cloud
• LOCATION: la ubicación de la configuración activa. Usa una de las regiones admitidas.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• LIVE_CONFIG_ID: identificador definido por el usuario de la configuración activa.

Para enviar tu solicitud, despliega una de estas opciones:

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"

$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 siguiente:

{
  "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 valor devuelto CUSTOM_ASSET_KEY. En un paso posterior, enviará estos valores al SDK de anuncios multimedia interactivos (IMA).