বস্তু

কোম্পানির রেফারেন্স

একটি কোম্পানিকে অনন্যভাবে চিহ্নিত করে।

ক্ষেত্র নাম ডেটা টাইপ বর্ণনা
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 মত অন্য সব ক্ষেত্র উপেক্ষা করা হয়।

অন্য সব অ্যান্ড্রয়েড ডিভাইসের জন্য:

  • সেলুলার ডিভাইসের জন্য imei এবং manufacturer প্রয়োজন।
  • শুধুমাত্র ওয়াইফাই ডিভাইসের জন্য serialNumber , manufacturer এবং model প্রয়োজন।
ক্ষেত্র নাম ডেটা টাইপ বর্ণনা
imei string ডিভাইসটির IMEI নম্বর। ইনপুট উপর বৈধ.
serialNumber string ডিভাইসের জন্য প্রস্তুতকারকের সিরিয়াল নম্বর। এই মান বিভিন্ন ডিভাইস মডেল জুড়ে অনন্য নাও হতে পারে.
meid string ডিভাইসের MEID নম্বর।
manufacturer string ডিভাইস প্রস্তুতকারকের নাম। android.os.Build.MANUFACTURER থেকে ফেরত ডিভাইসের অন্তর্নির্মিত মান মেলে৷ অনুমোদিত মান নির্মাতাদের তালিকাভুক্ত করা হয়.
model string ডিভাইসের মডেলের নাম। android.os.Build.MODEL থেকে ফেরত ডিভাইসের অন্তর্নির্মিত মান মেলে৷ অনুমোদিত মানগুলি মডেলগুলিতে তালিকাভুক্ত করা হয়েছে।

অপারেশন

এই সংস্থানটিতে একটি অ্যাসিঙ্ক্রোনাস API কলের স্থিতি রয়েছে৷ চারটি সম্ভাব্য অবস্থা আছে:

  • 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 ) ডিভাইস অপারেশন ত্রুটি.

সাধারণ ব্যতিক্রম

একটি ব্যতিক্রম যা সমস্ত সিঙ্ক্রোনাস API দ্বারা নিক্ষিপ্ত হতে পারে।

সম্পত্তির নাম মান বর্ণনা
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 অনুরোধে আরও ডিভাইস রয়েছে যা সীমা (বর্তমানে 100k)।
AUTHORIZATION_FAIL আপনার কাছে একটি প্রদত্ত সংস্থানে অ্যাক্সেস নেই (যেমন ডিভাইস, গ্রাহক), বা সংস্থানটি বিদ্যমান নেই৷ আরও বিশদ পেতে vendorMsg দেখুন।
INTERNAL_SERVER_ERROR অনির্দিষ্ট অভ্যন্তরীণ সার্ভার ত্রুটি৷ আরও বিশদ পেতে vendorMsg দেখুন। সার্ভারের ত্রুটির প্রকৃতির উপর নির্ভর করে এই অনুরোধগুলি পুনরায় চেষ্টা করা যেতে পারে।
NOT_IMPLEMENTED অনুরোধ পদ্ধতি সার্ভার দ্বারা সমর্থিত নয়.
,

কোম্পানির রেফারেন্স

একটি কোম্পানিকে অনন্যভাবে চিহ্নিত করে।

ক্ষেত্র নাম ডেটা টাইপ বর্ণনা
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 মত অন্য সব ক্ষেত্র উপেক্ষা করা হয়।

অন্য সব অ্যান্ড্রয়েড ডিভাইসের জন্য:

  • সেলুলার ডিভাইসের জন্য imei এবং manufacturer প্রয়োজন।
  • শুধুমাত্র ওয়াইফাই ডিভাইসের জন্য serialNumber , manufacturer এবং model প্রয়োজন।
ক্ষেত্র নাম ডেটা টাইপ বর্ণনা
imei string ডিভাইসটির IMEI নম্বর। ইনপুট উপর বৈধ.
serialNumber string ডিভাইসের জন্য প্রস্তুতকারকের সিরিয়াল নম্বর। এই মান বিভিন্ন ডিভাইস মডেল জুড়ে অনন্য নাও হতে পারে.
meid string ডিভাইসের MEID নম্বর।
manufacturer string ডিভাইস প্রস্তুতকারকের নাম। android.os.Build.MANUFACTURER থেকে ফেরত ডিভাইসের অন্তর্নির্মিত মান মেলে৷ অনুমোদিত মান নির্মাতাদের তালিকাভুক্ত করা হয়.
model string ডিভাইসের মডেলের নাম। android.os.Build.MODEL থেকে ফেরত ডিভাইসের অন্তর্নির্মিত মান মেলে৷ অনুমোদিত মানগুলি মডেলগুলিতে তালিকাভুক্ত করা হয়েছে।

অপারেশন

এই সংস্থানটিতে একটি অ্যাসিঙ্ক্রোনাস API কলের স্থিতি রয়েছে৷ চারটি সম্ভাব্য অবস্থা আছে:

  • 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 ) ডিভাইস অপারেশন ত্রুটি.

সাধারণ ব্যতিক্রম

একটি ব্যতিক্রম যা সমস্ত সিঙ্ক্রোনাস API দ্বারা নিক্ষিপ্ত হতে পারে।

সম্পত্তির নাম মান বর্ণনা
error object( Error ) সিঙ্ক্রোনাস অপারেশন ত্রুটি।

ত্রুটি

একটি ত্রুটি সম্পর্কে বিশদ বিবরণ ধারণকারী একটি বস্তু.

সম্পত্তির নাম মান বর্ণনা
code enum( ErrorCode ) ত্রুটি কোড. উদাহরণস্বরূপ, INVALID_REQUESET বা PERMISSION_DENIED
message string ত্রুটি বার্তা.
vendorMsg string বিক্রেতার কাছ থেকে ত্রুটির একটি বিস্তারিত ব্যাখ্যা।
errorId string অভ্যন্তরীণ ত্রুটি সনাক্তকারী।
vendorParams map বিক্রেতা-নির্দিষ্ট কী-মান জোড়ায় অতিরিক্ত ক্ষেত্র।

ভুল সংকেত

সাধারণ ত্রুটি.

এনাম বর্ণনা
INVALID_PARAM_DEFAULT অনির্দিষ্ট অবৈধ ইনপুট পরামিতি। আরও বিশদ বিবরণ পেতে vendorMsg দেখুন।
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 অনুরোধে আরও ডিভাইস রয়েছে যা সীমা (বর্তমানে 100k)।
AUTHORIZATION_FAIL আপনার কাছে একটি প্রদত্ত সংস্থানে অ্যাক্সেস নেই (যেমন ডিভাইস, গ্রাহক), বা সংস্থানটি বিদ্যমান নেই৷ আরও বিশদ পেতে vendorMsg দেখুন।
INTERNAL_SERVER_ERROR অনির্দিষ্ট অভ্যন্তরীণ সার্ভার ত্রুটি৷ আরও বিশদ পেতে vendorMsg দেখুন। সার্ভারের ত্রুটির প্রকৃতির উপর নির্ভর করে এই অনুরোধগুলি পুনরায় চেষ্টা করা যেতে পারে।
NOT_IMPLEMENTED অনুরোধ পদ্ধতি সার্ভার দ্বারা সমর্থিত নয়.