Method: users.batchGet

ユーザーのリストの RCS 対応の電話番号を取得します。

返されるペイロードには、指定されたユーザーに対して RCS for Business プラットフォームからアクセス可能な RCS 対応の電話番号のリストが含まれます。エージェントが起動された携帯通信会社で RCS が有効になっている電話番号のみが返されます。

返されるペイロードには、エージェントのリリース ステータスに関係なく、電話番号のリストの潜在的なリーチを推定するために使用できる値も含まれています。

最大 600 QPM（1 分あたりのクエリ数）。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "users": [
    string
  ],
  "agentId": string
}
フィールド
users[]

string

ユーザーの電話番号のリスト（E.164 形式）。
agentId

string

必須。エージェントの固有識別子。

レスポンスの本文

RCS for Business のユーザーの到達可能性データを含むレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
フィールド
reachableUsers[]

string

RCS for Business でリーチできるユーザーの電話番号のリスト。エージェントが起動される携帯通信会社のユーザーのみが含まれます。
totalRandomSampleUserCount

integer

reachableUsers からランダムに選択された電話番号の数。通常、この値はリクエストされた電話番号の合計数の約 75% です。リクエストされた電話番号の数が 500 未満の場合、この値は 0 になります。
reachableRandomSampleUserCount

integer

エージェントのリリース ステータスに関係なく、すべての携帯通信会社で RCS に対応している、ランダムに選択されたリストの電話番号の数。この値と totalRandomSampleUserCount の比率から、ユーザーリストの潜在的なリーチを概算できます。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。