Solución de problemas

En esta página, se muestra cómo resolver problemas relacionados 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 errores genéricos de las APIs de Google, consulta las API de Cloud Errores.

Solo se muestra el primer error. Si una solicitud encuentra varios errores, puedes debe corregir el error que se muestra y reintentar la solicitud para ver el siguiente error.

No se pudo recuperar la playlist mientras se creaba 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 vincule a un manifiesto de video válido.

    • Usa curl con sourceUri. Si el manifiesto pretende ser accesible públicamente, asegúrate de que la URL se pueda alcanzar públicamente.
    • Si el elemento sourceUri es correcto y el manifiesto de video requiere una URL firma, continúa con el paso siguiente.

  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 una clave de CDN esté registrada para un nombre de host en 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 la fuente hayan insertado pausas publicitarias en el manifiesto. El los siguientes marcadores de anuncios deben en el manifiesto del video de la transmisión en vivo para indicar a la API de Video Stitcher para reemplazar segmentos del video de origen por segmentos de anuncios.

    • Si el manifiesto del video de origen no tiene marcadores de anuncios, se puede no activó una pausa publicitaria o es necesario cambiarla para insertar los marcadores de anuncios compatibles

    • 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 que no esté vacía.

    • Copia la etiqueta del anuncio en la barra de direcciones de un navegador web (por ejemplo, Chrome) y, verifica que devuelva una respuesta de VAST que no está vacía. A continuación, se muestra un 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 el User-Agent encabezado que se debe proporcionar. Prueba el siguiente comando curl:

      curl AD_TAG_URI

    • Si el comando curl muestra una respuesta de VAST vacía, agrega el elemento 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 el etiqueta de anuncio. Confirma con el cliente que la etiqueta de anuncio sea correcta y que cualquiera macro de etiqueta de anuncio valores correctos también.

    • Si se resolvieron los problemas con las etiquetas de anuncios del cliente, pero no se haya insertado, continúa con el paso siguiente.

  3. Inspecciona la sesión en vivo. Si la sesión afectada muestra que el anuncio devuelve anuncios servidores, y continúa con el siguiente paso.

  4. La siguiente causa potencial de falta de anuncios es recodificació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. Reintentar la creación una nueva sesión después de unos minutos para ver si se insertaron los anuncios.

    Si no se insertó ningún anuncio, es posible que el problema se deba 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 necesita Trabaje con el proveedor de anuncios para determinar cuál es el problema con el contenido multimedia de sus 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 devuelva una respuesta de VAST, VMAP o SmartXML que no está vacía. La siguiente es una respuesta de VAST vacía:

    • Coloca la etiqueta de anuncio en un navegador web (p. ej., la barra de direcciones de Chrome, Firefox, etc. y verifica que muestre una notificación de VAST, VMAP o SmartXML respuesta. 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 el User-Agent encabezado que se debe proporcionar. Prueba el siguiente comando curl:

      curl AD_TAG_URI

    • Si el comando curl muestra una respuesta de VAST vacía, agrega el elemento 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 devuelve 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 crees 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 cualquiera macro de etiqueta de anuncio valores correctos también.

    • Si se resolvieron los problemas con las etiquetas de anuncios del cliente, pero no se haya insertado, continúa con el paso siguiente.

  2. Inspecciona la sesión de VOD. Si la sesión afectada muestra que el anuncio devuelve anuncios servidores, y continúa con el siguiente paso.

  3. La siguiente causa potencial de falta de anuncios es recodificació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. Reintentar la creación una nueva sesión después de unos minutos para ver si se insertaron los anuncios.

    Si no se insertó ningún anuncio, es posible que el problema se deba 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 necesita Trabaje con el proveedor de anuncios para determinar cuál es el problema con el contenido multimedia de sus anuncios.