- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- कमांड
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Status
- StopLostModeStatus
- Status
- इसे आज़माएं!
डिवाइस को कोई निर्देश देता है. Operation
मिले संसाधन में इसके metadata
फ़ील्ड में Command
शामिल है. निर्देश की स्थिति पाने के लिए, कार्रवाई करने का तरीका पाएं का इस्तेमाल करें.
एचटीटीपी अनुरोध
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
name |
|
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Command
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/androidmanagement
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
आदेश
कोई निर्देश.
जेएसओएन के काेड में दिखाना |
---|
{ "type": enum ( |
फ़ील्ड | |
---|---|
type |
निर्देश किस तरह का है. |
createTime |
वह टाइमस्टैंप जिस पर निर्देश दिया गया. सर्वर, टाइमस्टैंप को अपने-आप जनरेट करता है. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: |
duration |
वह अवधि जिसके लिए निर्देश मान्य है. अगर इस दौरान डिवाइस पर निर्देश इस्तेमाल नहीं किया जाता, तो वह काम नहीं करेगा. अगर जानकारी नहीं दी गई है, तो डिफ़ॉल्ट अवधि 10 मिनट है. कोई अधिकतम अवधि नहीं है. सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह ' |
userName |
डिवाइस का मालिकाना हक रखने वाले उपयोगकर्ता का संसाधन नाम, |
errorCode |
अगर निर्देश नहीं मिल पाता है, तो गड़बड़ी के बारे में बताने वाला गड़बड़ी कोड दिखेगा. इसे तब सेट नहीं किया जाता है, जब कॉलर ने निर्देश रद्द कर दिया हो. |
newPassword |
|
resetPasswordFlags[] |
|
यूनियन फ़ील्ड अगर यह नीति सेट है, तो |
|
clearAppsDataParams |
डिवाइस से तय किए गए ऐप्लिकेशन का डेटा मिटाने के लिए, |
startLostModeParams |
डिवाइस को खोए हुए मोड में ले जाने के लिए, |
stopLostModeParams |
डिवाइस को खोए हुए मोड से बाहर निकालने के लिए, |
यूनियन फ़ील्ड status . निर्देश के हिसाब से स्थिति. ध्यान दें कि कुछ निर्देशों में इसका इस्तेमाल नहीं किया जाता. खास तौर पर, , , , और के लिए. आने वाले समय में, ये निर्देश भी इसका इस्तेमाल कर सकते हैं. status इनमें से सिर्फ़ एक हो सकती है: |
|
clearAppsDataStatus |
सिर्फ़ आउटपुट के लिए. डिवाइस से तय किए गए ऐप्लिकेशन का डेटा मिटाने के लिए |
startLostModeStatus |
सिर्फ़ आउटपुट के लिए. डिवाइस को खोए हुए मोड में रखने के लिए |
stopLostModeStatus |
सिर्फ़ आउटपुट के लिए. डिवाइस को खोए हुए मोड से बाहर निकालने के लिए |
CommandType
अलग-अलग तरह के निर्देश.
Enums | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
इस मान की अनुमति नहीं है. |
LOCK |
डिवाइस को लॉक करें, जैसे कि लॉक स्क्रीन का टाइम आउट हो गया हो. |
RESET_PASSWORD |
उपयोगकर्ता का पासवर्ड रीसेट करें. |
REBOOT |
डिवाइस फिर से चालू करें. यह सुविधा सिर्फ़ उन डिवाइसों पर काम करती है जो पूरी तरह से मैनेज किए गए हों और Android 7.0 (एपीआई लेवल 24) या इसके बाद के वर्शन पर काम करते हों. |
RELINQUISH_OWNERSHIP |
कंपनी के मालिकाना हक वाले Android 8.0 या इसके बाद के वर्शन वाले डिवाइस से वर्क प्रोफ़ाइल और सभी नीतियां हटा दी जाती हैं. साथ ही, निजी इस्तेमाल के लिए डिवाइस का इस्तेमाल करना छोड़ दिया जाता है. निजी प्रोफ़ाइल से जुड़े ऐप्लिकेशन और डेटा को सुरक्षित रखा जाता है. निर्देश स्वीकार करने के बाद, डिवाइस को सर्वर से मिटा दिया जाएगा. |
CLEAR_APP_DATA |
बताए गए ऐप्लिकेशन के ऐप्लिकेशन डेटा को मिटाता है. यह सुविधा, Android 9 और उसके बाद के वर्शन पर काम करती है. ध्यान दें कि कोई ऐप्लिकेशन अपने ऐप्लिकेशन डेटा के बाहर, उदाहरण के लिए बाहरी मेमोरी या उपयोगकर्ता शब्दकोश में डेटा संग्रहित कर सकता है. भी देखें. |
START_LOST_MODE |
इससे डिवाइस, खोए हुए मोड में चला जाता है. यह सुविधा, सिर्फ़ पूरी तरह से मैनेज किए जा रहे डिवाइसों या संगठन के मालिकाना हक वाले उन डिवाइसों पर काम करती है जिनमें मैनेज की जा रही प्रोफ़ाइल हो. भी देखें. |
STOP_LOST_MODE |
डिवाइस को खोए हुए मोड से बाहर ले जाता है. यह सुविधा, सिर्फ़ पूरी तरह से मैनेज किए जा रहे डिवाइसों या संगठन के मालिकाना हक वाले उन डिवाइसों पर काम करती है जिनमें मैनेज की जा रही प्रोफ़ाइल हो. भी देखें. |
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[] |
उन ऐप्लिकेशन के पैकेज के नाम जिनका डेटा निर्देश दिए जाने पर मिटा दिया जाएगा. |
StartLostModeParams
डिवाइस को खोए हुए मोड में डालने के लिए,
कमांड से जुड़े पैरामीटर. डिवाइस को खोए हुए मोड में डालने के लिए, कम से कम एक पैरामीटर देना ज़रूरी है. इसमें संगठन का नाम शामिल नहीं है.START_LOST_MODE
जेएसओएन के काेड में दिखाना |
---|
{ "lostMessage": { object ( |
फ़ील्ड | |
---|---|
lostMessage |
डिवाइस के खोए हुए मोड में होने पर, उपयोगकर्ता को यह मैसेज दिखता है. |
lostPhoneNumber |
डिवाइस के 'खो गया' मोड में होने और 'मालिक को कॉल करें' बटन पर टैप किए जाने पर, जिस फ़ोन नंबर पर कॉल किया जाएगा. |
lostEmailAddress |
डिवाइस के खोए हुए मोड में होने पर, उपयोगकर्ता को दिखने वाला ईमेल पता. |
lostStreetAddress |
डिवाइस के खोए हुए मोड में होने पर, उपयोगकर्ता को दिखने वाला मोहल्ले का पता. |
lostOrganization |
डिवाइस के खोए हुए मोड में होने पर, उपयोगकर्ता को संगठन का नाम दिखता है. |
StopLostModeParams
इस टाइप के लिए कोई फ़ील्ड नहीं है.
डिवाइस को खोए हुए मोड से बाहर निकालने के लिए,
निर्देश से जुड़े पैरामीटर.STOP_LOST_MODE
ClearAppsDataStatus
डिवाइस से तय किए गए ऐप्लिकेशन का डेटा मिटाने के लिए
कमांड की स्थिति.CLEAR_APP_DATA
जेएसओएन के काेड में दिखाना |
---|
{
"results": {
string: {
object ( |
फ़ील्ड | |
---|---|
results |
हर ऐप्लिकेशन के नतीजों में, पैकेज के नामों से लेकर क्लियरिंग के उनके नतीजे की मैपिंग. एक ऑब्जेक्ट, जिसमें |
PerAppResult
यह किसी एक ऐप्लिकेशन के डेटा को मिटाने की कोशिश का नतीजा होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"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 |
स्थिति. |
स्थिति
स्थिति.
देखें.StartLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
नहीं बताया गया है इस वैल्यू का इस्तेमाल नहीं किया गया है. |
SUCCESS |
डिवाइस खोए हुए मोड में था. |
RESET_PASSWORD_RECENTLY |
डिवाइस को खोए हुए मोड में नहीं रखा जा सका, क्योंकि एडमिन ने हाल ही में इसका पासवर्ड रीसेट किया है. |
USER_EXIT_LOST_MODE_RECENTLY |
डिवाइस को 'खो गया' मोड में नहीं रखा जा सका, क्योंकि उपयोगकर्ता हाल ही में 'खो गया' मोड से बाहर निकल गया है. |
ALREADY_IN_LOST_MODE |
डिवाइस पहले से ही 'खो गया' मोड में है. |
StopLostModeStatus
डिवाइस को खोए हुए मोड से बाहर निकालने के लिए
निर्देश की स्थिति.STOP_LOST_MODE
जेएसओएन के काेड में दिखाना |
---|
{
"status": enum ( |
फ़ील्ड | |
---|---|
status |
स्थिति. |
स्थिति
स्थिति.
देखें.StopLostModeStatus
Enums | |
---|---|
STATUS_UNSPECIFIED |
नहीं बताया गया है इस वैल्यू का इस्तेमाल नहीं किया गया है. |
SUCCESS |
डिवाइस को 'खो गया' मोड से बाहर ले जाया गया था. |
NOT_IN_LOST_MODE |
डिवाइस 'खो गया' मोड में नहीं है. |