مرجع الشركة
تحدد الشركة بشكل فريد.
اسم الحقل | نوع البيانات | الوصف |
---|---|---|
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 |
لا يدعم الخادم طريقة الطلب. |