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

A API DV360 Exchange Reporting é exposta como uma lista de permissões do Google Cloud API que usa OAuth. O processo da lista de permissões é gerenciado pelo DV360 Exchange Equipe da API Reporting.

Procedimento

Estas são as etapas de integração da API DV360 Exchange Reporting:

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

    Esta conta é usada para gerenciar os tokens de acesso da sua cliente de produção. Por isso, não use sua conta pessoal do Gmail.

  2. Entre em contato com o Google DV360 com as informações da conta para que ela seja adicionada ao na lista de permissões.

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

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

    Acesse APIs e Serviços > Biblioteca > Particular. Deve aparecer um A API Exchange Reporting está listada como uma das APIs disponíveis para você. Ative o a API DV360 Exchange Reporting.

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

Conta de serviço

Uma conta de serviço permite que o código envie credenciais de aplicativos diretamente a a API. Uma conta de serviço, como uma conta de usuário, é representada por um e-mail endereço IP. Ao contrário das contas de usuário, a conta de serviço pertence apenas a um aplicativo e só podem ser usadas para acessar a API para a qual foram criados.

Siga estas etapas para criar credenciais de conta de serviço usando o Google Cloud console:

  1. No Gerenciador de APIs > página "Credenciais", selecione Criar credenciais→Chave de conta de serviço.

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

    Digite um Nome para a conta de serviço. Esse nome é usado como padrão o nome do seu ID da conta de serviço, à esquerda de @ na o endereço gerado pelo ID da conta de serviço.

    Em Tipo de chave, recomendamos que você deixe esse valor como JSON. Clique em Crie para gerar uma chave JSON como um arquivo de texto .json. Quando solicitado, Faça o download do arquivo para seu computador e abra uma caixa de diálogo Conta de serviço criada. é exibido.

    Este é 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 seu arquivo JSON com segurança, já que ele contém sua chave privada. Isso é a única cópia dessa chave. As credenciais neste arquivo são necessárias quando o código faz chamadas para a API.

  4. Entre em contato com o DV360 e informe as informações da conta de serviço que você criou. Mais especificamente, o endereço de e-mail da conta de serviço. Isso faz parte do processo da lista de permissões para acesso à API.

Token de acesso

Depois que sua conta de serviço for autorizada a fazer chamadas à API, será possível prossiga com os exemplos nos guias de API. Para receber um token de acesso manualmente, use uma ferramenta como o oauth2l; ou use uma de nosso cliente bibliotecas para autenticar programaticamente.