云消息服务 KOOMESSAGE-修改智能信息服务号菜单:请求参数

时间:2024-01-17 08:34:53

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

menu

Menus object

菜单配置信息。

change_reason

String

修改原因。

最小长度:1

最大长度:1000

表4 Menus

参数

是否必选

参数类型

描述

menu_items

Array of MenuItem objects

各子菜单项配置。

数组长度:0 - 3

表5 MenuItem

参数

是否必选

参数类型

描述

name

String

子菜单名称。

  1. 一级菜单名长度和菜单数量有关,具体约束为:

    • 当菜单数量为1个时,菜单名长度范围在1-24个字符。

    • 当菜单数量为2个时,菜单名长度范围在1-12个字符。

    • 当菜单数量为3个时,菜单名长度范围在1-8个字符。

  2. 二级菜单名长度范围恒为1-16个字符。

说明:

以上字符区分中英文,一个中文占2个字符,字母和数字占1个字符,且同时生效的一组菜单内名称不能重复。

action_type

String

菜单动作类型。

  • OPEN_SUBMENU:打开子菜单

  • OPEN_URL:打开URL

  • CALLING:拨打电话

  • OPEN_APP:打开APP

  • OPEN_QUICK:打开快应用

最小长度:0

最大长度:30

content

String

对应值类型。对应不同action_type值,content含义如下:

  • action_type=OPEN_SUBMENU:不填

  • action_type=OPEN_URL:参数数值为跳转URL

  • action_type=CALLING:参数数值为电话号码

  • action_type=OPEN_APP:参数数值为APP的跳转deeplink

  • action_type=OPEN_QUICK:参数数值为快应用跳转的deeplink

最小长度:0

最大长度:1000

ext_msg

ExtMsg object

额外需要携带的信息。

  • action_type=OPEN_SUBMENU时,不填

  • action_type=CALLING时,不填

  • action_type=OPEN_URL时,必填

  • action_type=OPEN_APP时,必填

  • action_type=OPEN_QUICK时,必填

sub_menu_items

Array of MenuItem objects

子菜单配置项。

说明:

仅当action_type=OPEN_SUBMENU时生效,且该项内不允许再配置子菜单。

数组长度:0 - 5

表6 ExtMsg

参数

是否必选

参数类型

描述

open_in_browser

String

打开方式。

  • 0:webView打开

  • 1:浏览器打开

说明:

action_type=OPEN_URL必填,其他不填。

web_title

String

标题,必填,长度范围为1-20个字符。

说明:

action_type=OPEN_URL必填,其他不填。

package_name

String

app包名,长度范围为1-50个字符。

说明:

action_type=OPEN_APP必填,其他不填。

app_id

String

商家应用的appid,长度范围为0-60个字符。

说明:

action_type=OPEN_APP必填,其他不填。

browser_floor_url

String

兜底url,长度范围为0-1000个字符,支持http/https。

说明:

action_type=OPEN_APP选填,其他不填。

depend_engine_ver

String

依赖的快应用引擎版本号,长度范围为1-50个字符。

说明:

action_type=OPEN_QUICK必填,其他不填。

third_service_name

String

第三方服务名,长度范围为1-50个字符。

说明:

action_type=OPEN_QUICK或OPEN_APP必填,其他不填。

support.huaweicloud.com/api-koomessage/UpdateMenu.html