Method: phones.getCapabilities

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

La charge utile renvoyée indique si un utilisateur peut être contacté avec RCS for Business et, le cas échéant, quelles fonctionnalités RCS for Business il accepte.

Gestion des exceptions : 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 fonctionnalité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 correspond à "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

Identifiant unique de la requête, attribué par l'agent. Il doit s'agir d'un UUID, tel que défini sur la page https://www.rfc-editor.org/info/rfc9562. Si l'ID de requête correspond à un ID utilisé par l'agent 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.
carrier

string

Uniquement en sortie. Informations sur l'opérateur auquel appartient le numéro de téléphone de l'utilisateur, d'après les backends Google RCS. Actuellement, ce champ n'est renseigné que pour les numéros de téléphone américains.

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 acceptées par l'utilisateur.

Enums
FEATURE_UNSPECIFIED Non spécifié.
RICHCARD_STANDALONE Cartes enrichies autonomes.
ACTION_CREATE_CALENDAR_EVENT Action suggérée 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.