日历资源类型calendar resource type
命名空间：microsoft.graphNamespace: microsoft.graph
日历即事件容器。A calendar which is a container for events. 它可以是 用户的日历，或者 Microsoft 365 组的默认日历。It can be a calendar for a user, or the default calendar of a Microsoft 365 group.
注意： 与用户日历和组日历交互的方式稍有不同：Note: There are a few minor differences in the way you can interact with user calendars and group calendars:
- 只能将用户日历组织到 calendarGroup 中。You can organize only user calendars in a calendarGroup.
- Outlook 将代表组自动接受所有会议请求。Outlook automatically accepts all meeting requests on behalf of groups. 只能接受、暂时接受或拒绝用户日历中的会议请求。You can accept, tentatively accept, or decline meeting requests for user calendars only.
- Outlook 不支持对组事件提供提醒。Outlook doesn't support reminders for group events. 只能推迟或取消用户日历的提醒。You can snooze or dismiss a reminder for user calendars only.
方法Methods
| 方法Method | 返回类型Return Type | 说明Description |
|---|---|---|
| 列出日历List calendars | 日历 集合calendar collection | 获取所有用户的日历，或者获取默认或其他特定日历组中的日历。Get all the user's calendars, or the calendars in the default or other specific calendar group. |
| 创建日历Create calendar | calendarcalendar | 在默认日历组或用户的指定日历组中新建日历。Create a new calendar in the default calendar group or specified calendar group for a user. |
| Get calendarGet calendar | calendarcalendar | 获取 calendar 对象的属性和关系。Get the properties and relationships of a calendar object. 可以是用户的日历，也可以是 Microsoft 365 组的默认日历。The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
| 更新Update | calendarcalendar | 更新 calendar 对象的属性。Update the properties of a calendar object. 可以是用户的日历，也可以是 Microsoft 365 组的默认日历。The calendar can be one for a user, or the default calendar of a Microsoft 365 group. |
| 删除Delete | 无None | 删除 calendar 对象。Delete calendar object. |
| 列出 calendarViewList calendarView | 事件 集合event collection | 从用户的主日历 (../me/calendarview) 或指定日历中，获取由时间范围定义的日历视图中的事件发生次数、异常和单个实例。Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's primary calendar (../me/calendarview) or from a specified calendar. |
| 列出事件List events | 事件 集合event collection | 检索日历中的事件列表。该列表包含单实例会议和系列主控事件。Retrieve a list of events in a calendar. The list contains single instance meetings and series masters. |
| 创建事件Create event | eventevent | 在默认或指定日历中创建新事件。Create a new event in the default or specified calendar. |
| getSchedulegetSchedule | scheduleInformation 集合scheduleInformation collection | 获取用户、通讯组列表或资源在指定时间段内的忙/闲状态信息。Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period. |
| findMeetingTimesfindMeetingTimes | meetingTimeSuggestionsResultmeetingTimeSuggestionsResult | 根据组织者和与会者忙/闲状态以及时间或地点约束，建议会议时间和地点。Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints. |
| 创建单值扩展属性Create single-value extended property | 日历calendar | 在新建或现有日历中创建一个或多个单值扩展属性。Create one or more single-value extended properties in a new or existing calendar. |
| 获取包含单值扩展属性的日历Get calendar with single-value extended property | 日历calendar | 通过使用 $expand 或 $filter 获取包含一个单值扩展属性的日历。Get calendars that contain a single-value extended property by using $expand or $filter. |
| 创建多值扩展属性Create multi-value extended property | 日历calendar | 在新建或现有的日历中创建一个或多个多值扩展属性。Create one or more multi-value extended properties in a new or existing calendar. |
| 获取包含多值扩展属性的日历Get calendar with multi-value extended property | 日历calendar | 使用 $expand 获取包含一个多值扩展属性的日历。Get a calendar that contains a multi-value extended property by using $expand. |
属性Properties
| 属性Property | 类型Type | DescriptionDescription |
|---|---|---|
| allowedOnlineMeetingProvidersallowedOnlineMeetingProviders | string 集合string collection | 表示此日历中可用于创建联机会议的联机会议服务提供商。Represent the online meeting service providers that can be used to create online meetings in this calendar. 可取值为：unknown、skypeForBusiness、skypeForConsumer、teamsForBusiness。Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness. |
| canEditcanEdit | 布尔Boolean | 如果用户可以写入日历则为 true，否则为 false。对于创建此日历的用户，此属性为 true。此属性对于共享日历并且授予写入访问权限的用户同样为 true。True if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access. |
| canSharecanShare | 布尔Boolean | 如果用户有权共享日历则为 ture，否则为 false。只有创建日历的用户才可以进行共享。True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it. |
| canViewPrivateItemscanViewPrivateItems | BooleanBoolean | 如果用户可以读取已标记为私有的日历项，则为 true，否则返回 false。True if the user can read calendar items that have been marked private, false otherwise. |
| changeKeychangeKey | 字符串String | 标识 calendar 对象的版本。每次日历更改时，changeKey 也将更改。这样，Exchange 可以将更改应用于该对象的正确版本。只读。Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only. |
| 颜色color | calendarColorcalendarColor | 在 UI 中指定将该日历与其他日历区分开来的颜色主题。属性值有：LightBlue=0、LightGreen=1、LightOrange=2、LightGray=3、LightYellow=4、LightTeal=5、LightPink=6、LightBrown=7、LightRed=8、MaxColor=9、Auto=-1Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1 |
| defaultOnlineMeetingProviderdefaultOnlineMeetingProvider | onlineMeetingProviderTypeonlineMeetingProviderType | 从此日历发送的会议的默认联机会议提供商。The default online meeting provider for meetings sent from this calendar. 可取值为：unknown、skypeForBusiness、skypeForConsumer、teamsForBusiness。Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness. |
| hexColorhexColor | StringString | 日历颜色，使用十六进制颜色代码表示，其中包含三个十六进制值，每个值介于 00 到 FF 之间，表示 RGB 颜色空间中颜色的红色、绿色或蓝色组件。The calendar color, expressed in a hex color code of three hexidecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. 若用户从未明确设置日历的颜色，则此属性为空。If the user has never explicitly set a color for the calendar, this property is empty. 只读。Read-only. |
| idid | StringString | 日历的唯一标识符。只读。The calendar's unique identifier. Read-only. |
| isDefaultCalendarisDefaultCalendar | BooleanBoolean | 若此为默认用于新建事件的默认日志则为 True，反之为 false。True if this is the default calendar where new events are created by default, false otherwise. |
| isRemovableisRemovable | BooleanBoolean | 表示是否可以从用户邮箱删除此用户日志。Indicates whether this user calendar can be deleted from the user mailbox. |
| isTallyingResponsesisTallyingResponses | BooleanBoolean | 表示此用户日历是否支持会议响应跟踪。Indicates whether this user calendar supports tracking of meeting responses. 仅从用户的主日志发送的会议邀请支持会议响应跟踪。Only meeting invites sent from users' primary calendars support tracking of meeting responses. |
| namename | StringString | 日历名称。The calendar name. |
| ownerowner | emailAddressemailAddress | 如果设置，则表示创建或添加日历的用户。对于用户创建或添加的日历，将 owner 属性设置为用户。对于与用户共享的日历，将 owner 属性设置为与此用户共享该日历的人员。If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user. |
关系Relationships
| 关系Relationship | 类型Type | DescriptionDescription |
|---|---|---|
| calendarPermissionscalendarPermissions | calendarPermission 集合calendarPermission collection | 共享日历的用户的权限。The permissions of the users with whom the calendar is shared. |
| calendarViewcalendarView | 事件 集合Event collection | 日历的日历视图。导航属性。只读。The calendar view for the calendar. Navigation property. Read-only. |
| eventsevents | 事件 集合Event collection | 日历中的事件。导航属性。只读。The events in the calendar. Navigation property. Read-only. |
| multiValueExtendedPropertiesmultiValueExtendedProperties | multiValueLegacyExtendedProperty 集合multiValueLegacyExtendedProperty collection | 为日历定义的多值扩展属性的集合。只读。可为 Null。The collection of multi-value extended properties defined for the calendar. Read-only. Nullable. |
| singleValueExtendedPropertiessingleValueExtendedProperties | singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection | 为日历定义的单值扩展属性的集合。只读。可为 Null。The collection of single-value extended properties defined for the calendar. Read-only. Nullable. |
JSON 表示形式JSON representation
下面是资源的 JSON 表示形式。Here is a JSON representation of the resource
{
"allowedOnlineMeetingProviders": ["string"],
"canEdit": "boolean",
"canShare": "boolean",
"canViewPrivateItems": "boolean",
"changeKey": "string",
"color": "String",
"defaultOnlineMeetingProvider": "string",
"hexColor": "String",
"id": "string (identifier)",
"isDefaultCalendar": "boolean",
"isRemovable": "boolean",
"isTallyingResponses": "boolean",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.emailAddress"}
}