Method: phones.getCapabilities

Recupera le funzionalità relative a RBM di un utente.

Il payload restituito specifica se un utente può essere raggiunto con RBM e, in caso affermativo, quali funzionalità RBM supporta.

Gestione degli errori: viene restituito un errore 404 NOT_FOUND quando l'utente non è raggiungibile con RBM. Sono inclusi diversi scenari: (1) Il dispositivo dell'utente non supporta RCS o RCS è disattivato. (2) L'utente si trova su una rete mobile in cui l'agente non è stato lanciato o in cui il traffico RCS non è attivato. (3) Un agente non lanciato richiede le funzionalità di un utente che non è un tester.

Richiesta HTTP

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Questo campo viene risolto in "phones/{E.164}/capabilities", dove {E.164} è il numero di telefono dell'utente in formato E.164. Ad esempio, per un utente con il numero di telefono statunitense +1-222-333-4444, l'endpoint risultante è https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parametri di query

Parametri
requestId

string

L'ID univoco della richiesta, assegnato dall'agente. Deve essere un UUID, come definito in https://tools.ietf.org/html/rfc4122. Se l'ID richiesta corrisponde a un ID utilizzato dall'agente per una richiesta precedente, la piattaforma RBM ignora la nuova richiesta.
agentId

string

Obbligatorio. L'identificatore univoco dell'agente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Elenco delle funzionalità supportate dall'utente

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "features": [
    enum (Feature)
  ]
}
Campi
features[]

enum (Feature)

Elenco delle funzionalità RBM supportate da questo dispositivo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la OAuth 2.0 Overview.

Funzionalità

Tipi di funzionalità RBM supportate dall'utente.

Enum
FEATURE_UNSPECIFIED Non specificato.
RICHCARD_STANDALONE Schede interattive autonome.
ACTION_CREATE_CALENDAR_EVENT Azione suggerita per creare un evento nel calendario.
ACTION_DIAL Azione suggerita per comporre un numero.
ACTION_OPEN_URL Azione suggerita per aprire un URL nel browser.
ACTION_SHARE_LOCATION Azione suggerita per condividere una posizione.
ACTION_VIEW_LOCATION Azione suggerita per visualizzare una posizione in un'app di mappe.
ACTION_OPEN_URL_IN_WEBVIEW Azione suggerita per aprire un URL in WebView.