أشياء

مرجع الشركة

تحدد الشركة بشكل فريد.

اسم الحقل نوع البيانات الوصف
companyId string الإخراج فقط. رقم تعريف الشركة، الذي تم تعيينه من قبل الخادم.
vendor enum Samsung أو Google.

شركة

يمثل شركة.

اسم الحقل نوع البيانات الوصف
companyReference object(CompanyReference) الكائن المرجعي للشركة.
companyName string اسم الشركة. على سبيل المثال، XYZ Corp. يتم عرضه لموظفي الشركة في بوابة "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
vendorParams map حقول إضافية في أزواج المفتاح/القيمة التي يحددها المورد.

الجهاز

جهاز Android مسجَّل للتسجيل.

اسم الحقل نوع البيانات الوصف
deviceId string الإخراج فقط. رقم تعريف الجهاز الذي تم تخصيصه من خلال الخادم.
deviceIdentifier object(DeviceIdentifier) معرّفات الأجهزة التي تحدّد جهازًا مصنّعًا.
customer object(CompanyReference) أرقام تعريف الشركة التي تحدِّد الشركة التي تم تخصيص الأجهزة لها.
orderNumber string رقم الطلب.
vendorParams map حقول إضافية في أزواج المفتاح/القيمة التي يحددها المورد.

معرّف الجهاز

تتضمن معرّفات الأجهزة ومعرّفات المنتجات لتحديد جهاز الشركة المصنّعة.

تتطلب أجهزة Samsung أحد الحقول التالية:

  • IMEI
  • serialNumber
  • meid

ويتم تجاهل جميع الحقول الأخرى، مثل model.

لجميع أجهزة Android الأخرى:

  • تتطلب أجهزة الجوّال imei وmanufacturer.
  • تتطلب أجهزة Wi-Fi فقط serialNumber وmanufacturer وmodel.
اسم الحقل نوع البيانات الوصف
imei string رقم IMEI للجهاز تم التحقق من الإدخال.
serialNumber string الرقم التسلسلي للشركة المصنّعة للجهاز قد لا تكون هذه القيمة فريدة عبر طُرز الأجهزة المختلفة.
meid string رقم MEID للجهاز.
manufacturer string اسم الشركة المصنّعة للجهاز تتطابق مع القيمة المضمَّنة للجهاز التي تم عرضها من android.os.Build.MANUFACTURER. يتم إدراج القيم المسموح بها في الشركات المصنّعة.
model string اسم طراز الجهاز. تتطابق مع القيمة المضمَّنة للجهاز التي تم عرضها من android.os.Build.MODEL. يتم إدراج القيم المسموح بها في النماذج.

العملية

يحتوي هذا المورد على حالة استدعاء واجهة برمجة التطبيقات غير المتزامنة. هناك أربع حالات محتملة:

  • IN_PROGRESS: العملية قيد التقدم.
  • COMPLETE: تمت معالجة جميع الأجهزة بنجاح.
  • COMPLETE_WITH_ERRORS: تمت معالجة العملية، ولكن حدثت بعض الأخطاء. يتم إدراج جميع الأخطاء في قائمة deviceErrors.
  • FAILED: تعذّر إتمام العملية ولم يتم عرض operationId.
اسم الحقل نوع البيانات الوصف
operationId string رقم تعريف العملية، مسبوقًا بـ samsung/ أو google/. إذا كانت فارغة، تكون قيمة state هي FAILED.
operationType enum(operationType) نوع العملية: CLAIM_DEVICES أو UNCLAIM_DEVICES.
state enum(operationState) حالة العملية: IN_PROGRESS، COMPLETE، COMPLETE_WITH_ERRORS، FAILED.
deviceErrors قائمة object(DeviceOperationError) قائمة بأخطاء تشغيل الجهاز.
vendorParams map حقول إضافية في أزواج المفتاح/القيمة التي يحددها المورد.

خطأ في تشغيل الجهاز

