Crear una configuración para una sesión de VOD

Para integrar Ad Manager, debe crear una etiqueta de anuncio para la sesión de vídeo bajo demanda. También debe crear una configuración de vídeo bajo demanda. La API Video Stitcher registra esta configuración en Ad Manager.

Crear una etiqueta de anuncio en Ad Manager

Siga estos pasos en su cuenta de Ad Manager:

1. Añadir un bloque de anuncios.
2. Active las reglas de anuncios.

3. Cree una regla de anuncio. Como parte de este paso, busque la sección Segmentación > Inventario en Ad Manager. Seleccione el nuevo bloque de anuncios del paso anterior.

4. Cree una etiqueta de anuncio válida siguiendo los pasos que se indican en el artículo Generar etiquetas de anuncio de vídeo y audio con las siguientes modificaciones:

   • En "Tipo de SDK del reproductor", seleccione SDK de IMA de Google.
   • Añade el parámetro ad_rule=1 a la etiqueta (por ejemplo, añade &ad_rule=1 al final).
   • Añade el parámetro vid_d=vod-asset-duration-in-secs a la etiqueta (por ejemplo, añade &vid_d=1800 al final para un recurso de vídeo bajo demanda de 30 minutos).
   • Modifica el parámetro output=vast para que sea output=xml_vmap1. La especificación Video Multiple Ad Playlist (VMAP) es el único tipo de salida admitido.

Crear una configuración de VOD

Para crear la configuración, usa el método projects.locations.vodConfigs.create. Para obtener información sobre los campos opcionales (como los encabezados personalizados), consulta la documentación de referencia de la configuración de VOD.

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 de VOD. Usa una de las regiones admitidas.
  Mostrar ubicaciones
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID: identificador definido por el usuario para la configuración de VOD. 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.
• VOD_URI: el URI del contenido multimedia que se va a combinar. Este URI debe hacer referencia a un archivo de manifiesto MPEG-DASH (MPD) o a un archivo de manifiesto HLS (M3U8). Usa un URI público o un URI sin firmar para el que hayas registrado una clave de CDN.
• AD_TAG_URI

  la URL de los metadatos del anuncio 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 de Ad Manager válida. Para obtener una etiqueta de anuncio válida, siga los pasos de la sección anterior Crear una etiqueta de anuncio en Ad Manager.
• 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.

Cuerpo JSON de la solicitud:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

Para enviar tu solicitud, despliega una de estas opciones:

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_CONFIG_ID"

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "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 configuración de VOD. 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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

Comprueba que el estado sea READY. Si no es así, espera unos segundos y vuelve a enviar la solicitud.

Para obtener más información sobre las configuraciones de vídeo bajo demanda, consulta Crear y gestionar una configuración de vídeo bajo demanda.