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

类 ChatAnnouncementBlock

java.lang.Object

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

public class ChatAnnouncementBlock
extends Object

构造器概要

构造器

构造器和说明
ChatAnnouncementBlock(Config config)

方法概要

限定符和类型	方法和说明
BatchUpdateChatAnnouncementBlockResp	batchUpdate(BatchUpdateChatAnnouncementBlockReq req) 批量更新群公告块的内容，批量更新块的富文本内容。
BatchUpdateChatAnnouncementBlockResp	batchUpdate(BatchUpdateChatAnnouncementBlockReq req, RequestOptions reqOptions) 批量更新群公告块的内容，批量更新块的富文本内容。
GetChatAnnouncementBlockResp	get(GetChatAnnouncementBlockReq req) 获取群公告块的内容;，获取指定块的富文本内容。
GetChatAnnouncementBlockResp	get(GetChatAnnouncementBlockReq req, RequestOptions reqOptions) 获取群公告块的内容;，获取指定块的富文本内容。
ListChatAnnouncementBlockResp	list(ListChatAnnouncementBlockReq req) 获取群公告所有块;，获取群公告所有块的富文本内容并分页返回。
ListChatAnnouncementBlockResp	list(ListChatAnnouncementBlockReq req, RequestOptions reqOptions) 获取群公告所有块;，获取群公告所有块的富文本内容并分页返回。

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

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

构造器详细资料

ChatAnnouncementBlock

public ChatAnnouncementBlock(Config config)

方法详细资料

batchUpdate

public BatchUpdateChatAnnouncementBlockResp batchUpdate(BatchUpdateChatAnnouncementBlockReq req,
                                                        RequestOptions reqOptions)
                                                 throws Exception

批量更新群公告块的内容，批量更新块的富文本内容。;

**应用频率限制**：单个应用调用频率上限为每秒 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=batch_update&project=docx&resource=chat.announcement.block&version=v1 ;

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

抛出:

Exception

batchUpdate

public BatchUpdateChatAnnouncementBlockResp batchUpdate(BatchUpdateChatAnnouncementBlockReq req)
                                                 throws Exception

批量更新群公告块的内容，批量更新块的富文本内容。;

**应用频率限制**：单个应用调用频率上限为每秒 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=batch_update&project=docx&resource=chat.announcement.block&version=v1 ;

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

抛出:

Exception

get

public GetChatAnnouncementBlockResp get(GetChatAnnouncementBlockReq 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&version=v1 ;

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

抛出:

Exception

get

public GetChatAnnouncementBlockResp get(GetChatAnnouncementBlockReq 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&version=v1 ;

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

抛出:

Exception

list

public ListChatAnnouncementBlockResp list(ListChatAnnouncementBlockReq 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=list&project=docx&resource=chat.announcement.block&version=v1 ;

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

抛出:

Exception

list

public ListChatAnnouncementBlockResp list(ListChatAnnouncementBlockReq 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=list&project=docx&resource=chat.announcement.block&version=v1 ;

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

抛出:

Exception