资源介绍

资源定义

日历是日程的容器，并有一些额外的属性，如：标题、描述、颜色等。

字段说明

名称	类型	描述
calendar_id	string	日历实体的唯一标识id，可以通过该id查询、删除或者更新日历信息。只读字段示例值："feishu.cn_ZefWrFi6e12ds@group.calendar.feishu.cn" 获取方式：获取主日历获取日历列表搜索日历创建日历
summary	string	日历标题示例值："Public Event Calendar" 数据校验规则：最大长度：`255` 字符
description	string	日历描述示例值："Subscribe this calendar to get the latest event information." 数据校验规则：最大长度：`255` 字符
color	int	当前身份下，日历颜色 RGB 值的 int32 表示。例如，-11034625 表示 RGB 值 (87, 159, 255) 飞书客户端展示日历颜色时，会将该值映射到预设色板上最相近的颜色示例值：-11034625 当前身份：由请求 API 时的鉴权方式决定，详细说明参见API访问凭证概述
summary_alias	string	当前身份下，日历标题的备注名称示例值："Public Event Calendar (Official)" 数据校验规则：最大长度：`255` 字符当前身份：由请求 API 时的鉴权方式决定，详细说明参见API访问凭证概述
type	string	日历类型只读字段可选值有：`primary` 用户或应用的主日历`shared` 共享日历`resource` 会议室日历`google` 来源于 "Google Calendar" 的第三方日历`exchange` 来源于 "Exchange Calendar" 的第三方日历示例值：`primary`
permissions	string	日历权限可选值有：`private` 不可查看该日历`show_only_free_busy` 仅展示日程的忙碌和空闲信息`public` 可查看所有日程详情示例值：`show_only_free_busy`
role	string	当前身份对该日历的访问控制权限只读字段可选值有：`free_busy_reader` 只能看到忙碌/空闲信息`reader` 查看所有日程详情`writer` 创建及修改日程`owner` 管理日历及共享设置示例值：`owner` 当前身份：由请求 API 时的鉴权方式决定，详细说明参见API访问凭证概述
is_deleted	boolean	当前身份下，日历是否被标记为删除只读字段示例值：false 当前身份：由请求 API 时的鉴权方式决定，详细说明参见API访问凭证概述
is_third_party	boolean	该日历是否是第三方日历，第三方日历及日程为只读，不支持写入只读字段示例值：false

数据示例

{
    "calendar_id": "feishu.cn_ZefWrFi6e12ds@group.calendar.feishu.cn",
    "color": -11034625,
    "description": "Working Calendar",
    "permissions": "private",
    "role": "owner",
    "summary": "Tom",
    "summary_alias": "Tom (Working Calendar)",
    "type": "primary",
    "is_deleted": false,
    "is_third_party": false
}

资源定义#

字段说明#

数据示例#

资源定义

字段说明

数据示例