البدء

قبل استخدام "مكتبة مورّدي أجهزة Android العاديين"، على المورّدين الانضمام إلى برنامج Knox Deployment Program وبرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" من Android.

برنامج نشر Knox (KDP)

اتّبِع الخطوات أدناه للانضمام إلى KDP واسترداد التفاصيل اللازمة لبدء استخدام مكتبة المورّد.

الخطوة 1: الاشتراك في KDP

1. يُرجى الانتقال إلى Samsung Knox للمورّدين للاشتراك في KDP.
2. أنشئ حسابًا على Samsung وسجِّل للحصول على حساب Samsung Knox بصفتك مورّدًا.
3. بعد الموافقة على حساب المورّد، سجِّل الدخول إلى بوابة KDP للعثور على resellerId.

الخطوة 2: طلب الوصول إلى بوابة Knox Cloud API

1. أرسِل طلبًا إلى Samsung للوصول إلى بوابة Knox Cloud API.
2. سجِّل الدخول إلى بوابة Knox Cloud API.

الخطوة 3: الحصول على مفاتيح حساب الخدمة وclientIdentifier

1. نزِّل ملف JSON لزوج المفاتيح من بوابة واجهة برمجة تطبيقات Knox Cloud API وخزنه في مكان آمن.
2. أنشئ clientIdentifier فريدًا من بوابة Knox Cloud API.

الخطوة 4: إنشاء عنصر SamsungResellerService

استخدِم مسار ملف JSON، clientIdentifier، resellerId لإنشاء كائن SamsungResellerService لاستخدام المكتبة المشتركة.

إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة

الخطوة 1: الانضمام إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة"

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

باستخدام حساب Google نفسه الذي تستخدمه للوصول إلى البوابة، اتّبِع التعليمات المتبقية لإنشاء حساب خدمة وتفعيل Reseller API.

الخطوة 2: إنشاء حساب خدمة

حساب الخدمة، الذي يُعرف أحيانًا باسم حساب الروبوت، هو حساب Google يمثّل التطبيقات بدلاً من المستخدمين. بما أنّ مكتبة التسجيل تستدعي واجهات برمجة تطبيقات Google نيابةً عن حساب الخدمة، استخدِم "وحدة تحكّم واجهة برمجة تطبيقات Google" لإعداد إمكانية الوصول.

إنشاء مشروع في وحدة تحكم واجهة برمجة التطبيقات

من المفيد إنشاء مشروع جديد في وحدة تحكم واجهة برمجة التطبيقات وحساب خدمة. ويسهِّل ذلك إدارة الوصول وإدارة الموارد وإصلاح المفاتيح المفقودة في المستقبل. ابدأ باتّباع الخطوات أدناه لإنشاء مشروع جديد في وحدة التحكم في واجهة Google API:

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

لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على مستند Google Cloud Platform بعنوان إدارة المشاريع في وحدة التحكّم.

إضافة بيانات اعتماد خدمة جديدة

لإضافة بيانات اعتماد جديدة وحساب خدمة إلى مشروعك، اتّبِع الخطوات التالية أدناه في "وحدة تحكّم واجهة برمجة التطبيقات".

1. افتح صفحة حسابات الخدمة. اختَر مشروعًا إذا طُلب منك ذلك.
2. انقر على إنشاء حساب للخدمة ثم أدخِل اسمًا ووصفًا لحساب الخدمة. يمكنك استخدام معرّف حساب الخدمة التلقائي أو اختيار معرّف فريد مختلف. وعند الانتهاء من ذلك، انقر على إنشاء.
3. قسم أذونات حساب الخدمة (اختيارية) التالي غير مطلوب. انقر على متابعة.
4. انتقِل إلى القسم إنشاء مفتاح في أسفل شاشة منح المستخدمين صلاحية الوصول إلى حساب الخدمة هذا. انقر على إنشاء مفتاح.
5. في اللوحة الجانبية التي تظهر، اختَر التنسيق الذي تريده للمفتاح: وننصح باختيار: JSON.
6. انقر على إنشاء. يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، وهو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات عن طريقة التخزين الآمن للمفتاح، يُرجى مراجعة إدارة مفاتيح حساب الخدمة.
7. انقر على إغلاق في مربّع الحوار تم حفظ المفتاح الخاص على الكمبيوتر، ثم انقر على تم للرجوع إلى جدول حسابات الخدمة.

