Method: phones.getCapabilities

Obtén las funciones relacionadas con RCS para empresas de un usuario.

La carga útil que se devuelve especifica si se puede contactar a un usuario con RCS para empresas y, de ser así, qué funciones de RCS para empresas admite el usuario.

Manejo de errores: Se devuelve un error 404 NOT_FOUND cuando no se puede establecer contacto con el usuario a través de RCS para empresas. Esto incluye varias situaciones: (1) El dispositivo del usuario no admite RCS o tiene los RCS inhabilitados. (2) El usuario está en una red móvil en la que no se inicia 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

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, como se define en https://www.rfc-editor.org/info/rfc9562. 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 solicitud nueva.
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 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)
  ],
  "carrier": string
}
Campos
features[]

enum (Feature)

Es la lista de funciones de RCS para empresas que admite este dispositivo.
carrier

string

Solo salida. Es la información del operador al que pertenece el número de teléfono del usuario, según los backends de RCS de Google. Actualmente, este campo solo se completa para los números de teléfono de EE.UU.

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 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 en el navegador.
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.
ACTION_OPEN_URL_IN_WEBVIEW Es la acción sugerida para abrir una URL en WebView.