دليل الدمج

الحصول على المفتاح الخاص

استخدام واجهة الإعداد

للدمج مع واجهة برمجة التطبيقات، يجب إنشاء مشروع Google Cloud. بعد ذلك، يمكنك إنشاء حساب خدمة والحصول على مفتاح خاص. للبدء، انقر على الزر التالي:

إنشاء حساب خدمة

إنشاء المفتاح يدويًا

في حال تعذُّر تنفيذ الواجهة أعلاه، يُرجى تجربة ما يلي:

  1. انتقِل إلى Google Cloud Console.
  2. اختَر المشروع الذي تريد الوصول إلى واجهة برمجة التطبيقات منه.
  3. ضمن قائمة "إدارة الهوية وإمكانية الوصول" (IAM) و"المشرف"، على يمين الصفحة، ابحث عن حسابات الخدمة وأنشئ حساب خدمة جديدًا سيكون مالك المشروع.
  4. بعد إنشاء حساب الخدمة، من المفترض أن تتلقّى مفتاحًا خاصًا.

إضافة حساب الخدمة إلى القائمة البيضاء

بعد إنشاء حساب خدمة:

  1. يمكنك التواصل مع فريق عمل GTAF على mdp-support@google.com باستخدام حساب Google مالك المشروع. ستتم إضافة حساب Google إلى القائمة البيضاء للوصول إلى نقاط نهاية واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال.
  2. ربط حساب الخدمة بمشغّل شبكة الجوّال على Google ISP Portal. ويمكن لمشغّل شبكة الجوّال إجراء هذا الربط من خلال الانتقال إلى الوصول إلى واجهة برمجة التطبيقات.

تفعيل المكتبة

بعد الانتهاء من إضافة القائمة البيضاء:

  1. انتقِل إلى Google Cloud Console.
  2. تأكد من أنك اخترت المشروع الصحيح في القائمة المنسدلة في شريط القوائم العلوي.
  3. فعِّل واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال في مكتبة واجهة برمجة التطبيقات.
  4. فعِّل واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال مسبقًا في مكتبة واجهة برمجة التطبيقات.

اختبار الوصول إلى واجهة برمجة التطبيقات

لاختبار إمكانية الوصول إلى الطرق الجانبية في Google:

  1. ثبِّت oauth2l.

  2. يمكنك الحصول على رمز الدخول لحساب الخدمة على النحو التالي. your-service-account-key-file.json هو ملف رئيسي لحساب الخدمة.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    ملاحظة: تنتهي صلاحية رمز الدخول خلال ساعة واحدة تقريبًا. قبل تنفيذ الأمر أعلاه مرة أخرى على رمز دخول جديد، شغِّل oauth2l reset لمحو ذاكرة التخزين المؤقت المحلية.

  3. ويمكنك إجراء مكالمات الاختبار كما يلي. يجب أن يكون YOUR-ASN أحد أسماء ASN التي ترسلها إلينا عندما نُعدّ GTAF أثناء عملية الدمج. ACCESS-TOKEN-OBTAINED هو مُخرجات الأمر oauth2l fetch أعلاه. PLAN_STATUS هي نص طلب PlanStatus الذي تريد إرساله إلى GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

طلبات بيانات واجهة برمجة التطبيقات الآلية

اتّبِع التعليمات لإجراء مكالمات معتمَدة مع طرق Google الجانبية باستخدام نطاق OAuth التالي:

https://www.googleapis.com/auth/dataplansharing

مشاركة ملكية المشروع

على الرغم من أنّ عملية الإعداد الأوّلية تشمل حسابًا واحدًا على Google، إلا أنّه من المفيد أن يحصل مجموعة من المستخدمين المُعتمَدين على ملكية المشروع. في Google Cloud Console، ضمن"إدارة الهوية وإمكانية الوصول" (IAM)، يمكنك إضافة أعضاء جدد (بما في ذلك حساب"مجموعات Google") ليكونوا مالكين للمشروع.