Este documento contiene información de autorización y autenticación específica de la API de Calendar de Google. Antes de leer este documento, asegúrate de leer la información general de autenticación y autorización de Google Workspace en Obtén información sobre la autenticación y la autorización.
Configura OAuth 2.0 para la autorización
Configura la pantalla de consentimiento de OAuth y elige los permisos para definir qué información se muestra a los usuarios y revisores de apps, y registra tu app para que puedas publicarla más adelante.
Permisos de la API de Calendar
Para definir el nivel de acceso otorgado a tu app, debes identificar y declarar permisos de autorización. Un permiso de autorización es una cadena de URI de OAuth 2.0 que contiene el nombre de la app de Google Workspace, el tipo de datos a los que accede y el nivel de acceso. Los permisos son las solicitudes de tu app para trabajar con datos de Google Workspace, incluidos los datos de la Cuenta de Google de los usuarios.
Cuando se instala tu app, se le pide al usuario que valide los permisos que usa la app. Por lo general, debes elegir el permiso más específico posible y evitar solicitar permisos que tu app no requiera. Los usuarios otorgan acceso más fácilmente a los permisos limitados y claramente descritos.
La API de Calendar admite los siguientes permisos:
| Alcance | Significado |
|---|---|
https://www.googleapis.com/auth/calendar |
Consultar, editar, compartir y borrar permanentemente todos los calendarios a los que puedes acceder mediante el Calendario de Google |
https://www.googleapis.com/auth/calendar.readonly |
Consultar y descargar cualquier calendario al que usted tenga acceso a través de su Calendario |
https://www.googleapis.com/auth/calendar.freebusy |
Consultar tu disponibilidad en tus calendarios |
https://www.googleapis.com/auth/calendar.events |
Consultar y editar eventos en todos tus calendarios |
https://www.googleapis.com/auth/calendar.events.readonly |
Consultar eventos en todos tus calendarios |
https://www.googleapis.com/auth/calendar.settings.readonly |
Consultar la configuración de tu Calendario |
https://www.googleapis.com/auth/calendar.addons.execute |
Ejecutar como un complemento de Calendario |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
Consultar los eventos que abres en el Calendario de Google |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Editar los eventos que abres en el Calendario de Google |
https://www.googleapis.com/auth/calendar.events.owned |
Consultar, crear, modificar y borrar eventos en los calendarios de Google de los que sea el propietario |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
Consultar los eventos de los calendarios de Google de los que sea el propietario |
https://www.googleapis.com/auth/calendar.events.freebusy |
Consultar la disponibilidad en los calendarios de Google a los que tiene acceso |
https://www.googleapis.com/auth/calendar.app.created |
Crear calendarios de Google secundarios, y consultar, crear, modificar y borrar eventos en ellos |
https://www.googleapis.com/auth/calendar.calendarlist |
Consultar, agregar y quitar calendarios de Google a los que te suscribiste |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
Consultar la lista de calendarios de Google a los que está suscrito |
https://www.googleapis.com/auth/calendar.calendars |
Consultar y modificar las propiedades de los calendarios de Google a los que tiene acceso, y crear calendarios secundarios |
https://www.googleapis.com/auth/calendar.calendars.readonly |
Consultar el título, la descripción, la zona horaria predeterminada y otras propiedades de los calendarios de Google a los que tiene acceso |
https://www.googleapis.com/auth/calendar.acls |
Consultar y modificar los permisos de uso compartido de los calendarios de Google de los que sea el propietario |
https://www.googleapis.com/auth/calendar.acls.readonly |
Consultar los permisos de uso compartido de los calendarios de Google de los que es el propietario |
https://www.googleapis.com/auth/calendar.events.public.readonly |
Consultar los eventos en calendarios públicos |