Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Events: instances

Muestra instancias del evento recurrente especificado. Pruébalo ahora.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

Parámetros

Nombre del parámetro	Valor	Descripción
Parámetros de ruta
`calendarId`	`string`	Identificador del calendario. Para recuperar los IDs del calendario, llama al método calendarList.list. Si quieres acceder al calendario principal del usuario que accedió actualmente, usa la palabra clave "`primary`".
`eventId`	`string`	Identificador del evento recurrente.
Parámetros de consulta opcionales
`alwaysIncludeEmail`	`boolean`	Dejó de estar disponible y se ignora. Siempre se mostrará un valor en el campo `email` para el organizador, el creador y los asistentes, incluso si no hay una dirección de correo electrónico real disponible (es decir, se proporcionará un valor generado que no funciona).
`maxAttendees`	`integer`	La cantidad máxima de asistentes que se incluirán en la respuesta. Si hay más asistentes que la cantidad especificada, solo se muestra el participante. Es opcional.
`maxResults`	`integer`	Cantidad máxima de eventos que se muestran en una página de resultados. De forma predeterminada, el valor es de 250 eventos. El tamaño de la página nunca puede ser superior a 2,500 eventos. Es opcional.
`originalStart`	`string`	La hora de inicio original de la instancia en el resultado. Es opcional.
`pageToken`	`string`	Token que especifica qué página de resultados se debe mostrar. Es opcional.
`showDeleted`	`boolean`	Indica si se deben incluir los eventos borrados (con `status` igual a "`cancelled`") en el resultado. Las instancias canceladas de eventos recurrentes se incluirán si `singleEvents` es False. Es opcional. El valor predeterminado es False.
`timeMax`	`datetime`	Límite superior (exclusivo) para la hora de inicio de un evento por la que se debe filtrar. Es opcional. La acción predeterminada es no filtrar por hora de inicio. Debe ser una marca de tiempo RFC3339 con un desplazamiento de zona horaria obligatorio.
`timeMin`	`datetime`	Límite inferior (inclusivo) para la hora de finalización de un evento por la que se debe filtrar. Es opcional. La acción predeterminada es no filtrar por hora de finalización. Debe ser una marca de tiempo RFC3339 con un desplazamiento de zona horaria obligatorio.
`timeZone`	`string`	Zona horaria que se usa en la respuesta. Es opcional. La acción predeterminada es la zona horaria del calendario.

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`
`https://www.googleapis.com/auth/calendar.app.created`
`https://www.googleapis.com/auth/calendar.events.freebusy`
`https://www.googleapis.com/auth/calendar.events.owned`
`https://www.googleapis.com/auth/calendar.events.owned.readonly`
`https://www.googleapis.com/auth/calendar.events.public.readonly`

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`	Tipo de la colección ("`calendar#events`").
`etag`	`etag`	ETag de la colección.
`summary`	`string`	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 para este calendario. Solo lectura. Estos son los posibles valores: "`none`": El usuario no tiene acceso. "`freeBusyReader`": El usuario tiene acceso de lectura a la información de disponibilidad. "`reader`": El usuario tiene acceso de lectura al calendario. Los eventos privados aparecerán para los usuarios con acceso de lector, pero los detalles del evento estarán ocultos. "`writerWithoutPrivateAccess`": El usuario tiene acceso de lectura y escritura al calendario. Los eventos privados aparecerán para los usuarios con acceso de writerWithoutPrivateAccess, pero los detalles del evento estarán ocultos. "`writer`": El usuario tiene acceso de lectura y escritura al calendario. Los eventos privados aparecerán para los usuarios con acceso de escritor, y los detalles del evento estarán visibles. "`owner`": El usuario tiene acceso de administrador al calendario. Este rol tiene todos los permisos del rol de escritor con la capacidad adicional de ver y modificar los niveles de acceso de otros usuarios. Importante: El rol `owner` es diferente del propietario de los datos del calendario. Un calendario tiene un solo propietario de datos, pero puede tener varios usuarios con el rol `owner`.
`defaultReminders[]`	`list`	Los recordatorios predeterminados en el calendario para el usuario autenticado. Estos recordatorios se aplican a todos los eventos de este calendario que no los anulan de forma explícita (es decir, no tienen `reminders.useDefault` establecido en True).
`defaultReminders[].method`	`string`	El método que usa este recordatorio. Estos son los posibles valores: "`email`": Los recordatorios se envían por correo electrónico. "`popup`": Los recordatorios se envían a través de una ventana emergente de la IU. Es obligatorio cuando se agrega un recordatorio.	admite escritura
`defaultReminders[].minutes`	`integer`	Cantidad de minutos antes del inicio del evento en que se debe activar el recordatorio. Los valores válidos están entre 0 y 40320 (4 semanas en minutos). Es obligatorio cuando se agrega un recordatorio.	admite escritura
`nextPageToken`	`string`	Token que se usa para acceder a la siguiente página de este resultado. Se omite si no hay más resultados disponibles, en cuyo caso se proporciona `nextSyncToken`.
`items[]`	`list`	Lista de eventos en el calendario.
`nextSyncToken`	`string`	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 cuyo caso se proporciona `nextPageToken`.

Pruébalo

Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos reales y ver la respuesta.