calendarView を一覧表示する
名前空間: microsoft.graph
グループの既定の予定表から、時間範囲で定義した予定表ビューのイベントの発生、例外、および単一インスタンスを取得します。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | Group.Read.All、Group.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | サポートされていません。 |
HTTP 要求
GET /groups/{id}/calendarView?startDateTime={start_datetime}&endDateTime={end_datetime}
クエリ パラメーター
要求 URL に、次の必須のクエリ パラメーターを値で指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
| startDateTime | 文字列 | 時間範囲の開始日時は、ISO 8601 形式で表されます。例: "2019-11-08T19:00:00-08:00"。 |
| endDateTime | 文字列 | 時間範囲の終了日時は、ISO 8601 形式で表されます。例: "2019-11-08T20:00:00-08:00"。 |
startDateTime および endDateTime の値は、値に指定されたタイムゾーン オフセットを使用して解釈され、ヘッダーが存在する場合は、Prefer: outlook.timezone ヘッダーの値に影響されません。 タイムゾーン オフセットが値に含まれていない場合、UTC と解釈されます。
また、このメソッドは応答をカスタマイズするための一部の OData クエリ パラメーターもサポートします。
注意
イベントの createdDateTime プロパティおよび lastModifiedDateTime プロパティは、$select をサポートしません。 これらの値を取得するには、calendarView にクエリするだけで、$select を適用しません。
要求ヘッダー
| 名前 | 型 | 説明 |
|---|---|---|
| Authorization | string | ベアラー {token}。必須。 |
| 優先: outlook.timezone | string | これを使用して、応答内の開始および終了時刻のタイム ゾーンを指定します。指定しなかった場合、時刻の値は UTC で返されます。オプション。 |
| Prefer: outlook.body-content-type | string | body プロパティが返されるときの形式です。 値は、"text" または "html" になります。 この Prefer ヘッダーが指定されている場合、Preference-Applied ヘッダーが確認として返されます。 このヘッダーが指定されていない場合は、body プロパティが HTML 形式で返されます。 省略可能。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で event オブジェクトのコレクションを返します。
例
要求
次の例では、イベントの本文をテキスト形式で返すよう要求します。
GET https://graph.microsoft.com/v1.0/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/calendarView?startDateTime=2017-01-01T19:00:00-08:00&endDateTime=2017-10-01T19:00:00.00-08:00
Prefer: outlook.body-content-type="text"
応答
応答の例を次に示します。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
Preference-Applied: outlook.body-content-type="text"
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups('02bd9fd6-8f93-4758-87c3-1fb73740a315')/calendarView",
"@odata.nextLink":"https://graph.microsoft.com/v1.0/groups/02bd9fd6-8f93-4758-87c3-1fb73740a315/calendarView?startDateTime=2017-01-01T19%3a00%3a00.0000000&endDateTime=2017-10-01T19%3a00%3a00.00&$skip=10",
"value":[
{
"@odata.etag":"W/\"xPZF2y46pEiVBni87OnrpgAAFq78Xw==\"",
"id":"AAMkAGI5MWYJOwAAEA==",
"createdDateTime":"2017-07-31T18:59:01.982289Z",
"lastModifiedDateTime":"2017-09-06T04:29:38.6647687Z",
"changeKey":"xPZF2y46pEiVBni87OnrpgAAFq78Xw==",
"categories":[
],
"originalStartTimeZone":"Eastern Standard Time",
"originalEndTimeZone":"Eastern Standard Time",
"iCalUId":"040000008200E00074C5B7101A82E00807E1080E824DDB122F0AD301000000000000000010000000824A8905B038D54AA7735F117B3442ED",
"reminderMinutesBeforeStart":15,
"isReminderOn":true,
"hasAttachments":false,
"subject":"New Training Plans",
"bodyPreview":"Meeting to plan new trainings.\r\n\r\n\r\n\r\nJoin Microsoft Teams Online Meeting<https://teams.microsoft.com/l/meetup-join/19%3a900876baa3134907b0dcb41a0d220e31%40thread.skype/1501527539926?tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35>",
"importance":"normal",
"sensitivity":"normal",
"isAllDay":false,
"isCancelled":false,
"isOrganizer":true,
"responseRequested":true,
"seriesMasterId":null,
"showAs":"busy",
"type":"singleInstance",
"webLink":"https://outlook.office365.com/owa/?itemid=AAMkAGI5MWYJOwAAEA%3D%3D&exvsurl=1&path=/calendar/item",
"onlineMeetingUrl":null,
"responseStatus":{
"response":"organizer",
"time":"0001-01-01T00:00:00Z"
},
"body":{
"contentType":"text",
"content":"Meeting to plan new trainings.\r\n\r\n\r\n\r\nJoin Microsoft Teams Online Meeting<https://teams.microsoft.com/l/meetup-join/19%3a900876baa3134907b0dcb41a0d220e31%40thread.skype/1501527539926?tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35>\r\n"
},
"start":{
"dateTime":"2017-08-14T21:00:00.0000000",
"timeZone":"UTC"
},
"end":{
"dateTime":"2017-08-14T22:00:00.0000000",
"timeZone":"UTC"
},
"location":{
"displayName":"HR Taskforce / Facilities"
},
"recurrence":null,
"attendees":[
{
"type":"required",
"status":{
"response":"none",
"time":"0001-01-01T00:00:00Z"
},
"emailAddress":{
"name":"HR Taskforce",
"address":"HRTaskforce@contoso.onmicrosoft.com"
}
},
{
"type":"required",
"status":{
"response":"none",
"time":"0001-01-01T00:00:00Z"
},
"emailAddress":{
"name":"Megan Bowen",
"address":"MeganB@contoso.onmicrosoft.com"
}
}
],
"organizer":{
"emailAddress":{
"name":"HR Taskforce",
"address":"HRTaskforce@contoso.onmicrosoft.com"
}
}
},
{
"@odata.etag":"W/\"xPZF2y46pEiVBni87OnrpgAAFq78Xw==\"",
"id":"AAMkAGI5MWYJOwAAEA==",
"createdDateTime":"2017-07-31T18:59:01.982289Z",
"lastModifiedDateTime":"2017-09-06T04:29:38.6647687Z",
"changeKey":"xPZF2y46pEiVBni87OnrpgAAFq78Xw==",
"categories":[
],
"originalStartTimeZone":"Eastern Standard Time",
"originalEndTimeZone":"Eastern Standard Time",
"iCalUId":"040000008200E00074C5B7101A82E00807E10810824DDB122F0AD301000000000000000010000000824A8905B038D54AA7735F117B3442ED",
"reminderMinutesBeforeStart":15,
"isReminderOn":true,
"hasAttachments":false,
"subject":"New Training Plans",
"bodyPreview":"Follow-up meeting to plan new trainings.\r\n\r\n\r\n\r\nJoin Microsoft Teams Online Meeting<https://teams.microsoft.com/l/meetup-join/19%3a900876baa3134907b0dcb41a0d220e31%40thread.skype/1501527539926?tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35>",
"importance":"normal",
"sensitivity":"normal",
"isAllDay":false,
"isCancelled":false,
"isOrganizer":true,
"responseRequested":true,
"seriesMasterId":null,
"showAs":"busy",
"type":"singleInstance",
"webLink":"https://outlook.office365.com/owa/?itemid=AAMkAGI5MWYJOwAAEA%3D%3D&exvsurl=1&path=/calendar/item",
"onlineMeetingUrl":null,
"responseStatus":{
"response":"organizer",
"time":"0001-01-01T00:00:00Z"
},
"body":{
"contentType":"text",
"content":"Meeting to plan new trainings.\r\n\r\n\r\n\r\nJoin Microsoft Teams Online Meeting<https://teams.microsoft.com/l/meetup-join/19%3a900876baa3134907b0dcb41a0d220e31%40thread.skype/1501527539926?tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35>\r\n"
},
"start":{
"dateTime":"2017-08-16T21:00:00.0000000",
"timeZone":"UTC"
},
"end":{
"dateTime":"2017-08-16T22:00:00.0000000",
"timeZone":"UTC"
},
"location":{
"displayName":"HR Taskforce / Facilities"
},
"recurrence":null,
"attendees":[
{
"type":"required",
"status":{
"response":"none",
"time":"0001-01-01T00:00:00Z"
},
"emailAddress":{
"name":"HR Taskforce",
"address":"HRTaskforce@contoso.onmicrosoft.com"
}
},
{
"type":"required",
"status":{
"response":"none",
"time":"0001-01-01T00:00:00Z"
},
"emailAddress":{
"name":"Megan Bowen",
"address":"MeganB@contoso.onmicrosoft.com"
}
}
],
"organizer":{
"emailAddress":{
"name":"HR Taskforce",
"address":"HRTaskforce@contoso.onmicrosoft.com"
}
}
}
]
}
フィードバック
フィードバックの送信と表示