Method: users.batchGet

获取用户名单中已启用 RCS 的电话号码。

返回的载荷包含 RBM 平台可供指定用户访问且已启用 RCS 的电话号码的列表。系统只会返回已针对发布代理的运营商启用 RCS 的电话号码。

返回的载荷还包含可用于估算电话号码列表的潜在覆盖面的值，而不考虑代理的发布状态。

每分钟最多 600 次查询 (QPM)。

HTTP 请求

POST https://rcsbusinessmessaging.googleapis.com/v1/users:batchGet

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "users": [
    string
  ],
  "agentId": string
}
字段
users[]

string

用户的电话号码列表（采用 E.164 格式）。
agentId

string

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

响应正文

包含 RBM 可达性用户数据的响应。

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

JSON 表示法 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
字段
reachableUsers[]

string

RBM 可以联系的用户电话号码列表。仅包含发布代理的运营商的用户。
totalRandomSampleUserCount

integer

从 reachableUsers 中随机选择的电话号码数量。通常，此值约为所请求电话号码总数的 75%。如果请求的电话号码数量少于 500，则此值为 0。
reachableRandomSampleUserCount

integer

所有运营商均可从随机选择的列表中看到的电话号码数量，无论代理的发布状态如何。此值与 totalRandomSampleUserCount 之间的比率可大致估算某个用户列表的潜在覆盖面。

授权范围

需要以下 OAuth 范围：

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

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