修改群菜单元信息

修改某个一级菜单或者二级菜单的元信息。

注意事项：

机器人必须在群里。

错误码

HTTP状态码	错误码	描述	排查建议
400	232001	Your request contains an invalid request parameter.	参数错误，参考本文档检查输入参数。
400	232011	Operator can NOT be out of the chat.	操作者需要在群组中。
400	232014	The token used in the request does NOT have the permissions necessary to complete the request.	操作者没有权限进行该操作，请检查是否具有相应的权限。
400	232025	Bot ability is not activated.	应用需要开启机器人能力。
400	232073	The group menu is being modified, please try again later.	群内菜单正在修改中，请稍后重试。

curl --location --request PATCH 'https://open.feishu.cn/open-apis/im/v1/chats//menu_items/' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "update_fields": [ "ICON" ], "chat_menu_item": { "action_type": "NONE", "redirect_link": { "common_url": "https://open.feishu.cn/", "ios_url": "https://open.feishu.cn/", "android_url": "https://open.feishu.cn/", "pc_url": "https://open.feishu.cn/", "web_url": "https://open.feishu.cn/" }, "image_key": "img_v2_b0fbe905-7988-4282-b882-82edd010336j", "name": "报名", "i18n_names": { "zh_cn": "报名", "en_us": "Sign up", "ja_jp": "サインアップ" } } }'

{ "code": 0, "msg": "success", "data": { "chat_menu_item": { "action_type": "NONE", "redirect_link": { "common_url": "https://open.feishu.cn/", "ios_url": "https://open.feishu.cn/", "android_url": "https://open.feishu.cn/", "pc_url": "https://open.feishu.cn/", "web_url": "https://open.feishu.cn/" }, "image_key": "img_v2_b0fbe905-7988-4282-b882-82edd010336j", "name": "报名", "i18n_names": { "zh_cn": "报名", "en_us": "Sign up", "ja_jp": "サインアップ" } } } }

请求参数

Path 参数

chat_id

string

必需

群ID，详情参见群ID 说明注意：仅支持群模式为group的群ID 示例值："oc_a0553eda9014c201e6969b478895c230"

menu_item_id

string

必需

一级或二级菜单ID，通过获取群菜单接口通过群ID获取菜单ID。示例值："7156553273518882844"

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

update_fields

array[string]

必需

要修改的字段示例值：["ICON"] 可选值有： ICON：图标 NAME：名称 I18N_NAME：国际化名称 REDIRECT_LINK：跳转链接

chat_menu_item

object

元信息

必需

action_type

string

可选

菜单类型示例值："NONE" 可选值有： NONE：无类型，仅一级菜单存在二级菜单时，该一级菜单设置NONE类型 REDIRECT_LINK：跳转链接类型

redirect_link

object

跳转链接

可选

image_key

string

可选

image_key，通过上传图片接口上传message类型图片获取image_key 示例值："img_v2_b0fbe905-7988-4282-b882-82edd010336j"

name

string

可选

名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内注意： 1中文=2英文=2其他语言字符=2字符示例值："群聊"

i18n_names

object

可选

国际化名称，一级菜单名称字符数要在1到8范围内，二级菜单名称字符数要在1到24范围内注意： 1中文=2英文=2其他语言字符=2字符

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

chat_menu_item

object

修改后的菜单元信息

必需

修改群菜单元信息

错误码#

请求参数

返回响应

错误码