Restituisce tutte le impostazioni utente per l'utente autenticato. Prova subito o guarda un esempio.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/calendar/v3/users/me/settings
Parametri
Nome del parametro | Valore | Descrizione |
---|---|---|
Parametri di query facoltativi | ||
maxResults |
integer |
Numero massimo di voci restituite in una pagina dei risultati. Per impostazione predefinita, il valore è 100 voci. La dimensione della pagina non può mai essere superiore a 250 voci. (Facoltativo) |
pageToken |
string |
Token che specifica la pagina dei risultati da restituire. (Facoltativo) |
syncToken |
string |
Token ottenuto dal campo nextSyncToken restituito nell'ultima pagina dei risultati della precedente richiesta di elenco. Il risultato di questa richiesta di elenco contiene solo le voci che sono cambiate da allora. Se syncToken scade, il server risponderà con un codice di risposta 410 GONE e il client dovrebbe cancellare lo spazio di archiviazione ed eseguire una sincronizzazione completa senza syncToken . Scopri di più sulla sincronizzazione incrementale. Facoltativo. L'impostazione predefinita è la restituzione di tutte le voci. |
Autorizzazione
Questa richiesta richiede 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.settings.readonly |
Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.
Corpo della richiesta
Non fornire 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#settings", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ settings Resource ] }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
kind |
string |
Tipo di raccolta ("calendar#settings "). |
|
etag |
etag |
ETag della collezione. | |
items[] |
list |
Elenco di impostazioni utente. | |
nextPageToken |
string |
Token utilizzato per accedere alla pagina successiva di questo risultato. Omesso se non sono disponibili ulteriori risultati, in questo caso viene fornito il valore nextSyncToken . |
|
nextSyncToken |
string |
Token utilizzato in un secondo momento per recuperare solo le voci che sono state modificate dopo che è stato restituito questo 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.Setting; import com.google.api.services.calendar.model.Settings; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Iterate over all user settings Settings settings = service.settings().list().execute(); for (Setting setting : settings.getItems()) { System.out.println(setting.getId() + ": " + setting.getValue()); }
Python
Utilizza la libreria client Python.
settings = service.settings().list().execute() for setting in settings['items']: print '%s: %s' % (setting['id'], setting['value'])
PHP
Utilizza la libreria client PHP.
$settings = $service->settings->listSettings(); foreach ($settings->getItems() as $setting) { echo $setting->getId() . ': ' . $setting->getValue(); }
Ruby
Utilizza la libreria client Ruby.
result = client.list_settings result.items.each do |e| print e.id + ": " + e.value + "\n" end
Prova
Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.