Obtenez les fonctionnalités RBM d'un utilisateur.
La charge utile renvoyée indique si un utilisateur peut être contacté avec RBM et, le cas échéant, les fonctionnalités RBM qu'il prend en charge.
Gestion des erreurs : une erreur 404 NOT_FOUND est renvoyée lorsque l'utilisateur ne peut pas être contacté avec RBM. Cela inclut plusieurs scénarios : (1) l'appareil de l'utilisateur n'est pas compatible avec le RCS ou le RCS est désactivé. (2) L'utilisateur se trouve sur un réseau mobile où l'agent n'est pas lancé ou où le trafic RCS n'est pas activé. (3) Un agent non lancé demande les capacités d'un utilisateur qui n'est pas un testeur.
Requête HTTP
GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
name |
Ce champ est résolu en "phones/{E.164}/capabilities", où {E.164} correspond au numéro de téléphone de l'utilisateur au format E.164. Par exemple, pour un utilisateur dont le numéro de téléphone américain est +1-222-333-4444, le point de terminaison obtenu est https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities. |
Paramètres de requête
Paramètres | |
---|---|
requestId |
ID unique de la requête, attribué par l'agent. Il doit s'agir d'un UUID, tel que défini dans https://tools.ietf.org/html/rfc4122. Si l'ID de la demande correspond à un ID que l'agent a utilisé pour une demande précédente, la plate-forme RBM ignore la nouvelle demande. |
agentId |
Obligatoire. Identifiant unique de l'agent. |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Liste des fonctionnalités compatibles avec l'utilisateur
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"features": [
enum ( |
Champs | |
---|---|
features[] |
Liste des fonctionnalités RBM compatibles avec cet appareil. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/rcsbusinessmessaging
Pour en savoir plus, consultez OAuth 2.0 Overview.
Fonctionnalité
Types de fonctionnalités RBM compatibles avec l'utilisateur.
Enums | |
---|---|
FEATURE_UNSPECIFIED |
Non spécifié. |
RICHCARD_STANDALONE |
Cartes enrichies autonomes. |
RICHCARD_CAROUSEL |
Carrousel de cartes enrichies. |
ACTION_CREATE_CALENDAR_EVENT |
Suggestion d'action pour créer un événement d'agenda. |
ACTION_DIAL |
Action suggérée pour composer un numéro. |
ACTION_OPEN_URL |
Action suggérée pour ouvrir une URL dans un navigateur. |
ACTION_SHARE_LOCATION |
Action suggérée pour partager une position. |
ACTION_VIEW_LOCATION |
Action suggérée pour afficher un lieu dans une application de cartographie. |
ACTION_OPEN_URL_IN_WEBVIEW |
Action suggérée pour ouvrir une URL dans une WebView. |