Импортирует событие. Эта операция используется для добавления частной копии существующего события в календарь. Импортировать можно только события с eventType по default .
 Устаревшее поведение: если импортируется событие, не являющееся default , его тип будет изменен на default , а все свойства, специфичные для типа события, которые оно может иметь, будут удалены.
Запрос
HTTP-запрос
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
Параметры
| Имя параметра | Ценить | Описание | 
|---|---|---|
| Параметры пути | ||
 calendarId |  string |  Идентификатор календаря. Для получения идентификаторов календаря вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово " primary ". | 
| Необязательные параметры запроса | ||
 conferenceDataVersion |  integer |  Номер версии данных конференции, поддерживаемый клиентом API. Версия 0 предполагает отсутствие поддержки данных конференции и игнорирует данные конференции в теле события. Версия 1 обеспечивает поддержку копирования ConferenceData, а также создания новых конференций с использованием поля createRequest conferenceData. Значение по умолчанию — 0. Допустимые значения — от 0 до 1 включительно. | 
 supportsAttachments |  boolean | Поддерживает ли API-клиент, выполняющий операцию, вложения событий. Необязательно. Значение по умолчанию — False. | 
Авторизация
Для этого запроса требуется авторизация по крайней мере в одной из следующих областей:
| Объем | 
|---|
 https://www.googleapis.com/auth/calendar | 
 https://www.googleapis.com/auth/calendar.events | 
 https://www.googleapis.com/auth/calendar.app.created | 
 https://www.googleapis.com/auth/calendar.events.owned | 
Более подробную информацию смотрите на странице аутентификации и авторизации .
Текст запроса
В теле запроса укажите ресурс Events со следующими свойствами:
| Имя свойства | Ценить | Описание | Примечания | 
|---|---|---|---|
| Требуемые свойства | |||
 end |  nested object | (Исключительное) время окончания события. Для повторяющегося события это время окончания первого экземпляра. | |
 iCalUID |  string |  Уникальный идентификатор события, определенный в RFC5545 . Он используется для уникальной идентификации событий в системах календарного планирования и должен быть указан при импорте событий с помощью метода импорта .  Обратите внимание, что   | |
 start |  nested object | Время начала события (включительно). Для повторяющегося события это время начала первого экземпляра. | |
