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

Resolver problemas

Nesta página, mostramos 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ê precisará corrigir o erro retornado e repetir a solicitação para ver o próximo.

Não foi 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 informado está vinculado a um manifesto de vídeo válido.
- Use curl com o sourceUri. Se o manifesto for acessível ao público, verifique se o URL pode ser acessado publicamente.
- Se o sourceUri estiver correto e o manifesto do vídeo exigir assinatura de URL, siga para a próxima etapa.
Verifique se a chave da CDN foi registrada com a API Video Stitcher na mesma região da solicitação.
- Verifique se a configuração da chave CDN correspondente ao nome do host sourceUri existe. Se a configuração não existir, registre a chave CDN com a API Video Stitcher. Aguarde pelo menos cinco 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, atualize a chave CDN registrada com a chave privada correta.

A chave de CDN está desatualizada

Se você registrou ou atualizou recentemente uma chave de CDN 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:

Se a chave CDN tiver sido registrada recentemente com a API Video Stitcher, aguarde pelo menos cinco minutos para que a atualização seja propagada. Se o problema persistir, prossiga para a próxima etapa.
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 selecionará uma das chaves de CDN para assinar o URL.
- Garanta que apenas uma chave de CDN tenha sido registrada com um nome do host especificado para uma determinada região. Exclua a chave de CDN obsoleta.

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

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

Verifique se as transmissões ao vivo de origem inseriu intervalos de anúncios no manifesto. Os marcadores de anúncio abaixo precisam estar no manifesto de streaming de vídeo ao vivo para indicar à API Video Stitcher a substituição de segmentos de vídeo de origem por segmentos de anúncio.
- Se o manifesto do vídeo de origem não tiver marcadores de anúncio, isso significa que o 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.
Verifique se a tag de anúncio fornecida retorna uma resposta VAST não vazia.
- Copie a tag de anúncio em um navegador da Web (por exemplo, o Chrome) e verifique se ela retorna uma resposta VAST não vazia. Veja 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 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 cabeçalho User-Agent seja fornecido. Tente 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 vai precisar 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 fornecida. Confirme com o cliente se a tag de anúncio está correta e se todos os valores da macro de tag de anúncio também estão.
- Se os problemas com a tag de anúncio do cliente foram resolvidos, mas os anúncios não foram inseridos, prossiga para a próxima etapa.
Inspecionar a sessão ao vivo. Se a sessão afetada estiver mostrando que anúncios são retornados dos servidores de anúncios, prossiga para a próxima etapa.
A próxima possível causa para anúncios ausentes é devido à recodificação de anúncios. A API recodifica os anúncios na primeira interação para que eles correspondam ao vídeo de origem. Normalmente, os anúncios levam alguns minutos para serem codificados. Tente criar uma nova sessão novamente após alguns minutos para ver se os anúncios foram inseridos.

Se nenhum anúncio foi inserido, o problema pode ter acontecido devido a uma falha na 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.

Nenhum anúncio foi inserido em uma sessão VOD demanda

Verifique se a tag de anúncio retorna uma resposta VAST ou VMAP não vazia. Use a tag de anúncio fornecida com as seguintes instruções:
- Copie a tag de anúncio em um navegador da Web (por exemplo, o Chrome) e verifique se ela retorna uma resposta VAST, VMAP ou SmartXML não vazia. Esta é uma resposta VAST vazia:
- Insira a tag de anúncio em um navegador da Web (por exemplo, Chrome, Firefox etc.) e verifica se ela retorna uma resposta VAST, VMAP ou SmartXML que não esteja vazia. Uma resposta VAST vazia é semelhante a esta:
```
<VAST version="3.0"/>
```
  Esta é 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 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 cabeçalho User-Agent seja fornecido. Tente 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 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 uma resposta vazia ainda for retornada, o problema está na tag de anúncio fornecida. Confirme com o cliente se a tag de anúncio está correta e se todos os valores da macro de tag de anúncio também estão.
- Se os problemas com a tag de anúncio do cliente foram resolvidos, mas os anúncios não foram inseridos, prossiga para a próxima etapa.
Inspecione a VOD sob demanda. Se a sessão afetada estiver mostrando que anúncios são retornados dos servidores de anúncios, prossiga para a próxima etapa.
A próxima possível causa para anúncios ausentes é devido à recodificação de anúncios. A API recodifica os anúncios na primeira interação para que eles correspondam ao vídeo de origem. Normalmente, os anúncios levam alguns minutos para serem codificados. Tente criar uma nova sessão novamente após alguns minutos para ver se os anúncios foram inseridos.

Se nenhum anúncio foi inserido, o problema pode ter acontecido devido a uma falha na 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.