API Reference

Этот справочник API организован по типу ресурса. Каждый тип ресурса имеет одно или несколько представлений данных и один или несколько методов.

Типы ресурсов

1. Акк
2. КалендарьСписок
3. Календари
4. каналы
5. Цвета
6. События
7. халявщик
8. Настройки

Акк

Подробную информацию о ресурсе Acl см. на странице представления ресурса .

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
удалить	DELETE /calendars/ calendarId /acl/ ruleId	Удаляет правило контроля доступа.
получать	GET /calendars/ calendarId /acl/ ruleId	Возвращает правило контроля доступа.
вставлять	POST /calendars/ calendarId /acl	Создает правило контроля доступа.
список	GET /calendars/ calendarId /acl	Возвращает правила в списке управления доступом для календаря.
пластырь	PATCH /calendars/ calendarId /acl/ ruleId	Обновляет правило контроля доступа. Этот метод поддерживает семантику исправления. Обратите внимание, что каждый запрос на исправление потребляет три единицы квоты; предпочитаю использовать get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, останутся без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива.
обновлять	PUT /calendars/ calendarId /acl/ ruleId	Обновляет правило контроля доступа.
смотреть	POST /calendars/ calendarId /acl/watch	Следите за изменениями в ресурсах ACL.

КалендарьСписок

Подробные сведения о ресурсе CalendarList см. на странице представления ресурса .

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
удалить	DELETE /users/me/calendarList/ calendarId	Удаляет календарь из списка календарей пользователя.
получать	GET /users/me/calendarList/ calendarId	Возвращает календарь из списка календарей пользователя.
вставлять	POST /users/me/calendarList	Вставляет существующий календарь в список календарей пользователя.
список	GET /users/me/calendarList	Возвращает календари из списка календарей пользователя.
пластырь	PATCH /users/me/calendarList/ calendarId	Обновляет существующий календарь в списке календарей пользователя. Этот метод поддерживает семантику исправления. Обратите внимание, что каждый запрос на исправление потребляет три единицы квоты; предпочитаю использовать get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, останутся без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива.
обновлять	PUT /users/me/calendarList/ calendarId	Обновляет существующий календарь в списке календарей пользователя.
смотреть	POST /users/me/calendarList/watch	Следите за изменениями в ресурсах CalendarList.

Календари

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

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
прозрачный	POST /calendars/ calendarId /clear	Очищает основной календарь. Эта операция удаляет все события, связанные с основным календарем учетной записи.
удалить	DELETE /calendars/ calendarId	Удаляет дополнительный календарь. Используйте calendars.clear для очистки всех событий в основных календарях.
получать	GET /calendars/ calendarId	Возвращает метаданные для календаря.
вставлять	POST /calendars	Создает дополнительный календарь.
пластырь	PATCH /calendars/ calendarId	Обновляет метаданные для календаря. Этот метод поддерживает семантику исправления. Обратите внимание, что каждый запрос на исправление потребляет три единицы квоты; предпочитаю использовать get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, останутся без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива.
обновлять	PUT /calendars/ calendarId	Обновляет метаданные для календаря.

каналы

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

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
останавливаться	POST /channels/stop	Перестаньте смотреть ресурсы через этот канал.

Цвета

Подробную информацию о ресурсах цветов см. на странице представления ресурсов .

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
получать	GET /colors	Возвращает определения цветов для календарей и событий.

События

Сведения о ресурсе Events см. на странице представления ресурса .

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
удалить	DELETE /calendars/ calendarId /events/ eventId	Удаляет событие.
получать	GET /calendars/ calendarId /events/ eventId	Возвращает событие на основе его идентификатора Google Calendar. Чтобы получить событие с помощью его идентификатора iCalendar, вызовите метод events.list, используя параметр iCalUID .
Импортировать	POST /calendars/ calendarId /events/import	Импортирует событие. Эта операция используется для добавления частной копии существующего события в календарь.
вставлять	POST /calendars/ calendarId /events	Создает событие.
экземпляры	GET /calendars/ calendarId /events/ eventId /instances	Возвращает экземпляры указанного повторяющегося события.
список	GET /calendars/ calendarId /events	Возвращает события в указанном календаре.
двигаться	POST /calendars/ calendarId /events/ eventId /move	Перемещает событие в другой календарь, т.е. меняет организатора события. Обязательные параметры запроса: destination
пластырь	PATCH /calendars/ calendarId /events/ eventId	Обновляет событие. Этот метод поддерживает семантику исправления. Обратите внимание, что каждый запрос на исправление потребляет три единицы квоты; предпочитаю использовать get с последующим update . Указанные вами значения полей заменяют существующие значения. Поля, которые вы не укажете в запросе, останутся без изменений. Поля массива, если они указаны, перезаписывают существующие массивы; это отбрасывает все предыдущие элементы массива.
быстроДобавить	POST /calendars/ calendarId /events/quickAdd	Создает событие на основе простой текстовой строки. Обязательные параметры запроса: text
обновлять	PUT /calendars/ calendarId /events/ eventId	Обновляет событие. Этот метод не поддерживает семантику исправления и всегда обновляет весь ресурс события. Чтобы выполнить частичное обновление, выполните команду get с последующим update с использованием тегов etag для обеспечения атомарности.
смотреть	POST /calendars/ calendarId /events/watch	Следите за изменениями в ресурсах Events.

халявщик

Подробную информацию о ресурсе Freebusy см. на странице представления ресурса .

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
запрос	POST /freeBusy	Возвращает информацию о занятости для набора календарей.

Настройки

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

Метод	HTTP-запрос	Описание
URI относительно https://www.googleapis.com/calendar/v3, если не указано иное.
получать	GET /users/me/settings/ setting	Возвращает одну настройку пользователя.
список	GET /users/me/settings	Возвращает все пользовательские настройки для аутентифицированного пользователя.
смотреть	POST /users/me/settings/watch	Следите за изменениями в ресурсах настроек.