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

Solución de problemas

En esta página, se muestra cómo resolver problemas con la API de Video Stitcher. Los errores que se muestran en esta página son específicos de la API de Video Stitcher. Para obtener información sobre los errores genéricos en las API de Google, consulta la página Errores de las API de Cloud.

Solo se devuelve el primer error. Si una solicitud encuentra varios errores, debes corregir el error que se muestra y volver a intentar la solicitud para ver el siguiente error.

No se pudo recuperar la playlist al crear una sesión

El siguiente problema ocurre cuando la API de Video Stitcher no puede recuperar el manifiesto de video del sourceUri especificado.

{
  "error": {
    "code": 404,
    "message": "got status code 403 when fetching playlist from URI \"https://example.com/manifest.m3u8\"",
    "status": "NOT_FOUND",
  }
}

Para resolver el problema, sigue estos pasos:

Verifica que el sourceUri proporcionado se vincule a un manifiesto de video válido.
- Usa curl con el sourceUri. Si se pretende que el manifiesto sea de acceso público, asegúrate de que se pueda acceder a la URL de manera pública.
- Si la sourceUri es correcta y el manifiesto de video requiere la firma de URL, continúa con el siguiente paso.
Asegúrate de que la clave de CDN se haya registrado con la API de Video Stitcher en la misma región que la solicitud.
- Verifica que la configuración de la clave de CDN que coincida con el nombre de host sourceUri exista. Si la configuración no existe, registra la clave de CDN con la API de Video Stitcher. Espera al menos 5 minutos para que la configuración se propague al servicio.
- Si ya existe, continúa con el paso siguiente.
Si sospechas que la clave privada que se usó para firmar la URL es incorrecta, te recomendamos actualizar la clave de CDN registrada con la clave privada correcta.

La clave de CDN está desactualizada

Si recientemente registraste o actualizaste una clave de CDN y la API de Video Stitcher no comenzó a firmar las URLs con la nueva configuración, sigue los pasos que se indican a continuación para diagnosticar el problema:

Si la clave de CDN se registró recientemente con la API de Video Stitcher, espera al menos 5 minutos para permitir que se propague la actualización. Si el problema persiste, continúa con el siguiente paso.
Verifica que solo haya una clave de CDN registrada para un nombre de host en la región. Si se registraron varias claves de CDN con el mismo nombre de host, la API de Video Stitcher seleccionará una de las claves de CDN con la que se firmará la URL.
- Asegúrate de que solo se haya registrado una clave de CDN con un nombre de host específico para una región determinada. Borra la clave de CDN obsoleta.

No se insertaron anuncios en una sesión en vivo

Si no se insertaron anuncios en una sesión en vivo, sigue estos pasos para diagnosticar el problema:

Verifica que las transmisiones en vivo de origen hayan insertado pausas publicitarias en el manifiesto. Los siguientes marcadores de anuncios deben existir en el manifiesto de video de transmisión en vivo para indicar a la API de Video Stitcher que reemplace los segmentos de video de origen por segmentos de anuncios.
- Si el manifiesto del video de origen no tiene ningún marcador de anuncios, significa que el codificador no activó una pausa publicitaria o que se debe cambiar para insertar los marcadores de anuncios compatibles.
- Si los marcadores de anuncios se ven claramente en el manifiesto de origen, continúa con el siguiente paso.
Verifica que la etiqueta de anuncio proporcionada muestre una respuesta de VAST que no esté vacía.
- Copia la etiqueta de anuncio en la barra de direcciones de un navegador web (por ejemplo, Chrome) y verifica que muestre una respuesta de VAST que no esté vacía. La siguiente es una respuesta de VAST vacía:
```
<VAST version="3.0"/>
```
- Si se muestra una respuesta de VAST vacía, el problema es la etiqueta de anuncio. Verifica que la etiqueta de anuncio esté configurada correctamente con los servidores de anuncios.
- Si se propaga la respuesta de VAST, usa curl para solicitar la etiqueta de anuncio. Algunos servidores de anuncios requieren que se proporcione el encabezado User-Agent. Prueba el siguiente comando curl:
```
curl AD_TAG_URI
```
- Si el comando curl muestra una respuesta de VAST vacía, agrega el encabezado User-Agent al comando curl:
```
curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI
```
- Si se muestra una respuesta de VAST propagada, el problema es que el encabezado User-Agent debe pasarse a la API de Video Stitcher cuando se crea la sesión en vivo. La API de Video Stitcher usa ese encabezado cuando ejecuta la etiqueta de anuncio para recuperar anuncios.
- Si aún se muestra una respuesta vacía, el problema está relacionado con la etiqueta de anuncio determinada. Confirma con el cliente que la etiqueta de anuncio sea correcta y que los valores de las macros de etiquetas de anuncios también lo sean.
- Si se resolvieron los problemas con la etiqueta de anuncios del cliente, pero no se insertaron anuncios, continúa con el paso siguiente.
Inspecciona la sesión en vivo. Si la sesión afectada muestra que los servidores de anuncios muestran anuncios, continúa con el siguiente paso.
La siguiente causa potencial de anuncios faltantes es la recodificación de anuncios. La API volverá a codificar los anuncios durante el primer encuentro para codificarlos de modo que coincidan con el video de origen. Por lo general, los anuncios tardan unos minutos en codificarse. Vuelve a crear una sesión nueva después de unos minutos para ver si se insertaron los anuncios.

