Method: phones.getCapabilities

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

string

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

string

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

string

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 (Feature)
  ]
}
Champs
features[]

enum (Feature)

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.
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.