Si quieres habilitar la API de Video Stitcher para tu proyecto, comunícate con tu representante de cuenta o comunícate con Sales para obtener más información.

Se usó la API de Cloud Translation para traducir esta página.

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

Para la integración de Ad Manager, debes crear una etiqueta de anuncio para la sesión de VOD.

Es posible que también debas crear una configuración de VOD según la plataforma de destino. La API de Video Stitcher registra esta configuración con Ad Manager.

Cómo crear una etiqueta de anuncio en Ad Manager

Sigue estos pasos en tu cuenta de Ad Manager:

Agrega una nueva unidad de anuncios.
Activa las reglas de anuncios.
Cree una nueva regla de anuncios. Como parte de este paso, busca la sección Segmentación > Inventario en Ad Manager. Selecciona la nueva unidad de anuncios del paso anterior.
Para crear 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 Player SDK tipo, selecciona Google IMA SDK.
- Agrega el parámetro ad_rule=1 a la etiqueta (por ejemplo, agrega &ad_rule=1 al final).
- Agrega el parámetro vid_d=<vod_asset_duration_in_secs> a la etiqueta (por ejemplo, agrega &vid_d=1800 al final para un activo de VOD de 30 minutos).
- Modifica el parámetro output=vast para que sea output=xml_vmap1. La especificación de la playlist de múltiples anuncios de video (VMAP) es el único tipo de salida admitido.

Selecciona la plataforma de segmentación

Selecciona una de las siguientes plataformas de segmentación para los usuarios finales:

Debes crear una configuración de VOD. Continúa con los pasos de esta página.

Crea una configuración de VOD

Para crear la configuración, usa el método projects.locations.vodConfigs.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 de VOD. Usa una de las regiones compatibles.
Mostrar ubicaciones
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
VOD_CONFIG_ID: Es un 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 debe ser una letra o un número y el ID completo tiene un máximo de 63 caracteres.
VOD_URI: Es el URI del contenido multimedia que se unirá. 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 registraste una clave de CDN.
Nota: Puedes usar la API de Transcoder para crear estos archivos de manifiesto. Consulta Cómo crear archivos de origen de VOD para obtener más información. Debes hacer públicos los archivos de manifiesto para que la API de Video Stitcher pueda acceder a ellos.
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 servidores de anuncios. Para la integración de Ad Manager, debe ser una etiqueta de anuncio de video válida de Ad Manager. Para obtener una etiqueta de anuncio válida, sigue los pasos de la sección anterior Cómo crear una etiqueta de anuncio en Ad Manager.
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.

Cuerpo JSON de la solicitud:

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

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

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": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "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/vodConfigs?vodConfigId=VOD_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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "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 configuración de VOD. 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)

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)

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/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"
  }
}

Verifica que el estado esté configurado como READY. De lo contrario, espera unos segundos y vuelve a enviar la solicitud.

Para obtener más información sobre la configuración de VOD, consulta Cómo crear y administrar una configuración de VOD.

Antes de comenzar

Prepárate para que tu aplicación cliente funcione con Google Ad Manager