跳到主要内容

查询时间范围内的日程

GET/v2/users/:email/calendars/:calendarId/eventsview

查询指定日历在 UTC 时间区间 [startTime, endTime) 内出现的日程，并通过 cursor 分页。循环日程会展开为该时间范围内的单次日程。

Request​

Path parameters

    email stringrequired
    calendarId stringrequired

Query parameters

    startTime string

    视图开始utc时间

    endTime string

    视图结束utc时间

    cursor string

    分页光标

响应

    nextCursor string

    分页光标

    hasMore boolean

    是否已结束

    events object[]
    id string

    日程id

    type enum

    日程类型

    • singleInstance: 单次日程
    • seriesMaster: 循环主日程
    • occurrence: 循环单次日程
    • exception: 循环例外日程

    Possible values: [singleInstance, seriesMaster, occurrence, exception]

    seriesMasterId string

    主日程id，type=occurrence/exception时生效

    createdTime string<date-time>

    日程创建时间

    lastModifiedTime string<date-time>

    日程最后修改时间

    isOrganizer boolean

    是否日程组织者

    isCancelled boolean

    是否日程已取消

    isAllDay boolean

    是否全天日程

    hasAttachments boolean

    日程是否包含附件

    subject string

    日程主题

    organizer object

    日程组织者

    email string

    人员或实体的电子邮件地址

    name string

    人员或实体的显示名称

    locations object[]

    日程地点

    type enum
    • defaultLocation:

    Possible values: [defaultLocation]

    name string
    startUtc object

    日程开始utc时间

    time string<date-time>

    非全天日程生效

    date string

    全天日程生效

    endUtc object

    日程结束utc时间

    time string<date-time>

    非全天日程生效

    date string

    全天日程生效

    reminders object[]

    日程提醒

    method enum
    • display:

    Possible values: [display]

    minutes number<int32>

    提前N分钟显示提醒

    responseStatus enum
    • organizer: 会议组织者
    • tentative: 暂定
    • accepted: 已接受
    • declined: 已拒绝
    • notResponded: 未响应

    Possible values: [organizer, tentative, accepted, declined, notResponded]

    calendarId string

    日程所在日历文件夹id

错误

400Bad Request
401

访问未授权，请检查是否传递了正确的授权token

403

无API访问权限，请在域管的应用管理页面完成相关授权

404Not Found