Integração da API do DV360 para vendedores
Há algumas etapas importantes para integrar uma API à API DV360 Seller. A API DV360 Seller é exposta como uma API do Google Cloud baseada em lista de permissões e usa o OAuth para autenticação.
O processo de inclusão na lista de permissões será tratado entrando em contato com a equipe da API DV360 Seller.
Etapas de integração:
- Inscreva-se em uma Conta do Google em https://console.cloud.google.com/
- Essa conta será usada para gerenciar tokens de acesso do seu cliente de produção. Não use sua conta pessoal do Gmail.
- A conta não pode ser um Grupo do Google.
- Se você estiver usando um projeto atual do Google Cloud:a conta precisa ser um administrador do projeto.
- Entre em contato com o Google DV360 com as informações da conta que você se inscreveu para adicionar à lista de permissões.
- Aguarde a adição da sua conta à lista de permissões.
- Opcional e não de bloqueio:envie uma solicitação de análise de verificação do OAuth para o app para acessar o escopo(doubleclickbidmanager).
- Acesse https://console.cloud.google.com/. Navegue até APIs e serviços > Biblioteca > Particular. A API DV360 Seller vai aparecer como uma das APIs disponíveis.
- Ativar a API DV360 Seller
- Navegue até Credenciais > Criar uma credencial > Chave de conta de serviço. Siga as instruções aqui: https://developers.google.com/identity/protocols/OAuth2ServiceAccount
Configure uma conta de serviço:
Observação:informe se você quer reutilizar uma conta de serviço, como a API Reporting do DV360.A autenticação e a autorização da API Google Cloud (normalmente agrupadas como "auth") geralmente são feitas usando uma conta de serviço. Uma conta de serviço permite que seu código envie credenciais de aplicativo diretamente para a API Cloud. 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. Como exemplo, vamos mostrar como criar credenciais de conta de serviço usando o Console do Google Cloud Platform.
Como usar o Console do Google Cloud
Na página Gerenciador de API → Credenciais do console do Google Cloud, selecione "Criar credenciais → Chave de conta de serviço".
Em seguida, selecione "Nova conta de serviço" no menu suspenso "Conta de serviço".
Digite um "Nome" para essa conta de serviço. Esse nome será usado como padrão para o "ID da conta de serviço" (à esquerda de "@" no endereço gerado do ID da conta de serviço), mas você pode mudar o nome do ID da conta de serviço, se quiser. Esses nomes são arbitrários. É importante apenas que você os memorize. Em "Tipo de chave", defina o valor como "JSON". Clique em "Criar". O Console do GCP vai gerar uma chave JSON (como um arquivo de texto
.json
), solicitar que você faça o download do arquivo no seu computador e mostrar uma caixa de diálogo Conta de serviço criada.A chave JSON gerada é semelhante a esta amostra de chave:
{ "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" }
Armazene esse arquivo JSON em segurança, já que ele contém a chave privada e é a única cópia dessa chave. Você vai precisar consultar esse arquivo de chave da conta de serviço no seu código quando quiser enviar credenciais para a API do Google Cloud Platform.
- Entre em contato com o DV360 com as informações da conta de serviço que você criou. Especificamente, vamos precisar do e-mail dessa conta de serviço. Esse é outro processo de lista de permissões para autorização.
- Depois que sua conta de serviço for autorizada a chamar a API, consulte a documentação da API em https://developers.google.com/display-video/seller. Para receber o token de autenticação manualmente, consulte as instruções em https://github.com/google/oauth2l. Você precisa ter salvo a versão JSON da chave da conta de serviço. Também há instruções detalhadas sobre como receber o token Oauth de forma programática: https://cloud.google.com/docs/authentication/production.
Importante: o escopo do OAuth precisa ser "doubleclickbidmanager"