Restituisce istanze dell'evento ricorrente specificato. Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri del percorso | ||
calendarId |
string |
Identificatore del calendario. Per recuperare gli ID calendario, chiama il metodo calendarList.list. Utilizza la parola chiave "primary " per accedere al calendario principale dell'utente che ha eseguito l'accesso.
|
eventId |
string |
Identificatore di evento ricorrente. |
Parametri di query facoltativi | ||
alwaysIncludeEmail |
boolean |
Obsoleto e ignorato. Verrà sempre restituito un valore nel campo email per l'organizzatore, il creatore e i partecipanti, anche se non è disponibile alcun indirizzo email reale (ad esempio, verrà fornito un valore generato e non funzionante).
|
maxAttendees |
integer |
Il numero massimo di partecipanti da includere nella risposta. Se il numero di partecipanti è superiore a quello specificato, verrà restituito solo il partecipante. Campo 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 superare i 2500 eventi. Campo facoltativo. |
originalStart |
string |
L'ora di inizio originale dell'istanza nel risultato. Campo facoltativo. |
pageToken |
string |
Token che specifica la pagina di risultati da restituire. Campo facoltativo. |
showDeleted |
boolean |
Indica se includere eventi eliminati (con status uguale a "cancelled ") nel risultato. Le istanze annullate di eventi ricorrenti saranno comunque incluse se singleEvents è False. Campo facoltativo. Il valore predefinito è False.
|
timeMax |
datetime |
Limite superiore (esclusivo) dell'ora di inizio di un evento in base al quale applicare il filtro. Campo facoltativo. L'impostazione predefinita non è il filtro in base all'ora di inizio. Deve essere un timestamp RFC3339 con offset di fuso orario obbligatorio. |
timeMin |
datetime |
Limite inferiore (incluso) per l'ora di fine di un evento in base alla quale filtrare. Campo facoltativo. L'impostazione predefinita non è il filtro in base all'ora di fine. Deve essere un timestamp RFC3339 con offset di fuso orario obbligatorio. |
timeZone |
string |
Fuso orario utilizzato nella risposta. Campo 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 |
Per ulteriori informazioni, consulta la pagina relativa all'autenticazione e autorizzazione.
Corpo della richiesta
Non fornire il corpo di una 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 (sotto forma di 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:
|
|
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 ignorano esplicitamente (ovvero non hanno reminders.useDefault impostato su True). |
|
defaultReminders[].method |
string |
Il metodo utilizzato per il promemoria. I valori possibili sono:
Obbligatorio quando aggiungi un promemoria. |
scrivibile |
defaultReminders[].minutes |
integer |
Numero di minuti prima dell'inizio dell'evento in cui dovrebbe 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 ulteriori risultati, nel qual caso viene fornito il valore nextSyncToken . |
|
items[] |
list |
Elenco di eventi nel calendario. | |
nextSyncToken |
string |
Token utilizzato in un secondo momento per recuperare solo le voci che sono cambiate dalla restituzione del risultato. Omesso se sono disponibili ulteriori risultati, in questo caso viene fornito il valore nextPageToken . |
Esempi
Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).
Java
Utilizza la libreria client 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 instances of a specific recurring event String pageToken = null; do { Events events = service.events().instances('primary', 'eventId').setPageToken(pageToken).execute(); List<Event> items = events.getItems(); for (Event event : items) { System.out.println(event.getSummary()); } pageToken = events.getNextPageToken(); } while (pageToken != null);
Python
Utilizza la libreria client Python.
page_token = None while True: events = service.events().instances(calendarId='primary', eventId='eventId', pageToken=page_token).execute() for event in events['items']: print event['summary'] page_token = events.get('nextPageToken') if not page_token: break
PHP
Utilizza la libreria client PHP.
$events = $service->events->instances('primary', "eventId"); while(true) { foreach ($events->getItems() as $event) { echo $event->getSummary(); } $pageToken = $events->getNextPageToken(); if ($pageToken) { $optParams = array('pageToken' => $pageToken); $events = $service->events->instances('primary', "eventId", $optParams); } else { break; } }
Ruby
Utilizza la libreria client di Ruby.
page_token = nil begin result = client.list_event_instances('primary', 'eventId') 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?
Prova.
Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.