Preparar o aplicativo cliente para funcionar com o Google Ad Manager

Colete as informações necessárias para seus aplicativos cliente

Você precisa ter as seguintes informações, que são necessárias para que o Google Ad Manager crie uma sessão de transmissão ao vivo:

CampoDescrição
projectNumberO número do projeto do Google Cloud usado para criar sessões ativadas para o Ad Manager. Como alternativa, é possível usar o ID do projeto.
region A região em que a configuração ativa está registrada.
liveConfigIdO ID de configuração ao vivo usado para registrar o evento de transmissão ao vivo com a API Video Stitcher. Veja a seguir o formato do nome completo do recurso de configuração:

projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
O ID da configuração é a última parte do nome completo (LIVE_CONFIG_ID). O local da configuração precisa estar no mesmo local em que você criou a sessão.
customAssetKeyÉ a chave de recurso personalizada criada durante o registro da configuração ao vivo. O SDK do IMA precisa desse valor para criar a transmissão.
networkCodeÉ o identificador numérico da sua rede do Ad Manager.
OAuth tokenUm token OAuth de curta duração para a conta de serviço com o papel Usuário de editor de vídeo. Consulte Gerar tokens OAuth de curta duração.

Tabela 1. Informações necessárias para sessões de transmissão ao vivo com o Ad Manager ativado

Gerar tokens OAuth de curta duração para testes

Para gerar um token OAuth de curta duração associado à conta de serviço com o papel Usuário do editor de vídeo, siga estas etapas:

  1. Substitua PATH_TO_YOUR_SERVICE_KEY pelo caminho do arquivo JSON que você salvou na máquina local.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
    
  2. Recupere o token do portador OAuth 2.0 da conta de serviço:
    gcloud auth print-access-token
    

Como esse é um token de curta duração, é necessário gerá-lo novamente periodicamente com o comando gcloud auth print-access-token e enviar os novos tokens para os aplicativos clientes. Consulte a seção a seguir para mais informações sobre como criar um serviço de produção para fornecer tokens de curta duração.

Criar um serviço para fornecer informações aos aplicativos clientes

Crie um serviço que possa fornecer as informações necessárias a serem transmitidas ao cliente. Quando o aplicativo solicita informações do seu serviço sobre como reproduzir uma transmissão ao vivo, o serviço precisa retornar as informações descritas na Tabela 1.

Em especial, o serviço precisa ser capaz de fornecer tokens OAuth aos aplicativos clientes de maneira segura. Configure esse serviço usando duas contas de serviço, uma representando a outra. Uma conta de serviço tem o papel de Criador de token de serviço e cria um token OAuth para a conta de serviço que tem o papel de Usuário de editor de vídeo. Exemplo:

  • Conta de serviço 1: a conta de serviço do autor da chamada. Essa conta tem a permissão de Criador de token de serviço na conta de serviço 2 e representa a conta de serviço 2 para aplicativos clientes.
  • Conta de serviço 2: é a conta de serviço com privilégios que tem o papel Usuário de editor de vídeo para criar sessões.

Para informações sobre como fornecer um token OAuth do seu serviço, incluindo exemplos de código da biblioteca de cliente, consulte Criar um token de acesso de curta duração.