RBM Management API

RBM Management API, RBM Developer Console'un özelliklerini kopyalar. Bu API, özellikle kendi kampanya platformlarını işleten ve RBM'yi sorunsuz bir şekilde kanal olarak entegre etmek isteyen toplayıcılar ve iş ortakları için faydalıdır.

RBM Management API, geliştiricilerin programatik olarak aşağıdakileri yapmasına olanak tanıyan bir REST API'dir:

  • RBM temsilci tanımları oluşturma ve düzenleme, öğe yükleme
  • RBM temsilcilerini doğrulama ve kullanıma sunma için gönderin.
  • Doğrulama ve lansman bilgilerini alın.

RBM Management API, Google'ın Business Communications API'sine RCS uzantıları olarak sunulur.

Kimlik doğrulama kimlik bilgileri

Tüm RBM geliştiricileri, RBM Management API'ye erişebilir. API'yi çağırırken Developer Console'da oluşturduğunuz bir hizmet hesabını kullanarak kimlik doğrulama yaparsınız.

Hizmet Hesabı anahtarınız, Google OAuth2 sunucusunda kimlik doğrulaması yapmak için kullanılır. Bu işlem sonucunda, RBM Yönetim API'sini çağırmak için kullanılan bir erişim jetonu elde edilir. Bu işlem hakkında daha fazla bilgiyi Hizmet Hesabı Kimlik Doğrulaması sayfasında bulabilirsiniz.

Bu API'nin OAuth kapsamı businesscommunications'dır.

Bu kod snippet'leri, kimlik doğrulama için Google'ın herkese açık kitaplıklarının nasıl kullanılacağını gösterir.

cURL

curl kullanırken oauth2l aracını kullanarak hizmet hesabı anahtarınızdan bir yetkilendirme taşıyıcı jetonu oluşturarak kimlik doğrulaması yapabilirsiniz.
-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)
Bu kod, RBM Management API örneğimizden alınmıştır.

Jetonun geçerlilik süresinin dolması ve yenilenmesi işlemlerinin karmaşıklığı nedeniyle, geliştiricilerin kimlik doğrulama işlemini kendilerinin uygulamamasını önemle tavsiye ederiz.

Örnek kod

RBM Management API'yi nasıl kullanacağınızı daha iyi anlamak için çeşitli dillerdeki örnek kodu indirin:

İstemci kitaplıkları

İstemci kitaplıkları, geliştirme sürecinizi basitleştirmek için kimlik doğrulama ve API marshalling ve unmarshalling işlemlerini gerçekleştirir. Bu makaleler birden fazla dilde yayınlanmaktadır:

İş akışı

RBM Management API ile bir temsilci oluşturup başlatmak için aşağıdaki adımları uygulayın:

  1. Marka oluşturun.
  2. Markada bir aracı oluşturun.
  3. Kullanıcı deneyimini doğrulayabilmek için aracıya test kullanıcıları ekleyin.
  4. Temsilciyi doğrulamaya gönderin.
  5. Temsilciyi bir veya daha fazla operatörle kullanıma sunmak için gönderin.
  6. Başlatma durumunu kontrol edin.