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 Обновляет событие.
смотреть 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 Следите за изменениями в ресурсах настроек.