RBM Management API

RBM Management API は、RBM デベロッパー コンソールの機能を複製します。この API は、独自のキャンペーン プラットフォームを運用しており、RBM をチャネルとしてシームレスに統合したいアグリゲーターやパートナーにとって特に便利です。

RBM Management API は、デベロッパーが次の操作をプログラムで行えるようにする REST API です。

  • RBM エージェント定義を作成、編集し、アセットをアップロードする。
  • 確認とリリースに向けて RBM エージェントを送信します。
  • 確認とリリースの情報を取得します。

RBM Management API は、Google の Business Communications API の RCS 拡張機能として公開されています。

認証情報

すべての RBM デベロッパーが RBM Management API にアクセスできます。API を呼び出すときは、デベロッパー コンソールで作成したサービス アカウントを使用して認証します。

サービス アカウント キーは、Google OAuth2 サーバーで認証を行い、アクセス トークンを取得するために使用されます。このアクセス トークンは、RBM Management API の呼び出しに使用されます。このプロセスの詳細については、サービス アカウント認証のページをご覧ください。

この API の OAuth スコープは businesscommunications です。

これらのコード スニペットは、認証に Google の公開ライブラリを使用する方法を示しています。

cURL

curl を使用する場合は、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)
 このコードは、RBM Management API サンプルからの抜粋です。

トークンの有効期限と更新の実装は複雑であるため、認証を独自に実装しないことを強くおすすめします。

サンプルコード

RBM Management API の使用方法をより深く理解するには、さまざまな言語のサンプルコードをダウンロードしてください。

クライアント ライブラリ

クライアント ライブラリは、認証と API のマーシャリングとアンマーシャリングを処理して、開発を簡素化します。複数の言語で公開されています。

ワークフロー

RBM Management API を使用してエージェントを作成して起動する手順は次のとおりです。

  1. ブランドを作成します。
  2. ブランドにエージェントを作成します。
  3. ユーザー エクスペリエンスを検証できるように、エージェントにテスターを追加します。
  4. エージェントを送信して確認を行います。
  5. 1 つ以上の携帯通信会社でリリースするエージェントを送信します。
  6. リリース ステータスを確認します。
次へ
携帯通信会社（リージョン）を一覧表示する