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

无论代理的发布状态如何，所有运营商都可以通过 RCS 访问随机选择的列表中的电话号码数量。此值与 totalRandomSampleUserCount 之间的比率可以估算一系列用户的潜在覆盖面。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。