Escolher os escopos da API Reports

Este documento contém informações específicas sobre autorização e autenticação da API do Centro de alertas. Antes de ler este documento, confira as informações gerais de autenticação e autorização do Google Workspace em Saiba mais sobre autenticação e autorização.

Configurar o OAuth 2.0 para autorização

Configure a tela de consentimento do OAuth e escolha escopos para definir quais informações são mostradas aos usuários e revisores de apps e registre o app para poder publicá-lo mais tarde.

Escopos da API Reports

Para definir o nível de acesso concedido ao seu app, é necessário identificar e declarar escopos de autorização. Um escopo de autorização é uma string URI do OAuth 2.0 que contém o nome do app do Google Workspace, o tipo de dados acessados e o nível de acesso. Os escopos são solicitações do app para trabalhar com dados do Google Workspace, incluindo dados da Conta do Google dos usuários.

Quando o app é instalado, o usuário precisa validar os escopos usados por ele. Em geral, escolha o escopo mais restrito possível e evite solicitar escopos que o app não precisa. Os usuários concedem acesso mais facilmente a escopos limitados e claramente descritos.

A API Reports é compatível com os seguintes escopos:

Escopos Significado
https://www.googleapis.com/auth/admin.reports.audit.readonly Ver relatórios de auditoria sobre seu domínio do Google Workspace
https://www.googleapis.com/auth/admin.reports.usage.readonly Ver relatórios de uso do seu domínio do Google Workspace