Method: users.batchGet

Récupère les numéros de téléphone compatibles RCS pour une liste d'utilisateurs.

La charge utile renvoyée contient une liste de numéros de téléphone compatibles RCS accessibles par la plate-forme RBM pour les utilisateurs spécifiés. Seuls les numéros de téléphone compatibles RCS pour l'opérateur avec lequel l'agent est lancé seront renvoyés.

La charge utile renvoyée contient également des valeurs qui peuvent être utilisées pour estimer la couverture potentielle d'une liste de numéros de téléphone, quel que soit l'état de lancement de l'agent.

600 requêtes par minute (RPM) au maximum.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "users": [
    string
  ],
  "agentId": string
}
Champs
users[]

string

Liste des utilisateurs les numéros de téléphone au format E.164.
agentId

string

Obligatoire. Identifiant unique de l'agent.

Corps de la réponse

Réponse avec des données utilisateur sur la joignabilité RBM.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
Champs
reachableUsers[]

string

Liste des utilisateurs les numéros de téléphone auxquels RBM peut joindre. N'inclut que les utilisateurs des opérateurs avec lesquels l'agent est lancé.
totalRandomSampleUserCount

integer

Nombre de numéros de téléphone sélectionnés de manière aléatoire dans reachableUsers. En général, cette valeur correspond à environ 75% du nombre total de numéros de téléphone demandés. Cette valeur est 0 si le nombre de numéros de téléphone demandés est inférieur à 500.
reachableRandomSampleUserCount

integer

Nombre de numéros de téléphone issus de la liste sélectionnée de manière aléatoire et accessibles via le RCS auprès de tous les opérateurs, quel que soit l'état du lancement de l'agent. Le ratio entre cette valeur et totalRandomSampleUserCount peut estimer la couverture potentielle pour une liste d'utilisateurs.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.