Method: phones.getCapabilities

Rufen Sie die RCS for Business-bezogenen Funktionen eines Nutzers ab.

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

Fehlerbehandlung: Der Fehler „404 NOT_FOUND“ wird zurückgegeben, wenn der Nutzer nicht über RCS for Business 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, wird die neue Anfrage von der RCS for Business-Plattform ignoriert.
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)
  ],
  "carrier": string
}
Felder
features[]

enum (Feature)

Liste der RCS for Business-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 RCS for Business-Funktionen, die der Nutzer unterstützt.

Enums
FEATURE_UNSPECIFIED Nicht angegeben.
RICHCARD_STANDALONE Eigenständige interaktive Chat-Nachrichten.
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.