イベントを一覧表示するList events

名前空間: microsoft.graphNamespace: microsoft.graph

予定表のイベント一覧を取得します。Retrieve a list of events in a calendar. ユーザーの予定表、または Office 365 グループの既定の予定表のいずれかを指定できます。The calendar can be one for a user, or the default calendar of an Office 365 group. イベントの一覧には、単一インスタンスの会議と定期的なマスターが含まれています。The list of events contains single instance meetings and series masters.

拡張イベントのインスタンスを取得すると、予定表ビューを取得するまたはイベントのインスタンスを取得することができます。To get expanded event instances, you can get the calendar view, or get the instances of an event.

アクセス許可Permissions

イベントが含まれている予定表の種類および要求されたアクセス許可の種類 (委任またはアプリケーション) に応じて、この API を呼び出すには、次のいずれかの権限が必要です。Depending on the type of calendar that the events are in and the permission type (delegated or application) requested, one of the following permissions is required to call this API. アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。To learn more, including how to choose permissions, see Permissions.

予定表Calendar 委任 (職場または学校のアカウント)Delegated (work or school account) 委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) アプリケーションApplication
ユーザーの予定表user calendar Calendars.Read、Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read、Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite Calendars.Read、Calendars.ReadWriteCalendars.Read, Calendars.ReadWrite
グループ予定表group calendar Group.Read.All、Group.ReadWrite.AllGroup.Read.All, Group.ReadWrite.All サポートされていません。Not supported. サポートされていません。Not supported.

HTTP 要求HTTP request

ユーザーまたはグループの既定の予定表A user's or group's default calendar.

GET /me/calendar/events
GET /users/{id | userPrincipalName}/calendar/events
GET /groups/{id}/calendar/events

既定の calendarGroup のユーザーの予定表A user's calendar in the default calendarGroup.

GET /me/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendars/{id}/events

GET /me/calendarGroup/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendarGroup/calendars/{id}/events

指定の calendarGroup のユーザーの 予定表A user's calendar in a specific calendarGroup.

GET /me/calendarGroups/{id}/calendars/{id}/events
GET /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events

オプションのクエリ パラメーターOptional query parameters

このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。This method supports the OData Query Parameters to help customize the response.

要求ヘッダーRequest headers

名前Name 種類Type 説明Description
AuthorizationAuthorization stringstring ベアラー {トークン}。必須。Bearer {token}. Required.
優先: outlook.timezonePrefer: outlook.timezone stringstring これを使用して、応答内の開始および終了時刻のタイム ゾーンを指定します。Use this to specify the time zone for start and end times in the response. 指定しない場合、これらの時刻値は UTC で返されます。If not specified, those time values are returned in UTC. 省略可能。Optional.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で Event オブジェクトのコレクションを返します。If successful, this method returns a 200 OK response code and collection of Event objects in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/calendar/events
応答Response

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 354

{
  "value": [
    {
      "originalStartTimeZone": "originalStartTimeZone-value",
      "originalEndTimeZone": "originalEndTimeZone-value",
      "responseStatus": {
        "response": "",
        "time": "datetime-value"
      },
      "iCalUId": "iCalUId-value",
      "reminderMinutesBeforeStart": 99,
      "isReminderOn": true
    }
  ]
}