Este documento contém informações de autorização e autenticação específicas da API Google Calendar. 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
Configurar a tela de consentimento do OAuth e escolher escopos para definir quais informações são exibidas para usuários e revisores de apps e registrar seu app para poder publicá-lo mais tarde.
Escopos da API Calendar
Para definir o nível de acesso concedido ao app, é necessário identificar e declarar os escopos de autorização. Um escopo de autorização é uma string de URI OAuth 2.0 que contém o nome do app do Google Workspace, o tipo de dados acessado e o nível de acesso. Os escopos são as 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. Geralmente, escolha o escopo mais focado possível e evite solicitar escopos que o app não exige. Os usuários concedem acesso mais fácil a escopos limitados e claramente descritos.
A API Calendar oferece suporte aos seguintes escopos:
| Escopo | Significado |
|---|---|
https://www.googleapis.com/auth/calendar |
Acessar, editar, compartilhar e excluir permanentemente todas as agendas a que você tem acesso pelo Google Agenda. |
https://www.googleapis.com/auth/calendar.readonly |
Acesse e faça o download de qualquer agenda que você possa acessar pelo Google Agenda. |
https://www.googleapis.com/auth/calendar.freebusy |
Confira sua disponibilidade nas suas agendas. |
https://www.googleapis.com/auth/calendar.events |
Acessar e editar eventos em todas as suas agendas. |
https://www.googleapis.com/auth/calendar.events.readonly |
Acessar eventos em todas as suas agendas. |
https://www.googleapis.com/auth/calendar.settings.readonly |
Acesse as 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 |
Acessar 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 |
Acessar, criar, alterar e excluir eventos nas suas agendas do Google. |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
Acessar os eventos nas suas agendas do Google. |
https://www.googleapis.com/auth/calendar.events.freebusy |
Confira a disponibilidade nas agendas do Google a que você tem acesso. |
https://www.googleapis.com/auth/calendar.app.created |
Crie agendas secundárias do Google e acesse, crie, altere e exclua eventos nelas. |
https://www.googleapis.com/auth/calendar.calendarlist |
Acessar, 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 |
Confira as permissões de compartilhamento das suas agendas do Google. |
https://www.googleapis.com/auth/calendar.events.public.readonly |
Acessar os eventos em agendas públicas. |