Resolver problemas

Esta página mostra como resolver problemas com a API Video Stitcher. Os erros mostrados nesta página são específicos da API Video Stitcher. Para ver informações sobre erros genéricos nas APIs do Google, consulte a página Erros das APIs do Cloud.

Apenas o primeiro erro é retornado. Se uma solicitação encontrar vários erros, você precisa corrigir o erro retornado e tentar novamente para ver o próximo.

Não é possível buscar a playlist ao criar uma sessão

O problema a seguir ocorre quando a API Video Stitcher não consegue buscar o manifesto de vídeo do 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 esse problema, siga as etapas abaixo:

  1. Verifique se o sourceUri fornecido está vinculado a um manifesto de vídeo válido.

    • Use curl com o sourceUri. Se o manifesto for acessível publicamente, verifique se o URL pode ser acessado publicamente.
    • Se o sourceUri estiver correto e o manifesto de vídeo exigir a assinatura de URL, prossiga para a próxima etapa.
  2. Verifique se a chave do CDN foi registrada na API Video Stitcher na mesma região da solicitação.

  3. Se você suspeitar que a chave privada usada para assinar o URL está incorreta, atualize a chave CDN registrada com a chave privada correta.

A chave de CDN está desatualizada

Se você registrou ou atualizou uma chave de CDN recentemente e a API Video Stitcher não começou a assinar URLs usando a nova configuração, siga as etapas abaixo para diagnosticar o problema:

  1. Se a chave do CDN foi registrada recentemente com a API Video Stitcher, aguarde pelo menos cinco minutos para que a atualização seja propagada. Se o problema persistir, siga para a próxima etapa.

  2. Verifique se apenas uma chave de CDN está registrada para um nome de host na região. Se várias chaves de CDN tiverem sido registradas com o mesmo nome de host, a API Video Stitcher vai selecionar uma das chaves de CDN para assinar o URL.

Nenhum anúncio inserido em uma sessão ao vivo

Se nenhum anúncio foi inserido em uma sessão ao vivo, siga estas etapas para diagnosticar o problema:

  1. Verifique se as transmissões ao vivo da origem inseriram intervalos de anúncios no manifesto. Os marcadores de anúncio abaixo precisam existir no manifesto de vídeo da transmissão ao vivo para indicar à API Video Stitcher que trechos de vídeo de origem devem ser substituídos por trechos de anúncio.

    • Se o manifesto do vídeo de origem não tiver marcadores de anúncio, seu codificador não acionou um intervalo de anúncio ou precisa ser alterado para inserir os marcadores de anúncio compatíveis.

    • Se os marcadores de anúncios estiverem claramente visíveis no manifesto de origem, prossiga para a próxima etapa.

  2. Verifique se a tag de anúncio fornecida retorna uma resposta VAST não vazia.

    • Copie a tag do anúncio na barra de endereço de um navegador da Web (por exemplo, Chrome) e verifique se ela retorna uma resposta VAST não vazia. Confira a seguir uma resposta VAST vazia:

      <VAST version="3.0"/>
      
    • Se uma resposta VAST vazia for retornada, o problema está na tag do anúncio. Verifique se a tag de anúncio está configurada corretamente com os servidores de anúncios.

    • Se a resposta VAST for preenchida, use curl para solicitar a tag de anúncio. Alguns servidores de anúncios exigem que o User-Agent cabeçalho seja fornecido. Tente usar o seguinte comando curl:

      curl AD_TAG_URI
      
    • Se o comando curl retornar uma resposta VAST vazia, adicione o cabeçalho User-Agent ao 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
      
    • Se uma resposta VAST preenchida for retornada, o problema é que o cabeçalho User-Agent precisa ser transmitido para a API Video Stitcher ao criar a sessão ao vivo. A API Video Stitcher usa esse cabeçalho ao executar a tag de anúncio para recuperar anúncios.

    • Se uma resposta vazia ainda for retornada, o problema está na tag de anúncio. Confirme com o cliente se a tag de anúncio está correta e se todos os valores da macro de tag de anúncio estão corretos.

    • Se os problemas com a tag de anúncios do cliente forem resolvidos, mas os anúncios não forem inseridos, prossiga para a próxima etapa.

  3. Inspecione a sessão ao vivo. Se a sessão afetada mostrar que os anúncios são retornados dos servidores de anúncios, prossiga para a próxima etapa.

  4. A próxima possível causa de anúncios ausentes é devido à recodificação de anúncios. A API vai codificar novamente os anúncios durante o primeiro encontro para que o anúncio seja codificado de acordo com o vídeo de origem. Normalmente, a codificação dos anúncios leva alguns minutos. Tente criar uma nova sessão depois de alguns minutos para ver se os anúncios são inseridos.

    Se nenhum anúncio foi inserido, o problema pode ser devido a uma falha na codificação. Os URLs de mídia do anúncio podem não ser acessíveis. Nesse caso, o cliente precisa trabalhar com o provedor de anúncios para determinar o que há de errado com a mídia do anúncio.

