RBM Management API

RBM Management API 复制了 RBM 开发者控制台的功能。 此 API 特别适用于运营自己的广告系列平台并希望将 RBM 无缝集成为渠道的聚合商和合作伙伴。

RBM Management API 是一种 REST API，开发者可以使用它以编程方式执行以下操作：

• 创建和修改 RBM 代理定义并上传素材资源。
• 提交 RBM 代理以进行验证和发布。
• 检索验证和发布信息。

RBM Management API 作为 Google's 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，请下载多种语言的示例代码：

• 下载 c网址 示例
• 下载 Python 示例
• 下载 Java 示例
• 下载 Node.js 示例

客户端库

客户端库可处理身份验证以及 API 编组和解组，以简化开发工作。它们以多种语言发布：

• Csharp
• Java
• Node.js

工作流程

如需使用 RBM Management API 创建和发布代理，请按以下步骤操作：

1. 创建品牌。
2. 在品牌中创建代理。
3. 向代理添加测试人员，以便验证用户体验。
4. 提交代理以进行验证。
5. 向一个或多个运营商提交代理以进行发布。
6. 检查发布状态。