Method: phones.getCapabilities

Obtiene las capacidades relacionadas con RCS para empresas de un usuario.

La carga útil devuelta especifica si se puede comunicar con un usuario a través de RCS for Business y, si es así, qué funciones de RCS for Business admite el usuario.

Control de errores: Se muestra un error 404 NOT_FOUND cuando no se puede comunicar con el usuario a través de RCS para empresas. Esto incluye varias situaciones: (1) El dispositivo del usuario no admite RCS o tiene inhabilitados los RCS. (2) El usuario se encuentra en una red móvil en la que no se lanzó el agente o en la que no está habilitado el tráfico de RCS. (3) Un agente no lanzado solicita las capacidades de un usuario que no es verificador.

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", donde {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

Es el ID único de la solicitud, asignado por el agente. Debe ser un UUID, según se define en https://tools.ietf.org/html/rfc4122. Si el ID de solicitud coincide con un ID que el agente usó para una solicitud anterior, la plataforma de RCS para Empresas ignora la nueva solicitud.
agentId

string

Obligatorio. Es el identificador único del agente.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la lista de funciones compatibles con el usuario.

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

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

enum (Feature)

Es una lista de las funciones de RCS para empresas que admite este dispositivo.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

Función

Son los tipos de funciones de RCS para Empresas que admite el usuario.

Enums
FEATURE_UNSPECIFIED No se especifica.
RICHCARD_STANDALONE Tarjetas enriquecidas independientes.
ACTION_CREATE_CALENDAR_EVENT Es la acción sugerida para crear un evento de calendario.
ACTION_DIAL Es la acción sugerida para marcar un número.
ACTION_OPEN_URL Es la acción sugerida para abrir una URL en el navegador.
ACTION_SHARE_LOCATION Es la acción sugerida para compartir una ubicación.
ACTION_VIEW_LOCATION Acción sugerida para ver una ubicación en una app de mapas.
ACTION_OPEN_URL_IN_WEBVIEW Es la acción sugerida para abrir una URL en WebView.