Settings: list

Возвращает все настройки аутентифицированного пользователя. Попробовать

Запрос

HTTP-запрос

GET https://www.googleapis.com/calendar/v3/users/me/settings

Параметры

Название параметра Значение Описание
Необязательные параметры запроса
maxResults integer Максимальное количество записей, возвращаемых на одной странице результатов. По умолчанию задано значение "100". Размер страницы не может превышать 250 записей. Необязательное поле.
pageToken string Токен, указывающий, какую страницу результатов нужно вернуть. Необязательное поле.
syncToken string Токен, полученный из поля nextSyncToken, которое возвращается на последней странице результатов предыдущего запроса списка. В результате в списке будут только записи, которые изменились с указанного момента.
Если срок действия syncToken истек, сервер вернет код ответа 410 GONE. В этом случае клиент должен очистить хранилище и выполнить полную синхронизацию без syncToken. Подробнее о добавочной синхронизации…

Необязательный параметр. По умолчанию возвращаются все записи.

Авторизация

Для выполнения этого запроса требуется авторизация хотя бы в одной из следующих областей действия:

Область действия
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

Подробную информацию можно найти в разделе об аутентификации и авторизации.

Тело запроса

При работе с этим методом тело запроса не используется.

Ответ

В случае успеха метод возвращает тело ответа со следующей структурой:

{
  "kind": "calendar#settings",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    settings Resource
  ]
}
Название свойства Значение Описание Примечания
kind string Тип подборки (calendar#settings).
etag etag Тег ETag коллекции.
items[] list Список пользовательских настроек.
nextPageToken string Токен, используемый для доступа к следующей странице этого результата. Если дополнительных результатов нет, то этот параметр опускается и указывается nextSyncToken.
nextSyncToken string Токен, который можно использовать позже, чтобы получить только те записи, которые изменились с момента возврата этого результата. Если доступны дополнительные результаты, то это свойство опускается и вместо него указывается nextPageToken.

Попробовать

Воспользуйтесь инструментом API Explorer ниже, чтобы применить этот метод к реальным данным и посмотреть, как он работает.