Method: enterprises.devices.issueCommand

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

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

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 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "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 Device Policy को नए वर्शन में अपडेट करने से समस्या हल हो सकती है.

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 डिवाइस खोए मोड में नहीं है.