Esta referencia de API se organiza por tipo de recurso. Cada tipo de recurso tiene una o más representaciones de datos y uno o más métodos.
Tipos de recursos
LCA
Para obtener detalles sobre los recursos LCA, consulta la página Representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| borrar |
DELETE /calendars/calendarId/acl/ruleId
|
Borra una regla de control de acceso. |
| obtener |
GET /calendars/calendarId/acl/ruleId
|
Muestra una regla de control de acceso. |
| insertar |
POST /calendars/calendarId/acl
|
Crea una regla de control de acceso. |
| list |
GET /calendars/calendarId/acl
|
Muestra las reglas de la lista de control de acceso del calendario. |
| parche |
PATCH /calendars/calendarId/acl/ruleId
|
Actualiza una regla de control de acceso. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Es preferible usar un get seguido de un update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud permanecerán sin cambios. Los campos de matriz, si se especifican, reemplazan los arreglos existentes; esto descarta cualquier elemento de arreglo anterior.
|
| actualizar |
PUT /calendars/calendarId/acl/ruleId
|
Actualiza una regla de control de acceso. |
| reloj |
POST /calendars/calendarId/acl/watch
|
Observa si hay cambios en los recursos de LCA. |
Lista de calendarios
Para obtener detalles sobre los recursos de CalendarList, consulta la página Representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| borrar |
DELETE /users/me/calendarList/calendarId
|
Quita un calendario de la lista de calendarios del usuario. |
| obtener |
GET /users/me/calendarList/calendarId
|
Muestra un calendario de la lista de calendarios del usuario. |
| insertar |
POST /users/me/calendarList
|
Inserta un calendario existente en la lista de calendarios del usuario. |
| list |
GET /users/me/calendarList
|
Muestra los calendarios en la lista de calendarios del usuario. |
| parche |
PATCH /users/me/calendarList/calendarId
|
Actualiza un calendario existente en la lista de calendarios del usuario. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Es preferible usar un get seguido de un update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud permanecerán sin cambios. Los campos de matriz, si se especifican, reemplazan los arreglos existentes; esto descarta cualquier elemento de arreglo anterior.
|
| actualizar |
PUT /users/me/calendarList/calendarId
|
Actualiza un calendario existente en la lista de calendarios del usuario. |
| reloj |
POST /users/me/calendarList/watch
|
Presta atención a los cambios en los recursos de CalendarList. |
Calendarios
Para obtener detalles sobre los recursos de calendario, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| sencillo |
POST /calendars/calendarId/clear
|
Borra un calendario principal. Esta operación borra todos los eventos asociados con el calendario principal de una cuenta. |
| borrar |
DELETE /calendars/calendarId
|
Borra un calendario secundario. Usa calendar.clear para borrar todos los eventos de los calendarios principales. |
| obtener |
GET /calendars/calendarId
|
Muestra los metadatos de un calendario. |
| insertar |
POST /calendars
|
Crea un calendario secundario. |
| parche |
PATCH /calendars/calendarId
|
Actualiza los metadatos de un calendario. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Es preferible usar un get seguido de un update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud permanecerán sin cambios. Los campos de matriz, si se especifican, reemplazan los arreglos existentes; esto descarta cualquier elemento de arreglo anterior.
|
| actualizar |
PUT /calendars/calendarId
|
Actualiza los metadatos de un calendario. |
Canales
Para obtener detalles sobre los recursos de canales, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| detener |
POST /channels/stop
|
Deja de mirar recursos a través de este canal. |
Colores
Para obtener información detallada sobre los recursos de colores, consulta la página Representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| obtener |
GET /colors
|
Muestra las definiciones de color para calendarios y eventos. |
Eventos
Para obtener detalles sobre el recurso de eventos, consulta la página Representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| borrar |
DELETE /calendars/calendarId/events/eventId
|
Borra un evento. |
| obtener |
GET /calendars/calendarId/events/eventId
|
Muestra un evento en función de su ID de Calendario de Google. Para recuperar un evento con el ID de iCalendar, llama al método events.list mediante el parámetro iCalUID.
|
| importar |
POST /calendars/calendarId/events/import
|
Importa un evento. Esta operación se usa para agregar una copia privada de un evento existente a un calendario. |
| insertar |
POST /calendars/calendarId/events
|
Crea un evento. |
| instancias |
GET /calendars/calendarId/events/eventId/instances
|
Muestra instancias del evento recurrente especificado. |
| list |
GET /calendars/calendarId/events
|
Muestra los eventos del calendario especificado. |
| mover |
POST /calendars/calendarId/events/eventId/move
|
Mueve un evento a otro calendario, es decir, cambia el organizador de un evento.
Parámetros de consulta obligatorios:
|
| parche |
PATCH /calendars/calendarId/events/eventId
|
Actualiza un evento. Este método es compatible con la semántica de parches. Ten en cuenta que cada solicitud de parche consume tres unidades de cuota. Es preferible usar un get seguido de un update. Los valores de campo que especifiques reemplazarán los valores existentes. Los campos que no especifiques en la solicitud permanecerán sin cambios. Los campos de matriz, si se especifican, reemplazan los arreglos existentes; esto descarta cualquier elemento de arreglo anterior.
|
| QuickAdd |
POST /calendars/calendarId/events/quickAdd
|
Crea un evento basado en una cadena de texto simple.
Parámetros de consulta obligatorios:
|
| actualizar |
PUT /calendars/calendarId/events/eventId
|
Actualiza un evento. Este método no admite semántica de parches y siempre actualiza todo el recurso de evento. Para realizar una actualización parcial, realiza una get seguida de una update mediante ETags a fin de garantizar la atomicidad.
|
| reloj |
POST /calendars/calendarId/events/watch
|
Presta atención a los cambios en los recursos de Eventos. |
Disponible
Para obtener información sobre el recurso Freebusy, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| query |
POST /freeBusy
|
Muestra información de disponible/ocupado de un conjunto de calendarios. |
Configuración
Para obtener detalles sobre los recursos de configuración, consulta la página de representación de recursos.
| Método | Solicitud HTTP | Descripción |
|---|---|---|
| URI relativos a https://www.googleapis.com/calendar/v3, a menos que se indique lo contrario | ||
| obtener |
GET /users/me/settings/setting
|
Muestra una configuración de usuario único. |
| list |
GET /users/me/settings
|
Muestra todas las opciones de configuración del usuario autenticado. |
| reloj |
POST /users/me/settings/watch
|
Presta atención a los cambios en los recursos de Configuración. |