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 de las APIs de Google, consulta la página Errores de las APIs de Cloud.

Solo se muestra 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 puede recuperar la playlist cuando se crea una sesión.

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

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

Para resolver este problema, sigue estos pasos:

  1. Verifica que el sourceUri proporcionado dirija a un manifiesto de video válido.

    • Usa curl con sourceUri. Si se pretende que el manifiesto sea de acceso público, asegúrate de que se pueda acceder a la URL de forma pública.
    • Si el sourceUri es correcto y el manifiesto de video requiere la firma de la URL, continúa con el siguiente paso.

  2. Asegúrate de que la clave de CDN se haya registrado con la API de Video Stitcher en la en la misma región que la solicitud.

  3. Si sospechas que la clave privada que se usó para firmar la URL es incorrecta, puedes quizás quieran actualizar la clave de CDN registrada con la clave privada correcta.

La clave de CDN está desactualizada

Si registraste o actualizaste una clave de CDN recientemente y la API de Video Stitcher no comenzaste a firmar las URLs con la nueva configuración y sigue estos pasos para diagnostica el problema:

  1. Si la clave de CDN se registró recientemente con la API de Video Stitcher, espera. al menos 5 minutos para que la actualización se propague. Si el problema persiste, continúa con el siguiente paso.

  2. Verifica que solo se registre una clave de CDN para un nombre de host de la región. Si se registraron varias claves CDN con el mismo nombre de host, el La API de Video Stitcher seleccionará una de las claves de CDN con la que firmará la URL.

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 el problema:

  1. 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 la transmisión en vivo para indicarle a la API de Video Stitcher que reemplace los segmentos de video de origen por segmentos de anuncios.

    • Si el manifiesto de video de origen no tiene ningún marcador de anuncio, significa que el codificador no activó una pausa publicitaria o que debe modificarse para insertar los marcadores de anuncios admitidos.

    • Si los marcadores de anuncios se ven claramente en el manifiesto de origen, continúa al siguiente paso.

  2. Verifica que la etiqueta de anuncio proporcionada muestre una respuesta de VAST no vacía.

    • 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 no vacía. La siguiente es una respuesta 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 el User-Agent encabezado que se debe proporcionar. Prueba el siguiente comando curl:

      curl AD_TAG_URI

    • Si el comando curl muestra una respuesta 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 se debe pasar a la API de Video Stitcher cuando creando la sesión en vivo. La API de Video Stitcher usa ese encabezado cuando ejecutar la etiqueta para recuperar anuncios.

    • Si aún se muestra una respuesta vacía, el problema está relacionado con la etiqueta de anuncio proporcionada. Confirma con el cliente que la etiqueta de anuncio sea correcta y que los valores de la macro de la etiqueta de anuncio también sean correctos.

    • Si se resolvieron los problemas de la etiqueta del anuncio del cliente, pero no se insertaron los anuncios, continúa con el siguiente paso.

  3. Inspecciona la sesión en vivo. Si la sesión afectada muestra que los anuncios se devuelven desde los servidores de anuncios, continúa con el siguiente paso.

  4. La siguiente causa potencial de la falta de anuncios se debe a la nueva codificación de anuncios. El La API volverá a codificar los anuncios durante su primer encuentro para que coincidan. el video de origen. Por lo general, los anuncios tardan unos minutos en codificarse. Vuelve a intentar crear una sesión nueva después de unos minutos para ver si se insertan los anuncios.

    Si no se insertaron anuncios, es posible que el problema se deba a que no se pudo codificar un anuncio. Es posible que no se pueda acceder a las URLs del material multimedia del anuncio. En este caso, el cliente debe trabajar con el proveedor de anuncios para determinar qué está mal con su material de anuncios.

No se insertaron anuncios en una sesión de VOD

  1. 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 VAST, VMAP o SmartXML no vacía. La siguiente es una respuesta VAST vacía:

    • Coloca la etiqueta de 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 del anuncio esté configurada correctamente con los servidores de anuncios.

    • Si se propaga la respuesta de VAST, usa curl para solicitar la etiqueta del anuncio. Algunos servidores de anuncios requieren el User-Agent encabezado que se debe proporcionar. Prueba el siguiente comando curl:

      curl AD_TAG_URI

    • Si el comando curl muestra una respuesta 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 se debe pasar el encabezado User-Agent a la API de Video Stitcher cuando se crea la sesión de VOD. La API de Video Stitcher usa ese encabezado cuando ejecute la etiqueta de anuncio para recuperar anuncios.

    • Si aún se muestra una respuesta vacía, el problema está relacionado con el etiqueta de anuncio. Confirma con el cliente que la etiqueta de anuncio sea correcta y que los valores de la macro de la etiqueta de anuncio también sean correctos.

    • Si se resolvieron los problemas de la etiqueta del anuncio del cliente, pero no se insertaron los anuncios, continúa con el siguiente paso.

  2. Inspecciona la sesión de VOD. Si la sesión afectada muestra que los anuncios se devuelven desde los servidores de anuncios, continúa con el siguiente paso.

  3. La siguiente causa potencial de falta de anuncios es recodificación de anuncios. La API volverá a codificar los anuncios durante su primer encuentro para que coincidan con el video de origen. Por lo general, los anuncios tardan unos minutos en codificarse. Vuelve a intentar crear una sesión nueva después de unos minutos para ver si se insertan los anuncios.

    Si no se insertaron anuncios, es posible que el problema se deba a que no se pudo codificar un anuncio. Es posible que no se pueda acceder a las URLs del material multimedia del anuncio. En este caso, el cliente debe trabajar con el proveedor de anuncios para determinar qué está mal con su material de anuncios.