Method: phones.getCapabilities

Ottieni le funzionalità correlate a RBM di un utente.

Il payload restituito specifica se un utente può essere raggiunto con RBM e, in caso affermativo, quali funzionalità RBM sono supportate dall'utente. Se l'utente non può essere raggiunto con RBM, la piattaforma RBM restituisce 404 NOT_FOUND.

Un agente non avviato può richiedere funzionalità solo agli utenti che sono tester dell'agente in questione. Se un agente non lanciato richiede le funzionalità di un non tester, la piattaforma RBM restituisce 403 PERMISSION_DENIED.

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 si risolve 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 Panoramica di OAuth 2.0.

Funzionalità

Tipi di funzionalità RBM supportate dall'utente.

Enum
FEATURE_UNSPECIFIED Non specificato.
REVOCATION Revoca. Se l'utente supporta la revoca, l'agente può revocare un messaggio inviato prima che la piattaforma RBM lo recapiti.
RICHCARD_STANDALONE Schede informative 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 un luogo in un'app della mappa.
ACTION_OPEN_URL_IN_WEBVIEW Azione suggerita per aprire un URL in WebView.
ACTION_COMPOSE Azione suggerita per scrivere un messaggio di testo/audio/video.