Method: phones.getCapabilities

获取用户的 RCS for Business 相关功能。

返回的载荷会指明是否可以通过 RCS for Business 与用户联系，如果可以，还会指明用户支持哪些 RCS for Business 功能。

错误处理：如果无法通过 RCS for Business 联系到用户，系统会返回 404 NOT_FOUND 错误。这包括多种情况：(1) 用户的设备不支持 RCS 或已停用 RCS。(2) 用户所在的移动网络未发布该代理或未启用 RCS 流量。(3) 未发布的代理请求非测试员用户的能力。

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，由代理分配。此值必须是 UUID，如 https://www.rfc-editor.org/info/rfc9562 中所定义。如果请求 ID 与代理在之前的请求中使用的 ID 匹配，RCS for Business 平台会忽略新请求。
agentId

string

必需。智能体的唯一标识符。

请求正文

请求正文必须为空。

响应正文

用户支持的功能列表。

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

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

enum (Feature)

此设备支持的 RCS for Business 功能列表。
carrier

string

仅限输出。根据 Google RCS 后端，用户电话号码所属的运营商信息。目前，此字段仅针对美国电话号码进行填充。

授权范围

需要以下 OAuth 范围：

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

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

功能

用户支持的 RCS for Business 功能类型。

枚举
FEATURE_UNSPECIFIED 未指定。
RICHCARD_STANDALONE 独立复合信息卡。
ACTION_CREATE_CALENDAR_EVENT 建议的操作：创建日历活动。
ACTION_DIAL 建议拨打电话号码的操作。
ACTION_OPEN_URL 在浏览器中打开网址的操作建议。
ACTION_SHARE_LOCATION 建议采取的分享位置信息操作。
ACTION_VIEW_LOCATION 建议在地图应用中查看位置。
ACTION_OPEN_URL_IN_WEBVIEW 建议在 WebView 中打开网址的操作。