دليل الدمج

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

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

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

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

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

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

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

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

بعد إنشاء حساب خدمة، اتّبِع الخطوات التالية:

1. يُرجى التواصل مع فريق GTAF على [e-mail] باستخدام حساب Google الذي يملك المشروع. سنضيف حساب Google إلى القائمة البيضاء لمنحه إذن الوصول إلى نقاط نهاية Mobile Data Plan Sharing API.
2. ربط حساب الخدمة بمشغّل شبكة الجوّال على بوابة Google لمقدّمي خدمات الإنترنت يمكن لمشغّل شبكة الجوّال إجراء هذا الربط من خلال الانتقال إلى إذن الوصول إلى واجهة برمجة التطبيقات.

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

بعد إكمال عملية إضافة عنوان URL إلى القائمة البيضاء، اتّبِع الخطوات التالية:

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

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

لاختبار إمكانية الوصول إلى طرق 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) ليكونوا مالكين للمشروع.