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 questo caso, quali funzionalità RBM sono supportate dall'utente. Se l'utente non può essere raggiunto con RBM, la piattaforma di RBM restituisce 404 NOT_FOUND.

Un agente non lanciato può richiedere funzionalità solo per gli utenti che sono tester dell'agente. 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 restituisce "phones/{E.164}/capabilities", dove {E.164} è il numero di telefono dell'utente nel 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 ricerca

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 di 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 supportati 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 invii.
RICHCARD_STANDALONE Schede interattive autonome.
ACTION_CREATE_CALENDAR_EVENT Azione suggerita per creare un evento di calendario.
ACTION_DIAL Azione suggerita per comporre un numero.
ACTION_OPEN_URL Azione suggerita per aprire un URL.
ACTION_SHARE_LOCATION Azione suggerita per condividere una posizione.
ACTION_VIEW_LOCATION Azione suggerita per visualizzare una posizione in un'app di mappe.