Como autenticar chamadas de API

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

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

Se você já tiver um projeto do Google Cloud, fique à vontade para usá-lo. Caso contrário, siga o guia abaixo para 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:

  • Acesse 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 os "Detalhes da conta de serviço". formam
    • As etapas 2 e 3 na página (como conceder 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, já que a conta de serviço precisa ter permissão para acessar sua conta do Google AdSense. Informe isso por meio do seu gerente de contas.

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 seguinte link 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 uso nas chamadas de API, é necessário criar uma chave de serviço. Siga estas etapas:

  • Acesse a página de contas de serviço no Google Cloud.
  • Na coluna de ações da conta de serviço que você quer usar para criar subcontas, clique em e em "Gerenciar chaves".
  • Clique em "Adicionar chave" e selecione "Criar nova chave".
  • Mantenha JSON selecionado como o tipo de chave e clique em "Criar".
  • Um arquivo JSON será criado e baixado para seu computador. Mantenha a segurança porque ela será necessária 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

Nesta fase, está tudo pronto para você começar a chamar as APIs. Como as bibliotecas de clientes ainda não são compatíveis com a API da plataforma do Google AdSense, é 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 ser semelhante a este:

Authorization: OAuth <credentials>

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