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

Campo	Descrição
projectNumber	O 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) que você quer que o SDK do IMA use para criar a sessão VOD.
vodConfigId	O ID de configuração de VOD usado para registrar a transmissão de VOD com a API Video Stitcher. O exemplo a seguir 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.
networkCode	O identificador numérico (NETWORK_CODE) da sua rede do Ad Manager.
oAuthToken	Um 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 recursos de VOD ativados pelo Ad Manager

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 de usuário do Video Stitcher, 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 este é 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.

Importante: a regeneração de um token OAuth é uma operação demorada. Tente reutilizar um token OAuth o máximo possível ao criar sessões. É possível estender a duração de um token usando a flag --lifetime.

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 um recurso de VOD, 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 duas contas de serviço, uma imitando 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 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.