Ao usar 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 de forma dinâmica durante os intervalos de anúncios. A resposta especifica o URL de reprodução e a configuração da sessão ao vivo.
Este documento descreve 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 em tempo real. Para a integração com o Google Ad Manager, verifique se o objeto
gamLiveConfig
está definido. - Se você estiver especificando uma lousa, verifique se o objeto
gamSlate
está definido na lousa registrada.
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 campo obrigatório no corpo do JSON. É possível definir ou substituir os seguintes parâmetros opcionais por sessão ativa (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 servidor. Isso substitui o valor na configuração em tempo real 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 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 projeto do Google Cloud localizado no campo Número do projeto na página Configurações do IAMLOCATION
: o local em que a sessão será criada. Use uma das regiões com suporte.Mostrar 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 em tempo real
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# da API 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 da API 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 da API 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 da API 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 da API 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 da API 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 da API 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 a playUri
não for solicitada nos últimos 5 minutos.
É possível usar o STREAM_ID
retornado para
inspecionar a sessão ao vivo.
Inspecionar sessões ao vivo ativadas pelo Google Ad Manager
Para conferir detalhes sobre as tags de anúncios das sessões, use o Monitoramento da atividade de streaming no Ad Manager. Use STREAM_ID
para depurar a sessão de stream. Para encontrar o STREAM_ID
de
uma sessão ao vivo, consulte Acessar uma sessão.