calendar リソース型calendar resource type

イベントのコンテナーである予定表です。A calendar which is a container for events. ユーザーの予定表、または Office 365 グループの既定の予定表のいずれかを指定できます。It can be a calendar for a user, or the default calendar of an Office 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.


メソッド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. ユーザーの予定表、または Office 365 のグループの既定の予定表のいずれかを指定できます。The calendar can be one for a user, or the default calendar of an Office 365 group.
更新するUpdate calendarcalendar 予定表オブジェクトのプロパティを更新します。Update the properties of a calendar object. ユーザーの予定表、または Office 365 のグループの既定の予定表のいずれかを指定できます。The calendar can be one for a user, or the default calendar of an Office 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. 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.


プロパティProperty Type 説明Description
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 ユーザーに予定表を共有するためのアクセス許可がある場合は true、それ以外の場合は 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 ブール値Boolean ユーザーがプライベートとしてマークされている予定表アイテムを読み取れることができる場合は true、それ以外の場合は false です。True if the user can read calendar items that have been marked private, false otherwise.
changeKeychangeKey StringString 予定表オブジェクトのバージョンを識別します。予定表を変更するたびに 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 で予定表を他の予定表から区別するための配色テーマを指定します。プロパティ値は次のとおりです。薄い青=0、薄い緑=1、薄いオレンジ=2、薄い灰色=3、薄い黄=4、薄い青緑=5、薄いピンク=6、薄い茶色=7、薄い赤=8、最大色=9、自動=-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
idid StringString グループの一意識別子。読み取り専用です。The group's unique identifier. Read-only.
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.


リレーションシップRelationship Type 説明Description
calendarViewcalendarView Event collectionEvent collection 予定表のカレンダー ビュー。ナビゲーション プロパティ。読み取り専用。The calendar view for the calendar. Navigation property. Read-only.
eventsevents Event collectionEvent collection 予定表内のイベント。ナビゲーション プロパティ。読み取り専用。The events in the calendar. Navigation property. Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty collectionmultiValueLegacyExtendedProperty 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

  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "id": "string (identifier)",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}