Este documento contiene información específica de la API del Calendario de Google sobre la autorización y la autenticación. Antes de leer este documento, asegúrate de leer la información general sobre la autenticación y la 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 Calendar
Para definir el nivel de acceso que se otorga 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 datos de Google Workspace, incluidos los datos de las Cuentas de Google de los usuarios.
Cuando se instala tu app, se le pide al usuario que valide los alcances que usa la app. Por lo general, debes elegir el alcance más específico posible y evitar solicitar alcances que tu app no necesite. Los usuarios otorgan acceso más fácilmente a los permisos limitados y claramente descritos.
La API de Calendar admite los siguientes alcances:
Alcance | Significado |
---|---|
https://www.googleapis.com/auth/calendar |
Consultar, editar, compartir y borrar permanentemente todos los calendarios a los que puedes acceder a través del Calendario de Google |
https://www.googleapis.com/auth/calendar.readonly |
Consultar y descargar cualquier calendario al que puedas acceder con tu Calendario |
https://www.googleapis.com/auth/calendar.freebusy |
Consulta 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 |
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 ingresaste en el Calendario de Google. |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Editar los eventos que ingresaste 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 |
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 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 sea el propietario |
https://www.googleapis.com/auth/calendar.events.public.readonly |
Consultar los eventos en calendarios públicos |