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)

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

सेकंड में कुल नौ दशमलव अंक, जो '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 डिवाइस खोए मोड में नहीं है.