Nenhum anúncio inserido em uma sessão VOD

  1. Verifique se a tag de anúncio fornecida retorna uma resposta VAST ou VMAP não vazia. Use a tag do anúncio fornecida com as seguintes instruções:

    • Copie a tag do anúncio para a barra de endereços de um navegador da Web (por exemplo, o Chrome) e verifique se ela retorna uma resposta VAST, VMAP ou SmartXML não vazia. Confira a seguir uma resposta VAST vazia:
    • Coloque a tag do anúncio em um navegador da Web (por exemplo, na barra de endereço do navegador (Chrome, Firefox etc.) e verifica se ela retorna uma resposta VAST, VMAP ou SmartXML não vazia. Uma resposta VAST vazia tem esta aparência:

      <VAST version="3.0"/>
      

      Confira a seguir uma resposta VMAP vazia:

      <VMAP xmlns:vmap="http://www.iab.net/vmap-1.0" version="1.0"/>
      
    • Se uma resposta VAST vazia for retornada, o problema está na tag do anúncio. Verifique se a tag de anúncio está configurada corretamente com os servidores de anúncios.

    • Se a resposta VAST for preenchida, use curl para solicitar a tag de anúncio. Alguns servidores de anúncios exigem que o User-Agent cabeçalho seja fornecido. Tente usar o seguinte comando curl:

      curl AD_TAG_URI
      
    • Se o comando curl retornar uma resposta VAST vazia, adicione o cabeçalho User-Agent ao 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
      
    • Se uma resposta VAST ou VMAP preenchida for retornada, o problema é que o cabeçalho User-Agent precisa ser transmitido à API Video Stitcher ao criar a sessão VOD. A API Video Stitcher usa esse cabeçalho ao executar a tag de anúncio para recuperar anúncios.

    • Se uma resposta vazia ainda for retornada, o problema está na tag de anúncio. Confirme com o cliente se a tag de anúncio está correta e se todos os valores da macro de tag de anúncio estão corretos.

    • Se os problemas com a tag de anúncios do cliente forem resolvidos, mas os anúncios não forem inseridos, prossiga para a próxima etapa.

  2. Inspecione a sessão de VOD. Se a sessão afetada mostrar que os anúncios são retornados dos servidores de anúncios, prossiga para a próxima etapa.

  3. A próxima possível causa de anúncios ausentes é devido à recodificação de anúncios. A API vai codificar novamente os anúncios durante o primeiro encontro para que o anúncio seja codificado de acordo com o vídeo de origem. Normalmente, a codificação dos anúncios leva alguns minutos. Tente criar uma nova sessão depois de alguns minutos para ver se os anúncios são inseridos.

    Se nenhum anúncio foi inserido, o problema pode ser devido à falha na codificação de um anúncio. Os URLs de mídia do anúncio podem não ser acessíveis. Nesse caso, o cliente precisa trabalhar com o provedor de anúncios para determinar o que há de errado com a mídia do anúncio.