Este documento contém informações de autorização e autenticação específicas da API Google Agenda. 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, além de registrar seu 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 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, um usuário precisa validar os escopos usados por ele. Em geral, escolha o escopo mais restrito 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.
A API Calendar oferece suporte aos 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ê acessa pelo Google Agenda. |
https://www.googleapis.com/auth/calendar.freebusy |
Ver 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 |
Ver suas configurações do 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 |
Editar os eventos que você abriu no Google Agenda. |
https://www.googleapis.com/auth/calendar.events.owned |
Ver, criar, alterar 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ê está inscrito. |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
Ver 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, descrição, fuso horário padrão e outras propriedades de 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. |