Escolher escopos da API Google Calendar

Este documento contém informações específicas sobre autorização e autenticação da API Google Calendar. 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 Calendar

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.

Se o aplicativo público usar escopos que permitem o acesso a determinados dados do usuário, ele precisará concluir um processo de verificação. Se você vir app não verificado na tela ao testar o aplicativo, envie uma solicitação de verificação para remover essa mensagem. Saiba mais sobre apps não verificados e encontre respostas para perguntas frequentes sobre a verificação de apps na Central de Ajuda.

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

Escopo	Significado
https://www.googleapis.com/auth/calendar	Ver, editar, compartilhar e excluir permanentemente todas as agendas a que você tem acesso pelo Google Agenda.
https://www.googleapis.com/auth/calendar.readonly	Ver e baixar qualquer agenda que você acesse pelo Google Agenda.
https://www.googleapis.com/auth/calendar.freebusy	Confira sua disponibilidade nas suas agendas.
https://www.googleapis.com/auth/calendar.events	Ver e editar eventos em todas as suas agendas.
https://www.googleapis.com/auth/calendar.events.readonly	Ver eventos em todas as suas agendas.
https://www.googleapis.com/auth/calendar.settings.readonly	Confira as configurações do Google Agenda.
https://www.googleapis.com/auth/calendar.addons.execute	Executar como um complemento do Agenda.
https://www.googleapis.com/auth/calendar.addons.current.event.read	Ver os eventos que você abriu no Google Agenda.
https://www.googleapis.com/auth/calendar.addons.current.event.write	Edite os eventos que você abrir no Google Agenda.
https://www.googleapis.com/auth/calendar.events.owned	Ver, criar, mudar e excluir eventos nas suas agendas do Google.
https://www.googleapis.com/auth/calendar.events.owned.readonly	Ver os eventos nas suas agendas do Google.
https://www.googleapis.com/auth/calendar.events.freebusy	Ver a disponibilidade nas agendas do Google a que você tem acesso.
https://www.googleapis.com/auth/calendar.app.created	Gerar agendas secundárias do Google e ver, criar, alterar e excluir eventos nelas.
https://www.googleapis.com/auth/calendar.calendarlist	Ver, adicionar e remover agendas do Google em que você se inscreveu.
https://www.googleapis.com/auth/calendar.calendarlist.readonly	Confira a lista de agendas do Google em que você se inscreveu.
https://www.googleapis.com/auth/calendar.calendars	Ver e mudar as propriedades de agendas do Google a que você tem acesso, além de criar agendas secundárias.
https://www.googleapis.com/auth/calendar.calendars.readonly	Ver o título, a descrição, o fuso horário padrão e outras propriedades das agendas do Google a que você tem acesso.
https://www.googleapis.com/auth/calendar.acls	Ver e mudar as permissões de compartilhamento das suas agendas do Google.
https://www.googleapis.com/auth/calendar.acls.readonly	Ver as permissões de compartilhamento das suas agendas do Google.
https://www.googleapis.com/auth/calendar.events.public.readonly	Ver os eventos em agendas públicas.