En este documento, se incluye información de autorización y autenticación específica de la API del Calendario 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 Más 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 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 Calendario
Para definir el nivel de acceso otorgado a tu app, debes identificar y declarar los alcances de autorización. Un alcance 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 los datos de Google Workspace, incluidos los datos de las Cuentas de Google de los usuarios.
Cuando se instala tu app, se le solicita al usuario que valide los permisos que esta usa. 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 con mayor facilidad a permisos limitados y descritos con claridad.
La API de Calendario admite los siguientes permisos de acceso:
| Alcance | Significado |
|---|---|
https://www.googleapis.com/auth/calendar |
Consultar, editar, compartir y borrar permanentemente todos los calendarios a los que puedes acceder con el Calendario de Google |
https://www.googleapis.com/auth/calendar.readonly |
Consultar y descargar cualquier calendario al que tengas acceso con tu Calendario |
https://www.googleapis.com/auth/calendar.freebusy |
Consulta tu disponibilidad en tus calendarios. |
https://www.googleapis.com/auth/calendar.events |
Consulta y edita 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 |
Consulta la configuración de tu Calendario. |
https://www.googleapis.com/auth/calendar.addons.execute |
Ejecutar como complemento de Calendario |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
Consulta los eventos que abriste en el Calendario de Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Edita 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 tienes 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 |
Consulta la lista de calendarios de Google a los que te suscribiste. |
https://www.googleapis.com/auth/calendar.calendars |
Consultar y modificar las propiedades de los calendarios de Google a los que tienes 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 tienes 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 |