Events: instances

Возвращает количество экземпляров указанного повторяющегося события. Попробуйте сейчас .

Запрос

HTTP-запрос 

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

Параметры

Имя параметра Ценить Описание
Параметры пути
calendarId string Идентификатор календаря. Для получения идентификаторов календарей вызовите метод calendarList.list . Чтобы получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово « primary ».
eventId string Идентификатор повторяющегося события.
Необязательные параметры запроса
alwaysIncludeEmail boolean Устарело и игнорируется. В поле email организатора, создателя и участников всегда будет возвращаться значение, даже если реальный адрес электронной почты недоступен (т.е. будет предоставлено сгенерированное, нерабочее значение).
maxAttendees integer Максимальное количество участников, включаемое в ответ. Если количество участников превышает указанное, возвращается только участник. Необязательно.
maxResults integer Максимальное количество событий, возвращаемых на одной странице результатов. Значение по умолчанию — 250 событий. Размер страницы не может превышать 2500 событий. Необязательно.
originalStart string Исходное время начала экземпляра в результате. Необязательно.
pageToken string Токен, указывающий, какую страницу результатов следует вернуть. Необязательно.
showDeleted boolean Включать ли удалённые события (со status « cancelled ») в результат. Отменённые события повторяющихся событий будут по-прежнему включены, если singleEvents имеет значение False. Необязательно. Значение по умолчанию — False.
timeMax datetime Верхняя граница (исключая) времени начала события для фильтрации. Необязательно. Фильтрация по времени начала по умолчанию отключена. Необходимо указать временную метку RFC3339 с обязательным смещением часового пояса.
timeMin datetime Нижняя граница (включительно) времени окончания события для фильтрации. Необязательно. Фильтрация по времени окончания по умолчанию отключена. Необходимо указать временную метку RFC3339 с обязательным смещением часового пояса.
timeZone string Часовой пояс, используемый в ответе. Необязательно. По умолчанию используется часовой пояс календаря.

Авторизация

Этот запрос допускает авторизацию по крайней мере в одной из следующих областей:

Объем
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
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

Более подробную информацию смотрите на странице аутентификации и авторизации .

Текст запроса

Не предоставляйте тело запроса с помощью этого метода.

Ответ

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

{
  "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
  ]
}
Имя объекта недвижимости Ценить Описание Примечания
kind string Тип коллекции (" calendar#events ").
etag etag ETag коллекции.
summary string Название календаря. Только для чтения.
description string Описание календаря. Только для чтения.
updated datetime Время последнего изменения календаря (в формате RFC3339 ). Только для чтения.
timeZone string Часовой пояс календаря. Только для чтения.
accessRole string Роль доступа пользователя к этому календарю. Только для чтения. Возможные значения:
  • « none » — у пользователя нет доступа.
  • « freeBusyReader » — пользователь имеет доступ на чтение информации о занятости.
  • « reader » — пользователь имеет доступ для чтения календаря. Закрытые мероприятия будут видны пользователям с доступом для чтения, но подробности о мероприятиях будут скрыты.
  • « writer » — пользователь имеет право на чтение и запись в календаре. Пользователи с правом на запись смогут просматривать личные события, а также информацию о событиях.
  • « owner » — пользователь имеет доступ к календарю с правами менеджера. Эта роль обладает всеми правами автора, а также возможностью просматривать и изменять уровни доступа других пользователей.

defaultReminders[] list Напоминания по умолчанию в календаре для аутентифицированного пользователя. Эти напоминания применяются ко всем событиям в этом календаре, которые явно не переопределяют их (т.е. для которых параметру reminders.useDefault не присвоено значение True).
defaultReminders[]. method string Метод, используемый в этом напоминании. Возможные значения:
  • « email » — напоминания отправляются по электронной почте.
  • « popup » — напоминания отправляются через всплывающее окно пользовательского интерфейса.

Обязательно при добавлении напоминания.

 записываемый
defaultReminders[]. minutes integer Количество минут до начала события, за которое должно сработать напоминание. Допустимые значения: от 0 до 40320 (4 недели в минутах).

Обязательно при добавлении напоминания.

 записываемый
nextPageToken string Токен, используемый для доступа к следующей странице этого результата. Не указывается, если других результатов нет. В этом случае предоставляется nextSyncToken .
items[] list Список событий в календаре.
nextSyncToken string Токен, используемый позднее для извлечения только тех записей, которые изменились с момента получения этого результата. Опускается, если доступны дополнительные результаты; в этом случае указывается nextPageToken .

Попробуйте!

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