Usando a API Video Stitcher, você cria uma sessão ao vivo sempre que inicia a reprodução de uma transmissão ao vivo em que os anúncios veiculados pelo Google Ad Manager são integrados dinamicamente durante os intervalos publicitários. A resposta especifica o URL de reprodução e a configuração da sessão ao vivo.
Neste documento, descrevemos como criar e gerenciar uma sessão ao vivo. Para mais detalhes, consulte a documentação REST.
Antes de começar
- Crie uma configuração de transmissão ao vivo. Para a integração com o Google Ad Manager, verifique se o objeto
gamLiveConfig
está definido. - Se você estiver especificando uma tela, verifique se o objeto
gamSlate
está definido na tela que você registrou.
Criar uma sessão ao vivo
Para criar uma sessão ao vivo usando a API diretamente, use o método
projects.locations.liveSessions.create
.
O campo liveConfig
é o único obrigatório no corpo JSON. É possível definir ou substituir os seguintes parâmetros opcionais por sessão ao vivo (conforme mostrado no exemplo REST a seguir):
manifestOptions
: especifica quais renderizações de vídeo são geradas no manifesto de vídeo costurado e a ordem das renderizações; consulte a documentação de opções de manifesto.adTracking
: selecione o acompanhamento de anúncios do lado do cliente ou do lado do servidor. Isso substitui o valor na configuração ativa da sessão.targetingParameters
: uma tag de anúncio do Google Ad Manager pode conter parâmetros de segmentação que podem ser atualizados por sessão. Forneça um mapeamento neste campo (por exemplo, para substituir a macro[my_key]
pela stringmy_value
, consulte o exemplo de REST).
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_NUMBER
: o número do seu Google Cloud projeto localizado no campo Número do projeto na página Configurações do IAMLOCATION
: o local em que você quer criar sua sessão. Use uma das regiões compatíveisMostrar locaisus-central1
us-east1
us-west1
asia-east1
asia-south1
asia-southeast1
europe-west1
southamerica-east1
LIVE_CONFIG_ID
: o identificador definido pelo usuário para a configuração ativa
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveSessions/SESSION_ID", "playUri": "PLAY_URI", "manifestOptions": { "includeRenditions": [ { "bitrateBps": 150000, "codecs": "hvc1.1.4.L126.B0" }, { "bitrateBps": 440000, "codecs": "hvc1.1.4.L126.B0" } ], "bitrateOrder": "DESCENDING" }, "gamSettings": { "streamId": "STREAM_ID" }, "liveConfig": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID", "adTracking": "SERVER" }
C#
Antes de testar esta amostra, siga as instruções de configuração do C# no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API C# Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Go Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Java Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Node.js Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Antes de testar esta amostra, siga as instruções de configuração do PHP no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API PHP Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Python Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Antes de testar esta amostra, siga as instruções de configuração do Ruby no Guia de início rápido da API Video Stitcher: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Ruby Video Stitcher.
Para autenticar na API Video Stitcher, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
A API Video Stitcher gera um ID de sessão exclusivo para cada solicitação. Uma sessão expira se o playUri
não for solicitado nos últimos cinco minutos.
Use o STREAM_ID
retornado para inspecionar a sessão ativa.
Inspecionar sessões ativas ativadas pelo Google Ad Manager
Para conferir detalhes da tag de anúncio das sessões, use o Monitoramento da atividade de streaming no Ad Manager e veja detalhes sobre as solicitações de anúncios. Use o STREAM_ID
para depurar a sessão de stream. Para encontrar o STREAM_ID
de
uma sessão ao vivo, consulte Receber uma sessão.