获取用户的 RBM 相关功能。
返回的载荷会指定是否可以通过 RBM 覆盖某个用户,如果可以,则指明用户支持哪些 RBM 功能。如果无法通过 RBM 联系到用户,RBM 平台会返回 404 NOT_FOUND
。
尚未发布的代理只能为作为该代理测试人员的用户请求功能。如果未发布的代理请求非测试人员的功能,RBM 平台会返回 403 PERMISSION_DENIED
。
HTTP 请求
GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
此字段将解析为“phones/{E.164}/capabilities”,其中 {E.164} 是 E.164 格式的用户电话号码。例如,如果用户使用的是美国电话号码 +1-222-333-4444,则生成的端点为 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities。 |
查询参数
参数 | |
---|---|
requestId |
请求的唯一 ID,由代理分配。此值必须是 UUID(如 https://tools.ietf.org/html/rfc4122 中所定义)。如果请求 ID 与代理用于上一个请求的 ID 匹配,则 RBM 平台会忽略新的请求。 |
agentId |
必需。代理的唯一标识符。 |
请求正文
请求正文必须为空。
响应正文
用户支持的功能列表
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"features": [
enum ( |
字段 | |
---|---|
features[] |
此设备支持的 RBM 功能列表。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/rcsbusinessmessaging
有关详情,请参阅 OAuth 2.0 概览。
功能
用户支持的 RBM 功能的类型。
枚举 | |
---|---|
FEATURE_UNSPECIFIED |
未指定。 |
REVOCATION |
撤消。如果用户支持撤消操作,则代理可以撤消在 RBM 平台递送消息之前发送的消息。 |
RICHCARD_STANDALONE |
独立的复合信息卡。 |
RICHCARD_CAROUSEL |
复合信息卡轮播界面。 |
ACTION_CREATE_CALENDAR_EVENT |
创建日历活动的建议操作。 |
ACTION_DIAL |
建议采取的拨号操作。 |
ACTION_OPEN_URL |
打开网址的建议操作。 |
ACTION_SHARE_LOCATION |
分享营业地点的建议操作。 |
ACTION_VIEW_LOCATION |
在地图应用中查看营业地点的建议操作。 |