Autorização

A API Checks usa o OAuth 2.0 para autorizar solicitações.

O escopo do OAuth é https://www.googleapis.com/auth/checks.

Autorizar com o OAuth 2.0

Este guia de início rápido mostra como autorizar solicitações com uma conta de serviço usando a CLI gcloud.

Configurar a CLI gcloud

  1. Instale a CLI gcloud.

  2. Faça login com a CLI gcloud e defina um projeto padrão:

    gcloud auth login
gcloud config set project PROJECT_ID

  3. Crie uma conta de serviço e uma chave de conta de serviço e configure as Application Default Credentials:

    gcloud iam service-accounts create SA_NAME
gcloud iam service-accounts keys create key.json \
    --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com
export GOOGLE_APPLICATION_CREDENTIALS=key.json

Conceder acesso à API à sua conta do Checks

Os chamadores de API precisam ser usuários da sua conta do Checks e ter as permissões de leitura ou gravação adequadas.

  1. Acesse a página Configurações no console de verificações e clique em Gerenciar usuários.

  2. Convide a conta de serviço que você criou:

    SA_NAME@PROJECT_ID.iam.gserviceaccount.com

Localizar o ID da conta

O ID da sua conta do Checks é o ID do recurso para solicitações de recursos da conta.

Por exemplo, o método accounts.apps.list, que lista seus apps, tem o seguinte formato:

https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps

Você encontra o ID da conta na página Configurações, na seção Informações da conta do console de verificações.

Receber um token de acesso

gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks

Fazer uma solicitação

curl -X GET \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks)" \
    "https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps"