Visão geral das transmissões ao vivo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Pod Serving fornece acesso a conjuntos de anúncios em vídeo com taxa de bits adaptável preparados
para que possam ser agrupados diretamente em uma playlist de mídia HLS ou MPEG
DASH voltada para o usuário.
Essa API é destinada a editores avançados e parceiros de tecnologia de vídeo.
O uso dessa API em escala requer o design e a implementação de um fluxo sofisticado de veiculação de mídia, o que está fora do escopo desta documentação.
Pré-requisitos
Antes de processar uma transmissão ao vivo por meio da API DAI Podserving, você precisa criar um evento de transmissão ao vivo usando a IU do Google Ad Manager ou a API de evento ao vivo.
Componentes
Há três componentes que constituem qualquer implementação da API Pod Serving: o Google Ad Manager, um player de vídeo do cliente e um servidor de manipulação de manifesto.

Ad Manager
O Ad Manager é responsável por exibir anúncios ao usuário e pode ser gerenciado
pelo SDK do Ad Manager ou pela interface da Web dele. O serviço tem estas
responsabilidades:
- Recebimento de solicitações de stream do player de vídeo do cliente, toma decisões de anúncios
e fornece execuções para corresponder aos seus perfis de codificação de conteúdo
- Responder a solicitações de segmento de anúncio do player de vídeo do cliente e
fornecer a parte apropriada do conjunto de anúncios para um determinado usuário.
- Recebimento e processamento de pings de rastreamento do player de vídeo do cliente
Player de vídeo do cliente
O player de vídeo do cliente é o app ou site que os clientes usam para reproduzir o
stream de vídeo resultante. O jogador tem estas responsabilidades:
- Inicializar um recurso de stream do Ad Manager e receber um objeto de stream
que representa uma única sessão de reprodução de um evento específico de transmissão ao vivo.
- Solicitação de um manifesto de stream do servidor de manipulação de manifesto,
que inicia a reprodução
- Pesquisa periódica de metadados do conjunto de anúncios do Ad Manager que descrevem os eventos
de anúncios incorporados aos segmentos de anúncios do stream
- Detecte eventos de metadados com marcação de tempo gerados pelo player que contêm IDs
de mídia de anúncio. Ao encontrar esses eventos, o player os encaminha ao
Ad Manager para verificar se os eventos de anúncios ocorreram.
Para saber mais sobre a implementação adequada do player de vídeo do cliente, consulte o guia de veiculação de pods da sua plataforma:
Para implementações personalizadas, consulte nosso guia do cliente de veiculação de conjuntos para a API DAI.
Servidor de manipulação de manifesto
O servidor de manipulação de manifesto é o servidor encarregado de hospedar o manifesto de stream fornecido ao player de vídeo do cliente. O servidor tem estas
responsabilidades:
- Como processar o envio do manifesto para o player de vídeo do cliente
- Solicitar um modelo de período do Ad Manager (somente para streams MPEG DASH)
para preencher com segmentos de anúncio.
- Inserção de URLs de segmento de anúncio hospedados pelo Ad Manager no manifesto de stream de vídeo
(para HLS) ou período de anúncio (para MPEG DASH) durante intervalos de anúncio.
- Exibir o manifesto modificado no player de vídeo do cliente.
Para saber mais sobre como implementar um servidor manipulador de manifesto personalizado, consulte o
guia de manipulação de
manifesto.
Glossário
- Evento de transmissão ao vivo: um evento que armazena dados de configuração importantes para
transmissão ao vivo, como perfis de codificação. Os eventos de transmissão ao vivo são criados usando o Ad
Manager.
- Objeto de stream: um objeto que representa uma única sessão de reprodução de um
recurso de vídeo específico. As propriedades importantes incluem o ID do stream e o
URL de verificação de mídia.
- Conjunto de anúncios: é o agrupamento de vídeos de anúncios exibidos em um intervalo de anúncio.
- Segmentos de anúncio: arquivos de segmento de mídia para o intervalo de anúncio.
- Metadados do conjunto de anúncios: metadados do intervalo de anúncio usados para renderizar a interface do anúncio no
cliente. Por exemplo, ocultar botões de busca durante o anúncio.
- ID da mídia do anúncio: metadados codificados como tags ID3 em arquivos de segmento de anúncio. Esses
metadados são usados para identificar quando eventos específicos relacionados a anúncios ocorreram
durante a reprodução, como início ou ponto médio do anúncio.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-01 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-01 UTC."],[[["\u003cp\u003eThe Pod Serving API facilitates the integration of adaptive-bitrate video ad pods directly into HLS or MPEG DASH media playlists for advanced publishers and video technology partners.\u003c/p\u003e\n"],["\u003cp\u003eImplementing the Pod Serving API involves three core components: Google Ad Manager, which handles ad delivery and tracking; a client video player, which manages stream initialization and playback; and a manifest manipulation server, which modifies and serves the stream manifest.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, a livestream event must be created via the Google Ad Manager UI or the live-event API, serving as a configuration resource for the livestream.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player is responsible for initializing the stream, requesting the manifest, polling for ad pod metadata, and forwarding timed metadata events to Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulation server handles manifest delivery, requests ad period templates, and inserts Ad Manager-hosted ad segment URLs or ad periods into the stream manifest during ad breaks.\u003c/p\u003e\n"]]],[],null,["# Overview for live streams\n\nThe Pod Serving API provides access to adaptive-bitrate video ad pods prepared\nin such a way that they can be stitched directly into a user-facing HLS or MPEG\nDASH media playlist.\n\nThis API is intended for advanced publishers and video technology partners.\nUsing this API at scale requires design and implementation of a sophisticated\nmedia serving workflow which is outside the scope of this documentation.\n\nPrerequisites\n-------------\n\nBefore processing a livestream through the DAI Podserving API, you\nwill need to create a\n[livestream event](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator#livestreamevent)\nusing the Google Ad Manager UI, or the live-event API.\n\nComponents\n----------\n\nThere are three components that make up any implementation of the Pod Serving\nAPI: Google Ad Manager, a client video player, and a manifest manipulation\nserver.\n\n### Ad Manager\n\nAd Manager is responsible for delivering ads to the user and can be managed\nthrough either the Ad Manager SDK or its web interface. The service has these\nresponsibilities:\n\n- Receiving stream requests from the client video player, decisioning ads, and providing renditions to match your content encoding profiles\n- Responding to ad segment requests from the client video player and providing the appropriate portion of the ad pod for the given user\n- Receiving and processing tracking pings from the client video player\n\n### Client video player\n\nThe client video player is the app or website that clients use to play the\nresulting video stream. The player has these responsibilities:\n\n- Initializing a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific livestream event.\n- Requesting a stream manifest from the manifest manipulation server, which starts playback\n- Periodically polling ad pod metadata from Ad Manager that describes the ad events embedded in the stream's ad segments\n- Listening for timed metadata events raised by the player that contain ad media IDs. Upon encountering these events, the player forwards them to Ad Manager to verify that ad events have successfully occurred.\n\nTo learn more about the proper implementation of the client video player, see\nthe pod serving guide for your platform:\n\n- [Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod)\n- [HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod)\n- [iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod)\n- [tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod)\n\nFor custom implementations, see our [pod serving client guide for the DAI\nAPI](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client).\n\n### Manifest manipulation server\n\nThe manifest manipulation server is the server in charge of hosting the\nstream manifest provided to the client video player. The server has these\nresponsibilities:\n\n- Handling manifest delivery to the client video player\n- Requesting a period template from Ad Manager (for MPEG DASH streams only), to populate with ad segments.\n- Inserting Ad Manager-hosted ad segment URLs into the video stream manifest (for HLS) or ad period (for MPEG DASH) during ad breaks.\n- Serving the modified manifest to the client video player.\n\nTo learn more about implementing a custom manifest manipulator server, see the\n[manifest manipulation\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator).\n\nGlossary\n--------\n\n- **Livestream event**: An event that stores important configuration data for livestream, such as encoding profiles. Livestream events are created using Ad Manager.\n- **Stream object**: An object that represents a single playback session of a specific video asset. Notable properties include the stream ID and the media verification URL.\n- **Ad pod**: Grouping of ad videos shown in an ad break\n- **Ad segments**: Media segment files for the ad break\n- **Ad pod metadata**: Metadata for the ad break used to render ad UI on the client; for example, hide seek buttons during ad\n- **Ad media ID**: Metadata encoded as ID3 tags within ad segment files. This metadata is used to identify when specific ad-related events have occurred during playback, such as ad start or midpoint."]]