انسخ عنوان البريد الإلكتروني لحساب الخدمة واحفظه في متناول اليد. ستحتاج إليه لاحقًا عند ربط حساب الخدمة بمؤسستك.

الخطوة 3: تخزين ملف مفتاح JSON

تُنشئ "وحدة تحكّم واجهات برمجة التطبيقات" مفتاحَي تشفير خاصَّين جديدَين يتم استخدامهما للمصادقة على طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام حساب الخدمة. يوجد المفتاح الخاص في ملف مفتاح JSON الذي تقوم بتنزيله.

يجب الحفاظ على سرية المفتاح، لذا لا تدرجه في رمز مصدر البرنامج. إذا فقدت ملف المفاتيح، عليك إنشاء مفتاحَين جديدَين.

لمزيد من المعلومات حول تخزين ملف المفاتيح بأمان، يمكنك الاطّلاع على أفضل الممارسات لاستخدام مفاتيح واجهة برمجة التطبيقات بأمان.

الخطوة 4: تفعيل واجهة برمجة التطبيقات

قبل أن تتمكّن المكتبة من استخدام Reseller API، عليك تفعيلها. يؤدي تفعيل واجهة برمجة تطبيقات إلى ربطها بمشروع API Console الحالي، ويؤدي أيضًا إلى إضافة صفحات المراقبة في وحدة التحكّم.

لتمكين واجهة برمجة تطبيقات المورد، اتبع الخطوات أدناه في وحدة تحكم واجهة برمجة التطبيقات:

1. انقر على واجهات برمجة التطبيقات والخدمات > المكتبة.
2. استخدِم حقل البحث للعثور على Android Device Provisioning Partner API.
3. انقر على Android Device Provisioning Partner API.
4. انقر على تفعيل.

بعد تأخير قصير، تتغير حالة واجهة برمجة التطبيقات إلى مفعَّلة. إذا لم يظهر لك Android Device Provisioning Partner API، تأكَّد من أنّ مؤسستك تم إعدادها للاستفادة من برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة". تأكَّد من استخدام حساب Google نفسه لكل من ميزة "إعداد الأجهزة الجوّالة للمؤسسات بدون تلامس" و"وحدة تحكّم Google API". اطلب من مستشار حلول منصّة Google التحقّق مما إذا كان حسابك على Google يملك إذن الوصول إلى واجهة برمجة التطبيقات.

الخطوة 5: ربط حساب الخدمة

يؤدي ربط حساب الخدمة بحساب "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" في مؤسستك إلى تفويض حساب الخدمة لإجراء طلبات بيانات من واجهة برمجة التطبيقات بالنيابة عن مؤسستك. اتّبِع الخطوات التالية لربط حساب الخدمة:

1. افتح بوابة "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". وقد تحتاج إلى تسجيل الدخول.
2. انقر على حسابات الخدمة.
3. انقر على ربط حساب الخدمة.
4. اضبط عنوان البريد الإلكتروني على عنوان حساب الخدمة الذي أنشأته.
5. انقر على ربط حساب الخدمة لاستخدام حساب الخدمة مع حساب التسجيل باستخدام ميزة "إعداد الجهاز تلقائيًا" .

إذا لم تتمكن من العثور على عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته، انسخه من أحد الأماكن التالية:

• رقم تعريف حساب الخدمة من صفحة حسابات الخدمة في وحدة التحكم في Google API.
• حقل السمة client_email في ملف مفتاح JSON.

يمكنك الآن استخدام حساب الخدمة مع مكتبة التسجيل لإنشاء ResellerService عناصر.

إضافة مكتبة Common Android Reseller Library إلى مشروع Gradle

تتوفّر المكتبة كـ مستودع Maven. اتّبِع الخطوات التالية لإضافة المكتبة إلى مشروع Gradle جديد:

1. شغِّل الأمر التالي لإنشاء مشروع جديد:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. انسخ ملف service_account_key.json الذي نزّلته في الخطوة 2 إلى الدليل src/main/resources/ الذي أنشأته أعلاه.

3. افتح ملف build.gradle التلقائي وأعلِن عن مستودع Maven المركزي الذي تريد إنشاءه:

   repositories {
       mavenCentral()
   }
   

4. في الملف نفسه، أضِف التبعية التالية:

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

من المفترض أن يتمكن مشروعك الآن من استخدام مكتبة العملاء لتسجيل أجهزة Android.

---

الخطوات التالية: العمليات الشائعة