Method: phones.getCapabilities

Pobieranie funkcji użytkownika związanych z RCS dla firm.

Zwrócone dane określają, czy można się skontaktować z użytkownikiem za pomocą RCS dla firm, a jeśli tak, to które funkcje RCS dla firm są obsługiwane przez tego użytkownika.

Obsługa błędów: gdy nie można skontaktować się z użytkownikiem za pomocą RCS dla firm, 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 przypadku poprzedniego żądania, platforma RCS dla firm zignoruje nowe żądanie.
agentId

string

Wymagane. 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)
  ],
  "carrier": string
}
Pola
features[]

enum (Feature)

Lista funkcji RCS dla firm 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

Typy funkcji RCS Business Messaging obsługiwane 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, aby wybrać numer.
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.