Skip to content

群公告概述

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

image.png

字段说明

名称类型描述
contentstring群公告内容,以云文档序列化信息的形式展示,对应的数据结构说明参考旧版文档数据结构参考
revisionstring公告文档当前的版本号,纯数字。
create_timestring公告文档生成的时间戳(秒)
update_timestring公告文档更新的时间戳(秒)
owner_id_typestring公告文档所有者的 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_idstring公告文档所有者 ID,ID 类型与 owner_id_type 的取值一致。
modifier_id_typestring公告文档最新修改者的 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_idstring文档最新修改者 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"
}

内容来源:飞书开放平台 · 自动爬取整理