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.

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 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, corrija o erro retornado e tente fazer a solicitação novamente para ver o próximo erro.

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 fornecido está vinculado a um manifesto de vídeo válido.
- Use curl com o sourceUri. Se o manifesto for destinado ao público, verifique se o URL pode ser acessado publicamente.
- Se a sourceUri estiver correta e o manifesto do vídeo exigir uma assinatura de URL, prossiga para a próxima etapa.
Verifique se a chave de 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 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 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, prossiga para a próxima etapa.
Verifique se apenas uma chave de CDN está registrada para um nome de host da região. Se várias chaves CDN tiverem sido registradas com o mesmo nome de host, a API Video Stitcher selecionará uma das chaves CDN para assinar o URL.
- Certifique-se de que apenas uma chave de CDN tenha sido registrada com um nome de host especificado para uma determinada região. Exclua a chave de CDN obsoleta.

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

Se nenhum anúncio for 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. Os marcadores de anúncio a seguir precisam estar presentes no manifesto do vídeo de transmissão ao vivo para indicar à API Video Stitcher que substitua os 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, 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ú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 de 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 nos servidores de anúncios.
- Se a resposta VAST estiver 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 será que o cabeçalho User-Agent 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 ainda assim uma resposta vazia for retornada, o problema está na tag de anúncio fornecida. Confirme com o cliente se a tag de anúncio e os valores de 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 inseridos, 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 para a ausência de anúncios é a recodificação. A API vai recodificar os anúncios durante o primeiro encontro para codificar o anúncio para que ele corresponda ao vídeo de origem. Normalmente, a codificação dos anúncios leva alguns minutos. Tente criar uma nova sessão novamente após alguns minutos para ver se os anúncios foram 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 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 de anúncio dele.

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 de um navegador da Web (por exemplo, o Chrome) e verifique se ela retorna uma resposta VAST, VMAP ou SmartXML não vazia. Veja a seguir uma resposta VAST vazia:
- Coloque a tag de anúncio em um navegador da Web (por exemplo, Chrome, Firefox etc.) e verifica se 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 estiver 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 de 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 fornecida. Confirme com o cliente se a tag de anúncio e os valores de 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 inseridos, prossiga para a próxima etapa.
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.
A próxima possível causa para a ausência de anúncios é a recodificação. A API vai recodificar os anúncios durante o primeiro encontro para codificar o anúncio para que ele corresponda ao vídeo de origem. Normalmente, a codificação dos anúncios leva alguns minutos. Tente criar uma nova sessão novamente após alguns minutos para ver se os anúncios foram 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 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 de anúncio dele.