Muestra toda la configuración del usuario autenticado. Pruébalo ahora y ve un ejemplo.
Solicitud
Solicitud HTTP
GET https://www.googleapis.com/calendar/v3/users/me/settings
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de consulta opcionales | ||
maxResults |
integer |
Cantidad máxima de entradas mostradas en una página de resultados. De forma predeterminada, el valor es de 100 entradas. El tamaño de la página nunca puede superar las 250 entradas. Opcional. |
pageToken |
string |
Token que especifica qué página de resultados se mostrará. Opcional. |
syncToken |
string |
El token obtenido del campo nextSyncToken que se muestra en la última página de resultados de la solicitud de lista anterior. Esto hace que el resultado de esta solicitud de lista contenga solo las entradas que cambiaron desde entonces. Si el syncToken vence, el servidor responderá con un código de respuesta 410 GONE y el cliente debería liberar su almacenamiento y realizar una sincronización completa sin ninguna syncToken . Obtén más información sobre la sincronización incremental. Opcional. El valor predeterminado es mostrar todas las entradas. |
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances:
Permiso |
---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.settings.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 solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{ "kind": "calendar#settings", "etag": etag, "nextPageToken": string, "nextSyncToken": string, "items": [ settings Resource ] }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
kind |
string |
Es el tipo de colección ("calendar#settings "). |
|
etag |
etag |
ETag de la colección. | |
items[] |
list |
Lista de parámetros de configuración del usuario. | |
nextPageToken |
string |
El token que se usa para acceder a la página siguiente de este resultado. Se omite si no hay más resultados disponibles, en cuyo caso se proporciona nextSyncToken . |
|
nextSyncToken |
string |
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 cuyo 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.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
Usa la biblioteca cliente de Python.
settings = service.settings().list().execute() for setting in settings['items']: print '%s: %s' % (setting['id'], setting['value'])
PHP
Usa la biblioteca cliente de PHP.
$settings = $service->settings->listSettings(); foreach ($settings->getItems() as $setting) { echo $setting->getId() . ': ' . $setting->getValue(); }
Ruby
Usa la biblioteca cliente Ruby.
result = client.list_settings result.items.each do |e| print e.id + ": " + e.value + "\n" end
Pruébala
Usa el Explorador de APIs que aparece a continuación para llamar a este método con datos en tiempo real y ver la respuesta.