| Дополнительные свойства | |||
 anyoneCanAddSelf |  boolean | Может ли кто-либо приглашать себя на мероприятие (устарело). Необязательно. Значение по умолчанию — False. | записываемый | 
 attachments[]. fileUrl |  string |  URL-ссылка на вложение.  Для добавления вложений файлов Google Диска используйте тот же формат, что и в свойстве  Требуется при добавлении вложения.  | записываемый | 
 attendees[] |  list | Участники мероприятия. Дополнительную информацию о планировании мероприятий с другими пользователями календаря см. в руководстве « События с участниками» . Учетные записи служб должны использовать делегирование полномочий на уровне домена для заполнения списка участников. | записываемый | 
 attendees[]. additionalGuests |  integer | Количество дополнительных гостей. Необязательно. По умолчанию 0. | записываемый | 
 attendees[]. comment |  string | Комментарий ответа участника. Необязательно. | записываемый | 
 attendees[]. displayName |  string | Имя участника, если доступно. Необязательно. | записываемый | 
 attendees[]. email |  string |  Адрес электронной почты участника, если доступен. Это поле должно присутствовать при добавлении участника. Это должен быть действительный адрес электронной почты согласно RFC5322 . Обязательно при добавлении участника.  | записываемый | 
 attendees[]. optional |  boolean | Является ли это необязательным участником. Необязательно. Значение по умолчанию — Ложь. | записываемый | 
 attendees[]. resource |  boolean | Является ли участник ресурсом. Может быть установлено только при первом добавлении участника к событию. Последующие изменения игнорируются. Необязательно. Значение по умолчанию — False. | записываемый | 
 attendees[]. responseStatus |  string |  Статус ответа участника. Возможные значения:
  | записываемый | 
 attendeesOmitted |  boolean |  Возможно, участники были пропущены из представления события. При извлечении события это может быть связано с ограничением, указанным параметром запроса maxAttendee . При обновлении события это можно использовать только для обновления ответа участника. Необязательно. Значение по умолчанию — False. | записываемый | 
 colorId |  string |  Цвет события. Это идентификатор, ссылающийся на запись в разделе event определения цветов (см. конечную точку цветов ). Необязательно. | записываемый | 
 conferenceData |  nested object |  Информация, связанная с конференцией, например, сведения о конференции Google Meet. Для создания новых сведений о конференции используйте поле createRequest . Чтобы сохранить изменения, не забудьте установить параметр запроса conferenceDataVersion на 1 для всех запросов на изменение событий. | записываемый | 
 description |  string | Описание события. Может содержать HTML. Необязательно. | записываемый | 
 end. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 end. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 end. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 extendedProperties. private |  object | Свойства, которые являются частными для копии события, отображаемого в этом календаре. | записываемый | 
 extendedProperties. shared |  object | Свойства, которые являются общими для копий события в календарях других участников. | записываемый | 
 focusTimeProperties |  nested object |  Данные события Focus Time. Используется, если eventType — focusTime . | записываемый | 
 gadget. display |  string |  Режим отображения гаджета. Устарело. Возможные значения:
  | записываемый | 
 gadget. height |  integer | Высота гаджета в пикселях. Высота должна быть целым числом больше 0. Необязательно. Устарело. | записываемый | 
 gadget. iconLink |  string | URL значка гаджета. Схема URL должна быть HTTPS. Устарело. | записываемый | 
 gadget. link |  string | URL гаджета. Схема URL должна быть HTTPS. Устарело. | записываемый | 
 gadget. preferences |  object | Предпочтения. | записываемый | 
 gadget. title |  string | Название гаджета. Устарело. | записываемый | 
 gadget. type |  string | Тип гаджета. Устарело. | записываемый | 
 gadget. width |  integer | Ширина гаджета в пикселях. Ширина должна быть целым числом больше 0. Необязательно. Устарело. | записываемый | 
 guestsCanInviteOthers |  boolean | Могут ли участники, кроме организатора, приглашать других на мероприятие. Необязательно. Значение по умолчанию — True. | записываемый | 
 guestsCanModify |  boolean | Могут ли участники, кроме организатора, изменять событие. Необязательно. Значение по умолчанию — False. | записываемый | 
 guestsCanSeeOtherGuests |  boolean | Могут ли участники, кроме организатора, видеть, кто является участниками мероприятия. Необязательно. Значение по умолчанию — True. | записываемый | 
 location |  string | Географическое местоположение события в виде текста в свободной форме. Необязательно. | записываемый | 
 organizer |  object |  Организатор мероприятия. Если организатор также является участником, это указывается отдельной записью в attendees с полем organizer , установленным на True. Чтобы изменить организатора, используйте операцию перемещения . Только для чтения, за исключением импорта мероприятия. | записываемый | 
 organizer. displayName |  string | Имя организатора, если известно. | записываемый | 
 organizer. email |  string | Адрес электронной почты организатора, если имеется. Это должен быть действительный адрес электронной почты согласно RFC5322 . | записываемый | 
 originalStartTime. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 originalStartTime. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 originalStartTime. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 outOfOfficeProperties |  nested object |  Данные о событиях «Вне офиса». Используется, если eventType — outOfOffice . | записываемый | 
 recurrence[] |  list |  Список строк RRULE, EXRULE, RDATE и EXDATE для повторяющегося события, как указано в RFC5545 . Обратите внимание, что строки DTSTART и DTEND не допускаются в этом поле; время начала и окончания события указывается в полях start и end . Это поле опускается для отдельных событий или экземпляров повторяющихся событий. | записываемый | 
 reminders. overrides[] |  list | Если событие не использует напоминания по умолчанию, это список напоминаний, специфичных для события, или, если не установлено, указывает, что напоминания для этого события не установлены. Максимальное количество переопределенных напоминаний — 5. | записываемый | 
 reminders.overrides[]. method |  string |  Метод, используемый этим напоминанием. Возможные значения:
 Обязательно при добавлении напоминания.  | записываемый | 
 reminders.overrides[]. minutes |  integer |  Количество минут до начала события, когда должно сработать напоминание. Допустимые значения — от 0 до 40320 (4 недели в минутах). Обязательно при добавлении напоминания.  | записываемый | 
 reminders. useDefault |  boolean | Применяются ли к событию напоминания календаря по умолчанию. | записываемый | 
 sequence |  integer | Порядковый номер согласно iCalendar. | записываемый | 
 source. title |  string | Название источника; например, название веб-страницы или тема электронного письма. | записываемый | 
 source. url |  string | URL источника, указывающего на ресурс. Схема URL должна быть HTTP или HTTPS. | записываемый | 
 start. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 start. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 start. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 status |  string |  Статус события. Необязательно. Возможные значения:
  | записываемый | 
 summary |  string | Название мероприятия. | записываемый | 
 transparency |  string |  Блокирует ли событие время в календаре. Необязательно. Возможные значения:
  | записываемый | 
 visibility |  string |  Видимость события. Необязательно. Возможные значения:
  | записываемый | 
