com.lark.oapi.service.docx.v1.resource

类 ChatAnnouncementBlockChildren

java.lang.Object

com.lark.oapi.service.docx.v1.resource.ChatAnnouncementBlockChildren

public class ChatAnnouncementBlockChildren
extends Object

构造器概要

构造器

构造器和说明
ChatAnnouncementBlockChildren(Config config)

方法概要

限定符和类型	方法和说明
BatchDeleteChatAnnouncementBlockChildrenResp	batchDelete(BatchDeleteChatAnnouncementBlockChildrenReq req) 删除群公告中的块;，指定需要操作的块，删除其指定范围的子块。
BatchDeleteChatAnnouncementBlockChildrenResp	batchDelete(BatchDeleteChatAnnouncementBlockChildrenReq req, RequestOptions reqOptions) 删除群公告中的块;，指定需要操作的块，删除其指定范围的子块。
CreateChatAnnouncementBlockChildrenResp	create(CreateChatAnnouncementBlockChildrenReq req) 在群公告中创建块，在指定块的子块列表中，新创建一批子块，并放置到指定位置。
CreateChatAnnouncementBlockChildrenResp	create(CreateChatAnnouncementBlockChildrenReq req, RequestOptions reqOptions) 在群公告中创建块，在指定块的子块列表中，新创建一批子块，并放置到指定位置。
GetChatAnnouncementBlockChildrenResp	get(GetChatAnnouncementBlockChildrenReq req) 获取所有子块;，获取群公告中指定块的所有子块的富文本内容并分页返回。
GetChatAnnouncementBlockChildrenResp	get(GetChatAnnouncementBlockChildrenReq req, RequestOptions reqOptions) 获取所有子块;，获取群公告中指定块的所有子块的富文本内容并分页返回。

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ChatAnnouncementBlockChildren

public ChatAnnouncementBlockChildren(Config config)

方法详细资料

batchDelete

public BatchDeleteChatAnnouncementBlockChildrenResp batchDelete(BatchDeleteChatAnnouncementBlockChildrenReq req,
                                                                RequestOptions reqOptions)
                                                         throws Exception

删除群公告中的块;，指定需要操作的块，删除其指定范围的子块。如果操作成功，接口将返回应用删除操作后的群公告版本号。;

## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内。;- 操作内部群的群公告时，请确保当前调用身份（tenant_access_token 或 user_access_token）与对应群组在同一租户下。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/BatchDeleteChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception

batchDelete

public BatchDeleteChatAnnouncementBlockChildrenResp batchDelete(BatchDeleteChatAnnouncementBlockChildrenReq req)
                                                         throws Exception

删除群公告中的块;，指定需要操作的块，删除其指定范围的子块。如果操作成功，接口将返回应用删除操作后的群公告版本号。;

## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内。;- 操作内部群的群公告时，请确保当前调用身份（tenant_access_token 或 user_access_token）与对应群组在同一租户下。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=batch_delete&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/BatchDeleteChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception

create

public CreateChatAnnouncementBlockChildrenResp create(CreateChatAnnouncementBlockChildrenReq req,
                                                      RequestOptions reqOptions)
                                               throws Exception

在群公告中创建块，在指定块的子块列表中，新创建一批子块，并放置到指定位置。如果操作成功，接口将返回新创建子块的富文本内容。调用该接口前，你可参考[群公告概述-基本概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/upgraded-group-announcement/group-announcement-overview)了解块的父子关系规则。

**应用频率限制**：单个应用调用频率上限为每秒 5 次，超过该频率限制，接口将返回 HTTP 状态码 400 及错误码 99991400；;;**群公告频率限制**：单篇群公告并发编辑上限为每秒 3 次，超过该频率限制，接口将返回 HTTP 状态码 429，编辑操作包括：;- 创建块;- 批量更新块;- 删除块;;当请求被限频，应用需要处理限频状态码，并使用指数退避算法或其它一些频控策略降低对 API 的调用速率。;;## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内，且需要拥有群公告的编辑权限。;- 操作内部群的群公告时，请确保当前调用身份（tenant_access_token 或 user_access_token）与对应群组在同一租户下。;;## 使用限制;;- 如果群组配置了 **仅群主和群管理员可编辑群信息**，则仅有群主、群管理员，或者是创建群组且具有 **更新应用所创建群的群信息（im:chat:operate_as_owner）** 权限的机器人，可以更新群公告信息。;- 如果群组没有配置 **仅群主和群管理员可编辑群信息**，则所有群成员可以更新群公告信息。;; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/CreateChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception

