Solucionar problemas

En esta página se explica cómo resolver problemas con la API Video Stitcher. Los errores que se muestran en esta página son específicos de la API 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 devuelve el primer error. Si una solicitud tiene varios errores, debes corregir el error devuelto y volver a intentarlo para ver el siguiente error.

No se puede obtener la lista de reproducción al crear una sesión

El siguiente problema se produce cuando la API Video Stitcher no puede obtener el manifiesto de vídeo 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 solucionar este problema, siga estos pasos:

  1. Comprueba que el sourceUri enlace a un manifiesto de vídeo válido.

    • Usa curl con sourceUri. Si el manifiesto debe ser de acceso público, asegúrate de que se pueda acceder a la URL públicamente.
    • Si el sourceUri es correcto y el manifiesto de vídeo requiere la firma de la URL, vaya al paso siguiente.

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

  3. Si sospechas que la clave privada utilizada para firmar la URL es incorrecta, puedes actualizar la clave de CDN registrada con la clave privada correcta.

La clave de CDN está obsoleta

Si has registrado o actualizado recientemente una clave de CDN y la API Video Stitcher no ha empezado a firmar URLs con la nueva configuración, sigue los pasos que se indican a continuación para diagnosticar el problema:

  1. Si la clave de CDN se ha registrado recientemente en la API Video Stitcher, espera al menos 5 minutos para que se propague la actualización. Si el problema persiste, ve al paso siguiente.

  2. Verifica que solo haya registrada una clave de CDN para un nombre de host de la región. Si se han registrado varias claves de CDN con el mismo nombre de host, la API Video Stitcher seleccionará una de ellas para firmar la URL.

No se insertan anuncios en una sesión en directo

Si no se han insertado anuncios en una sesión en directo, sigue estos pasos para diagnosticar el problema:

  1. Verifica que las emisiones en directo de origen hayan insertado pausas publicitarias en el manifiesto. Los siguientes marcadores de anuncio deben estar en el manifiesto de vídeo de la emisión en directo para indicar a la API Video Stitcher que sustituya los segmentos de vídeo de origen por segmentos de anuncio.

    • Si el manifiesto de vídeo de origen no tiene ningún marcador de anuncio, significa que tu codificador no ha activado un bloque publicitario o que debes cambiarlo para insertar los marcadores de anuncio admitidos.

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

  2. Verifique que la etiqueta de anuncio proporcionada devuelva una respuesta de VAST no vacía.

    • Copia la etiqueta publicitaria en la barra de direcciones de un navegador web (por ejemplo, Chrome) y comprueba que devuelve una respuesta VAST no vacía. A continuación se muestra una respuesta de VAST vacía:

      <VAST version="3.0"/>

    • Si se devuelve una respuesta de VAST vacía, el problema está en la etiqueta de anuncio. Verifique que la etiqueta de anuncio esté configurada correctamente con los servidores de anuncios.

    • Si la respuesta VAST se rellena, use curl para solicitar la etiqueta de anuncio. Algunos servidores de anuncios requieren que se proporcione el encabezado User-Agent . Prueba el siguiente comando de curl:

      curl AD_TAG_URI

    • Si el comando curl devuelve una respuesta de VAST vacía, añade 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 devuelve una respuesta de VAST con datos, el problema es que el encabezado User-Agent debe enviarse a la API Video Stitcher al crear la sesión en directo. La API Video Stitcher usa ese encabezado cuando ejecuta la etiqueta de anuncio para obtener anuncios.

    • Si sigue recibiendo una respuesta vacía, el problema está en la etiqueta de anuncio. Confirme con el cliente que la etiqueta de anuncio es correcta y que los valores de las macros de etiquetas de anuncio también lo son.

    • Si los problemas con la etiqueta de anuncio del cliente se han resuelto, pero los anuncios no se han insertado, vaya al paso siguiente.

  3. Inspecciona la sesión en directo. Si en la sesión afectada se indica que los anuncios se devuelven desde los servidores de anuncios, vaya al paso siguiente.

  4. Otro posible motivo por el que faltan anuncios es que se hayan recodificado. La API volverá a codificar los anuncios en su primer encuentro para que coincidan con el vídeo de origen. Normalmente, los anuncios tardan unos minutos en codificarse. Vuelve a intentar crear una sesión nueva al cabo de unos minutos para ver si se insertan anuncios.

    Si no se han insertado anuncios, puede que el problema se deba a que no se ha podido codificar un anuncio. Es posible que no se pueda acceder a las URLs de los medios publicitarios. En este caso, el cliente debe colaborar con el proveedor de anuncios para determinar qué ocurre con su contenido multimedia publicitario.

No se han insertado anuncios en una sesión de VOD

  1. Verifique que la etiqueta de anuncio proporcionada devuelva una respuesta de VAST o VMAP no vacía. Utilice la etiqueta de anuncio proporcionada siguiendo estas instrucciones:

    • Copia la etiqueta de anuncio en la barra de direcciones de un navegador web (por ejemplo, Chrome) y comprueba que devuelve una respuesta VAST, VMAP o SmartXML no vacía. A continuación se muestra una respuesta de VAST vacía:

    • Coloque la etiqueta de anuncio en un navegador web (por ejemplo, Chrome, Firefox, etc.) y comprueba que devuelve una respuesta de VAST, VMAP o SmartXML no vacía. Una respuesta de VAST vacía tiene este aspecto:

      <VAST version="3.0"/>

      A continuación se muestra una respuesta de VMAP vacía:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>

    • Si se devuelve una respuesta de VAST vacía, el problema está en la etiqueta de anuncio. Verifique que la etiqueta de anuncio esté configurada correctamente con los servidores de anuncios.

    • Si la respuesta VAST se rellena, use curl para solicitar la etiqueta de anuncio. Algunos servidores de anuncios requieren que se proporcione el encabezado User-Agent . Prueba el siguiente comando de curl:

      curl AD_TAG_URI

    • Si el comando curl devuelve una respuesta de VAST vacía, añade 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 devuelve una respuesta VAST o VMAP con datos, el problema es que el encabezado User-Agent debe enviarse a la API Video Stitcher al crear la sesión de vídeo bajo demanda. La API Video Stitcher usa ese encabezado cuando ejecuta la etiqueta de anuncio para obtener anuncios.

    • Si sigue recibiendo una respuesta vacía, el problema está en la etiqueta de anuncio. Confirme con el cliente que la etiqueta de anuncio es correcta y que los valores de las macros de etiquetas de anuncio también lo son.

    • Si los problemas con la etiqueta de anuncio del cliente se han resuelto, pero los anuncios no se han insertado, vaya al paso siguiente.

  2. Inspecciona la sesión de VOD. Si en la sesión afectada se indica que los anuncios se devuelven desde los servidores de anuncios, vaya al paso siguiente.

  3. Otro posible motivo por el que faltan anuncios es que se hayan recodificado. La API volverá a codificar los anuncios en su primer encuentro para que coincidan con el vídeo de origen. Normalmente, los anuncios tardan unos minutos en codificarse. Vuelve a intentar crear una sesión nueva al cabo de unos minutos para ver si se insertan anuncios.

    Si no se han insertado anuncios, puede que el problema se deba a que no se ha podido codificar un anuncio. Es posible que no se pueda acceder a las URLs de los medios publicitarios. En este caso, el cliente debe colaborar con el proveedor de anuncios para determinar qué ocurre con su contenido multimedia publicitario.