Method: enterprises.devices.issueCommand

একটি ডিভাইসে একটি কমান্ড জারি করে। ফিরে আসা Operation রিসোর্স এর metadata ক্ষেত্রে একটি Command রয়েছে। কমান্ডের স্থিতি পেতে গেট অপারেশন পদ্ধতি ব্যবহার করুন।

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 ওভারভিউ দেখুন।

আদেশ

একটি আদেশ.

JSON প্রতিনিধিত্ব
{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}
ক্ষেত্র
type

enum ( CommandType )

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

createTime

string ( Timestamp format)

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

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z"

duration

string ( Duration format)

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

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"

userName

string

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

errorCode

enum ( CommandErrorCode )

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

newPassword

string

RESET_PASSWORD টাইপ কমান্ডের জন্য, ঐচ্ছিকভাবে নতুন পাসওয়ার্ড নির্দিষ্ট করে। দ্রষ্টব্য: Android 14 ডিভাইসের ক্ষেত্রে নতুন পাসওয়ার্ডটি সাংখ্যিক হলে কমপক্ষে 6 অক্ষরের হতে হবে। অন্যথায় কমান্ডটি INVALID_VALUE এর সাথে ব্যর্থ হবে।

resetPasswordFlags[]

enum ( ResetPasswordFlag )

RESET_PASSWORD টাইপ কমান্ডের জন্য, ঐচ্ছিকভাবে পতাকা নির্দিষ্ট করে।

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

যদি এটি সেট করা থাকে, তাহলে new_password এবং reset_password_flags অবশ্যই সেট করা উচিত নয়। params নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

clearAppsDataParams

object ( ClearAppsDataParams )

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

startLostModeParams

object ( StartLostModeParams )

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

stopLostModeParams

object ( StopLostModeParams )

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

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

object ( ClearAppsDataStatus )

শুধুমাত্র আউটপুট। ডিভাইস থেকে নির্দিষ্ট অ্যাপের ডেটা সাফ করতে CLEAR_APP_DATA কমান্ডের স্থিতি। ClearAppsDataStatus দেখুন।

startLostModeStatus

object ( StartLostModeStatus )

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

stopLostModeStatus

object ( StopLostModeStatus )

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

কমান্ড টাইপ

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

এনামস
COMMAND_TYPE_UNSPECIFIED এই মান অননুমোদিত.
LOCK ডিভাইসটি লক করুন, যেন লক স্ক্রিনের সময়সীমা শেষ হয়ে গেছে।
RESET_PASSWORD ব্যবহারকারীর পাসওয়ার্ড রিসেট করুন।
REBOOT ডিভাইসটি রিবুট করুন। শুধুমাত্র অ্যান্ড্রয়েড 7.0 (API লেভেল 24) বা উচ্চতর চলমান সম্পূর্ণরূপে পরিচালিত ডিভাইসগুলিতে সমর্থিত৷
RELINQUISH_OWNERSHIP একটি কোম্পানির মালিকানাধীন Android 8.0+ ডিভাইস থেকে কাজের প্রোফাইল এবং সমস্ত নীতিগুলি সরিয়ে দেয়, ব্যক্তিগত ব্যবহারের জন্য ডিভাইসটি ত্যাগ করে৷ ব্যক্তিগত প্রোফাইল(গুলি) এর সাথে যুক্ত অ্যাপ এবং ডেটা সংরক্ষিত হয়। কমান্ডটি স্বীকার করার পরে ডিভাইসটি সার্ভার থেকে মুছে ফেলা হবে।
CLEAR_APP_DATA নির্দিষ্ট অ্যাপের অ্যাপ্লিকেশন ডেটা সাফ করে। এটি Android 9 এবং তার উপরে সমর্থিত। মনে রাখবেন যে একটি অ্যাপ্লিকেশন তার অ্যাপ্লিকেশন ডেটার বাইরে ডেটা সঞ্চয় করতে পারে, উদাহরণস্বরূপ বাহ্যিক স্টোরেজ বা ব্যবহারকারীর অভিধানে। এছাড়াও clearAppsDataParams দেখুন।
START_LOST_MODE ডিভাইসটিকে হারিয়ে যাওয়া মোডে রাখে। শুধুমাত্র সম্পূর্ণরূপে পরিচালিত ডিভাইসে বা পরিচালিত প্রোফাইল সহ প্রতিষ্ঠানের মালিকানাধীন ডিভাইসগুলিতে সমর্থিত৷ এছাড়াও startLostModeParams দেখুন।
STOP_LOST_MODE হারিয়ে যাওয়া মোড থেকে ডিভাইসটি নিয়ে যায়। শুধুমাত্র সম্পূর্ণরূপে পরিচালিত ডিভাইসে বা পরিচালিত প্রোফাইল সহ প্রতিষ্ঠানের মালিকানাধীন ডিভাইসগুলিতে সমর্থিত৷ এছাড়াও stopLostModeParams দেখুন।

CommandErrorCode

একটি কমান্ড ত্রুটি কোড. এটি সার্ভার দ্বারা জনবহুল একটি শুধুমাত্র পঠন ক্ষেত্র।

এনামস
COMMAND_ERROR_CODE_UNSPECIFIED কোন ত্রুটি ছিল না.
UNKNOWN একটি অজানা ত্রুটি ঘটেছে.
API_LEVEL ডিভাইসের API স্তর এই কমান্ড সমর্থন করে না.
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 কমান্ডের সাথে যুক্ত প্যারামিটার।

ClearAppsData Status

ডিভাইস থেকে নির্দিষ্ট অ্যাপের ডেটা সাফ করতে 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 এই অ্যাপটির ডেটা সাফ করা যায়নি কারণ অ্যাপটি সুরক্ষিত। উদাহরণস্বরূপ, এটি Google Play স্টোরের মতো ডিভাইসের কার্যকারিতার জন্য গুরুত্বপূর্ণ অ্যাপগুলিতে প্রযোজ্য হতে পারে।
API_LEVEL এই অ্যাপের ডেটা সাফ করা যায়নি কারণ ডিভাইস API লেভেল এই কমান্ড সমর্থন করে না।

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

ডিভাইসটিকে হারিয়ে যাওয়া মোডে রাখার জন্য 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 ডিভাইসটি ইতিমধ্যে হারিয়ে যাওয়া মোডে রয়েছে৷

StopLostModeStatus

ডিভাইসটিকে হারিয়ে যাওয়া মোড থেকে বের করতে STOP_LOST_MODE কমান্ডের স্থিতি।

JSON প্রতিনিধিত্ব
{
  "status": enum (Status)
}
ক্ষেত্র
status

enum ( Status )

স্ট্যাটাস। StopLostModeStatus দেখুন।

স্ট্যাটাস

স্ট্যাটাস। StopLostModeStatus দেখুন।

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