Settings: list

Devuelve todos los parámetros de configuración del usuario autenticado. Pruébalo ahora.

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 Es la cantidad máxima de entradas que se devuelven en una página de resultados. De forma predeterminada, el valor es de 100 entradas. El tamaño de la página nunca puede ser superior a 250 entradas. Opcional.
pageToken string Es el token que especifica qué página de resultados se debe mostrar. Opcional.
syncToken string Es el token obtenido del campo nextSyncToken que se devolvió en la última página de resultados de la solicitud de lista anterior. 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á borrar su almacenamiento y realizar una sincronización completa sin ningún syncToken.
Obtén más información sobre la sincronización incremental.
Opcional. La configuración predeterminada es devolver todas las entradas.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes permisos:

Alcance
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly
https://www.googleapis.com/auth/calendar.settings

Para obtener más información, consulta la página 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#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 Es la etiqueta de entidad de la colección.
items[] list Es la lista de parámetros de configuración del usuario.
nextPageToken string Es el 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.
nextSyncToken string Es el token que se usa más adelante para recuperar solo las entradas que cambiaron desde que se devolvió 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 en vivo y ver la respuesta.