Method: phones.getCapabilities

Rufen Sie die RBM-bezogenen Funktionen eines Nutzers ab.

Die zurückgegebene Nutzlast gibt an, ob ein Nutzer über RBM erreicht werden kann und, falls ja, welche RBM-Funktionen der Nutzer unterstützt.

Fehlerbehandlung: Der Fehler 404 NOT_FOUND wird zurückgegeben, wenn der Nutzer nicht über RBM erreicht werden kann. Das kann verschiedene Gründe haben: (1) Das Gerät des Nutzers unterstützt RCS nicht oder RCS ist deaktiviert. 2. Der Nutzer befindet sich in einem Mobilfunknetz, in dem der Agent nicht gestartet wird oder in dem kein RCS-Traffic aktiviert ist. 3. Ein noch nicht eingeführter Agent fordert die Funktionen eines Nutzers an, der kein Tester ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Dieses Feld wird zu „phones/{E.164}/capabilities“ aufgelöst, wobei {E.164} die Telefonnummer des Nutzers im E.164-Format ist. Für einen Nutzer mit der US-Telefonnummer +1-222-333-4444 lautet der resultierende Endpunkt beispielsweise https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Abfrageparameter

Parameter
requestId

string

Die eindeutige ID der Anfrage, die vom Agent zugewiesen wurde. Dies muss eine UUID sein, wie in https://tools.ietf.org/html/rfc4122 definiert. Wenn die Anfrage-ID mit einer ID übereinstimmt, die der Kundenservicemitarbeiter für eine frühere Anfrage verwendet hat, ignoriert die RBM-Plattform die neue Anfrage.
agentId

string

Erforderlich. Die eindeutige ID des Agents.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Liste der vom Nutzer unterstützten Funktionen

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "features": [
    enum (Feature)
  ]
}
Felder
features[]

enum (Feature)

Liste der RBM-Funktionen, die von diesem Gerät unterstützt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

Funktion

Arten von RBM-Funktionen, die der Nutzer unterstützt.

Enums
FEATURE_UNSPECIFIED Nicht angegeben.
RICHCARD_STANDALONE Eigenständige Rich Cards.
ACTION_CREATE_CALENDAR_EVENT Vorgeschlagene Aktion zum Erstellen eines Kalendertermins.
ACTION_DIAL Vorgeschlagene Aktion zum Wählen einer Nummer.
ACTION_OPEN_URL Vorgeschlagene Aktion zum Öffnen einer URL im Browser.
ACTION_SHARE_LOCATION Vorgeschlagene Aktion zum Teilen eines Standorts.
ACTION_VIEW_LOCATION Vorgeschlagene Aktion zum Aufrufen eines Orts in einer Karten-App.
ACTION_OPEN_URL_IN_WEBVIEW Vorgeschlagene Aktion zum Öffnen einer URL in WebView.