Method: enterprises.devices.issueCommand

किसी डिवाइस को निर्देश देता है. दिखाए गए Operation रिसॉर्स के metadata फ़ील्ड में Command मौजूद है. कमांड की स्थिति जानने के लिए, get operation method का इस्तेमाल करें.

एचटीटीपी अनुरोध

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

यूआरएल में 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)

वह टाइमस्टैंप जब निर्देश बनाया गया था. टाइमस्टैंप, सर्वर की मदद से अपने-आप जनरेट होता है.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

वह समयावधि जिसके लिए निर्देश मान्य है. अगर इस दौरान डिवाइस से निर्देश नहीं दिया जाता है, तो वह खत्म हो जाएगा. अगर कोई अवधि नहीं बताई गई है, तो डिफ़ॉल्ट अवधि 10 मिनट होती है. वीडियो की अवधि ज़्यादा से ज़्यादा कितनी हो सकती है, इसकी कोई सीमा नहीं है.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".
userName

string

डिवाइस का मालिकाना हक रखने वाले उपयोगकर्ता के संसाधन का नाम, enterprises/{enterpriseId}/users/{userId} फ़ॉर्मैट में. यह सर्वर के ज़रिए अपने-आप जनरेट होता है. यह उस डिवाइस के हिसाब से होता है जिस पर निर्देश भेजा जाता है.
errorCode

enum (CommandErrorCode)

अगर निर्देश पूरा नहीं हो पाता है, तो गड़बड़ी की जानकारी देने वाला गड़बड़ी कोड. अगर कॉलर ने कमांड रद्द कर दिया है, तो यह सेट नहीं होता.
newPassword

string

RESET_PASSWORD टाइप के निर्देशों के लिए, वैकल्पिक रूप से नया पासवर्ड डाला जा सकता है. ध्यान दें: Android 14 डिवाइसों के लिए, अगर नया पासवर्ड अंकों से बना है, तो वह कम से कम छह वर्णों का होना चाहिए. ऐसा न करने पर, निर्देश 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 पर सेट कर देता है. 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 पर सेट करना भी स्वीकार किया जाता है.
यूनियन फ़ील्ड 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 देखें.

CommandType

निर्देशों के टाइप.

Enums
COMMAND_TYPE_UNSPECIFIED इस वैल्यू की अनुमति नहीं है.
LOCK डिवाइस को लॉक करें, जैसे कि लॉक स्क्रीन के टाइम आउट की समयसीमा खत्म हो गई हो.
RESET_PASSWORD उपयोगकर्ता का पासवर्ड रीसेट करें.
REBOOT डिवाइस को रीबूट करें. यह सुविधा सिर्फ़ उन डिवाइसों पर काम करती है जिन्हें पूरी तरह से मैनेज किया जा रहा हो और जो Android 7.0 (एपीआई लेवल 24) या इसके बाद के वर्शन पर काम करते हों.
RELINQUISH_OWNERSHIP कंपनी के मालिकाना हक वाले Android 8.0 और उसके बाद के वर्शन वाले डिवाइस से, वर्क प्रोफ़ाइल और सभी नीतियां हटाती है. इससे, डिवाइस को निजी इस्तेमाल के लिए छोड़ दिया जाता है. निजी प्रोफ़ाइल से जुड़े ऐप्लिकेशन और डेटा को सेव रखा जाता है. निर्देश स्वीकार करने के बाद, डिवाइस को सर्वर से मिटा दिया जाएगा.
CLEAR_APP_DATA यह सुविधा, चुने गए ऐप्लिकेशन का डेटा मिटाती है. यह सुविधा, Android 9 और उसके बाद के वर्शन पर काम करती है. ध्यान दें कि कोई ऐप्लिकेशन, अपने ऐप्लिकेशन डेटा के अलावा, बाहरी स्टोरेज या उपयोगकर्ता के डिक्शनरी में भी डेटा सेव कर सकता है. clearAppsDataParams भी देखें.
START_LOST_MODE डिवाइस को खोए हुए डिवाइस को लॉक करने वाले मोड में डालता है. यह सुविधा सिर्फ़ उन डिवाइसों पर काम करती है जिन्हें पूरी तरह से मैनेज किया जाता है. इसके अलावा, यह सुविधा उन डिवाइसों पर भी काम करती है जिनका मालिकाना हक संगठन के पास है और जिन पर मैनेज की जा सकने वाली प्रोफ़ाइल है. startLostModeParams भी देखें.
STOP_LOST_MODE डिवाइस को खोए हुए डिवाइस के मोड से बाहर निकालता है. यह सुविधा सिर्फ़ उन डिवाइसों पर काम करती है जिन्हें पूरी तरह से मैनेज किया जाता है. इसके अलावा, यह सुविधा उन डिवाइसों पर भी काम करती है जिनका मालिकाना हक संगठन के पास है और जिन पर मैनेज की जा सकने वाली प्रोफ़ाइल है. stopLostModeParams भी देखें.

