La API de RBM Management replica las capacidades de la Consola del desarrollador de RBM. Esta API es especialmente útil para los agregadores y socios que operan sus propias plataformas de campañas y desean integrar RBM como un canal sin problemas.
La API de RBM Management es una API de REST que permite a los desarrolladores realizar las siguientes acciones de manera programática:
- Crear y editar definiciones de agentes de RBM, y subir recursos
- Envía los agentes de RBM para su verificación y lanzamiento.
- Recupera la información de verificación y lanzamiento.
La API de RBM Management se expone como extensiones de RCS a la API de Business Communications de Google.
Credenciales de autenticación
Cualquier desarrollador de RBM puede acceder a la API de RBM Management. Cuando llamas a la API, te autenticas con una cuenta de servicio que creaste en la Consola de Google Developers.
La clave de tu cuenta de servicio se usa para autenticarte con el servidor de Google OAuth2 y obtener un token de acceso que luego se usa para llamar a la API de RBM Management. Puedes obtener más información sobre este proceso en la página Autenticación de cuentas de servicio.
El alcance de OAuth para esta API es businesscommunications.
En estos fragmentos de código, se muestra cómo usar las bibliotecas públicas de Google para la autenticación.
cURL
Cuando usas curl, puedes autenticarte generando un token de portador de autorización a partir de la clave de tu cuenta de servicio con la herramienta oauth2l.-H "`oauth2l header --json rbm-developer-service-account-credentials.json businesscommunications`"Python
from google.auth.transport.requests import AuthorizedSession from google.oauth2 import service_account BASE_ENDPOINT = 'https://businesscommunications.googleapis.com/v1/' SCOPES = ['https://www.googleapis.com/auth/businesscommunications'] credentials = service_account.Credentials.from_service_account_file( './rbm-developer-service-account-credentials.json', scopes = SCOPES) authed_session = AuthorizedSession(credentials)
Recomendamos a los desarrolladores que no implementen la autenticación por su cuenta, dada la complejidad de implementar la actualización y el vencimiento de tokens.
Código de muestra
Para comprender mejor cómo usar la API de RBM Management, descarga el código de muestra en una variedad de lenguajes:
- Descarga muestras de cURL
- Descarga muestras de Python
- Descarga las muestras de Java
- Descarga las muestras de Node.js
Bibliotecas cliente
Las bibliotecas cliente controlan la autenticación y el ordenamiento y desordenamiento de las APIs para simplificar tu desarrollo. Se publican en varios idiomas:
Flujo de trabajo
Para crear y lanzar un agente con la API de Management de RBM, sigue estos pasos:
- Crea una marca.
- Crea un agente en la marca.
- Agrega verificadores al agente para que puedas validar la experiencia del usuario.
- Envía el agente para su verificación.
- Envía el agente para su lanzamiento con uno o más operadores.
- Verifica el estado de lanzamiento.