Method: phones.getCapabilities

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

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

Обработка ошибок. Если пользователь недоступен в RCS for Business, возвращается ошибка 404 NOT_FOUND. Это может произойти в следующих случаях: 1) устройство пользователя не поддерживает RCS или эта функция отключена; 2) Пользователь подключен к мобильной сети, в которой агент не запущен или не включен трафик RCS. 3) Незапущенный агент запрашивает возможности пользователя, который не является тестировщиком.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

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

Параметры
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://www.rfc-editor.org/info/rfc9562. Если идентификатор запроса совпадает с идентификатором, который агент использовал для предыдущего запроса, платформа RCS for Business игнорирует новый запрос.
agentId

string

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

Тело запроса

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

Тело ответа

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

Ниже приведена структура данных в ответе, полученном на запрос.

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

enum (Feature)

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

string

Только для вывода. Информация об операторе связи, к которому относится номер телефона пользователя, согласно серверным системам Google RCS. В настоящее время это поле заполняется только для номеров телефонов в США.

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

Требуется следующая область действия 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.