Method: phones.getCapabilities

获取用户的 RBM 相关功能。

返回的载荷会指定是否可以通过 RBM 覆盖用户，如果可以，则会指定用户支持哪些 RBM 功能。如果无法通过 RBM 联系到用户，RBM 平台会返回 404 NOT_FOUND。

未发布的客服人员只能为该客服人员的测试人员请求能力。如果某个未发布的代理请求非测试人员的功能，RBM 平台会返回 403 PERMISSION_DENIED。

HTTP 请求

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

网址采用 gRPC 转码语法。

路径参数

参数
name

string

此字段会解析为“phones/{E.164}/capabilities”，其中 {E.164} 是用户的电话号码（采用 E.164 格式）。例如，对于电话号码为 +1-222-333-4444 的用户，生成的端点为 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities。

查询参数

参数
requestId

string

代理分配的请求唯一 ID。此值必须是 https://tools.ietf.org/html/rfc4122 中定义的 UUID。如果请求 ID 与代理在上一个请求中使用的 ID 匹配，则 RBM 平台会忽略新请求。
agentId

string

必需。代理的唯一标识符。

请求正文

请求正文必须为空。

响应正文

用户支持的功能的列表

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "features": [
    enum (Feature)
  ]
}
字段
features[]

enum (Feature)

此设备支持的 RBM 功能列表。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/rcsbusinessmessaging

如需了解详情，请参阅 OAuth 2.0 概览。

功能

用户支持的 RBM 功能类型。

枚举
FEATURE_UNSPECIFIED 未指定。
REVOCATION 撤消。如果用户支持撤消，则代理可以在 RBM 平台传送消息之前撤消自己发送的消息。
RICHCARD_STANDALONE 独立的复合信息卡。
ACTION_CREATE_CALENDAR_EVENT 创建日历活动的建议操作。
ACTION_DIAL 建议的拨号操作。
ACTION_OPEN_URL 建议在浏览器中打开网址的操作。
ACTION_SHARE_LOCATION 分享位置信息的建议操作。
ACTION_VIEW_LOCATION 在地图应用中查看地点的建议操作。
ACTION_OPEN_URL_IN_WEBVIEW 在 WebView 中打开网址的建议操作。
ACTION_COMPOSE 撰写文字/音频/视频消息的建议操作。