新旧版本说明

飞书开放平台于 2024 年 12 月开放了新版群公告接口。本文介绍如何区分新旧版群公告，以及新旧版群公告所支持开放能力的差异。

新旧群公告区分

你可以通过调用获取群公告基本信息接口，并根据接口返回的announcement_type字段对群公告版本进行区分。

群公告类别	群公告类型相关字段	概述文档
新版群公告	docx	新版群公告概述
旧版群公告	doc	旧版群公告概述

新旧群公告接口区分

对于以下跟群公告内容相关的能力，新版群公告跟旧版群公告接口不同，不能混用。

能力	新版接口	旧版接口
获取群公告基本信息	获取群公告基本信息	获取群公告信息
编辑群公告内容	在群公告中创建块 批量更新群公告块的内容 删除群公告中的块	更新群公告信息
获取群公告富文本内容	获取群公告所有块 获取群公告块的内容 获取所有子块	获取群公告信息

常见问题

1. 为什么不在旧版群公告 OpenAPI 基础上兼容新版群公告？

旧版群公告和新版群公告的底层格式和相关协议存在完全的差异，原来的数据结构和接口协议都无法实现兼容，因此需对接到新版群公告的接口。

2. 新版群公告是否同旧版群公告一样，使用 Location 来标记位置？

旧版群公告数据结构与旧版云文档数据结构相同，使用 Location 来标记位置，详情参考旧版文档数据结构概述。 在新版群公告 OpenAPI 中，没有 Location 的概念，这也是新版和旧版底层数据结构主要区别之一。新版群公告是基于 BlockID 及其 Parent Block ID 来定位的，可以将其看成是一棵 Block 树。