Method: phones.getCapabilities

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

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

Обработка ошибок: Ошибка 404 NOT_FOUND возвращается, когда пользователь недоступен с помощью RCS для бизнеса. Это может произойти по нескольким причинам: (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 . Если идентификатор запроса совпадает с идентификатором, который агент использовал для предыдущего запроса, платформа RCS for Business игнорирует новый запрос.

agentId

string

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

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

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

Тело ответа

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

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

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

enum ( Feature )

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

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

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

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

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

Особенность

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

Перечисления
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.