Events: instances

Restituisce le istanze dell'evento ricorrente specificato. Prova subito.

Richiesta

Richiesta HTTP

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

Parametri

Nome parametro Valore Descrizione
Parametri del percorso
calendarId string Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Se vuoi accedere al calendario principale dell'utente che ha eseguito l'accesso, utilizza la parola chiave "primary".
eventId string Identificatore dell'evento ricorrente.
Parametri di query facoltativi
alwaysIncludeEmail boolean Ritirata e ignorata. Nel campo email verrà sempre restituito un valore per l'organizzatore, il creator e i partecipanti, anche se non è disponibile un indirizzo email reale (ovvero verrà fornito un valore generato non funzionante).
maxAttendees integer Il numero massimo di partecipanti da includere nella risposta. Se il numero di partecipanti è superiore a quello specificato, viene restituito solo il partecipante. Facoltativo.
maxResults integer Numero massimo di eventi restituiti in una pagina dei risultati. Per impostazione predefinita, il valore è 250 eventi. Le dimensioni della pagina non possono mai essere superiori a 2500 eventi. Facoltativo.
originalStart string L'ora di inizio originale dell'istanza nel risultato. Facoltativo.
pageToken string Token che specifica la pagina dei risultati da restituire. Facoltativo.
showDeleted boolean Indica se includere o meno nel risultato gli eventi eliminati (con status uguale a "cancelled"). Le istanze annullate di eventi ricorrenti verranno comunque incluse se singleEvents è False. Facoltativo. Il valore predefinito è False.
timeMax datetime Soglia superiore (esclusa) per l'ora di inizio di un evento in base alla quale filtrare. Facoltativo. Per impostazione predefinita, non viene applicato alcun filtro in base all'ora di inizio. Deve essere un timestamp RFC3339 con un offset del fuso orario obbligatorio.
timeMin datetime Limite inferiore (incluso) per l'ora di fine di un evento in base al quale applicare il filtro. Facoltativo. Per impostazione predefinita, non viene applicato alcun filtro in base all'ora di fine. Deve essere un timestamp RFC3339 con un offset del fuso orario obbligatorio.
timeZone string Fuso orario utilizzato nella risposta. Facoltativo. Il valore predefinito è il fuso orario del calendario.

Autorizzazione

Questa richiesta consente l'autorizzazione con almeno uno dei seguenti ambiti:

Ambito
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

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Non specificare un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "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
  ]
}
Nome proprietà Valore Descrizione Note
kind string Tipo di raccolta ("calendar#events").
etag etag ETag della raccolta.
summary string Titolo del calendario. Sola lettura.
description string Descrizione del calendario. Sola lettura.
updated datetime Ora dell'ultima modifica del calendario (come timestamp RFC3339). Sola lettura.
timeZone string Il fuso orario del calendario. Sola lettura.
accessRole string Il ruolo di accesso dell'utente per questo calendario. Sola lettura. I valori possibili sono:
  • "none": l'utente non ha accesso.
  • "freeBusyReader": l'utente ha accesso in lettura alle informazioni su stato libero/occupato.
  • "reader": l'utente ha accesso in lettura al calendario. Gli eventi privati verranno visualizzati agli utenti con accesso in qualità di lettore, ma i dettagli degli eventi verranno nascosti.
  • "writer": l'utente ha accesso in lettura e scrittura al calendario. Gli eventi privati verranno visualizzati agli utenti con accesso come autore e i relativi dettagli saranno visibili.
  • "owner": l'utente è il proprietario del calendario. Questo ruolo ha tutte le autorizzazioni del ruolo Scrittore, con la possibilità aggiuntiva di visualizzare e manipolare le ACL.
defaultReminders[] list I promemoria predefiniti nel calendario per l'utente autenticato. Questi promemoria si applicano a tutti gli eventi di questo calendario che non li sostituiscono esplicitamente (ovvero per i quali reminders.useDefault non è impostato su True).
defaultReminders[].method string Il metodo utilizzato da questo promemoria. I valori possibili sono:
  • "email": i promemoria vengono inviati via email.
  • "popup": i promemoria vengono inviati tramite un popup dell'interfaccia utente.

Obbligatorio quando aggiungi un promemoria.

 scrivibile
defaultReminders[].minutes integer Numero di minuti prima dell'inizio dell'evento in cui deve essere attivato il promemoria. I valori validi sono compresi tra 0 e 40320 (4 settimane in minuti).

Obbligatorio quando aggiungi un promemoria.

 scrivibile
nextPageToken string Token utilizzato per accedere alla pagina successiva di questo risultato. Omesso se non sono disponibili altri risultati, nel qual caso viene fornito nextSyncToken.
items[] list Elenco di eventi nel calendario.
nextSyncToken string Token utilizzato in un secondo momento per recuperare solo le voci che sono cambiate da quando è stato restituito questo risultato. Omesso se sono disponibili altri risultati, nel qual caso viene fornito nextPageToken.

Prova

Utilizza l'Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.