Com 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 agrupados dinamicamente durante os intervalos. 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 da 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 barreira, verifique se o objeto
gamSlate
está definido na barreira 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 modificar os seguintes parâmetros opcionais por sessão ao vivo (conforme mostrado no
exemplo de REST a seguir):
manifestOptions
: especifica quais execuções de vídeo são geradas no manifesto do vídeo agrupado e a ordem delas. Consulte a documentação das opções do manifesto.adTracking
: selecione o rastreamento de anúncios do lado do cliente ou do lado do servidor. Isso substitui o valor na configuração ativa para a 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 nesse 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, faça as substituições a seguir:
PROJECT_NUMBER
: o número do projeto do Google Cloud localizado no campo Número do projeto da 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 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 de C# no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de Go no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de Java no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de Node.js no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de PHP no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de Python no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 de Ruby no Guia de início rápido da API Video Stitcher usando bibliotecas de cliente. Para ver 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 único para cada solicitação. A
sessão expira quando o playUri
não é solicitado nos últimos cinco minutos.
É possível usar o STREAM_ID
retornado para
inspecionar a sessão ativa.
Inspecionar sessões ao vivo ativadas pelo Google Ad Manager
Para ver detalhes da tag de anúncio das sessões, use o monitor da atividade de streaming no Ad Manager para conferir detalhes sobre solicitações de anúncios. Use o STREAM_ID
para depurar a sessão do stream. Para encontrar o STREAM_ID
de
uma sessão ao vivo, consulte Acessar uma sessão.