CalendarList: insert

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

Запрос

HTTP-запрос

POST https://www.googleapis.com/calendar/v3/users/me/calendarList

Параметры

Имя параметра Ценить Описание
Необязательные параметры запроса
colorRgbFormat boolean Следует ли использовать поля foregroundColor и backgroundColor для записи цветов календаря (RGB). Если эта функция используется, в поле colorId на основе индекса автоматически будет установлен вариант наилучшего соответствия. Необязательный. По умолчанию установлено значение Ложь.

Авторизация

Этот запрос требует авторизации со следующей областью действия:

Объем
https://www.googleapis.com/auth/calendar

Дополнительную информацию см. на странице аутентификации и авторизации .

Тело запроса

В теле запроса укажите ресурс CalendarList со следующими свойствами:

Имя свойства Ценить Описание Примечания
Обязательные свойства
id string Идентификатор календаря.
Дополнительные свойства
backgroundColor string Основной цвет календаря в шестнадцатеричном формате « #0088aa ». Это свойство заменяет свойство colorId на основе индекса. Чтобы установить или изменить это свойство, вам необходимо указать colorRgbFormat=true в параметрах методов вставки , обновления и исправления . Необязательный. записываемый
colorId string Цвет календаря. Это идентификатор, ссылающийся на запись в разделе calendar определения цветов (см. конечную точку цветов ). Это свойство заменяется свойствами backgroundColor и foregroundColor , и его можно игнорировать при использовании этих свойств. Необязательный. записываемый
defaultReminders[] list Напоминания по умолчанию, которые аутентифицированный пользователь имеет для этого календаря. записываемый
defaultReminders[]. method string Метод, используемый в этом напоминании. Возможные значения:
  • « email » — напоминания отправляются по электронной почте.
  • « popup » — напоминания отправляются через всплывающее окно пользовательского интерфейса.

Требуется при добавлении напоминания.

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

Требуется при добавлении напоминания.

записываемый
foregroundColor string Цвет переднего плана календаря в шестнадцатеричном формате « #ffffff ». Это свойство заменяет свойство colorId на основе индекса. Чтобы установить или изменить это свойство, вам необходимо указать colorRgbFormat=true в параметрах методов вставки , обновления и исправления . Необязательный. записываемый
hidden boolean Был ли календарь скрыт из списка. Необязательный. Атрибут возвращается только в том случае, если календарь скрыт, и в этом случае значение равно true . записываемый
notificationSettings object Уведомления, которые получает авторизованный пользователь для этого календаря. записываемый
notificationSettings.notifications[]. method string Метод, используемый для доставки уведомления. Возможное значение:
  • « email » — уведомления отправляются по электронной почте.

Требуется при добавлении уведомления.

записываемый
notificationSettings.notifications[]. type string Тип уведомления. Возможные значения:
  • « eventCreation » — уведомление отправляется, когда в календарь добавляется новое событие.
  • « eventChange » — уведомление отправляется при изменении события.
  • « eventCancellation » — уведомление отправляется при отмене события.
  • « eventResponse » — уведомление отправляется, когда участник отвечает на приглашение на мероприятие.
  • « agenda » — повестка дня с событиями дня (рассылается утром).

Требуется при добавлении уведомления.

записываемый
selected boolean Отображается ли содержимое календаря в пользовательском интерфейсе календаря. Необязательный. По умолчанию установлено значение Ложь. записываемый
summaryOverride string Сводка, которую авторизованный пользователь установил для этого календаря. Необязательный. записываемый

Ответ

В случае успеха этот метод возвращает ресурс CalendarList в теле ответа.

Примеры

Примечание. Примеры кода, доступные для этого метода, не представляют все поддерживаемые языки программирования (список поддерживаемых языков см. на странице клиентских библиотек ).

Ява

Использует клиентскую библиотеку Java .

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.CalendarListEntry;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Create a new calendar list entry
CalendarListEntry calendarListEntry = new CalendarListEntry();
calendarListEntry.setId("calendarId");

// Insert the new calendar list entry
CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute();

System.out.println(createdCalendarListEntry.getSummary());

Питон

Использует клиентскую библиотеку Python .

calendar_list_entry = {
    'id': 'calendarId'
}

created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute()

print created_calendar_list_entry['summary']

PHP

Использует клиентскую библиотеку PHP .

$calendarListEntry = new Google_Service_Calendar_CalendarListEntry();
$calendarListEntry->setId("calendarId");

$createdCalendarListEntry = $service->calendarList->insert($calendarListEntry);

echo $createdCalendarListEntry->getSummary();

Руби

Использует клиентскую библиотеку Ruby .

entry = Google::Apis::CalendarV3::CalendarListEntry.new(
 id: 'calendarId'
)

result = client.insert_calendar_list(entry)
print result.summary

Попробуйте!

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