日历资源类型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:

方法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.
UpdateUpdate 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.
DeleteDelete 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.Retrieve a list of events in a calendar. The list contains single instance meetings and series masters.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. 可取值为:unknownskypeForBusinessskypeForConsumerteamsForBusinessPossible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEditcanEdit 布尔Boolean True if the user can write to the calendar, false otherwise.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 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.This property is also true for a user who has been shared a calendar and granted write access.
canSharecanShare 布尔Boolean True if the user has the permission to share the calendar, false otherwise.True if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it.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 Identifies the version of the calendar object.Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well.Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object.This allows Exchange to apply changes to the correct version of the object. Read-only.Read-only.
颜色color calendarColorcalendarColor Specifies the color theme to distinguish the calendar from other calendars in a UI.Specifies 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=-1The 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. 可取值为:unknownskypeForBusinessskypeForConsumerteamsForBusinessPossible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
idid StringString The calendar's unique identifier.The calendar's unique identifier. Read-only.Read-only.
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 If set, this represents the user who created or added the calendar.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 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.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.The calendar view for the calendar. Navigation property.Navigation property. Read-only.Read-only.
eventsevents 事件 集合Event collection The events in the calendar.The events in the calendar. Navigation property.Navigation property. Read-only.Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty 集合multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the calendar.The collection of multi-value extended properties defined for the calendar. Read-only.Read-only. Nullable.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the calendar.The collection of single-value extended properties defined for the calendar. Read-only.Read-only. Nullable.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",
  "id": "string (identifier)",
  "isRemovable": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}