create

public CreateChatAnnouncementBlockChildrenResp create(CreateChatAnnouncementBlockChildrenReq req)
                                               throws Exception

在群公告中创建块，在指定块的子块列表中，新创建一批子块，并放置到指定位置。如果操作成功，接口将返回新创建子块的富文本内容。调用该接口前，你可参考[群公告概述-基本概念](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/group/upgraded-group-announcement/group-announcement-overview)了解块的父子关系规则。

**应用频率限制**：单个应用调用频率上限为每秒 5 次，超过该频率限制，接口将返回 HTTP 状态码 400 及错误码 99991400；;;**群公告频率限制**：单篇群公告并发编辑上限为每秒 3 次，超过该频率限制，接口将返回 HTTP 状态码 429，编辑操作包括：;- 创建块;- 批量更新块;- 删除块;;当请求被限频，应用需要处理限频状态码，并使用指数退避算法或其它一些频控策略降低对 API 的调用速率。;;## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内，且需要拥有群公告的编辑权限。;- 操作内部群的群公告时，请确保当前调用身份（tenant_access_token 或 user_access_token）与对应群组在同一租户下。;;## 使用限制;;- 如果群组配置了 **仅群主和群管理员可编辑群信息**，则仅有群主、群管理员，或者是创建群组且具有 **更新应用所创建群的群信息（im:chat:operate_as_owner）** 权限的机器人，可以更新群公告信息。;- 如果群组没有配置 **仅群主和群管理员可编辑群信息**，则所有群成员可以更新群公告信息。;; ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=create&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/CreateChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception

get

public GetChatAnnouncementBlockChildrenResp get(GetChatAnnouncementBlockChildrenReq req,
                                                RequestOptions reqOptions)
                                         throws Exception

获取所有子块;，获取群公告中指定块的所有子块的富文本内容并分页返回。;

**应用频率限制**：单个应用调用频率上限为每秒 10 次，超过该频率限制，接口将返回 HTTP 状态码 400 及错误码 99991400。当请求被限频，应用需要处理限频状态码，并使用指数退避算法或其它一些频控策略降低对 API 的调用速率。;;## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内。;- 获取内部群信息时，调用当前接口的用户或者机器人必须与对应群组在同一租户下。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/GetChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception

get

public GetChatAnnouncementBlockChildrenResp get(GetChatAnnouncementBlockChildrenReq req)
                                         throws Exception

获取所有子块;，获取群公告中指定块的所有子块的富文本内容并分页返回。;

**应用频率限制**：单个应用调用频率上限为每秒 10 次，超过该频率限制，接口将返回 HTTP 状态码 400 及错误码 99991400。当请求被限频，应用需要处理限频状态码，并使用指数退避算法或其它一些频控策略降低对 API 的调用速率。;;## 前提条件;;- 应用需要开启[机器人能力](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-enable-bot-ability)。;- 调用当前接口的用户或者机器人必须在对应的群组内。;- 获取内部群信息时，调用当前接口的用户或者机器人必须与对应群组在同一租户下。 ;

官网API文档链接:https://open.feishu.cn/api-explorer?from=op_doc_tab&apiName=get&project=docx&resource=chat.announcement.block.children&version=v1 ;

使用Demo链接: https://github.com/larksuite/oapi-sdk-java/tree/v2_main/sample/src/main/java/com/lark/oapi/sample/apiall/docxv1/GetChatAnnouncementBlockChildrenSample.java ;

抛出:

Exception