Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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.
Verifique se a chave do CDN foi registrada com a API Video Stitcher na
mesma região da solicitaçã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 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:
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.
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.
Verifique se apenas uma chave de CDN foi 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 foi inserido em uma sessão ao vivo, siga estas etapas para diagnosticar
o problema:
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.
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:
<VASTversion="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-Agentcabeçalho
seja fornecido. Tente usar o seguinte comando curl:
curlAD_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.
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 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
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:
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-Agentcabeçalho
seja fornecido. Tente usar o seguinte comando curl:
curlAD_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. 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.
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 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[],[],null,["# Troubleshoot\n\nThis page shows you how to resolve issues with the Video Stitcher API. The errors\nshown on this page are specific to the Video Stitcher API. For information on\ngeneric errors across Google APIs, see the Cloud APIs\n[Errors](/apis/design/errors) page.\n\nOnly the first error is returned. If a request encounters multiple errors, you\nneed to fix the returned error and retry the request to see the next error.\n\nUnable to fetch playlist when creating a session\n------------------------------------------------\n\nThe following issue occurs when the Video Stitcher API is unable to fetch the\nvideo manifest from the specified `sourceUri`. \n\n```\n{\n \"error\": {\n \"code\": 404,\n \"message\": \"got status code 403 when fetching playlist from URI \\\"https://example.com/manifest.m3u8\\\"\",\n \"status\": \"NOT_FOUND\",\n }\n}\n```\n\nTo resolve this issue, follow the steps below:\n\n1. Verify that the provided `sourceUri` links to a valid video manifest.\n\n - Use `curl` with the `sourceUri`. If the manifest is intended to be publicly accessible, ensure that the URL can be reached publicly.\n - If the `sourceUri` is correct and the video manifest requires URL signing, proceed to the next step.\n2. Ensure that the CDN key has been registered with the Video Stitcher API in the\n same region as the request.\n\n - [Verify that the CDN key configuration](/video-stitcher/docs/how-to/managing-cdn-keys#list_cdn_keys) matching the `sourceUri` hostname exists. If the configuration doesn't exist, [register the CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#register_cdn_key) with the Video Stitcher API. Wait at least 5 minutes for the configuration to propagate to the service.\n - If the configuration exists, proceed to the next step.\n3. If you suspect the private key used for signing the URL is incorrect, you\n may want to\n [update the registered CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#update_cdn_key)\n with the correct private key.\n\nCDN key is outdated\n-------------------\n\nIf you recently registered or updated a CDN key and the Video Stitcher API has not\nstarted signing URLs using the new configuration, then follow the steps below to\ndiagnose the issue:\n\n1. If the CDN key was recently registered with the Video Stitcher API, then wait\n at least 5 minutes to allow the update to propagate. If the issue persist,\n proceed to the next step.\n\n2. Verify that only one CDN key is registered for one hostname for the region.\n If multiple CDN keys have been registered with the same hostname, the\n Video Stitcher API will select one of the CDN keys to sign the URL with.\n\n - Ensure that only one CDN key has been registered with a specified hostname for a given region. [Delete the obsolete CDN key](/video-stitcher/docs/how-to/managing-cdn-keys#delete_cdn_key).\n\nNo ads inserted in a live session\n---------------------------------\n\nIf no ads were inserted in a live session, use the following steps to diagnose\nthe issue:\n\n1. Verify that the source livestreams inserted ad breaks in the manifest. The\n following [ad markers](/video-stitcher/docs/concepts/ad-markers) need to\n exist in the livestream video manifest to indicate to the Video Stitcher API\n to replace source video segments with ad segments.\n\n - If the source video manifest does not have any ad markers, either your\n encoder hasn't triggered an ad break or needs to be changed to insert\n the supported [ad markers](/video-stitcher/docs/concepts/ad-markers).\n\n - If ad markers are clearly visible in the source manifest, then proceed\n to the next step.\n\n2. Verify that the provided ad tag returns a non-empty VAST response.\n\n - Copy the ad tag into a web browser (for example, Chrome) address bar and\n verifies that it returns a non-empty VAST response. The following is an\n empty VAST response:\n\n \u003cVAST version=\"3.0\"/\u003e\n\n - If an empty VAST response is returned, then the issue is the ad tag.\n Verify that the ad tag is set up correctly with the ad servers.\n\n - If the VAST response is populated, use `curl` to request the ad tag.\n Some ad servers require the `User-Agent`\n [header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent)\n to be provided. Try the following `curl` command:\n\n curl \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If the `curl` command returns an empty VAST response, add the\n `User-Agent` header to the `curl` command:\n\n 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\" \\\n \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If a populated VAST response is returned, then the issue is that the\n `User-Agent` header needs to be passed to the Video Stitcher API when\n creating the live session. The Video Stitcher API uses that header when\n executing the ad tag to retrieve ads.\n\n - If an empty response is still returned, then the issue is with the given\n ad tag. Confirm with the customer that the ad tag is correct and that\n any\n [ad tag macro](/video-stitcher/docs/how-to/managing-live-sessions#ad-tag-macros)\n values are correct as well.\n\n - If the customer's ad tag issues have been resolved, but ads have not\n been inserted, proceed to the next step.\n\n3. [Inspect the live session](/video-stitcher/docs/how-to/managing-live-sessions#inspect-live-sessions).\n If the affected session is showing that ads are returned from the ad\n servers, then proceed to the next step.\n\n4. The next potential cause for missing ads is due to\n [ad re-encoding](/video-stitcher/docs/concepts/overview#ad_re-encoding). The\n API will re-encode ads during its first encounter to encode the ad to match\n the source video. Usually, ads take a few minutes to encode. Retry creating\n a new session after a few minutes to see if ads are inserted.\n\n If no ads were inserted, the issue may be due to an ad failing to encode.\n The ad media URLs may not be reachable. In this case, the customer needs to\n work with the ad provider to determine what's wrong with their ad media.\n\nNo ads inserted in a VOD session\n--------------------------------\n\n1. Verify that the provided ad tag returns a non-empty VAST or VMAP response.\n Use the provided ad tag with the following directions:\n\n - Copy the ad tag into a web browser (for example, Chrome) address bar and verifies that it returns a non-empty VAST, VMAP, or SmartXML response. The following is an empty VAST response:\n - Put the ad tag into a web browser (ie. Chrome, Firefox, etc) address bar\n and verifies that it returns a non empty VAST, VMAP, or SmartXML\n response. An empty VAST response looks like:\n\n \u003cVAST version=\"3.0\"/\u003e\n\n The following is an empty VMAP response: \n\n \u003cVMAP xmlns:vmap=\"http://www.iab.net/vmap-1.0\" version=\"1.0\"/\u003e\n\n - If an empty VAST response is returned, then the issue is the ad tag.\n Verify that the ad tag is set up correctly with the ad servers.\n\n - If the VAST response is populated, use `curl` to request the ad tag.\n Some ad servers require the `User-Agent`\n [header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent)\n to be provided. Try the following `curl` command:\n\n curl \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If the `curl` command returns an empty VAST response, add the\n `User-Agent` header to the `curl` command:\n\n 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\" \\\n \u003cvar translate=\"no\"\u003eAD_TAG_URI\u003c/var\u003e\n\n - If a populated VAST or VMAP response is returned, then the issue is that\n the `User-Agent` header needs to be passed to the Video Stitcher API\n when creating the VOD session. The Video Stitcher API uses that header\n when executing the ad tag to retrieve ads.\n\n - If an empty response is still returned, then the issue is with the given\n ad tag. Confirm with the customer that the ad tag is correct and that\n any\n [ad tag macro](/video-stitcher/docs/how-to/managing-vod-sessions#ad-tag-macros)\n values are correct as well.\n\n - If the customer's ad tag issues have been resolved, but ads have not\n been inserted, proceed to the next step.\n\n2. [Inspect the VOD session](/video-stitcher/docs/how-to/managing-vod-sessions#inspect-vod-sessions).\n If the affected session is showing that ads are returned from the ad\n servers, then proceed to the next step.\n\n3. The next potential cause for missing ads is due to\n [ad re-encoding](/video-stitcher/docs/concepts/overview#ad_re-encoding). The\n API will re-encode ads during its first encounter to encode the ad to match\n the source video. Usually, ads take a few minutes to encode. Retry creating\n a new session after a few minutes to see if ads are inserted.\n\n If no ads were inserted, the issue may be due to an ad failing to encode.\n The ad media URLs may not be reachable. In this case, the customer needs to\n work with the ad provider to determine what's wrong with their ad media."]]
