ReadCalendarEvent¶
按 id 读取一个日历事件:消息、文档或电子邮件中日历事件提及(blockName calendar)的 documentId,或日历工具返回的 eventId。返回该提及的预览卡片所显示的内容:标题、时间、地点、描述(截断)、组织者、访客人数,以及是否重复。ReadContent 和 ReadMetadata 仅读取文档;读取日历事件请使用此工具。
access 表示用户持有该会议的方式,与卡片所示一致。on_your_calendar:用户自己的事件(由用户组织,或由委派收件箱持有)。invited:用户是访客。snapshot:用户为共享会议添加的私人副本;它不会跟随组织者的更改,且答复或新访客永远不会送达原会议。在这三种情况下,可对 UpdateCalendarEvent 和 DeleteCalendarEvent 使用的 eventId 是用户自己的副本。shared_with_you:有人将他们的副本共享到了用户所属的频道,且该会议不在用户的任何日历上。此时该事件对用户是只读的;AddSharedCalendarEvent 会添加它的一个快照,canRequestToJoin 和 joinRequestStatus 表示用户是否可以请求共享者将其添加为访客,用户可从事件卡片上发起该请求。要读取重复事件中的某一次实例,请传入该提及的 occurrenceKey 块参数。
参数¶
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
eventId |
string | 是 | 日历事件 id:日历提及的 documentId,或日历工具返回的 eventId。 |
occurrenceKey |
string | 否 | 要读取的重复事件实例:该提及的 occurrenceKey 块参数,或 ListCalendarEvents 返回的 recurrenceId。省略时读取下一个即将到来的实例;否则读取最近已过去的一个实例;否则读取系列起点。 |
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 macro3/macro