حدث خطأ خاص بالجهاز في Operation. يحتوي كل مورد على deviceId وdeviceIdentifier نفس الطلب الذي بدأ العملية.

اسم الحقل نوع البيانات الوصف
deviceId string الإخراج فقط. رقم تعريف الجهاز الذي تم تخصيصه من خلال الخادم.
deviceIdentifier object(DeviceIdentifier) معرّفات الأجهزة التي تحدّد جهازًا مصنّعًا.
error object(Error) حدث خطأ في تشغيل الجهاز.

استثناء

استثناء يمكن طرحه بواسطة جميع واجهات برمجة التطبيقات المتزامنة.

اسم الموقع القيمة الوصف
error object(Error) حدث خطأ في العملية المتزامنة.

خطأ

كائن يحتوي على تفاصيل حول خطأ معيّن.

اسم الموقع القيمة الوصف
code enum(ErrorCode) رمز الخطأ. على سبيل المثال، INVALID_REQUESET أو PERMISSION_DENIED
message string رسالة الخطأ.
vendorMsg string شرح مفصّل للخطأ من المورِّد.
errorId string معرّف الخطأ الداخلي.
vendorParams map حقول إضافية في أزواج المفتاح/القيمة التي يحددها المورد.

رمز الخطأ

الأخطاء الشائعة.

تعداد الوصف
INVALID_PARAM_DEFAULT معلمة إدخال غير صالحة غير محددة. يمكنك إلقاء نظرة على المورِّد للحصول على مزيد من التفاصيل.
INVALID_PAGE_TOKEN الرمز المميز للصفحة الذي تم تقديمه غير صالح.
INVALID_CUSTOMER_ID الرقم التعريفي للعميل الذي أدخلته غير صالح.
INVALID_DEVICE_IMEI رقم IMEI هذا غير صالح.
INVALID_DEVICE_MEID MEID غير صالح.
INVALID_DEVICE_SERIAL الرقم التسلسلي غير صالح.
INVALID_OPERATION_ID معرّف العملية الذي تم تقديمه غير صالح.
INVALID_RESELLER_ID رقم تعريف المورّد الذي تم تقديمه غير صالح.
INVALID_MANUFACTURER الشركة المصنّعة التي قدمتها غير صالحة / غير متاحة.
INVALID_IDENTIFIER_SET مجموعة المعرّفات المقدَّمة غير كافية للطلب. اطّلِع على DeviceIdentifier للحصول على مزيد من المعلومات عن مجموعات المعرّفات المسموح بها.
INVALID_MODEL النموذج الذي تم تقديمه غير صالح / غير متوافق.
INVALID_DEVICE_ID رقم تعريف الجهاز الذي تم تقديمه غير صالح.
INVALID_DEVICE الجهاز الذي تم تقديمه غير موجود. هذا رمز خطأ خاص بـ Samsung.
DUPLICATE_DEVICE تمت المطالبة بالجهاز سابقًا لنفس العميل. لا يلزم اتخاذ أي إجراء تصحيحي.
DEVICE_UPLOAD_COUNT_EXCEEDED يحتوي الطلب على المزيد من الأجهزة التي تم بلوغ الحد الأقصى لاستخدامها حاليًا (100 ألف جهاز حاليًا).
AUTHORIZATION_FAIL ليست لديك إمكانية الدخول إلى مورد معين (على سبيل المثال، الجهاز، العميل)، أو أن المورد غير موجود. يمكنك الاطّلاع على vendorMsg للحصول على مزيد من التفاصيل.
INTERNAL_SERVER_ERROR خطأ غير محدد في الخادم الداخلي. يُرجى الاطّلاع على الموردMsg للحصول على مزيد من التفاصيل. ويمكن إعادة محاولة هذه الطلبات بناءً على طبيعة خطأ الخادم.
NOT_IMPLEMENTED لا يدعم الخادم طريقة الطلب.