calendar リソース型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 collectioncalendar 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 calendar calendarcalendar 予定表オブジェクトのプロパティと関係を取得します。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 予定表オブジェクトのプロパティを更新します。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 予定表オブジェクトを削除します。Delete calendar object.
calendarView を一覧表示するList calendarView event コレクション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 コレクション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 calendarcalendar 新規または既存の予定表に、1 つ以上の単一値の拡張プロパティを作成します。Create one or more single-value extended properties in a new or existing calendar.
単一値の拡張プロパティを持つ予定表を取得するGet calendar with single-value extended property calendarcalendar $expand または $filter を使用して、単一値の拡張プロパティを含む予定表を取得します。Get calendars that contain a single-value extended property by using $expand or $filter.
複数値の拡張プロパティを作成するCreate multi-value extended property calendarcalendar 新規または既存の予定表に、1 つ以上の複数値の拡張プロパティを作成します。Create one or more multi-value extended properties in a new or existing calendar.
複数値の拡張プロパティを持つ予定表を取得するGet calendar with multi-value extended property calendarcalendar $expand を使用して、複数値の拡張プロパティを含む予定表を取得します。Get a calendar that contains a multi-value extended property by using $expand.

プロパティProperties

プロパティProperty Type 説明Description
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 ブール値Boolean ユーザーがプライベートとしてマークされている予定表アイテムを読み取れることができる場合は true、それ以外の場合は false です。True if the user can read calendar items that have been marked private, false otherwise.
changeKeychangeKey StringString 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 文字列String The calendar's unique identifier.The calendar's unique identifier. Read-only.Read-only.
isRemovableisRemovable ブール値Boolean このユーザーの予定表がユーザーのメールボックスから削除できるかどうかを示します。Indicates whether this user calendar can be deleted from the user mailbox.
isTallyingResponsesisTallyingResponses ブール値Boolean このユーザーの予定表が会議依頼の応答の追跡をサポートしているかどうかを示します。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 説明Description
calendarPermissionscalendarPermissions calendarPermission コレクションcalendarPermission collection 予定表を共有しているユーザーのアクセス許可です。The permissions of the users with whom the calendar is shared.
calendarViewcalendarView Event コレクションEvent collection The calendar view for the calendar.The calendar view for the calendar. Navigation property.Navigation property. Read-only.Read-only.
eventsevents Event collectionEvent collection The events in the calendar.The events in the calendar. Navigation property.Navigation property. Read-only.Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty collectionmultiValueLegacyExtendedProperty 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"}
}