RBM Management API는 RBM 개발자 콘솔의 기능을 복제합니다. 이 API는 특히 자체 캠페인 플랫폼을 운영하고 RBM을 채널로 원활하게 통합하려는 애그리게이터와 파트너에게 유용합니다.
RBM Management API는 개발자가 프로그래매틱 방식으로 다음 작업을 할 수 있도록 지원하는 REST API입니다.
- RBM 에이전트 정의를 만들고 수정하며 애셋을 업로드합니다.
- 인증 및 출시를 위해 RBM 에이전트를 제출합니다.
- 인증 및 출시 정보를 가져옵니다.
RBM Management API는 Google의 Business Communications API에 대한 RCS 확장 프로그램으로 노출됩니다.
사용자 인증 정보
모든 RBM 개발자는 RBM 관리 API에 액세스할 수 있습니다. API를 호출할 때 Developer Console에서 만든 서비스 계정을 사용하여 인증합니다.
서비스 계정 키는 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 관리 API 사용 방법을 더 잘 이해하려면 다양한 언어로 된 샘플 코드를 다운로드하세요.
- cURL 샘플 다운로드
- Python 샘플 다운로드
- Java 샘플 다운로드
- Node.js 샘플 다운로드
클라이언트 라이브러리
클라이언트 라이브러리는 인증 및 API 마샬링/언마샬링을 처리하여 개발을 간소화합니다. 이러한 보고서는 여러 언어로 게시됩니다.
워크플로
RBM Management API로 에이전트를 만들고 실행하려면 다음 단계를 따르세요.
- 브랜드를 만듭니다.
- 브랜드에 에이전트를 만듭니다.
- 사용자 환경을 검증할 수 있도록 상담사에 테스터를 추가합니다.
- 인증을 위해 에이전트를 제출합니다.
- 하나 이상의 이동통신사와 함께 출시할 에이전트를 제출합니다.
- 출시 상태를 확인합니다.