Method: phones.getCapabilities

Ottieni le funzionalità di un utente correlate a RCS for Business.

Il payload restituito specifica se un utente può essere contattato con RCS for Business e, in caso affermativo, quali funzionalità di RCS for Business supporta.

Gestione degli errori: viene restituito un errore 404 NOT_FOUND quando l'utente non è raggiungibile con RCS for Business. 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 avviato o in cui il traffico RCS non è abilitato. (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 RCS for Business 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)
  ],
  "carrier": string
}
Campi
features[]

enum (Feature)

Elenco delle funzionalità di RCS for Business supportate da questo dispositivo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta OAuth 2.0 Overview.

Funzionalità

Tipi di funzionalità RCS for Business 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.