Method: phones.getCapabilities

Obtén las funciones relacionadas con RBM de un usuario.

La carga útil que se muestra especifica si se puede establecer contacto con un usuario mediante RBM y, de ser así, qué funciones de RBM admite. Si no se puede llegar al usuario con RBM, la plataforma de RBM muestra 404 NOT_FOUND.

Un agente que no se haya iniciado solo puede solicitar capacidades para los usuarios que sean verificadores de ese agente. Si un agente no iniciado solicita las capacidades de un no verificador, la plataforma de RBM muestra 403 PERMISSION_DENIED.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Este campo se resuelve como "phones/{E.164}/capabilities", en el que {E.164} es el número de teléfono del usuario en formato E.164. Por ejemplo, para un usuario con el número de teléfono de EE.UU. +1-222-333-4444, el extremo resultante es https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parámetros de consulta

Parámetros
requestId

string

El ID único de la solicitud, asignado por el agente. Debe ser un UUID, como se define en https://tools.ietf.org/html/rfc4122. Si el ID de solicitud coincide con uno que el agente usó para una solicitud anterior, la plataforma de RBM ignorará la solicitud nueva.
agentId

string

Obligatorio. El identificador único del agente.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Lista de funciones que admite el usuario

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "features": [
    enum (Feature)
  ]
}
Campos
features[]

enum (Feature)

Lista de funciones de RBM que admite este dispositivo.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

Función

Son los tipos de funciones de RBM que admite el usuario.

Enumeradores
FEATURE_UNSPECIFIED No se especifica.
REVOCATION Revocación Si el usuario admite la revocación, el agente puede revocar un mensaje que haya enviado antes de que la plataforma de RBM lo entregue.
RICHCARD_STANDALONE Tarjetas enriquecidas independientes
ACTION_CREATE_CALENDAR_EVENT Acción sugerida para crear un evento de calendario.
ACTION_DIAL Acción sugerida para marcar un número.
ACTION_OPEN_URL Acción sugerida para abrir una URL.
ACTION_SHARE_LOCATION Acción sugerida para compartir una ubicación.
ACTION_VIEW_LOCATION Acción sugerida para ver una ubicación en una app de mapas.