calendar リソース型calendar resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

イベントのコンテナーである予定表です。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.

メソッド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. ユーザーの予定表、または 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.

プロパティ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、それ以外の場合は 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.
colorcolor StringString 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
defaultOnlineMeetingProviderdefaultOnlineMeetingProvider onlineMeetingProviderTypeonlineMeetingProviderType この予定表から送信された会議の既定のオンライン会議プロバイダーです。The default online meeting provider for meetings sent from this calendar. 使用可能な値: unknownskypeForBusinessskypeForConsumerteamsForBusinessPossible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColorhexColor 文字列String 予定表の色。3 つの 16 進数値による 16 進数の色コードです。それぞれの範囲は 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.
idid StringString グループの一意識別子。読み取り専用です。The group's unique identifier. Read-only.
isDefaultCalendarisDefaultCalendar ブール値Boolean これが既定の予定表 (新しいイベントが既定で作成される予定表) の場合は true です。それ以外の場合は false です。True if this is the default calendar where new events are created by default, false otherwise.
isRemovableIsRemovable ブール値Boolean このユーザーの予定表がユーザーのメールボックスから削除できるかどうかを示します。Indicates whether this user calendar can be deleted from the user mailbox.
isSharedisShared BooleanBoolean ユーザーが他のユーザーと予定表を共有している場合は true、それ以外の場合は false です。True if the user has shared the calendar with other users, false otherwise. 予定表を共有できるのはその予定表を作成したユーザーのみであるため、同じユーザーに対して isSharedisSharedWithMe を true にすることはできません。Since only the user who created the calendar can share it, isShared and isSharedWithMe cannot be true for the same user.
isSharedWithMeisSharedWithMe BooleanBoolean ユーザーが予定表を共有している場合は true、それ以外の場合は false です。予定表の所有者の場合、このプロパティは常に false です。True if the user has been shared this calendar, false otherwise. This property is always false for a calendar owner.
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 設定すると、これは予定表を作成または追加したユーザーを表します。ユーザーが作成または追加した予定表の場合、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 説明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. Navigation property. Read-only.
eventsevents event コレクションevent 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

{
  "allowedOnlineMeetingProviders": ["string"],
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "defaultOnlineMeetingProvider": "string",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isRemovable": "boolean",
  "isShared": "boolean",
  "isSharedWithMe": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}