Preparar o aplicativo cliente para funcionar com o Google Ad Manager

Colete 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 recurso de VOD:

CampoDescrição
projectNumberO número do projeto do Google Cloud (PROJECT_NUMBER) usadas para criar sessões ativadas para o Ad Manager. como alternativa, use o ID do projeto.
region O local (LOCATION) que você quer que o SDK do IMA use para criar a sessão VOD.
vodConfigIdO ID de configuração de VOD usado para registrar a transmissão de VOD com a API Video Stitcher. O seguinte mostra o formato do nome completo do recurso de configuração:
projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID
O ID da configuração de VOD é a última parte do nome completo (VOD_CONFIG_ID). O local da configuração precisa ser o mesmo em que você cria a sessão de VOD.
networkCodeO identificador numérico (NETWORK_CODE) para à 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 necessárias para sessões de recursos de VOD ativadas para o 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 para 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 clientes

Crie um serviço que possa fornecer as informações necessárias a serem transmitidas para o para o cliente. Quando o aplicativo solicitar informações do seu serviço sobre como reproduzir um recurso de VOD, o serviço precisará retornar as informações descritas na tabela 1.

Especificamente, o serviço deve ser capaz de fornecer tokens OAuth para 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 Criador de token de serviço e cria um OAuth para a conta de serviço que tem o papel Usuário de editor de vídeo. Exemplo:

  • Conta de serviço 1: é a conta de serviço do autor da chamada. Esta conta tem o Permissão de Criador de token de serviço na conta de serviço 2 e personifica 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 mais informações sobre como fornecer um token OAuth do seu serviço, incluindo exemplos de código da biblioteca, consulte Crie um token de acesso de curta duração.