Integração da API DV360 Exchange Reporting e configuração do OAuth

A API Reporting do DV360 Exchange oferece aos parceiros de troca de terceiros (3PE, na sigla em inglês) acesso programático a relatórios de performance do Display &Video 360.

A API Reporting do DV360 Exchange é exposta como uma API do Google Cloud baseada em lista de permissões que usa o OAuth. O processo de lista de permissões é gerenciado pela equipe da API Reporting do DV360 Exchange.

Procedimento

Confira as etapas de integração da API Reporting do DV360 Exchange:

  1. Inscreva uma Conta do Google no Google Cloud console.

    Essa conta será usada para gerenciar tokens de acesso do cliente de produção. Portanto, não use sua conta pessoal do Gmail.

  2. Entre em contato com o Google DV360 e informe os dados da conta para que ela seja adicionada à lista de permissões.

  3. Depois de receber a notificação de que você está na lista de permissões, solicite uma análise de verificação do OAuth para que seu app tenha acesso ao escopo doubleclickbidmanager.

  4. Faça login no console do Google Cloud.

    Acesse APIs e serviços > Biblioteca > Particular. A API Reporting do DV360 Exchange vai aparecer como uma das APIs disponíveis. Ative a API Reporting do DV360 Exchange.

  5. Acesse Credenciais > Criar uma credencial > Chave de conta de serviço. Siga as instruções para criar uma conta de serviço.

Conta de serviço

Uma conta de serviço permite que seu código envie credenciais de aplicativo diretamente para a API. Uma conta de serviço, como uma conta de usuário, é representada por um endereço de e-mail. No entanto, ao contrário de uma conta de usuário, uma conta de serviço pertence apenas a um aplicativo e só pode ser usada para acessar a API para a qual foi criada.

Confira as etapas para criar credenciais de conta de serviço usando o console do Google Cloud:

  1. Na página Gerenciador de API > Credenciais, selecione Criar credenciais → Chave de conta de serviço.

  2. Selecione Nova conta de serviço no menu suspenso Conta de serviço.

    Insira um nome para essa conta de serviço. Esse nome é usado como padrão para seu ID da conta de serviço, localizado à esquerda de @ no endereço gerado desse ID conta de serviço.

    Em Tipo de chave, recomendamos que você deixe esse valor como JSON. Clique em Criar para gerar uma chave JSON como um arquivo de texto .json. Quando solicitado, faça o download do arquivo para seu computador. Uma caixa de diálogo Conta de serviço criada será exibida.

    Confira um exemplo de chave JSON:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. Armazene o arquivo JSON em segurança, já que ele contém a chave privada e é a única cópia dessa chave. As credenciais nesse arquivo são necessárias quando o código faz chamadas para a API.

  4. Entre em contato com o DV360 e informe os dados da conta de serviço criada, especificamente o endereço de e-mail da conta de serviço. Isso faz parte do processo de lista de permissões para acesso à API.

Token de acesso

Depois que a conta de serviço for autorizada a fazer chamadas para a API, você poderá continuar com os exemplos nos guias da API. Para receber um token de acesso manualmente, use uma ferramenta como o oauth2l ou uma das nossas bibliotecas de cliente para autenticar de forma programática.