このAPIは変更される可能性があります。プレビュー期間中、開発者からのフィードバックに基づいてバグ修正や新機能がリリースされる予定です。
Retrieves a list of sessions, given the provided time range, filtering, and paging.
To query for event instances within a specified time range of up to 1 year, provide a startDate
そして endDate
.
Query Sessions runs with these defaults, which you can override:
EVENT
are returned. An event is a single or recurring session that appears in a calendar, for example an appointment or a class.instances
is true. This means only single session instances and instances of recurring sessions are returned.includeExternal
is false. This means that sessions imported from connected external calendars are not returned.NO_PI
fieldset. This means they don't contain personal information.query.cursorPaging.limit
is 100
.Note the following limitations, which you can't override:
start.timestamp
in ASC
order.To query only for working hours sessions, set タイプ
to WORKING_HOURS
. A working hours session is a single or recurring session that defines availability in a schedule.
To query for all session types, including events and working hours sessions, set タイプ
to ALL
.
To query for recurring session pattern definitions, set instances
to 擬似
. In this case, fromDate
そして toDate
may be more than 1 year apart.
To return session objects including personal information, use the ALL_PI
fieldset. This requires the Read Bookings Calendar - Including Participants or the Manage Bookings Services and Settings or the Manage Business Calendar permission scope.
For details on fieldsets, see Sessions: Supported Fieldsets.
For field support for filters, see Sessions: Supported Filters.
To learn about working with Query endpoints in general, see API Query Language and Field Projection.