群公告概述
群公告是群组中的公告文档,采用飞书云文档承载,每个群组只有一个群公告。通过 OpenAPI 可更新或查看群公告。

字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
content | string | 群公告内容,以云文档序列化信息的形式展示,对应的数据结构说明参考旧版文档数据结构参考。 |
revision | string | 公告文档当前的版本号,纯数字。 |
create_time | string | 公告文档生成的时间戳(秒) |
update_time | string | 公告文档更新的时间戳(秒) |
owner_id_type | string | 公告文档所有者的 ID 类型 - 如果所有者是用户,取值为open_id user_id union_id 其中之一,不同 ID 的说明参见 用户相关的 ID 概念。 - 如果所有者是机器人,为机器人应用的 app_id,详情参见通用参数。 可选值有: - user_id:标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内,一个用户的 User ID 在所有应用(包括商店应用)中都保持一致。User ID 主要用于在不同的应用间打通用户数据。 - union_id:标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的,在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID,应用开发商可以把同个用户在多个应用中的身份关联起来。 - open_id:标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。 - app_id:飞书开放平台应用的唯一标识。在创建应用时,由系统自动生成,用户不能自行修改。 |
owner_id | string | 公告文档所有者 ID,ID 类型与 owner_id_type 的取值一致。 |
modifier_id_type | string | 公告文档最新修改者的 ID 类型 - 如果修改者是用户,取值为open_id user_id union_id 其中之一,不同 ID 的说明参见 用户相关的 ID 概念。 - 如果修改者是机器人,为机器人应用的 app_id,详情参见通用参数。 可选值有: - user_id:标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内,一个用户的 User ID 在所有应用(包括商店应用)中都保持一致。User ID 主要用于在不同的应用间打通用户数据。 - union_id:标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的,在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID,应用开发商可以把同个用户在多个应用中的身份关联起来。 - open_id:标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。 - app_id:飞书开放平台应用的唯一标识。在创建应用时,由系统自动生成,用户不能自行修改。 |
modifier_id | string | 文档最新修改者 ID,ID 类型与 modifier_id_type 的取值一致。 |
数据示例
json
{
"content": "{\"title\":{\"elements\":[{\"type\":\"textRun\",\"textRun\":{\"text\":\"announcement\",\"style\":{},\"location\":{\"zoneId\":\"0\",\"startIndex\":0,\"endIndex\":12}}}],\"location\":{\"zoneId\":\"0\",\"startIndex\":0,\"endIndex\":12},\"lineId\":\"4m10Rp\"},\"body\":{\"blocks\":[{\"type\":\"paragraph\",\"paragraph\":{\"elements\":[{\"type\":\"textRun\",\"textRun\":{\"text\":\"Announcement.\",\"style\":{},\"location\":{\"zoneId\":\"0\",\"startIndex\":13,\"endIndex\":26}}}],\"location\":{\"zoneId\":\"0\",\"startIndex\":13,\"endIndex\":26},\"lineId\":\"5VYRPT\"}},{\"type\":\"paragraph\",\"paragraph\":{\"elements\":[],\"location\":{\"zoneId\":\"0\",\"startIndex\":27,\"endIndex\":27}}}]}}",
"revision": "12",
"create_time": "1609296809",
"update_time": "1609296809",
"owner_id_type": "open_id",
"owner_id": "ou_7d8a6e6df7621556ce0d21922b676706ccs",
"modifier_id_type": "open_id",
"modifier_id": "ou_7d8a6e6df7621556ce0d21922b676706ccs"
}