Method: phones.getCapabilities

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

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

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ę funkcję. (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) Nieuruchomiony agent żąda uprawnień 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 ma postać „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 prośby przypisany przez agenta. Musi to być identyfikator UUID, zgodnie z definicją na stronie https://www.rfc-editor.org/info/rfc9562. Jeśli identyfikator żądania jest zgodny z identyfikatorem, którego agent użył w poprzednim żądaniu, platforma RCS dla firm ignoruje 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.
carrier

string

Tylko dane wyjściowe. Informacje o operatorze, do którego należy numer telefonu użytkownika, zgodnie z backendami Google RCS. Obecnie to pole jest wypełniane tylko w przypadku numerów telefonów w Stanach Zjednoczonych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

Funkcja

Typy funkcji RCS dla firm 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: utworzenie wydarzenia w kalendarzu.
ACTION_DIAL Sugerowane działanie: wybierz numer.
ACTION_OPEN_URL Sugerowane działanie polegające na otwarciu adresu URL w przeglądarce.
ACTION_SHARE_LOCATION Sugerowane działanie dotyczące udostępniania lokalizacji.
ACTION_VIEW_LOCATION Sugerowane działanie, aby wyświetlić lokalizację w aplikacji map.
ACTION_OPEN_URL_IN_WEBVIEW Sugerowane działanie polegające na otwarciu adresu URL w komponencie WebView.