Method: enterprises.devices.issueCommand

কোনো ডিভাইসে একটি কমান্ড জারি করে। ফেরত আসা Operation রিসোর্সটির metadata ফিল্ডে একটি Command থাকে। কমান্ডটির স্ট্যাটাস জানতে get operation মেথডটি ব্যবহার করুন।

HTTP অনুরোধ

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
name

string

ডিভাইসের নামটি enterprises/{enterpriseId}/devices/{deviceId} ফর্ম্যাটে থাকবে।

অনুরোধকারী শরীর

অনুরোধের বডিতে Command এর একটি ইনস্ট্যান্স থাকে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Operation এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/androidmanagement

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

আদেশ

একটি আদেশ।

JSON উপস্থাপনা
{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  },
  "addEsimParams": {
    object (AddEsimParams)
  },
  "removeEsimParams": {
    object (RemoveEsimParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  },
  "wipeParams": {
    object (WipeParams)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  },
  "esimStatus": {
    object (EsimCommandStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
type

enum ( CommandType )

কমান্ডের ধরণ।

createTime

string ( Timestamp format)

যে টাইমস্ট্যাম্পে কমান্ডটি তৈরি করা হয়েছিল। টাইমস্ট্যাম্পটি সার্ভার দ্বারা স্বয়ংক্রিয়ভাবে তৈরি হয়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

duration

string ( Duration format)

যে সময়কালের জন্য কমান্ডটি বৈধ থাকে। এই সময়ের মধ্যে ডিভাইসটি দ্বারা কার্যকর না হলে কমান্ডটির মেয়াদ শেষ হয়ে যাবে। নির্দিষ্ট করা না থাকলে ডিফল্ট সময়কাল দশ মিনিট। এর কোনো সর্বোচ্চ সময়কাল নেই।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s"

userName

string

ডিভাইসটির মালিক ব্যবহারকারীর রিসোর্স নামটি enterprises/{enterpriseId}/users/{userId} ফর্ম্যাটে থাকে। যে ডিভাইসে কমান্ডটি পাঠানো হয়, তার উপর ভিত্তি করে সার্ভার এটি স্বয়ংক্রিয়ভাবে তৈরি করে।

errorCode

enum ( CommandErrorCode )

যদি কমান্ডটি ব্যর্থ হয়, তাহলে ব্যর্থতার কারণ ব্যাখ্যা করে একটি এরর কোড। কলার দ্বারা কমান্ডটি বাতিল করা হলে এটি সেট করা হয় না। কমান্ডের ত্রুটি সম্পর্কে জানার জন্য, নিম্নলিখিত ক্রমে ফিল্ডগুলিকে অগ্রাধিকার দিন (সবচেয়ে পছন্দেরটি প্রথমে): ১. কমান্ড-নির্দিষ্ট ফিল্ড যেমন clearAppsDataStatus , startLostModeStatus , বা অনুরূপ, যদি সেগুলি বিদ্যমান থাকে। ২. এই ফিল্ড, যদি সেট করা থাকে। ৩. যে Operation কমান্ডটিকে আবৃত করে, তার মধ্যে থাকা জেনেরিক error ফিল্ড।

newPassword

string

RESET_PASSWORD ধরনের কমান্ডের ক্ষেত্রে, ঐচ্ছিকভাবে নতুন পাসওয়ার্ড নির্দিষ্ট করা যায়। দ্রষ্টব্য: অ্যান্ড্রয়েড ১৪ ডিভাইসের ক্ষেত্রে, নতুন পাসওয়ার্ডটি সংখ্যাসূচক হলে তা অবশ্যই কমপক্ষে ৬ অক্ষরের হতে হবে। অন্যথায়, কমান্ডটি INVALID_VALUE সাথে ব্যর্থ হবে।

resetPasswordFlags[]

enum ( ResetPasswordFlag )

RESET_PASSWORD ধরনের কমান্ডের ক্ষেত্রে, ঐচ্ছিকভাবে ফ্ল্যাগ নির্দিষ্ট করা যায়।

কমান্ডের জন্য নির্দিষ্ট প্যারামিটার। উল্লেখ্য যে, কিছু কমান্ড এটি ব্যবহার করে না, বিশেষ করে LOCK , RESET_PASSWORD , REBOOT , এবং RELINQUISH_OWNERSHIP । ভবিষ্যতে এই কমান্ডগুলোও এটি ব্যবহার করতে পারে।

যদি এটি সেট করা থাকে, তাহলে new_password এবং reset_password_flags ফিল্ডগুলো অবশ্যই সেট করা যাবে না। নিচে পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা থাকবে:

clearAppsDataParams

object ( ClearAppsDataParams )

ডিভাইস থেকে নির্দিষ্ট অ্যাপের ডেটা মুছে ফেলার জন্য CLEAR_APP_DATA কমান্ডের প্যারামিটারসমূহ। ClearAppsDataParams দেখুন। যদি এটি সেট করা থাকে, তবে type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে CLEAR_APP_DATA তে সেট করে দেয়। type স্পষ্টভাবে CLEAR_APP_DATA তে সেট করাও গ্রহণযোগ্য।

startLostModeParams

object ( StartLostModeParams )

ডিভাইসটিকে লস্ট মোডে রাখার জন্য START_LOST_MODE কমান্ডের প্যারামিটারসমূহ। StartLostModeParams দেখুন। যদি এটি সেট করা থাকে, তবে type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে START_LOST_MODE এ সেট করে দেয়। type স্পষ্টভাবে START_LOST_MODE এ সেট করাও গ্রহণযোগ্য।

stopLostModeParams

object ( StopLostModeParams )

ডিভাইসটিকে লস্ট মোড থেকে বের করে আনার জন্য STOP_LOST_MODE কমান্ডের প্যারামিটারসমূহ। StopLostModeParams দেখুন। যদি এটি সেট করা থাকে, তবে type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে STOP_LOST_MODE এ সেট করে দেয়। type স্পষ্টভাবে STOP_LOST_MODE এ সেট করাও গ্রহণযোগ্য।

addEsimParams

object ( AddEsimParams )

ঐচ্ছিক। ডিভাইসে একটি ই-সিম প্রোফাইল যোগ করার জন্য ADD_ESIM কমান্ডের প্যারামিটারসমূহ। যদি এটি সেট করা থাকে, তবে type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে ADD_ESIM এ সেট করে দেয়। স্পষ্টভাবে type কে ADD_ESIM এ সেট করাও গ্রহণযোগ্য।

removeEsimParams

object ( RemoveEsimParams )

ঐচ্ছিক। ডিভাইস থেকে একটি ই-সিম প্রোফাইল মুছে ফেলার জন্য REMOVE_ESIM কমান্ডের প্যারামিটারসমূহ। যদি এটি সেট করা থাকে, তবে type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে REMOVE_ESIM এ সেট করে দেয়। স্পষ্টভাবে type কে REMOVE_ESIM এ সেট করাও গ্রহণযোগ্য।

requestDeviceInfoParams

object ( RequestDeviceInfoParams )

ঐচ্ছিক। ডিভাইস সম্পর্কিত তথ্য পাওয়ার জন্য REQUEST_DEVICE_INFO কমান্ডের প্যারামিটারসমূহ। এটি সেট করা থাকলে, type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে REQUEST_DEVICE_INFO তে সেট করে দেয়। এছাড়াও, type স্পষ্টভাবে REQUEST_DEVICE_INFO তে সেট করাও গ্রহণযোগ্য।

wipeParams

object ( WipeParams )

ঐচ্ছিক। ডিভাইসটি মুছে ফেলার জন্য WIPE কমান্ডের প্যারামিটারসমূহ। এটি সেট করা থাকলে, type সেট না করার পরামর্শ দেওয়া হয়। এক্ষেত্রে, সার্ভার স্বয়ংক্রিয়ভাবে এটিকে WIPE এ সেট করে দেয়। স্পষ্টভাবে type কে WIPE এ সেট করাও গ্রহণযোগ্য।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।
কমান্ড-নির্দিষ্ট স্ট্যাটাস। উল্লেখ্য যে, কিছু কমান্ড এটি ব্যবহার করে না, বিশেষ করে LOCK , RESET_PASSWORD , REBOOT , এবং RELINQUISH_OWNERSHIP । ভবিষ্যতে এই কমান্ডগুলোও এটি ব্যবহার করতে পারে। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
clearAppsDataStatus

object ( ClearAppsDataStatus )

শুধুমাত্র আউটপুট। ডিভাইস থেকে নির্দিষ্ট অ্যাপগুলোর ডেটা মুছে ফেলার জন্য ব্যবহৃত CLEAR_APP_DATA কমান্ডের স্ট্যাটাস। ClearAppsDataStatus দেখুন।

startLostModeStatus

object ( StartLostModeStatus )

শুধুমাত্র আউটপুট। ডিভাইসটিকে লস্ট মোডে রাখার জন্য ব্যবহৃত START_LOST_MODE কমান্ডের স্ট্যাটাস। StartLostModeStatus দেখুন।

stopLostModeStatus

object ( StopLostModeStatus )

শুধুমাত্র আউটপুট। ডিভাইসটিকে লস্ট মোড থেকে বের করে আনার জন্য ব্যবহৃত STOP_LOST_MODE কমান্ডের স্ট্যাটাস। StopLostModeStatus দেখুন।

esimStatus

object ( EsimCommandStatus )

শুধুমাত্র আউটপুট। ADD_ESIM বা REMOVE_ESIM কমান্ডের অবস্থা।

requestDeviceInfoStatus

object ( RequestDeviceInfoStatus )

শুধুমাত্র আউটপুট। REQUEST_DEVICE_INFO কমান্ডের অবস্থা।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

কমান্ডের ধরণ

কমান্ডের প্রকারভেদ।

এনাম
COMMAND_TYPE_UNSPECIFIED এই মানটি অনুমোদিত নয়।
LOCK ডিভাইসটি লক করুন, যেন লক স্ক্রিনের সময়সীমা শেষ হয়ে গেছে। কোনো ওয়ার্ক প্রোফাইলের ক্ষেত্রে, যদি আলাদা ওয়ার্ক প্রোফাইল লক থাকে, তবে এটি শুধুমাত্র সেই ওয়ার্ক প্রোফাইলটিকেই লক করে, তবে একটি ব্যতিক্রম রয়েছে: প্রতিষ্ঠান-মালিকানাধীন অ্যান্ড্রয়েড ৮, ৯, বা ১০ চালিত ডিভাইসের ওয়ার্ক প্রোফাইলগুলোর ক্ষেত্রে, এটি পুরো ডিভাইসটিকেই লক করে দেয়।
RESET_PASSWORD ব্যবহারকারীর পাসওয়ার্ড রিসেট করুন।
REBOOT ডিভাইসটি রিবুট করুন। শুধুমাত্র অ্যান্ড্রয়েড ৭.০ (এপিআই লেভেল ২৪) বা তার উচ্চতর সংস্করণে চালিত সম্পূর্ণ পরিচালিত ডিভাইসগুলিতে সমর্থিত।
RELINQUISH_OWNERSHIP কোম্পানির মালিকানাধীন একটি অ্যান্ড্রয়েড ৮.০+ ডিভাইস থেকে কাজের প্রোফাইল এবং সমস্ত পলিসি মুছে দেয়, এবং ডিভাইসটিকে ব্যক্তিগত ব্যবহারের জন্য ছেড়ে দেয়। ব্যক্তিগত প্রোফাইল(গুলি)র সাথে যুক্ত অ্যাপ এবং ডেটা সংরক্ষিত থাকে। ডিভাইসটি কমান্ডটি স্বীকার করার পর সার্ভার থেকে এটি মুছে ফেলা হবে।
CLEAR_APP_DATA নির্দিষ্ট অ্যাপগুলির অ্যাপ্লিকেশন ডেটা মুছে ফেলে। এটি অ্যান্ড্রয়েড ৯ এবং তার পরবর্তী সংস্করণগুলিতে সমর্থিত। মনে রাখবেন যে, একটি অ্যাপ্লিকেশন তার নিজস্ব অ্যাপ্লিকেশন ডেটার বাইরেও ডেটা সংরক্ষণ করতে পারে, যেমন এক্সটার্নাল স্টোরেজে বা ব্যবহারকারীর ডিকশনারিতে। clearAppsDataParams ও দেখুন।
START_LOST_MODE ডিভাইসটিকে লস্ট মোডে রাখে। শুধুমাত্র সম্পূর্ণভাবে পরিচালিত ডিভাইস অথবা পরিচালিত প্রোফাইলযুক্ত প্রতিষ্ঠানের মালিকানাধীন ডিভাইসে সমর্থিত। startLostModeParams ও দেখুন।
STOP_LOST_MODE ডিভাইসটিকে লস্ট মোড থেকে বের করে আনে। শুধুমাত্র সম্পূর্ণভাবে পরিচালিত ডিভাইস অথবা পরিচালিত প্রোফাইলযুক্ত প্রতিষ্ঠানের মালিকানাধীন ডিভাইসে সমর্থিত। stopLostModeParams ও দেখুন।
ADD_ESIM ডিভাইসে একটি ই-সিম প্রোফাইল যোগ করে। এটি অ্যান্ড্রয়েড ১৫ এবং তার উপরের সংস্করণগুলোতে সমর্থিত। addEsimParams ও দেখুন। একটি ই-সিম প্রোফাইল মুছে ফেলার জন্য, REMOVE_ESIM কমান্ডটি ব্যবহার করুন। ডিভাইস ওয়াইপ করা হলে ই-সিম প্রোফাইলের কী হবে তা নির্ধারণ করতে, পলিসিতে wipeDataFlags সেট করুন। দ্রষ্টব্য: একটি ডিভাইসে একাধিক ই-সিম প্রোভিশন করার জন্য, পরপর কমান্ডটি চালানোর মধ্যে কয়েক মিনিটের ব্যবধান রাখার পরামর্শ দেওয়া হয়।
REMOVE_ESIM ডিভাইস থেকে একটি ই-সিম প্রোফাইল মুছে ফেলে। এটি অ্যান্ড্রয়েড ১৫ এবং তার পরবর্তী সংস্করণগুলোতে সমর্থিত। removeEsimParams ও দেখুন।
REQUEST_DEVICE_INFO ডিভাইস সম্পর্কিত তথ্য অনুরোধ করুন।
WIPE কোম্পানির মালিকানাধীন ডিভাইসের ক্ষেত্রে ফ্যাক্টরি রিসেটের মাধ্যমে, অথবা ওয়ার্ক প্রোফাইলসহ ব্যক্তিগত মালিকানাধীন ডিভাইসের ক্ষেত্রে ওয়ার্ক প্রোফাইলটি মুছে ফেলার মাধ্যমে ডিভাইসটি ওয়াইপ করা হয়। ডিভাইসটি কমান্ডটি স্বীকার করলেই কেবল ওয়াইপ প্রক্রিয়াটি সম্পন্ন হয়। এর আগে কমান্ডটি বাতিল করা যেতে পারে।

কমান্ড ত্রুটি কোড

একটি কমান্ড ত্রুটি কোড। এটি একটি পঠনযোগ্য ক্ষেত্র যা সার্ভার দ্বারা পূরণ করা হয়।

এনাম
COMMAND_ERROR_CODE_UNSPECIFIED কোনো ত্রুটি ছিল না।
UNKNOWN একটি অজানা ত্রুটি ঘটেছে।
API_LEVEL ডিভাইসটির এপিআই লেভেল এই কমান্ডটি সমর্থন করে না।
MANAGEMENT_MODE ম্যানেজমেন্ট মোড (প্রোফাইল ওনার, ডিভাইস ওনার, ইত্যাদি) এই কমান্ডটি সমর্থন করে না।
INVALID_VALUE কমান্ডটির প্যারামিটার মানটি অবৈধ।
UNSUPPORTED ডিভাইসটি কমান্ডটি সমর্থন করে না। অ্যান্ড্রয়েড ডিভাইস পলিসি সর্বশেষ সংস্করণে আপডেট করলে সমস্যাটির সমাধান হতে পারে।

পাসওয়ার্ড রিসেট করুন

RESET_PASSWORD কমান্ড টাইপের জন্য ব্যবহারযোগ্য ফ্ল্যাগসমূহ।

এনাম
RESET_PASSWORD_FLAG_UNSPECIFIED এই মানটি উপেক্ষা করা হয়।
REQUIRE_ENTRY ব্যবহারকারী পাসওয়ার্ড প্রবেশ না করানো পর্যন্ত অন্য অ্যাডমিনদের তা পুনরায় পরিবর্তন করতে দেবেন না।
DO_NOT_ASK_CREDENTIALS_ON_BOOT ডিভাইস চালু করার সময় ব্যবহারকারীর পরিচয়পত্র চাইবেন না।
LOCK_NOW পাসওয়ার্ড রিসেট করার পর ডিভাইসটি লক করুন।

ClearAppsDataParams

ডিভাইস থেকে নির্দিষ্ট অ্যাপগুলোর ডেটা মুছে ফেলার জন্য ব্যবহৃত CLEAR_APP_DATA কমান্ডের সাথে সম্পর্কিত প্যারামিটারগুলো।

JSON উপস্থাপনা
{
  "packageNames": [
    string
  ]
}
ক্ষেত্র
packageNames[]

string

কমান্ডটি কার্যকর করা হলে যে অ্যাপগুলোর ডেটা মুছে ফেলা হবে, সেগুলোর প্যাকেজের নাম।

StartLostModeParams

ডিভাইসটিকে লস্ট মোডে রাখার জন্য START_LOST_MODE কমান্ডের সাথে সম্পর্কিত প্যারামিটারসমূহ। ডিভাইসটিকে লস্ট মোডে রাখার জন্য, প্রতিষ্ঠানের নাম ছাড়া প্যারামিটারগুলোর মধ্যে অন্তত একটি অবশ্যই প্রদান করতে হবে।

JSON উপস্থাপনা
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
ক্ষেত্র
lostMessage

object ( UserFacingMessage )

ডিভাইসটি লস্ট মোডে থাকলে ব্যবহারকারীকে এই বার্তাটি দেখানো হয়।

lostPhoneNumber

object ( UserFacingMessage )

ডিভাইসটি লস্ট মোডে থাকা অবস্থায় কল ওনার বাটনটি ট্যাপ করলে যে ফোন নম্বরে কল করা হবে।

lostEmailAddress

string

ডিভাইসটি লস্ট মোডে থাকলে ব্যবহারকারীকে যে ইমেল ঠিকানাটি দেখানো হয়।

lostStreetAddress

object ( UserFacingMessage )

ডিভাইসটি হারিয়ে গেলে ব্যবহারকারীকে রাস্তার ঠিকানা দেখানো হয়।

lostOrganization

object ( UserFacingMessage )

ডিভাইসটি লস্ট মোডে থাকলে ব্যবহারকারীকে প্রতিষ্ঠানের নাম দেখানো হয়।

StopLostModeParams

এই প্রকারে কোনো ক্ষেত্র নেই।

ডিভাইসটিকে লস্ট মোড থেকে বের করে আনার জন্য STOP_LOST_MODE কমান্ডের সাথে সম্পর্কিত প্যারামিটারসমূহ।

AddEsimParams

ডিভাইসে একটি ই-সিম প্রোফাইল যোগ করার জন্য ADD_ESIM কমান্ডের সাথে সম্পর্কিত প্যারামিটারসমূহ।

JSON উপস্থাপনা
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
ক্ষেত্র
activationCode

string

ই-সিম প্রোফাইলের অ্যাক্টিভেশন কোডটি প্রয়োজন।

activationState

enum ( ActivationState )

প্রয়োজনীয়। ই-সিম প্রোফাইলটি ডাউনলোড হয়ে গেলে সেটির অ্যাক্টিভেশন অবস্থা।

অ্যাক্টিভেশন অবস্থা

ই-সিম প্রোফাইলটি ডাউনলোড হয়ে যাওয়ার পর তার সক্রিয়করণ অবস্থা।

এনাম
ACTIVATION_STATE_UNSPECIFIED eSIM অ্যাক্টিভেশন অবস্থা নির্দিষ্ট করা নেই। ডিফল্টরূপে, ব্যক্তিগত মালিকানাধীন ডিভাইসগুলিতে eSIM প্রোফাইলটি NOT_ACTIVATED এবং কোম্পানির মালিকানাধীন ডিভাইসগুলিতে ACTIVATED থাকে।
ACTIVATED ডাউনলোড করার পর ই-সিম স্বয়ংক্রিয়ভাবে সক্রিয় হয়ে যায়। ব্যক্তিগত মালিকানাধীন ডিভাইসগুলির জন্য সক্রিয়করণ অবস্থা হিসেবে এটি সেট করলে কমান্ডটি প্রত্যাখ্যাত হবে।
NOT_ACTIVATED ই-সিম প্রোফাইলটি ডাউনলোড হয়েছে কিন্তু অ্যাক্টিভেট হয়নি। এক্ষেত্রে, ব্যবহারকারীকে ডিভাইসে ম্যানুয়ালি ই-সিমটি অ্যাক্টিভেট করতে হবে।

RemoveEsimParams

ডিভাইস থেকে একটি ই-সিম প্রোফাইল মুছে ফেলার জন্য ব্যবহৃত REMOVE_ESIM কমান্ডের সাথে সম্পর্কিত প্যারামিটারসমূহ।

JSON উপস্থাপনা
{
  "iccId": string
}
ক্ষেত্র
iccId

string

প্রয়োজনীয়। যে ই-সিম প্রোফাইলটি মুছে ফেলতে হবে, তার আইসিসি আইডি।

অনুরোধডিভাইসতথ্যপ্যারামিটার

ডিভাইস সম্পর্কিত তথ্য পাওয়ার জন্য REQUEST_DEVICE_INFO কমান্ডের সাথে সংশ্লিষ্ট প্যারামিটারগুলো।

JSON উপস্থাপনা
{
  "deviceInfo": enum (DeviceInfo)
}
ক্ষেত্র
deviceInfo

enum ( DeviceInfo )

আবশ্যক। যে ধরনের ডিভাইসের তথ্য অনুরোধ করতে হবে।

ডিভাইসইনফো

যে ধরনের ডিভাইসের তথ্য অনুরোধ করতে হবে।

এনাম
DEVICE_INFO_UNSPECIFIED এই মানটি অনুমোদিত নয়।
EID ই-সিমের জন্য আইডেন্টিফায়ার অনুরোধ করা হচ্ছে। ফলাফল দেখানোর আগে, তথ্য প্রকাশের জন্য ব্যবহারকারীকে অনুমোদন দিতে বলা হবে। যদি ব্যবহারকারী তথ্য প্রকাশে অনুমোদন না দেন, তাহলে USER_DECLINED দেখানো হবে। এই সুবিধাটি শুধুমাত্র ওয়ার্ক প্রোফাইলযুক্ত ব্যক্তিগত মালিকানাধীন ডিভাইস এবং অ্যান্ড্রয়েড ভার্সন ১৩ ও তার উপরের সংস্করণের জন্য সমর্থিত।

ওয়াইপপ্যারামস

ডিভাইসটি মুছে ফেলার জন্য ব্যবহৃত WIPE কমান্ডের সাথে সম্পর্কিত প্যারামিটারসমূহ।

JSON উপস্থাপনা
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
ক্ষেত্র
wipeDataFlags[]

enum ( WipeDataFlag )

ঐচ্ছিক। কোন ডেটা মুছে ফেলা হবে তা নির্ধারণ করার জন্য ফ্ল্যাগ।

wipeReason

object ( UserFacingMessage )

ঐচ্ছিক। ব্যক্তিগত ডিভাইসে কাজের প্রোফাইল মুছে ফেলার আগে ব্যবহারকারীকে দেখানো একটি সংক্ষিপ্ত বার্তা। কোম্পানির মালিকানাধীন ডিভাইসের উপর এর কোনো প্রভাব নেই। বার্তাটির সর্বোচ্চ দৈর্ঘ্য ২০০ অক্ষর।

ক্লিয়ারঅ্যাপস ডেটা স্ট্যাটাস

ডিভাইস থেকে নির্দিষ্ট অ্যাপগুলোর ডেটা মুছে ফেলার জন্য ব্যবহৃত CLEAR_APP_DATA কমান্ডের অবস্থা।

JSON উপস্থাপনা
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
ক্ষেত্র
results

map (key: string, value: object ( PerAppResult ))

প্রতিটি অ্যাপের ফলাফল, যা প্যাকেজের নাম থেকে সংশ্লিষ্ট ক্লিয়ারিং ফলাফলের একটি ম্যাপিং।

একটি অবজেক্ট যা "key": value জোড়ের একটি তালিকা ধারণ করে। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

PerAppResult

একটি নির্দিষ্ট অ্যাপের ডেটা মুছে ফেলার চেষ্টার ফলাফল।

JSON উপস্থাপনা
{
  "clearingResult": enum (ClearingResult)
}
ক্ষেত্র
clearingResult

enum ( ClearingResult )

একটি নির্দিষ্ট অ্যাপের ডেটা মুছে ফেলার চেষ্টার ফলাফল।

ক্লিয়ারিংরেজাল্ট

একটি নির্দিষ্ট অ্যাপের ডেটা মুছে ফেলার চেষ্টার ফলাফল।

এনাম
CLEARING_RESULT_UNSPECIFIED অনির্দিষ্ট ফলাফল।
SUCCESS এই অ্যাপটির ডেটা সফলভাবে মুছে ফেলা হয়েছে।
APP_NOT_FOUND অ্যাপটি খুঁজে না পাওয়ায় এর ডেটা মুছে ফেলা সম্ভব হয়নি।
APP_PROTECTED এই অ্যাপটি সুরক্ষিত হওয়ায় এর ডেটা মুছে ফেলা সম্ভব হয়নি। উদাহরণস্বরূপ, এটি ডিভাইসের কার্যকারিতার জন্য অপরিহার্য অ্যাপগুলোর ক্ষেত্রে প্রযোজ্য হতে পারে, যেমন গুগল প্লে স্টোর।
API_LEVEL এই অ্যাপের ডেটা মুছে ফেলা যায়নি, কারণ ডিভাইস এপিআই লেভেল এই কমান্ডটি সমর্থন করে না।

স্টার্টলস্টমোডস্ট্যাটাস

ডিভাইসটিকে লস্ট মোডে রাখার জন্য ব্যবহৃত START_LOST_MODE কমান্ডের অবস্থা।

JSON উপস্থাপনা
{
  "status": enum (Status)
}
ক্ষেত্র
status

enum ( Status )

অবস্থা। StartLostModeStatus দেখুন।

অবস্থা

অবস্থা। StartLostModeStatus দেখুন।

এনাম
STATUS_UNSPECIFIED অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
SUCCESS ডিভাইসটি লস্ট মোডে চলে গেছে।
RESET_PASSWORD_RECENTLY ডিভাইসটিকে লস্ট মোডে রাখা যায়নি, কারণ অ্যাডমিন সম্প্রতি ডিভাইসটির পাসওয়ার্ড রিসেট করেছেন।
USER_EXIT_LOST_MODE_RECENTLY ডিভাইসটিকে লস্ট মোডে রাখা যায়নি, কারণ ব্যবহারকারী সম্প্রতি লস্ট মোড থেকে বেরিয়ে এসেছেন।
ALREADY_IN_LOST_MODE ডিভাইসটি ইতিমধ্যে লস্ট মোডে আছে।

স্টপলস্টমোডস্ট্যাটাস

ডিভাইসটিকে লস্ট মোড থেকে বের করে আনার জন্য ব্যবহৃত STOP_LOST_MODE কমান্ডের অবস্থা।

JSON উপস্থাপনা
{
  "status": enum (Status)
}
ক্ষেত্র
status

enum ( Status )

অবস্থা। StopLostModeStatus দেখুন।

অবস্থা

অবস্থা। StopLostModeStatus দেখুন।

এনাম
STATUS_UNSPECIFIED অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
SUCCESS ডিভাইসটিকে লস্ট মোড থেকে বের করে আনা হয়েছে।
NOT_IN_LOST_MODE ডিভাইসটি লস্ট মোডে নেই।

EsimCommandStatus

ADD_ESIM বা REMOVE_ESIM কমান্ডের স্ট্যাটাস এবং ত্রুটির বিবরণ (যদি থাকে)।

JSON উপস্থাপনা
{
  "status": enum (Status),
  "esimInfo": {
    object (EsimInfo)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "internalErrorDetails": {
    object (InternalErrorDetails)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
status

enum ( Status )

শুধুমাত্র আউটপুট। ADD_ESIM বা REMOVE_ESIM কমান্ডের অবস্থা।

esimInfo

object ( EsimInfo )

শুধুমাত্র আউটপুট। যোগ করা বা সরানো ই-সিম সম্পর্কিত তথ্য। এটি শুধুমাত্র তখনই পূরণ করা হয় যখন ই-সিম অপারেশনের status SUCCESS হয়।

ADD_ESIM বা REMOVE_ESIM কমান্ডের স্থিতির বিবরণ। নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি প্রতিক্রিয়ায় এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
internalErrorDetails

object ( InternalErrorDetails )

শুধুমাত্র আউটপুট। status INTERNAL_ERROR সেট করা থাকলে ত্রুটির বিস্তারিত বিবরণ।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

অবস্থা

ADD_ESIM বা REMOVE_ESIM কমান্ডের অবস্থা।

এনাম
STATUS_UNSPECIFIED অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
SUCCESS ডিভাইসটিতে ই-সিম কার্যক্রম সফলভাবে সম্পন্ন হয়েছে।
IN_PROGRESS ই-সিম কার্যক্রম চলমান আছে।
PENDING_USER_ACTION ই-সিম কার্যক্রমটি এগিয়ে নিয়ে যাওয়ার জন্য ব্যবহারকারীকে একটি পদক্ষেপ নিতে হবে।
ERROR_SETUP_IN_PROGRESS সেটআপ চলাকালীন ই-সিম অপারেশনটি চালানো যাবে না।
ERROR_USER_DENIED ব্যবহারকারী ই-সিম কার্যক্রমটি প্রত্যাখ্যান করেছেন।
INTERNAL_ERROR ডিভাইসটিতে ই-সিম যোগ বা অপসারণ করার সময় একটি ত্রুটি ঘটেছে, internalErrorDetails দেখুন।
ERROR_ICC_ID_NOT_FOUND REMOVE_ESIM কমান্ডের ক্ষেত্রে, যে eSIM-টি অপসারণ করতে হবে তার iccId ডিভাইসটিতে খুঁজে পাওয়া যায়নি। এর অর্থ হতে পারে যে, eSIM-টি এন্টারপ্রাইজের নয় অথবা উক্ত iccId সাথে সম্পর্কিত eSIM-টি ডিভাইসটিতে উপস্থিত নেই।
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT ADD_ESIM কমান্ডটি ব্যর্থ হয়েছে যখন একটি নতুন ই-সিম যোগ করার চেষ্টা করা হচ্ছিল যার অ্যাক্টিভেশন অবস্থা ACTIVATED হিসেবে সেট করা ছিল, কারণ ডিভাইসের একাধিক ই-সিম স্লটে সক্রিয় ই-সিম প্রোফাইল রয়েছে এবং কোনো খালি ই-সিম স্লট উপলব্ধ নেই। এর সমাধান করতে, নতুন ই-সিমটি তার অ্যাক্টিভেশন অবস্থা NOT_ACTIVATED হিসেবে যোগ করা যেতে পারে, যা পরে ম্যানুয়ালি সক্রিয় করা হবে, অথবা অপারেশনটি সম্পন্ন করার জন্য ব্যবহারকারীকে প্রথমে একটি বিদ্যমান সক্রিয় ই-সিম নিষ্ক্রিয় করতে হবে।

অভ্যন্তরীণ ত্রুটির বিবরণ

ADD_ESIM বা REMOVE_ESIM কমান্ডের ক্ষেত্রে কোনো অভ্যন্তরীণ ত্রুটি থাকলে তার বিবরণ।

JSON উপস্থাপনা
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
ক্ষেত্র
operationCode

string ( int64 format)

শুধুমাত্র আউটপুট। এখানে উল্লেখিত অপারেশন কোডের পূর্ণসংখ্যা রূপ। আরও বিস্তারিত জানতে operationCodeDetail দেখুন।

errorCode

string ( int64 format)

শুধুমাত্র আউটপুট। এখানে উল্লেখিত ত্রুটি কোডের পূর্ণসংখ্যা রূপ। আরও দেখুন, OPERATION_SMDX_SUBJECT_REASON_CODE । আরও বিস্তারিত জানতে errorCodeDetail দেখুন।

operationCodeDetail

enum ( OperationCodeDetail )

শুধুমাত্র আউটপুট। operationCode এর সাথে সম্পর্কিত অপারেশন কোডের বিস্তারিত বিবরণ।

errorCodeDetail

enum ( ErrorCodeDetail )

শুধুমাত্র আউটপুট। errorCode এর সাথে সম্পর্কিত ত্রুটি কোডের বিস্তারিত বিবরণ।

অপারেশনকোডবিস্তারিত

operationCode এর সাথে সম্পর্কিত অপারেশন কোডের বিস্তারিত বিবরণ।

এনাম
OPERATION_CODE_DETAIL_UNSPECIFIED অপারেশন কোডের বিবরণ অনির্দিষ্ট। অ্যান্ড্রয়েড ম্যানেজমেন্ট এপিআই দ্বারা operationCode স্বীকৃত নয়। তবে, operationCode দেখুন।
OPERATION_SYSTEM বিস্তারিত জানতে EuiccManager.OPERATION_SYSTEM দেখুন।
OPERATION_SIM_SLOT বিস্তারিত জানতে EuiccManager.OPERATION_SIM_SLOT দেখুন।
OPERATION_EUICC_CARD বিস্তারিত জানতে EuiccManager.OPERATION_EUICC_CARD দেখুন।
OPERATION_SMDX বিস্তারিত জানতে EuiccManager.OPERATION_SMDX দেখুন।
OPERATION_SWITCH বিস্তারিত জানতে EuiccManager.OPERATION_SWITCH দেখুন।
OPERATION_DOWNLOAD বিস্তারিত জানতে EuiccManager.OPERATION_DOWNLOAD দেখুন।
OPERATION_METADATA বিস্তারিত জানতে EuiccManager.OPERATION_METADATA দেখুন।
OPERATION_EUICC_GSMA বিস্তারিত জানতে EuiccManager.OPERATION_EUICC_GSMA দেখুন।
OPERATION_APDU বিস্তারিত জানতে EuiccManager.OPERATION_APDU দেখুন।
OPERATION_SMDX_SUBJECT_REASON_CODE বিস্তারিত জানতে EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE দেখুন। লক্ষ্য করুন যে, এই ক্ষেত্রে, errorCode হলো EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE এর সর্বনিম্ন গুরুত্বপূর্ণ ৩ বাইট, যা এখানে নির্দেশিত বিষয় কোড এবং কারণ কোড নির্দিষ্ট করে। পূর্ণসংখ্যাটির সর্বোচ্চ গুরুত্বপূর্ণ বাইটটি শূন্য করে দেওয়া হয়। উদাহরণস্বরূপ, 8.11.1 বিষয় কোড এবং 5.1 কারণ কোডকে errorCode এ বাইনারিতে 0000 0000 1000 1011 0001 0000 0101 0001 হিসেবে দেখানো হয়, যা দশমিকে 9113681-এর সমান।
OPERATION_HTTP বিস্তারিত জানতে EuiccManager.OPERATION_HTTP দেখুন।

ত্রুটি কোডের বিবরণ

errorCode এর সাথে সম্পর্কিত ত্রুটি কোডের বিস্তারিত বিবরণ।

এনাম
ERROR_CODE_DETAIL_UNSPECIFIED ত্রুটি কোডের বিস্তারিত বিবরণ অনির্দিষ্ট। errorCode অ্যান্ড্রয়েড ম্যানেজমেন্ট এপিআই দ্বারা স্বীকৃত নয়। তবে, errorCode দেখুন।
ERROR_TIME_OUT বিস্তারিত জানতে EuiccManager.ERROR_TIME_OUT দেখুন।
ERROR_EUICC_MISSING বিস্তারিত জানতে EuiccManager.ERROR_EUICC_MISSING দেখুন।
ERROR_UNSUPPORTED_VERSION বিস্তারিত জানতে EuiccManager.ERROR_UNSUPPORTED_VERSION দেখুন।
ERROR_ADDRESS_MISSING বিস্তারিত জানতে EuiccManager.ERROR_ADDRESS_MISSING দেখুন।
ERROR_INVALID_CONFIRMATION_CODE বিস্তারিত জানতে EuiccManager.ERROR_INVALID_CONFIRMATION_CODE দেখুন।
ERROR_CERTIFICATE_ERROR বিস্তারিত জানতে EuiccManager.ERROR_CERTIFICATE_ERROR দেখুন।
ERROR_NO_PROFILES_AVAILABLE বিস্তারিত জানতে EuiccManager.ERROR_NO_PROFILES_AVAILABLE দেখুন।
ERROR_CONNECTION_ERROR বিস্তারিত জানতে EuiccManager.ERROR_CONNECTION_ERROR দেখুন।
ERROR_INVALID_RESPONSE বিস্তারিত জানতে EuiccManager.ERROR_INVALID_RESPONSE দেখুন।
ERROR_CARRIER_LOCKED বিস্তারিত জানতে EuiccManager.ERROR_CARRIER_LOCKED দেখুন।
ERROR_DISALLOWED_BY_PPR বিস্তারিত জানতে EuiccManager.ERROR_DISALLOWED_BY_PPR দেখুন।
ERROR_INVALID_ACTIVATION_CODE বিস্তারিত জানতে EuiccManager.ERROR_INVALID_ACTIVATION_CODE দেখুন।
ERROR_INCOMPATIBLE_CARRIER বিস্তারিত জানতে EuiccManager.ERROR_INCOMPATIBLE_CARRIER দেখুন।
ERROR_OPERATION_BUSY বিস্তারিত জানতে EuiccManager.ERROR_OPERATION_BUSY দেখুন।
ERROR_INSTALL_PROFILE বিস্তারিত জানতে EuiccManager.ERROR_INSTALL_PROFILE দেখুন।
ERROR_EUICC_INSUFFICIENT_MEMORY বিস্তারিত জানতে EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY দেখুন।
ERROR_INVALID_PORT বিস্তারিত জানতে EuiccManager.ERROR_INVALID_PORT দেখুন।
ERROR_SIM_MISSING বিস্তারিত জানতে EuiccManager.ERROR_SIM_MISSING দেখুন।

EsimInfo

যোগ করা বা সরানো ই-সিমের বিবরণ।

JSON উপস্থাপনা
{
  "iccId": string
}
ক্ষেত্র
iccId

string

শুধুমাত্র আউটপুট। ই-সিমের আইসিসি আইডি।

অনুরোধ ডিভাইস তথ্য স্থিতি

REQUEST_DEVICE_INFO কমান্ডের অবস্থা।

JSON উপস্থাপনা
{
  "status": enum (Status),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "eidInfo": {
    object (EidInfo)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
status

enum ( Status )

শুধুমাত্র আউটপুট। REQUEST_DEVICE_INFO কমান্ডের অবস্থা।

অ্যাডমিনের অনুরোধ করা ডিভাইসের তথ্যের বিবরণ। এটি শুধুমাত্র তখনই পূরণ করা হয় যখন status SUCCEEDED হয়। নিম্নলিখিতটি হলো পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলির একটি তালিকা। একটি প্রতিক্রিয়ায় এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
eidInfo

object ( EidInfo )

ডিভাইসটির ইআইডি-গুলো সম্পর্কিত তথ্য।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

অবস্থা

REQUEST_DEVICE_INFO কমান্ডের অবস্থা।

এনাম
STATUS_UNSPECIFIED অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
SUCCEEDED ডিভাইসের তথ্য সফলভাবে পৌঁছে দেওয়া হয়েছে।
PENDING_USER_ACTION ব্যবহারকারী ডিভাইসের তথ্য শেয়ার করার জন্য প্রয়োজনীয় পদক্ষেপগুলো সম্পন্ন করেননি।
USER_DECLINED ব্যবহারকারী ডিভাইসের তথ্য শেয়ার করতে অস্বীকৃতি জানিয়েছেন।
UNSUPPORTED অনুরোধ করা ডিভাইসের তথ্য এই ডিভাইসে সমর্থিত নয়, যেমন, ডিভাইসটিতে ই-সিম সমর্থিত নয়।

ঈদইনফো

ডিভাইসটির ইআইডি-গুলো সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
ক্ষেত্র
eids[]

object ( Eid )

শুধুমাত্র আউটপুট। প্রতিটি eUICC চিপের জন্য EID তথ্য।

ঈদ

প্রতিটি eUICC চিপের জন্য EID তথ্য।

JSON উপস্থাপনা
{
  "eid": string
}
ক্ষেত্র
eid

string

শুধুমাত্র আউটপুট। EID