Si no se insertó ningún anuncio, el problema puede deberse a que un anuncio no se codificó. Es posible que no se pueda acceder a las URLs de medios del anuncio. En este caso, el cliente debe trabajar con el proveedor de anuncios para determinar el problema con el contenido multimedia de sus anuncios.

No se insertaron anuncios en una sesión de VOD.

Verifica que la etiqueta de anuncio proporcionada muestre una respuesta de VAST o VMAP que no esté vacía. Usa la etiqueta de anuncio proporcionada con las siguientes instrucciones:
- Copia la etiqueta del anuncio en la barra de direcciones de un navegador web (por ejemplo, Chrome) y verifica que muestre una respuesta de VAST, VMAP o SmartXML que no esté vacía. La siguiente es una respuesta de VAST vacía:
- Coloca la etiqueta del anuncio en un navegador web (p. ej., Chrome, Firefox, etc.) y verifica que muestre una respuesta de VAST, VMAP o SmartXML que no esté vacía. Una respuesta de VAST vacía se ve de la siguiente manera:
```
<VAST version="3.0"/>
```
  La siguiente es una respuesta de VMAP vacía:
```
<VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>
```
- Si se muestra una respuesta de VAST vacía, el problema es la etiqueta de anuncio. Verifica que la etiqueta de anuncio esté configurada correctamente con los servidores de anuncios.
- Si se propaga la respuesta de VAST, usa curl para solicitar la etiqueta de anuncio. Algunos servidores de anuncios requieren que se proporcione el encabezado User-Agent. Prueba el siguiente comando curl:
```
curl AD_TAG_URI
```
- Si el comando curl muestra una respuesta de VAST vacía, agrega el encabezado User-Agent al comando curl:
```
curl -H "User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36" \
    AD_TAG_URI
```
- Si se muestra una respuesta de VAST o VMAP propagada, el problema es que el encabezado User-Agent se debe pasar a la API de Video Stitcher cuando se crea la sesión de VOD. La API de Video Stitcher usa ese encabezado cuando ejecuta la etiqueta de anuncio para recuperar anuncios.
- Si aún se muestra una respuesta vacía, el problema está relacionado con la etiqueta de anuncio determinada. Confirma con el cliente que la etiqueta de anuncio sea correcta y que los valores de las macros de etiquetas de anuncios también lo sean.
- Si se resolvieron los problemas con la etiqueta de anuncios del cliente, pero no se insertaron anuncios, continúa con el paso siguiente.
Inspecciona la sesión de VOD. Si la sesión afectada muestra que los servidores de anuncios muestran anuncios, continúa con el siguiente paso.
La siguiente causa potencial de anuncios faltantes es la recodificación de anuncios. La API volverá a codificar los anuncios durante el primer encuentro para codificarlos de modo que coincidan con el video de origen. Por lo general, los anuncios tardan unos minutos en codificarse. Vuelve a crear una sesión nueva después de unos minutos para ver si se insertaron los anuncios.

Si no se insertó ningún anuncio, el problema puede deberse a que un anuncio no se codificó. Es posible que no se pueda acceder a las URLs de medios del anuncio. En este caso, el cliente debe trabajar con el proveedor de anuncios para determinar el problema con el contenido multimedia de sus anuncios.