Получите возможности пользователя, связанные с 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 | Это поле преобразуется в «phones/{E.164}/capabilities», где {E.164} — это номер телефона пользователя в формате E.164. Например, для пользователя с номером телефона в США +1-222-333-4444 результирующей конечной точкой будет https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities . |
Параметры запроса
Параметры | |
---|---|
requestId | Уникальный идентификатор запроса, присвоенный агентом. Это должен быть UUID, как определено в https://tools.ietf.org/html/rfc4122 . Если идентификатор запроса совпадает с идентификатором, который агент использовал для предыдущего запроса, платформа RBM игнорирует новый запрос. |
agentId | Необходимый. Уникальный идентификатор агента. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Список поддерживаемых пользователем функций
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"features": [
enum ( |
Поля | |
---|---|
features[] | Список функций RBM, которые поддерживает это устройство. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/rcsbusinessmessaging
Дополнительную информацию см. в обзоре OAuth 2.0 .
Особенность
Типы функций RBM, которые поддерживает пользователь.
Перечисления | |
---|---|
FEATURE_UNSPECIFIED | Не указан. |
REVOCATION | Отзыв. Если пользователь поддерживает отзыв, агент может отозвать отправленное им сообщение до того, как платформа RBM доставит это сообщение. |
RICHCARD_STANDALONE | Автономные расширенные карты. |
RICHCARD_CAROUSEL | Карусель богатых карт. |
ACTION_CREATE_CALENDAR_EVENT | Предлагаемое действие для создания события календаря. |
ACTION_DIAL | Предлагаемое действие для набора номера. |
ACTION_OPEN_URL | Предлагаемое действие для открытия URL-адреса. |
ACTION_SHARE_LOCATION | Рекомендуемое действие, чтобы поделиться местоположением. |
ACTION_VIEW_LOCATION | Рекомендуемое действие для просмотра местоположения в приложении карты. |