Method: phones.getCapabilities

Ruft die RBM-bezogenen Funktionen eines Nutzers ab.

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

Fehlerbehandlung: Wenn der Nutzer nicht über RBM erreicht werden kann, wird der Fehler 404 NOT_FOUND zurückgegeben. Dies umfasst mehrere Szenarien: (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 Kundenservicemitarbeiter nicht gestartet oder RCS-Traffic nicht aktiviert ist. (3) Ein nicht gestarteter 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 in „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-amerikanischen Telefonnummer +1-222-333-4444 lautet der resultierende Endpunkt beispielsweise https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Abfrageparameter

Parameter
requestId

string

Die vom Kundenservicemitarbeiter zugewiesene eindeutige ID der Anfrage. Dies muss eine UUID sein, wie unter https://tools.ietf.org/html/rfc4122 definiert. Wenn die Anfrage-ID mit einer ID übereinstimmt, die der Kundenservicemitarbeiter für eine vorherige Anfrage verwendet hat, wird die neue Anfrage von der RBM-Plattform ignoriert.
agentId

string

Erforderlich. Die eindeutige Kennung des Kundenservicemitarbeiters.

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, um sich einen Ort in einer Karten-App anzusehen.
ACTION_OPEN_URL_IN_WEBVIEW Vorgeschlagene Aktion zum Öffnen einer URL in WebView.
ACTION_COMPOSE

Vorgeschlagene Aktion zum Verfassen einer Text-, Audio- oder Videonachricht.

Achtung: Mobilfunkanbieter haben Bedenken hinsichtlich der aktuellen Definition und Implementierung der Aktion „Schreiben“, wie in der GSMA-Spezifikation beschrieben, geäußert. Aufgrund dieser Bedenken und um für eine einheitliche und zuverlässige Nutzung für Nutzer und das gesamte System zu sorgen, haben wir die Ausnahmeentscheidung getroffen, die Einführung der Aktion „Erstellen“ auszusetzen. Die Dokumentation zu Aktionen vom Typ „Erstellen“ wird am 5. Juni 2025 entfernt. Uns ist bewusst, dass das Zurücksetzen einer API-Funktion nicht üblich ist. Diese Entscheidung spiegelt jedoch wider, wie wichtig es uns ist, auf das Feedback unserer Partner zu reagieren und die Stabilität und Integrität der RBM-Plattform zu erhalten. Wenden Sie sich an Ihren Google RBM-Kontakt, wenn die Aktion „Schreiben“ für Ihre Anwendungsfälle wichtig ist.