Escolher escopos da API Google Slides

Este documento contém informações de autorização e autenticação específicas da API Google Slides. Antes de ler este documento, leia 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 permissão OAuth e escolha escopos para definir quais informações são mostradas aos usuários e revisores de apps. Registre seu app para poder publicá-lo mais tarde.

Escopos da API Slides

Para definir o nível de acesso concedido ao seu app, identifique e declare escopos de autorização. Um escopo de autorização é uma string de URI do OAuth 2.0 que contém o nome do app do Google Workspace, o tipo de dados que ele acessa e o nível de acesso. Os escopos são solicitações do seu 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 específico possível e evite solicitar escopos que seu app não exige. Os usuários concedem acesso mais facilmente a escopos limitados e claramente descritos.

Quando possível, recomendamos o uso de escopos não sensíveis, porque eles concedem escopo de acesso por arquivo e restringem o acesso a recursos específicos necessários para um app.

A API Slides oferece suporte aos seguintes escopos:

Código do escopo Descrição Uso
https://www.googleapis.com/auth/presentations Ver, editar, criar e excluir todas as suas apresentações do Google Slides. Sensível
https://www.googleapis.com/auth/presentations.readonly Ver todas as suas apresentações do Google Slides. Sensível
https://www.googleapis.com/auth/spreadsheets Ver, editar, criar e excluir todas as suas planilhas do Google Sheets. Sensível
https://www.googleapis.com/auth/spreadsheets.readonly Ver todas as suas planilhas do Google Sheets. Sensível
https://www.googleapis.com/auth/drive.file Ver, editar, criar e excluir somente os arquivos do Google Drive que você usa com este app. Recomendado
Não sensível
https://www.googleapis.com/auth/drive Ver, editar, criar e excluir todos os seus arquivos do Google Drive. Restrito
https://www.googleapis.com/auth/drive.readonly Ver e baixar todos os seus arquivos do Google Drive. Restrito

A coluna "Uso" na tabela indica a sensibilidade de cada escopo, de acordo com as seguintes definições:

  • Não sensível: esses escopos fornecem o menor escopo de acesso de autorização e exigem apenas a verificação de apps básica. Para mais informações sobre esse requisito, consulte Enviar seu app para verificação.

  • Sensível: esses escopos fornecem acesso a dados específicos do usuário do Google autorizados pelo usuário para seu app. É necessário passar por uma verificação adicional de apps. Para mais informações sobre esse requisito, consulte Requisitos de escopo sensível e restrito.

  • Restrito: esses escopos fornecem acesso amplo aos dados do usuário do Google e exigem que você passe por um processo de verificação de escopo restrito. Para mais informações sobre esse requisito, consulte Política de dados do usuário dos serviços da API do Google e Requisitos adicionais dos escopos específicos da API. Se você armazena dados de escopo restrito em servidores (ou transmite), é necessário passar por uma avaliação de segurança.

Se o app precisar de acesso a outras APIs do Google, você também poderá adicionar esses escopos. Para mais informações sobre os escopos da API do Google, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Para mais informações sobre escopos específicos do OAuth 2.0, consulte Escopos do OAuth 2.0 para APIs do Google.