Method: phones.getCapabilities

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

Il payload restituito specifica se un utente può essere raggiunto 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 può essere raggiunto con RCS for Business. Sono inclusi più scenari: (1) il dispositivo dell'utente non supporta RCS o ha 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 è 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 di percorso

Parametri
name

string

Questo campo viene risolto in "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 query

Parametri
requestId

string

L'ID univoco della richiesta, assegnato dall'agente. Deve essere un UUID, come definito in https://www.rfc-editor.org/info/rfc9562. 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.
carrier

string

Solo output. Le informazioni sull'operatore a cui appartiene il numero di telefono dell'utente, in base ai backend Google RCS. Al momento, questo campo viene compilato solo per i numeri di telefono degli Stati Uniti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la 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.