CommandErrorCode

निर्देश से जुड़ी गड़बड़ी का कोड. यह रीड-ओनली फ़ील्ड है, जिसे सर्वर से पॉप्युलेट किया जाता है.

Enums
COMMAND_ERROR_CODE_UNSPECIFIED कोई गड़बड़ी नहीं हुई.
UNKNOWN कोई अज्ञात गड़बड़ी हुई.
API_LEVEL डिवाइस का एपीआई लेवल, इस निर्देश के साथ काम नहीं करता.
MANAGEMENT_MODE मैनेजमेंट मोड (प्रोफ़ाइल का मालिक, डिवाइस का मालिक वगैरह) में यह निर्देश काम नहीं करता.
INVALID_VALUE कमांड में पैरामीटर की अमान्य वैल्यू है.
UNSUPPORTED डिवाइस पर यह निर्देश काम नहीं करता. Android डिवाइस नीति को नए वर्शन पर अपडेट करके, इस समस्या को हल किया जा सकता है.

ResetPasswordFlag

ऐसे फ़्लैग जिनका इस्तेमाल RESET_PASSWORD कमांड टाइप के लिए किया जा सकता है.

Enums
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 कमांड से जुड़े पैरामीटर.

ClearAppsDataStatus

डिवाइस से चुने गए ऐप्लिकेशन का डेटा मिटाने के लिए, 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)

किसी एक ऐप्लिकेशन का डेटा मिटाने की कोशिश का नतीजा.

ClearingResult

किसी एक ऐप्लिकेशन का डेटा मिटाने की कोशिश का नतीजा.

Enums
CLEARING_RESULT_UNSPECIFIED नतीजा नहीं मिला.
SUCCESS इस ऐप्लिकेशन का डेटा मिटा दिया गया है.
APP_NOT_FOUND इस ऐप्लिकेशन का डेटा इसलिए नहीं मिटाया जा सका, क्योंकि ऐप्लिकेशन नहीं मिला.
APP_PROTECTED इस ऐप्लिकेशन का डेटा इसलिए नहीं मिटाया जा सका, क्योंकि यह ऐप्लिकेशन सुरक्षित है. उदाहरण के लिए, यह Google Play Store जैसे ऐसे ऐप्लिकेशन पर लागू हो सकता है जो डिवाइस के काम करने के लिए ज़रूरी हैं.
API_LEVEL इस ऐप्लिकेशन का डेटा नहीं मिटाया जा सका, क्योंकि डिवाइस का एपीआई लेवल इस निर्देश के साथ काम नहीं करता.

StartLostModeStatus

डिवाइस को लॉस्ट मोड में डालने के लिए START_LOST_MODE कमांड की स्थिति.

JSON के काेड में दिखाना 
{
  "status": enum (Status)
}
फ़ील्ड
status

enum (Status)

स्टेटस. StartLostModeStatus देखें.

स्थिति

स्टेटस. StartLostModeStatus देखें.

Enums
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 देखें.

Enums
STATUS_UNSPECIFIED नहीं बताया गया है इस वैल्यू का इस्तेमाल नहीं किया जाता.
SUCCESS डिवाइस को खोने का मोड बंद कर दिया गया.
NOT_IN_LOST_MODE डिवाइस, खोए हुए डिवाइस के तौर पर सेट नहीं किया गया हो.