Prepare a sua aplicação cliente para funcionar com o Google Ad Manager

Recolha as informações necessárias para as candidaturas dos seus clientes

Deve ter as seguintes informações necessárias para o Google Ad Manager criar uma sessão de stream em direto:

Campo	Descrição
projectNumber	O Google Cloud número do projeto (PROJECT_NUMBER) usado para criar sessões ativadas no Ad Manager; em alternativa, pode usar o ID do projeto.
region	O local (LOCATION) onde a configuração em direto está registada.
liveConfigId	O ID de configuração em direto usado para registar o evento de stream em direto na API Video Stitcher. O exemplo 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). Tenha em atenção que a localização da configuração tem de ser a mesma em que cria a sessão.
customAssetKey	A chave de recurso personalizada (CUSTOM_ASSET_KEY) criada durante o registo da configuração em direto. O SDK IMA precisa deste valor para criar a stream.
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 a função Utilizador do Video Stitcher. Consulte o artigo Gere tokens OAuth de curta duração.

Tabela 1. Informações necessárias para sessões de streams em direto ativadas no Ad Manager

Gere tokens OAuth de curta duração para testes

Para gerar um token OAuth de curta duração associado à conta de serviço com a função Utilizador do Video Stitcher, siga estes passos:

1. Substitua PATH_TO_YOUR_SERVICE_KEY pelo caminho para o ficheiro JSON que transferiu para a sua máquina local.

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY

2. Obtenha o token de autorização do OAuth 2.0 a partir da conta de serviço:

   gcloud auth print-access-token

Uma vez que este é um token de curta duração, tem de o gerar novamente periodicamente com o comando gcloud auth print-access-token e enviar os novos tokens para as suas aplicações cliente. Consulte a secção seguinte para obter mais informações sobre a criação de 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. Pode prolongar a duração de um token através da sinalização --lifetime.

Crie um serviço para fornecer informações às suas aplicações cliente

Crie um serviço que possa fornecer as informações necessárias para serem transmitidas ao cliente. Quando a aplicação pede informações ao seu serviço sobre como ver uma transmissão em direto, o serviço deve devolver as informações descritas na Tabela 1.

Em particular, o serviço tem de conseguir fornecer tokens OAuth às aplicações cliente de forma segura. Configure este serviço com duas contas de serviço, uma a representar a outra. Uma conta de serviço tem a função Criador de tokens de serviço e cria um token OAuth para a conta de serviço que tem a função Utilizador do Video Stitcher. Por exemplo:

• Conta de serviço 1: esta é a conta de serviço do autor da chamada. Esta conta tem a autorização de criador de tokens de serviço na conta de serviço 2 e rouba a identidade da conta de serviço 2 para aplicações cliente.
• Conta de serviço 2: esta é a conta de serviço com privilégios que tem a função de utilizador do Video Stitcher para criar sessões.

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