Die RBM Management API

Die RBM Management API bietet dieselben Funktionen wie die RBM Developer Console. Diese API ist besonders nützlich für Aggregatoren und Partner, die eigene Kampagnenplattformen betreiben und RBM nahtlos als Channel einbinden möchten.

Die RBM Management API ist eine REST API, mit der Entwickler programmatisch Folgendes tun können:

  • RBM-Agentendefinitionen erstellen und bearbeiten und Assets hochladen
  • RBM-Agents zur Überprüfung und zum Start einreichen
  • Bestätigungs- und Launch-Informationen abrufen

Die RBM Management API wird als RCS-Erweiterung der Business Communications API von Google bereitgestellt.

Anmeldedaten für die Authentifizierung

Alle RBM-Entwickler können auf die RBM Management API zugreifen. Wenn Sie die API aufrufen, authentifizieren Sie sich mit einem Dienstkonto, das Sie in der Developer Console erstellt haben.

Ihr Dienstkontoschlüssel wird für die Authentifizierung beim Google OAuth2-Server verwendet, um ein Zugriffstoken zu erhalten, mit dem dann die RBM Management API aufgerufen wird. Weitere Informationen zu diesem Prozess finden Sie auf der Seite Dienstkontoauthentifizierung.

Der OAuth-Bereich für diese API ist businesscommunications.

Diese Code-Snippets zeigen, wie Sie die öffentlichen Bibliotheken von Google für die Authentifizierung verwenden.

cURL

Wenn Sie curl verwenden, können Sie sich authentifizieren, indem Sie mit dem Tool oauth2l ein Autorisierungs-Bearer-Token aus Ihrem Dienstkontoschlüssel generieren. 
-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)
 Dieser Code ist ein Auszug aus unserem RBM Management API-Beispiel.

Wir raten Entwicklern dringend davon ab, die Authentifizierung selbst zu implementieren, da die Implementierung von Tokenablauf und ‑aktualisierung sehr komplex ist.

Beispielcode

Wenn Sie besser verstehen möchten, wie Sie die RBM Management API verwenden, können Sie den Beispielcode in verschiedenen Sprachen herunterladen:

Clientbibliotheken

Clientbibliotheken übernehmen die Authentifizierung sowie das Marshalling und Unmarshalling von APIs, um die Entwicklung zu vereinfachen. Sie werden in mehreren Sprachen veröffentlicht:

Workflow

So erstellen und starten Sie einen Agent mit der RBM Management API:

  1. Marke erstellen
  2. Erstellen Sie einen Agent in der Marke.
  3. Fügen Sie dem Agent Tester hinzu, damit Sie die Nutzerfreundlichkeit überprüfen können.
  4. Reichen Sie den Agent zur Überprüfung ein.
  5. Reichen Sie den Agent bei einem oder mehreren Mobilfunkanbietern zur Einführung ein.
  6. Prüfen Sie den Startstatus.
Weiter
Mobilfunkanbieter (Regionen) auflisten