Method: phones.getCapabilities

Pobieranie informacji o możliwościach użytkownika związanych z RBM.

Zwracany ł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 tego użytkownika. Jeśli nie można skontaktować się z użytkownikiem za pomocą RBM, platforma RBM zwraca 404 NOT_FOUND.

Agent, który nie został uruchomiony, może prosić o uprawnienia tylko użytkowników, którzy są jego testerami. Jeśli nieuruchomiony agent poprosi o uprawnienia osoby niebędącej testerem, platforma RBM zwróci wartość 403 PERMISSION_DENIED.

Żą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 przyjmuje wartość „phones/{E.164}/capabilities”, gdzie {E.164} to numer telefonu użytkownika w formacie E.164. Na przykład w przypadku użytkownika o amerykańskim numerze telefonu +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 pracownika obsługi klienta. Musi to być identyfikator UUID zdefiniowany w dokumencie https://tools.ietf.org/html/rfc4122. Jeśli identyfikator żądania odpowiada identyfikatorowi użytemu przez agenta w poprzednim żądaniu, platforma RBM zignoruje nowe żądanie.
agentId

string

Wymagane. Unikalny identyfikator agenta.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista obsługiwanych funkcji 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 artykule Omówienie OAuth 2.0.

Funkcja

Typy funkcji RBM obsługiwanych przez użytkownika.

Wartości w polu enum
FEATURE_UNSPECIFIED Nie określono.
REVOCATION Anulowanie. Jeśli użytkownik obsługuje unieważnienie, agent może unieważnić wiadomość wysłaną przed dostarczeniem przez platformę RBM.
RICHCARD_STANDALONE samodzielne karty informacyjne;
ACTION_CREATE_CALENDAR_EVENT Sugerowane działanie polegające na utworzeniu wydarzenia w kalendarzu.
ACTION_DIAL Sugerowane działanie polegające na wybraniu numeru.
ACTION_OPEN_URL Sugerowane działanie polegające na otwarciu adresu URL w przeglądarce.
ACTION_SHARE_LOCATION Sugerowane działanie udostępnienia lokalizacji.
ACTION_VIEW_LOCATION Sugerowane działanie polegające na wyświetleniu lokalizacji w aplikacji mapowej.
ACTION_OPEN_URL_IN_WEBVIEW Sugerowane działanie polegające na otwarciu adresu URL w komponencie WebView.
ACTION_COMPOSE Sugerowane działanie dotyczące tworzenia wiadomości tekstowej, audio lub wideo.