Method: phones.getCapabilities

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

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

Fehlerbehandlung: Wenn der Nutzer nicht über RCS for Business erreicht werden kann, wird der Fehler „404 NOT_FOUND“ zurückgegeben. Dazu gehören 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 KI-Agent nicht eingeführt wurde oder in dem RCS-Traffic nicht aktiviert ist. (3) Ein nicht aktivierter 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.

Suchparameter

Parameter
requestId

string

Die eindeutige ID der Anfrage, die vom KI-Agenten zugewiesen wurde. Dies muss eine UUID sein, wie unter https://www.rfc-editor.org/info/rfc9562 definiert. Wenn die Anfrage-ID mit einer ID übereinstimmt, die der Agent für eine vorherige Anfrage verwendet hat, ignoriert die RCS for Business-Plattform die neue Anfrage.
agentId

string

Erforderlich. Die eindeutige Kennung des KI-Agenten.

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 dieses Gerät unterstützt.
carrier

string

Nur Ausgabe. Die Informationen zum Mobilfunkanbieter, zu dem die Telefonnummer des Nutzers gehört, gemäß den Google RCS-Backends. Derzeit wird dieses Feld nur für US-amerikanische Telefonnummern ausgefüllt.

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