Method: phones.getCapabilities

Obtenez les fonctionnalités liées à RCS for Business d'un utilisateur.

La charge utile renvoyée indique si un utilisateur peut être contacté avec RCS for Business et, le cas échéant, les fonctionnalités RCS for Business 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 RCS for Business. 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} est le 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 demande, 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 requête correspond à un ID que l'agent a utilisé pour une requête précédente, la plate-forme RCS for Business ignore la nouvelle requête.
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)
  ],
  "carrier": string
}
Champs
features[]

enum (Feature)

Liste des fonctionnalités RCS for Business compatibles avec cet appareil.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.

Fonctionnalité

Types de fonctionnalités RCS for Business 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.