Integração da API Display &Video 360 Seller
Há algumas etapas importantes para a integração com a API Display &Video 360 Seller. A API DV360 Seller é uma API do Google Cloud baseada em lista de permissões e usa o OAuth 2.0 para autenticação e autorização.
O processo de lista de permissões é gerenciado pela equipe da API Display &Video 360 Seller.
Etapas de integração:
- Inscreva-se em uma Conta do Google acessando https://console.cloud.google.com/.
- Essa conta será usada para gerenciar tokens de acesso do cliente de produção. Não use uma 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 a equipe do Google DV360 com os detalhes da sua conta para que ela seja adicionada à lista de permissões.
- Aguarde a confirmação de que sua conta foi ativada.
- Opcional e não bloqueador: envie uma solicitação de revisão de verificação do OAuth para seu aplicativo para acessar o escopo
https://www.googleapis.com/auth/doubleclickbidmanager. - No console do Google Cloud, acesse APIs e serviços > Biblioteca > Particular. A API DV360 Seller vai aparecer como disponível para seu projeto.
- Ative a API DV360 Seller.
- Acesse APIs e serviços > Credenciais > Criar credenciais > Chave da conta de serviço. Siga as instruções de configuração na documentação da conta de serviço do OAuth 2.0.
Configurar uma conta de serviço:
Observação:informe se você quer reutilizar uma conta de serviço atual, como uma usada para a API DV360 Reporting.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" na lista suspensa "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", localizado à esquerda de "@" no endereço gerado desse ID conta de serviço. No entanto, é possível alterar o nome do ID da conta de serviço. Esses nomes são arbitrários. É importante apenas que você os memorize. Em "Tipo de chave", defina o valor como "JSON". Clique em "Criar". No console do GCP, uma chave JSON é gerada como um arquivo de texto
.json. Faça o download desse arquivo no seu computador, e a caixa de diálogo Conta de serviço criada será exibida.
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ê precisará consultar esse arquivo de chave da conta de serviço no seu código ao enviar credenciais para a API do Google Cloud Platform.
- Entre em contato com a equipe do DV360 com as informações da conta de serviço que você criou (especificamente, o endereço de e-mail da conta de serviço). Essa é uma segunda etapa 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 DV360 Seller. Para receber um token de autenticação manualmente, consulte as instruções no repositório da ferramenta oauth2l (usando a chave de conta de serviço JSON baixada). Instruções detalhadas sobre como receber tokens OAuth de maneira programática estão disponíveis na documentação de autenticação do Google Cloud.
Importante: o escopo do OAuth precisa ser https://www.googleapis.com/auth/doubleclickbidmanager