تكرّر RBM Management API إمكانات RBM Developer Console. تُعدّ واجهة برمجة التطبيقات هذه مفيدة بشكل خاص للمجمّعين والشركاء الذين يديرون منصات حملاتهم الخاصة ويريدون دمج مراسلة المؤسسات من خلال خدمات الاتصالات التفاعلية (RCS) بسلاسة كقناة.
RBM Management API هي واجهة برمجة تطبيقات REST تتيح للمطوّرين تنفيذ ما يلي آليًا:
- إنشاء تعريفات وكلاء مراسلة المؤسسات من خلال خدمات الاتصالات التفاعلية (RCS) وتعديلها وتحميل مواد العرض
- إرسال وكلاء مراسلة المؤسسات من خلال خدمات الاتصالات التفاعلية (RCS) للتحقّق منهم وإطلاقهم
- استرداد معلومات التحقّق والإطلاق
تظهر RBM Management API كإضافات RCS لواجهة Google's Business Communications API.
بيانات اعتماد للمصادقة
يمكن لأي مطوّر في مراسلة المؤسسات من خلال خدمات الاتصالات التفاعلية (RCS) الوصول إلى RBM Management API. عند استدعاء واجهة برمجة التطبيقات، تتم المصادقة باستخدام حساب خدمة أنشأته في Play Console.
يُستخدَم مفتاح حساب الخدمة للمصادقة مع خادم Google OAuth2 للحصول على رمز الدخول الذي يُستخدَم بعد ذلك لاستدعاء RBM Management 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 بشكل أفضل، نزِّل نموذج الرموز البرمجية بمجموعة من اللغات:
- تنزيل نماذج cURL
- تنزيل نماذج Python
- تنزيل نماذج Java
- تنزيل نماذج Node.js
مكتبات العملاء
تتولى مكتبات العملاء عملية المصادقة وتنسيق واجهة برمجة التطبيقات وإلغاء تنسيقها لتبسيط عملية التطوير. وهي منشورة بلغات متعددة:
سير العمل
لإنشاء وكيل وإطلاقه باستخدام RBM Management API، اتّبِع الخطوات التالية:
- إنشاء علامة تجارية
- إنشاء وكيل في العلامة التجارية
- إضافة مختبِرين إلى الوكيل حتى تتمكّن من التحقّق من تجربة المستخدم
- إرسال الوكيل للتحقّق منه
- إرسال الوكيل لإطلاقه مع مشغّل شبكة جوّال واحد أو أكثر
- الاطّلاع على حالة الإطلاق