Method: phones.getCapabilities

Получите возможности пользователя, связанные с RBM.

Возвращаемая полезная нагрузка определяет, можно ли связаться с пользователем с помощью RBM, и если да, то какие функции RBM поддерживает пользователь.

Обработка ошибок: ошибка 404 NOT_FOUND возвращается, если пользователь недоступен с помощью RBM. Это может произойти в следующих случаях: (1) Устройство пользователя не поддерживает RCS или RCS на нём отключён. (2) Пользователь находится в мобильной сети, где агент не запущен или RCS-трафик не включён. (3) Незапущенный агент запрашивает возможности пользователя, который не является тестировщиком.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
name

string

Это поле преобразуется в «phones/{E.164}/capabilities», где {E.164} — номер телефона пользователя в формате E.164. Например, для пользователя с номером телефона в США +1-222-333-4444 результирующая конечная точка будет https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities .

Параметры запроса

Параметры
requestId

string

Уникальный идентификатор запроса, назначенный агентом. Это должен быть универсальный уникальный идентификатор (UUID), как определено в https://tools.ietf.org/html/rfc4122 . Если идентификатор запроса совпадает с идентификатором, который агент использовал для предыдущего запроса, платформа RBM игнорирует новый запрос.

agentId

string

Обязательно. Уникальный идентификатор агента.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Список поддерживаемых пользователем функций

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "features": [
    enum (Feature)
  ]
}
Поля
features[]

enum ( Feature )

Список функций RBM, поддерживаемых этим устройством.

Области авторизации

Требуется следующая область OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

Особенность

Типы функций RBM, которые поддерживает пользователь.

Перечисления
FEATURE_UNSPECIFIED Не указан.
RICHCARD_STANDALONE Отдельные расширенные карты.
ACTION_CREATE_CALENDAR_EVENT Предлагаемое действие по созданию события в календаре.
ACTION_DIAL Предлагаемое действие для набора номера.
ACTION_OPEN_URL Предлагаемое действие для открытия URL в браузере.
ACTION_SHARE_LOCATION Предлагаемое действие для предоставления доступа к местоположению.
ACTION_VIEW_LOCATION Предлагаемое действие для просмотра местоположения в приложении «Карта».
ACTION_OPEN_URL_IN_WEBVIEW Предлагаемое действие для открытия URL в WebView.