Muestra los eventos del calendario especificado. Pruébalo ahora y ve un ejemplo.
Solicitud
Solicitud HTTP
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
calendarId |
string |
Es el identificador de calendario. Para recuperar los ID del calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió, usa "primary " palabra clave.
|
Parámetros de consulta opcionales | ||
alwaysIncludeEmail |
boolean |
Se ignoró y dejó de estar disponible. |
eventTypes |
string |
Tipos de eventos que se mostrarán. Opcional. Este parámetro se puede repetir varias veces para mostrar eventos de diferentes tipos. Si no se establece, muestra todos los tipos de eventos.
Los valores aceptables son los siguientes:
|
iCalUID |
string |
Especifica un ID de evento en el formato iCalendario que se proporcionará en la respuesta. Opcional. Úsalo si deseas buscar un evento por su ID de iCalendario. |
maxAttendees |
integer |
Es la cantidad máxima de asistentes que se deben incluir en la respuesta. Si el número de asistentes supera la cantidad especificada, solo se devuelve el participante. Opcional. |
maxResults |
integer |
Cantidad máxima de eventos mostrados en una página de resultados. Es posible que la cantidad de eventos de la página resultante sea menor que este valor o ninguno, incluso si hay más eventos que coinciden con la búsqueda. Las páginas incompletas se pueden detectar a través de un campo nextPageToken que no está vacío en la respuesta. De forma predeterminada, el valor es de 250 eventos. El tamaño de la página nunca puede superar los 2,500 eventos. Opcional.
|
orderBy |
string |
Es el orden de los eventos que se muestran en el resultado. Opcional. El valor predeterminado es un orden estable no especificado.
Los valores aceptables son los siguientes:
|
pageToken |
string |
Token que especifica qué página de resultados se debe mostrar. Opcional. |
privateExtendedProperty |
string |
Se especificó una restricción de propiedades extendidas como propertyName=value. Coincide solo con propiedades privadas. Este parámetro puede repetirse varias veces para mostrar eventos que coincidan con todas las restricciones determinadas. |
q |
string |
Términos de búsqueda de texto libre para encontrar eventos que coincidan con esos términos en los siguientes campos:
Estos términos de búsqueda también hacen coincidir las palabras clave predefinidas con todas las traducciones de los títulos visibles de los eventos de ubicación de trabajo, fuera de la oficina y de tiempo dedicado. Por ejemplo, si buscas "Office", o Oficina muestra los eventos de ubicación de trabajo del tipo |
sharedExtendedProperty |
string |
Se especificó una restricción de propiedades extendidas como propertyName=value. Coincide solo con las propiedades compartidas. Este parámetro puede repetirse varias veces para mostrar eventos que coincidan con todas las restricciones determinadas. |
showDeleted |
boolean |
Indica si se deben incluir eventos borrados (con status es igual a "cancelled ") en el resultado. Las instancias canceladas de eventos recurrentes (pero no el evento recurrente subyacente) se incluirán si los valores showDeleted y singleEvents son falsos. Si los valores de showDeleted y singleEvents son verdaderos, solo se muestran instancias únicas de eventos borrados (pero no los eventos recurrentes subyacentes). Opcional. El valor predeterminado es False.
|
showHiddenInvitations |
boolean |
Indica si se deben incluir las invitaciones ocultas en el resultado. Opcional. El valor predeterminado es False. |
singleEvents |
boolean |
Establece si es necesario expandir eventos recurrentes a instancias y mostrar solo eventos únicos e instancias de eventos recurrentes, pero no los eventos recurrentes subyacentes en sí. Opcional. El valor predeterminado es False. |
syncToken |
string |
El token obtenido del campo nextSyncToken se muestra en la última página de resultados de la solicitud de lista anterior. Hace que el resultado de esta solicitud de lista contenga solo las entradas que cambiaron desde entonces. Todos los eventos borrados desde la solicitud de lista anterior siempre estarán en el conjunto de resultados y no se permite establecer showDeleted como falsa. Existen varios parámetros de consulta que no se pueden especificar junto con nextSyncToken para garantizar la coherencia del estado del cliente. Estos son:
syncToken , el servidor responderá con un código de respuesta 410 GONE y el cliente deberá liberar su almacenamiento y realizar una sincronización completa sin ningún syncToken . Obtén más información sobre la sincronización incremental. Opcional. La configuración predeterminada es mostrar todas las entradas. |
timeMax |
datetime |
Es el límite superior (exclusivo) de la hora de inicio de un evento para filtrar. Opcional. La opción predeterminada no es filtrar por hora de inicio. Debe ser una marca de tiempo RFC3339 con un desplazamiento de zona horaria obligatorio, por ejemplo, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Se pueden proporcionar milisegundos, pero se ignoran. Si se establece timeMin , timeMax debe ser mayor que timeMin .
|
timeMin |
datetime |
Es el límite inferior (exclusivo) para la hora de finalización de un evento para filtrar. Opcional. La configuración predeterminada no es filtrar por hora de finalización. Debe ser una marca de tiempo RFC3339 con un desplazamiento de zona horaria obligatorio, por ejemplo, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Se pueden proporcionar milisegundos, pero se ignoran. Si se establece timeMax , timeMin debe ser menor que timeMax .
|
timeZone |
string |
Zona horaria utilizada en la respuesta. Opcional. La zona horaria predeterminada es la del calendario. |
updatedMin |
datetime |
Es el límite inferior de la hora de la última modificación de un evento (como una marca de tiempo RFC3339) para filtrar. Cuando se especifica, las entradas que se borran desde este momento siempre se incluyen sin importar la showDeleted . Opcional. La configuración predeterminada no es filtrar por la hora de la última modificación.
|
Autorización
Esta solicitud permite la autorización con al menos uno de los siguientes alcances:
Alcance |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events.readonly |
https://www.googleapis.com/auth/calendar.events |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{ "kind": "calendar#events", "etag": etag, "summary": string, "description": string, "updated": datetime, "timeZone": string, "accessRole": string, "defaultReminders": [ { "method": string, "minutes": integer } ], "nextPageToken": string, "nextSyncToken": string, "items": [ events Resource ] }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
kind |
string |
Es el tipo de colección ("calendar#events "). |
|
etag |
etag |
ETag de la colección. | |
summary |
string |
Es el título del calendario. Solo lectura. | |
description |
string |
Descripción del calendario. Solo lectura. | |
updated |
datetime |
Hora de la última modificación del calendario (como una marca de tiempo RFC3339). Solo lectura. | |
timeZone |
string |
La zona horaria del calendario. Solo lectura. | |
accessRole |
string |
El rol de acceso del usuario en este calendario. Solo lectura. Los valores posibles son:
|
|
defaultReminders[] |
list |
Los recordatorios predeterminados en el calendario del usuario autenticado. Estos recordatorios se aplican a todos los eventos de este calendario que no los anulan de forma explícita (es decir, no tienes el parámetro reminders.useDefault establecido como verdadero). |
|
defaultReminders[].method |
string |
Indica el método que usa este recordatorio. Los valores posibles son:
Es obligatorio para agregar un recordatorio. |
admite escritura |
defaultReminders[].minutes |
integer |
Cantidad de minutos antes del inicio del evento en los que se debe activar el recordatorio. Los valores válidos están entre 0 y 40,320 (4 semanas en minutos). Es obligatorio para agregar un recordatorio. |
admite escritura |
nextPageToken |
string |
Token utilizado para acceder a la siguiente página de este resultado. Se omite si no hay más resultados disponibles. En ese caso, se proporciona nextSyncToken . |
|
items[] |
list |
Lista de eventos del calendario. | |
nextSyncToken |
string |
Es el token que se usa más adelante para recuperar solo las entradas que cambiaron desde que se mostró este resultado. Se omite si hay más resultados disponibles. En ese caso, se proporciona nextPageToken . |
Ejemplos
Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).
Java
Usa la biblioteca cliente de Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; import com.google.api.services.calendar.model.Events; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over the events in the specified calendar String pageToken = null; do { Events events = service.events().list('primary').setPageToken(pageToken).execute(); List<Event> items = events.getItems(); for (Event event : items) { System.out.println(event.getSummary()); } pageToken = events.getNextPageToken(); } while (pageToken != null);
Python
Utiliza la biblioteca cliente Python.
page_token = None while True: events = service.events().list(calendarId='primary', pageToken=page_token).execute() for event in events['items']: print event['summary'] page_token = events.get('nextPageToken') if not page_token: break
PHP
Utiliza la biblioteca cliente de PHP.
$events = $service->events->listEvents('primary'); while(true) { foreach ($events->getItems() as $event) { echo $event->getSummary(); } $pageToken = $events->getNextPageToken(); if ($pageToken) { $optParams = array('pageToken' => $pageToken); $events = $service->events->listEvents('primary', $optParams); } else { break; } }
Rita
Utiliza la biblioteca cliente de Ruby.
page_token = nil begin result = client.list_events('primary', page_token: page_token) result.items.each do |e| print e.summary + "\n" end if result.next_page_token != page_token page_token = result.next_page_token else page_token = nil end end while !page_token.nil?
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.