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 की खास जानकारी देखें.

आदेश

कोई निर्देश.

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

जेएसओएन के काेड में दिखाना 
{
  "packageNames": [
    string
  ]
}
फ़ील्ड
packageNames[]

string

उन ऐप्लिकेशन के पैकेज के नाम जिनका डेटा निर्देश दिए जाने पर मिटा दिया जाएगा.

StartLostModeParams

डिवाइस को खोए हुए मोड में डालने के लिए, START_LOST_MODE कमांड से जुड़े पैरामीटर. डिवाइस को खोए हुए मोड में डालने के लिए, कम से कम एक पैरामीटर देना ज़रूरी है. इसमें संगठन का नाम शामिल नहीं है.

जेएसओएन के काेड में दिखाना 
{
  "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 कमांड की स्थिति.

जेएसओएन के काेड में दिखाना 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
फ़ील्ड
results

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

हर ऐप्लिकेशन के नतीजों में, पैकेज के नामों से लेकर क्लियरिंग के उनके नतीजे की मैपिंग.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

PerAppResult

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

जेएसओएन के काेड में दिखाना 
{
  "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 निर्देश की स्थिति.

जेएसओएन के काेड में दिखाना 
{
  "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 निर्देश की स्थिति.

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

enum (Status)

स्थिति. StopLostModeStatus देखें.

स्थिति

स्थिति. StopLostModeStatus देखें.

Enums
STATUS_UNSPECIFIED नहीं बताया गया है इस वैल्यू का इस्तेमाल नहीं किया गया है.
SUCCESS डिवाइस को 'खो गया' मोड से बाहर ले जाया गया था.
NOT_IN_LOST_MODE डिवाइस 'खो गया' मोड में नहीं है.