Configurar o acesso à API

Confira como configurar o acesso à API Data Manager com um SDK ou REST.

Escolha o tipo de processo de configuração que você quer seguir:

Pré-requisitos

Antes de usar a API Data, verifique se você tem o seguinte:

Um projeto do Google Cloud.
Uma Conta do Google com a permissão serviceusage.services.enable no seu projeto do Google Cloud ou um papel que inclua essa permissão. Por exemplo, roles/owner e roles/serviceusage.serviceUsageAdmin incluem a permissão serviceusage.services.enable. Para verificar suas permissões, consulte Ver acesso atual.
A interface de linha de comando do Google Cloud instalada.

Ativar a API

Se ainda não tiver feito isso, ative a API Data Manager clicando em Ativar a API Data Manager ou siga as instruções para realizar essa etapa manualmente.

Se você não encontrar a API Data Manager ou se a opção Ativar a API Data Manager falhar, verifique se sua Conta do Google atende aos pré-requisitos.

Configurar a autenticação

Você pode usar qualquer um dos métodos de autenticação no Google, além das chaves de API. Recomendamos que você revise como Escolher o método de autenticação certo para seu caso de uso e decida qual abordagem é adequada para seu caso de uso.

Dois métodos de autenticação comuns são contas de usuário e contas de serviço:

Contas de usuário: representam pessoas que interagem diretamente com as APIs e os serviços do Google.
Contas de serviço: representam apps, não pessoas, como usuários. Elas permitem que seus apps gerenciem a autenticação e a autorização. Por exemplo, se um app precisar acessar recursos do Google Cloud.

Sua integração pode usar o Application Default Credentials (ADC) para encontrar automaticamente as credenciais do ambiente. Assim, não é necessário mudar o código do cliente para autenticar.

Escolha Conta de usuário ou Representação de conta de serviço para configurar o ADC:

Estas são as etapas para autenticar com credenciais da conta de usuário:

Configure as configurações da plataforma de autenticação do Google para seu projeto.

Importante: qualquer app do Google Cloud usado para receber credenciais de usuário para o escopo da API Data Manager precisa passar pela verificação do Google OAuth para evitar uma tela de interface não verificada para os usuários. A verificação do OAuth do Google não é necessária para contas de serviço.
1. Abra a página de branding no console do Google Cloud.
2. Selecione o projeto.
3. Preencha o formulário e clique em Criar.
Como o escopo da API Data Manager é sensível, as etapas a seguir são necessárias:
1. Acesse as configurações de Acesso a dados do seu projeto.
2. Clique em Adicionar ou remover escopos.
3. Marque a caixa ao lado de API Data Manager na lista de escopos e clique em Atualizar.
4. Clique em Salvar.
5. Acesse Público-alvo no console do Google Cloud e atualize o Status de publicação e o Tipo de usuário. Saiba mais sobre essas configurações em Gerenciar público-alvo do app.
Clique em Criar cliente OAuth2 para criar um cliente OAuth2 no projeto ou siga as instruções para criar um cliente OAuth2 para computador. Pule esta etapa se você já tiver um cliente OAuth2 para computador que queira usar com a API Data Manager.

Se você clicar em Criar cliente OAuth2, selecione App para computador quando solicitado a Configurar seu cliente OAuth para poder usar o cliente nas etapas restantes.

Criar cliente OAuth2
Na última etapa, clique em FAZER O DOWNLOAD DA CONFIGURAÇÃO DO CLIENTE e anote o local de download escolhido.

Gere um arquivo ADC local executando o seguinte comando. Esse comando inicia um fluxo da Web em que você precisa fazer login na Conta do Google que está usando com a API.

Substitua PATH_TO_CLIENT_JSON pelo nome do arquivo JSON que você baixou.

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Se você quiser usar as mesmas credenciais para a API Data Manager e a API Google Ads, inclua o escopo da API Google Ads na lista --scopes:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Se você quiser usar as mesmas credenciais para a API Data Manager e a API Display & Video 360, inclua o escopo da API Display & Video 360 na lista --scopes:

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

Confirme se as credenciais estão configuradas corretamente usando o seguinte comando. Se a operação for bem-sucedida, o comando vai imprimir um token de acesso no console.
```
gcloud auth application-default print-access-token
```

Para saber mais sobre autenticação e credenciais do seu app, consulte Métodos de autenticação no Google e Como as credenciais padrão do aplicativo funcionam.

Configurar o acesso à conta

Conceda ao e-mail associado à sua conta de usuário acesso ao Destination.

Se você estiver usando uma conta do Google Ads, siga as instruções para adicionar o e-mail do usuário à conta do Google Ads ou a uma conta de administrador principal do Google Ads.
Se você estiver usando uma conta do Display & Video 360, siga as instruções para adicionar o e-mail do usuário à conta.
Se você estiver usando uma propriedade do Google Analytics, siga as instruções para adicionar o e-mail do usuário à conta.

Próximas etapas

Instale uma biblioteca de cliente e execute exemplos de código para testar sua primeira solicitação da API Data Manager.

Avançar

Instalar uma biblioteca de cliente