Prepare seu aplicativo cliente para funcionar com o Google Ad Manager

Coletar as informações necessárias para seus aplicativos clientes

Você precisa ter as seguintes informações 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 (PROJECT_NUMBER) usado para criar sessões ativadas pelo Ad Manager. Também é possível usar o ID do projeto.
region O local (LOCATION) onde a configuração ativa é registrada.
liveConfigIdO ID de configuração ao vivo usado para registrar o evento de transmissão ao vivo com a API Video Stitcher. O seguinte mostra o formato do nome completo do recurso de configuração:
projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
O ID de configuração é a última parte do nome completo (LIVE_CONFIG_ID). O local da configuração precisa ser o mesmo em que você cria a sessão.
customAssetKeyA chave de recurso personalizada (CUSTOM_ASSET_KEY) criada durante o registro de configuração ao vivo. O SDK do IMA precisa desse valor para criar a transmissão.
networkCodeO identificador numérico (NETWORK_CODE) da sua rede do Ad Manager.
oAuthTokenUm token OAuth de curta duração para a conta de serviço com o papel Usuário do Video Stitcher. Consulte Gerar tokens OAuth de curta duração.

Tabela 1. Informações obrigatórias para sessões de transmissão ao vivo ativadas pelo Ad Manager

Gerar tokens OAuth de curta duração para testes

Para gerar uma token OAuth de curta duração associadas ao conta de serviço com o papel Usuário de editor de vídeo, siga estas etapas:

  1. Substitua PATH_TO_YOUR_SERVICE_KEY pelo caminho do arquivo JSON. que você fez o download na sua máquina local.
    gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
  2. Extraia 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 aos aplicativos cliente. 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 cliente

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

Em particular, o serviço precisa ser capaz de fornecer tokens OAuth a aplicativos clientes de maneira segura. Configure esse serviço usando dois contas, uma falsificar a identidade da 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 do Video Stitcher. 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 do 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 de usuário do Video Stitcher 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.