Ответ
В случае успеха этот метод возвращает ресурс Events в теле ответа.
Попробуйте!
Используйте API Explorer ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.
 Импортирует событие. Эта операция используется для добавления частной копии существующего события в календарь. Импортировать можно только события с eventType по default .
 Устаревшее поведение: если импортируется событие, не являющееся default , его тип будет изменен на default , а все свойства, специфичные для типа события, которые оно может иметь, будут удалены.
Запрос
HTTP-запрос
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
Параметры
| Имя параметра | Ценить | Описание | 
|---|---|---|
| Параметры пути | ||
 calendarId |  string |  Идентификатор календаря. Для получения идентификаторов календаря вызовите метод calendarList.list . Если вы хотите получить доступ к основному календарю текущего вошедшего в систему пользователя, используйте ключевое слово " primary ". | 
| Необязательные параметры запроса | ||
 conferenceDataVersion |  integer |  Номер версии данных конференции, поддерживаемый клиентом API. Версия 0 предполагает отсутствие поддержки данных конференции и игнорирует данные конференции в теле события. Версия 1 обеспечивает поддержку копирования ConferenceData, а также создания новых конференций с использованием поля createRequest conferenceData. Значение по умолчанию — 0. Допустимые значения — от 0 до 1 включительно. | 
 supportsAttachments |  boolean | Поддерживает ли API-клиент, выполняющий операцию, вложения событий. Необязательно. Значение по умолчанию — False. | 
Авторизация
Для этого запроса требуется авторизация по крайней мере в одной из следующих областей:
| Объем | 
|---|
 https://www.googleapis.com/auth/calendar | 
 https://www.googleapis.com/auth/calendar.events | 
 https://www.googleapis.com/auth/calendar.app.created | 
 https://www.googleapis.com/auth/calendar.events.owned | 
Более подробную информацию смотрите на странице аутентификации и авторизации .
Текст запроса
В теле запроса укажите ресурс Events со следующими свойствами:
| Имя свойства | Ценить | Описание | Примечания | 
|---|---|---|---|
| Требуемые свойства | |||
 end |  nested object | (Исключительное) время окончания события. Для повторяющегося события это время окончания первого экземпляра. | |
 iCalUID |  string |  Уникальный идентификатор события, определенный в RFC5545 . Он используется для уникальной идентификации событий в системах календарного планирования и должен быть указан при импорте событий с помощью метода импорта .  Обратите внимание, что   | |
 start |  nested object | Время начала события (включительно). Для повторяющегося события это время начала первого экземпляра. | |
