Para ativar a API Video Stitcher no seu projeto, entre em contato com seu representante de conta ou com o departamento de vendas para saber mais.

Esta página foi traduzida pela API Cloud Translation.

Resolver problemas

Esta página mostra como resolver problemas com a API Video Stitcher. Os erros mostrados nesta página são específicos à 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 repetir a solicitação para ver o próximo erro.

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:

Verifique se o sourceUri fornecido está vinculado a um manifesto de vídeo válido.
- Use curl com o sourceUri. Se o manifesto for criado para ser publicamente acessível, 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.
Verifique se a chave de CDN foi registrada com a API Video Stitcher no mesma região da solicitação.
- Verifique se a configuração da chave do CDN corresponde ao nome do host sourceUri. Se a configuração não existir, registre a chave do CDN com a API Video Stitcher. Aguarde pelo menos 5 minutos para que a configuração seja propagada para o serviço.
- Se a configuração existir, prossiga para a próxima etapa.
Se você suspeitar que a chave privada usada para assinar o URL está incorreta, pode querer atualizar a chave de CDN registrada com a chave privada correta.

A chave de CDN está desatualizada

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

Se a chave de CDN foi registrada recentemente com a API Video Stitcher, aguarde pelo menos cinco minutos para permitir que a atualização seja propagada. Se o problema persistir, siga para a próxima etapa.
Verifique se apenas uma chave da 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.
- Verifique se apenas uma chave CDN foi registrada com um nome do host de uma determinada região. Exclua a chave de CDN obsoleta.

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

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

Verifique se as transmissões ao vivo de origem inseriram intervalos de anúncio no manifesto. O seguintes marcadores de anúncio precisam existem no manifesto do vídeo de transmissão ao vivo para indicar à API Video Stitcher. para substituir segmentos do vídeo de origem por segmentos 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úncio estiverem claramente visíveis no manifesto de origem, prossiga. para a próxima etapa.
Verifique se a tag de anúncio fornecida retorna uma resposta VAST não vazia.
- Copie a tag de anúncio na barra de endereço do navegador da Web (por exemplo, Chrome) e verifica se ele 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 é a tag de anúncio. Verifique se a tag de anúncio está configurada corretamente nos 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 O cabeçalho User-Agent precisa ser transmitido para a API Video Stitcher quando criando 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 ainda assim uma resposta vazia for retornada, o problema está na tag de anúncio padrão. 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 de tag de anúncio do cliente foram resolvidos, mas os anúncios não foram foi inserido, prossiga para a próxima etapa.
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.
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 estar 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 foi inserido em uma sessão VOD demanda

Verifique se a tag de anúncio fornecida retorna uma resposta VAST ou VMAP não vazia. Use a tag de anúncio fornecida seguindo estas instruções:
- Copie a tag de anúncio na barra de endereço do navegador da Web (por exemplo, Chrome) e verifica se ele retorna uma resposta VAST, VMAP ou SmartXML não vazia. Confira a seguir uma resposta VAST vazia:
- Coloque a tag de 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 é semelhante a esta:
```
<VAST version="3.0"/>
```
  Veja 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 é a tag de anúncio. Verifique se a tag de anúncio está configurada corretamente nos 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 a permissão User-Agent cabeçalho precisam ser fornecidos. Tente usar o seguinte comando curl:
```
curl AD_TAG_URI
```
- Se o comando curl retornar uma resposta VAST vazia, adicione o User-Agent para o 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 para a 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 ainda assim uma resposta vazia for retornada, o problema está na tag de anúncio padrão. Confirme com o cliente se a tag de anúncio está correta e se nenhum Macro de tag de anúncio também estejam 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.
Inspecione a sessão de VOD. Se a sessão afetada mostrar que os anúncios foram retornados e siga para a próxima etapa.
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 for inserido, o problema pode estar relacionado a uma falha de codificação do 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.