Como autenticar chamadas de API

Neste exemplo, mostramos como as contas de serviço podem ser usadas para chamar a API AdSense Platforms para criar e gerenciar subcontas.

Etapa 1: criar um novo projeto do Google Cloud (ou usar um atual)

Se você já tiver um projeto do Google Cloud, fique à vontade para usá-lo. Caso contrário, siga o guia abaixo sobre como configurar um novo projeto:

https://cloud.google.com/resource-manager/docs/creating-managing-projects

Etapa 2: criar uma conta de serviço

Usar contas de serviço é a melhor maneira de criar subcontas. Siga estas etapas para criar sua conta de serviço:

  • acessar a página de contas de serviço no Google Cloud;
  • É possível usar uma conta de serviço atual ou criar uma nova:
    • Clique em "+ Criar conta de serviço".
    • Preencha o formulário "Detalhes da conta de serviço".
    • As etapas 2 e 3 da página (que concede acesso a projetos e usuários) são opcionais

Saiba mais sobre como criar e gerenciar contas de serviço.

Depois que a conta de serviço for criada, você precisará enviá-la ao Google para que ela seja adicionada à sua conta do Google AdSense. Isso é essencial, porque a conta de serviço precisa ter permissão para acessar sua conta do Google AdSense. Informe isso por meio do gerente da sua conta.

Etapa 3: ativar a API AdSense Platform para seu projeto do Google Cloud

A API AdSense Platform não é detectável. Isso significa que você precisa acessar o link a seguir para ativá-la no seu projeto:

https://console.developers.google.com/apis/api/adsenseplatform.googleapis.com/overview

Etapa 4: criar uma chave de serviço

Para gerar tokens de acesso para usar nas chamadas de API, você precisa criar uma chave de serviço. Siga estas etapas:

  • acessar a página de contas de serviço no Google Cloud;
  • Na coluna de ações, clique em para a conta de serviço que você quer usar para criar subcontas e, depois, em "Gerenciar chaves".
  • Clique em "Adicionar chave" e selecione "Criar nova chave".
  • Mantenha o JSON selecionado como o tipo de chave e clique em "Criar"
  • Um arquivo JSON será criado e transferido por download para o seu computador. Mantenha este código em segurança, já que ele é necessário para autenticar as chamadas de API

Saiba mais sobre como criar e gerenciar chaves de contas de serviço.

Etapa 5: usar as bibliotecas OAuth do Google para gerar um token de acesso

O Google fornece bibliotecas para ajudar a gerar tokens de acesso, que podem ser usados para fazer chamadas de API. Saiba como gerar credenciais para contas de serviço aqui:

https://developers.google.com/identity/protocols/oauth2/service-account#authorizingrequests

O escopo da API AdSense Platforms é o seguinte: https://www.googleapis.com/auth/adsense

Exemplo do Python

from google.auth.transport import requests
from google.oauth2 import service_account

CREDENTIAL_SCOPES = ["https://www.googleapis.com/auth/adsense"]
CREDENTIALS_KEY_PATH = 'service.json'

def get_service_account_token():
  credentials = service_account.Credentials.from_service_account_file(
          CREDENTIALS_KEY_PATH, scopes=CREDENTIAL_SCOPES)
  credentials.refresh(requests.Request())
  return credentials.token

Agora, você já pode começar a chamar as APIs. Como as bibliotecas de cliente ainda não são compatíveis com a API AdSense Platform, é necessário fazer solicitações HTTP diretas. O token de acesso deve ser incluído como cabeçalho na solicitação HTTP. O cabeçalho deve ficar assim:

Authorization: OAuth <credentials>

Os exemplos estão incluídos nas páginas da API.