| Дополнительные свойства | |||
 anyoneCanAddSelf |  boolean | Может ли кто-либо приглашать себя на мероприятие (устарело). Необязательно. Значение по умолчанию — False. | записываемый | 
 attachments[]. fileUrl |  string |  URL-ссылка на вложение.  Для добавления вложений файлов Google Диска используйте тот же формат, что и в свойстве  Требуется при добавлении вложения.  | записываемый | 
 attendees[] |  list | Участники мероприятия. Дополнительную информацию о планировании мероприятий с другими пользователями календаря см. в руководстве « События с участниками» . Учетные записи служб должны использовать делегирование полномочий на уровне домена для заполнения списка участников. | записываемый | 
 attendees[]. additionalGuests |  integer | Количество дополнительных гостей. Необязательно. По умолчанию 0. | записываемый | 
 attendees[]. comment |  string | Комментарий ответа участника. Необязательно. | записываемый | 
 attendees[]. displayName |  string | Имя участника, если доступно. Необязательно. | записываемый | 
 attendees[]. email |  string |  Адрес электронной почты участника, если доступен. Это поле должно присутствовать при добавлении участника. Это должен быть действительный адрес электронной почты согласно RFC5322 . Обязательно при добавлении участника.  | записываемый | 
 attendees[]. optional |  boolean | Является ли это необязательным участником. Необязательно. Значение по умолчанию — Ложь. | записываемый | 
 attendees[]. resource |  boolean | Является ли участник ресурсом. Может быть установлено только при первом добавлении участника к событию. Последующие изменения игнорируются. Необязательно. Значение по умолчанию — False. | записываемый | 
 attendees[]. responseStatus |  string |  Статус ответа участника. Возможные значения:
  | записываемый | 
 attendeesOmitted |  boolean |  Возможно, участники были пропущены из представления события. При извлечении события это может быть связано с ограничением, указанным параметром запроса maxAttendee . При обновлении события это можно использовать только для обновления ответа участника. Необязательно. Значение по умолчанию — False. | записываемый | 
 colorId |  string |  Цвет события. Это идентификатор, ссылающийся на запись в разделе event определения цветов (см. конечную точку цветов ). Необязательно. | записываемый | 
 conferenceData |  nested object |  Информация, связанная с конференцией, например, сведения о конференции Google Meet. Для создания новых сведений о конференции используйте поле createRequest . Чтобы сохранить изменения, не забудьте установить параметр запроса conferenceDataVersion на 1 для всех запросов на изменение событий. | записываемый | 
 description |  string | Описание события. Может содержать HTML. Необязательно. | записываемый | 
 end. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 end. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 end. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 extendedProperties. private |  object | Свойства, которые являются частными для копии события, отображаемого в этом календаре. | записываемый | 
 extendedProperties. shared |  object | Свойства, которые являются общими для копий события в календарях других участников. | записываемый | 
 focusTimeProperties |  nested object |  Данные события Focus Time. Используется, если eventType — focusTime . | записываемый | 
 gadget. display |  string |  Режим отображения гаджета. Устарело. Возможные значения:
  | записываемый | 
 gadget. height |  integer | Высота гаджета в пикселях. Высота должна быть целым числом больше 0. Необязательно. Устарело. | записываемый | 
 gadget. iconLink |  string | URL значка гаджета. Схема URL должна быть HTTPS. Устарело. | записываемый | 
 gadget. link |  string | URL гаджета. Схема URL должна быть HTTPS. Устарело. | записываемый | 
 gadget. preferences |  object | Предпочтения. | записываемый | 
 gadget. title |  string | Название гаджета. Устарело. | записываемый | 
 gadget. type |  string | Тип гаджета. Устарело. | записываемый | 
 gadget. width |  integer | Ширина гаджета в пикселях. Ширина должна быть целым числом больше 0. Необязательно. Устарело. | записываемый | 
 guestsCanInviteOthers |  boolean | Могут ли участники, кроме организатора, приглашать других на мероприятие. Необязательно. Значение по умолчанию — True. | записываемый | 
 guestsCanModify |  boolean | Могут ли участники, кроме организатора, изменять событие. Необязательно. Значение по умолчанию — False. | записываемый | 
 guestsCanSeeOtherGuests |  boolean | Могут ли участники, кроме организатора, видеть, кто является участниками мероприятия. Необязательно. Значение по умолчанию — True. | записываемый | 
 location |  string | Географическое местоположение события в виде текста в свободной форме. Необязательно. | записываемый | 
 organizer |  object |  Организатор мероприятия. Если организатор также является участником, это указывается отдельной записью в attendees с полем organizer , установленным на True. Чтобы изменить организатора, используйте операцию перемещения . Только для чтения, за исключением импорта мероприятия. | записываемый | 
 organizer. displayName |  string | Имя организатора, если известно. | записываемый | 
 organizer. email |  string | Адрес электронной почты организатора, если имеется. Это должен быть действительный адрес электронной почты согласно RFC5322 . | записываемый | 
 originalStartTime. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 originalStartTime. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 originalStartTime. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 outOfOfficeProperties |  nested object |  Данные о событиях «Вне офиса». Используется, если eventType — outOfOffice . | записываемый | 
 recurrence[] |  list |  Список строк RRULE, EXRULE, RDATE и EXDATE для повторяющегося события, как указано в RFC5545 . Обратите внимание, что строки DTSTART и DTEND не допускаются в этом поле; время начала и окончания события указывается в полях start и end . Это поле опускается для отдельных событий или экземпляров повторяющихся событий. | записываемый | 
 reminders. overrides[] |  list | Если событие не использует напоминания по умолчанию, это список напоминаний, специфичных для события, или, если не установлено, указывает, что напоминания для этого события не установлены. Максимальное количество переопределенных напоминаний — 5. | записываемый | 
 reminders.overrides[]. method |  string |  Метод, используемый этим напоминанием. Возможные значения:
 Обязательно при добавлении напоминания.  | записываемый | 
 reminders.overrides[]. minutes |  integer |  Количество минут до начала события, когда должно сработать напоминание. Допустимые значения — от 0 до 40320 (4 недели в минутах). Обязательно при добавлении напоминания.  | записываемый | 
 reminders. useDefault |  boolean | Применяются ли к событию напоминания календаря по умолчанию. | записываемый | 
 sequence |  integer | Порядковый номер согласно iCalendar. | записываемый | 
 source. title |  string | Название источника; например, название веб-страницы или тема электронного письма. | записываемый | 
 source. url |  string | URL источника, указывающего на ресурс. Схема URL должна быть HTTP или HTTPS. | записываемый | 
 start. date |  date | Дата в формате «гггг-мм-дд», если это событие на весь день. | записываемый | 
 start. dateTime |  datetime |  Время, как комбинированное значение даты и времени (отформатированное в соответствии с RFC3339 ). Требуется смещение часового пояса, если часовой пояс явно не указан в timeZone . | записываемый | 
 start. timeZone |  string | Часовой пояс, в котором указано время. (Отформатировано как имя базы данных часовых поясов IANA, например, "Европа/Цюрих".) Для повторяющихся событий это поле является обязательным и указывает часовой пояс, в котором расширено повторение. Для одиночных событий это поле является необязательным и указывает пользовательский часовой пояс для начала/конца события. | записываемый | 
 status |  string |  Статус события. Необязательно. Возможные значения:
  | записываемый | 
 summary |  string | Название мероприятия. | записываемый | 
 transparency |  string |  Блокирует ли событие время в календаре. Необязательно. Возможные значения:
  | записываемый | 
 visibility |  string |  Видимость события. Необязательно. Возможные значения:
  | записываемый | 
Ответ
В случае успеха этот метод возвращает ресурс Events в теле ответа.
Попробуйте!
Используйте API Explorer ниже, чтобы вызвать этот метод для реальных данных и увидеть ответ.