Method: phones.getCapabilities

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

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

Незапущенный агент может запрашивать возможности только для пользователей, которые являются тестировщиками этого агента. Если незапущенный агент запрашивает возможности нетестера, платформа RBM возвращает 403 PERMISSION_DENIED .

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 .

Особенность

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

Перечисления
FEATURE_UNSPECIFIED Не указан.
REVOCATION Отзыв. Если пользователь поддерживает отзыв, агент может отозвать отправленное им сообщение до того, как платформа RBM доставит это сообщение.
RICHCARD_STANDALONE Автономные расширенные карты.
ACTION_CREATE_CALENDAR_EVENT Предлагаемое действие для создания события календаря.
ACTION_DIAL Предлагаемое действие для набора номера.
ACTION_OPEN_URL Предлагаемое действие для открытия URL-адреса.
ACTION_SHARE_LOCATION Рекомендуемое действие, чтобы поделиться местоположением.
ACTION_VIEW_LOCATION Рекомендуемое действие для просмотра местоположения в приложении карты.