Method: phones.getCapabilities

Pobieranie funkcji RBM użytkownika.

Zwrócony ładunek określa, czy można się skontaktować z użytkownikiem za pomocą RBM, a jeśli tak, to które funkcje RBM są obsługiwane przez użytkownika.

Obsługa błędów: gdy nie można skontaktować się z użytkownikiem za pomocą RBM, zwracany jest błąd 404 NOT_FOUND. Obejmuje to kilka scenariuszy: (1) urządzenie użytkownika nie obsługuje RCS lub ma wyłączoną tę usługę; (2) Użytkownik korzysta z sieci komórkowej, w której agent nie jest uruchomiony lub w której ruch RCS nie jest włączony. (3) Nieopublikowany agent prosi o możliwości użytkownika, który nie jest testerem.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

To pole jest przekształcane w „phones/{E.164}/capabilities”, gdzie {E.164} to numer telefonu użytkownika w formacie E.164. Na przykład w przypadku użytkownika z numerem telefonu w USA +1-222-333-4444 wynikowy punkt końcowy to https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parametry zapytania

Parametry
requestId

string

Unikalny identyfikator żądania przypisany przez agenta. Musi to być identyfikator UUID zgodnie z definicją w dokumencie https://tools.ietf.org/html/rfc4122. Jeśli identyfikator żądania pasuje do identyfikatora użytego przez agenta w poprzednim żądaniu, platforma RBM zignoruje nowe żądanie.
agentId

string

Wymagany. Unikalny identyfikator agenta.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista funkcji obsługiwanych przez użytkownika

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "features": [
    enum (Feature)
  ]
}
Pola
features[]

enum (Feature)

Lista funkcji RBM obsługiwanych przez to urządzenie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

Funkcja

Rodzaje funkcji RBM obsługiwanych przez użytkownika.

Wartości w polu enum
FEATURE_UNSPECIFIED Nie określono.
RICHCARD_STANDALONE Samodzielne karty informacyjne.
ACTION_CREATE_CALENDAR_EVENT Sugerowane działanie umożliwiające utworzenie wydarzenia w kalendarzu.
ACTION_DIAL Sugerowane działanie umożliwiające wybranie numeru.
ACTION_OPEN_URL Sugerowane działanie otwierania adresu URL w przeglądarce.
ACTION_SHARE_LOCATION Sugerowane działanie umożliwiające udostępnienie lokalizacji.
ACTION_VIEW_LOCATION Sugerowane działanie umożliwiające wyświetlenie lokalizacji w aplikacji do map.
ACTION_OPEN_URL_IN_WEBVIEW Sugerowane działanie otwierania adresu URL w widoku WebView.