CalendarList: insert

将现有日历插入到用户的日历列表中。 立即试用查看示例

请求

HTTP 请求

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

参数

参数名称 说明
可选的查询参数
colorRgbFormat boolean 是否使用 foregroundColorbackgroundColor 字段写入日历颜色 (RGB)。如果使用此功能,基于索引的 colorId 字段将自动设置为最佳匹配选项。可选。默认值为 False。

授权

此请求需要获得以下范围的授权:

范围
https://www.googleapis.com/auth/calendar

如需了解详情,请参阅身份验证和授权页面。

请求正文

在请求正文中,提供具有以下属性的 calendarList 资源

属性名称 说明 备注
必需属性
id string 日历的标识符。
可选属性
backgroundColor string 日历的主颜色,采用十六进制格式“#0088aa”。此属性会取代基于索引的 colorId 属性。要设置或更改此属性,您需要在 insertupdatepatch 方法的参数中指定 colorRgbFormat=true。可选。 可写入
colorId string 日历的颜色。这是一个 ID,它引用了颜色定义的 calendar 部分中的条目(请参阅颜色端点)。此属性已被 backgroundColorforegroundColor 属性取代,使用这些属性时可以忽略。可选。 可写入
defaultReminders[] list 通过身份验证的用户对此日历的默认提醒。 可写入
defaultReminders[].method string 此提醒使用的方法。可能的值包括:
  • email”- 提醒通过电子邮件发送。
  • popup”- 提醒通过 UI 弹出窗口发送。

添加提醒时必填。

可写入
defaultReminders[].minutes integer 在事件开始前多少分钟应触发提醒。有效值介于 0 到 40320 之间(4 周的分钟数)。

添加提醒时必填。

可写入
foregroundColor string 日历的前景颜色,采用十六进制格式“#ffffff”。此属性会取代基于索引的 colorId 属性。要设置或更改此属性,您需要在 insertupdatepatch 方法的参数中指定 colorRgbFormat=true。可选。 可写入
hidden boolean 日历是否已在列表中隐藏。可选。此属性仅在日历处于隐藏状态时才会返回,在这种情况下,值为 true 可写入
notificationSettings object 通过身份验证的用户为此日历收到的通知。 可写入
notificationSettings.notifications[].method string 用于传送通知的方法。可能的值是:
  • email”- 通知通过电子邮件发送。

添加通知时必填。

可写入
notificationSettings.notifications[].type string 通知的类型。可能的值包括:
  • eventCreation”- 日历中有新活动时发送通知。
  • eventChange”- 更改事件时发送通知。
  • eventCancellation”- 取消活动时发送通知。
  • eventResponse”- 参加者回复活动邀请时发送通知。
  • agenda”- 包含当天活动的日程(在早上发送)。

添加通知时必填。

可写入
selected boolean 日历内容是否显示在日历界面中。可选。默认值为 False。 可写入
summaryOverride string 经过身份验证的用户为此日历设置的摘要。可选。 可写入

响应

如果成功,此方法将在响应正文中返回一项 calendarList 资源

示例

注意:此方法的代码示例并未列出所有受支持的编程语言(请参阅客户端库页面,查看受支持的语言列表)。

Java

使用 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

使用 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

使用 Ruby 客户端库

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

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

试试看!

使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。