इस संसाधन के लिए उपलब्ध तरीकों की सूची देखने के लिए, इस पेज के आखिर में देखें.
संसाधन निरूपण
डिवाइस का संसाधन, ऐसे मोबाइल डिवाइस को दिखाता है जिसे ईएमएम मैनेज करता है और जो किसी खास एंटरप्राइज़ उपयोगकर्ता से जुड़ा होता है.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
androidId |
string |
डिवाइस के लिए Google Play services का Android आईडी, जिसे छोटे अक्षर वाली हेक्स स्ट्रिंग के तौर पर एन्कोड किया गया है. उदाहरण के लिए, "123456789abcdef0" . |
|
device |
string |
डिवाइस के हार्डवेयर का कोडनेम. यह android.os.Build.DEVICE से मिलता है. (हर लॉग/wireless/android/android_checkin.proto के लिए "device" नाम की फ़ील्ड) |
|
kind |
string |
||
latestBuildFingerprint |
string |
डिवाइस के बिल्ड फ़िंगरप्रिंट की जानकारी होने पर. | |
maker |
string |
डिवाइस बनाने वाली कंपनी. यह android.os.Build.MANUFACTURER से मिलता है. |
|
managementType |
string |
इस बात की पहचान करता है कि अलग-अलग डिप्लॉयमेंट कॉन्फ़िगरेशन में, मैनेज किए जा रहे Google Play के ईएमएम से डिवाइस को किस हद तक कंट्रोल किया जाता है. संभावित वैल्यू में ये शामिल हैं:
ये वैल्यू स्वीकार की जाती हैं:
|
|
model |
string |
डिवाइस के मॉडल का नाम. यह android.os.Build.MODEL से मिलता है. |
|
policy |
nested object |
डिवाइस पर नीति लागू की गई. | |
policy.autoUpdatePolicy |
string |
यह नीति कंट्रोल करती है कि डिवाइस पर ऐप्लिकेशन अपने-आप अपडेट कब-कब लागू किए जा सकते हैं. सुझाया गया विकल्प: autoUpdateMode के लिए, हर ऐप्लिकेशन के हिसाब से सेट किया गया समय. इससे, अपडेट होने के अंतराल में ज़्यादा बदलाव किए जा सकते हैं. जब autoUpdateMode को AUTO_UPDATE_POSTPONED या AUTO_UPDATE_HIGH_PRIORITY पर सेट किया जाता है, तो autoUpdatePolicy का कोई असर नहीं होता. "choiceToTheUser" डिवाइस के उपयोगकर्ता को ऐप्लिकेशन अपडेट नीति कॉन्फ़िगर करने देता है. "हमेशा" अपने-आप अपडेट होने की सुविधा चालू करता है. "कभी नहीं" अपने-आप अपडेट होने की सुविधा बंद कर देता है. "वाई-फ़ाई ओनली" अपने-आप अपडेट होने की सुविधा को सिर्फ़ तब चालू करें, जब डिवाइस वाई-फ़ाई से कनेक्ट हो. ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.deviceReportPolicy |
string |
डिवाइस, ईएमएम से जुड़ी जानकारी की रिपोर्ट करता है या नहीं. इसके लिए, डिफ़ॉल्ट वैल्यू "device ReportEnabled" है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.maintenanceWindow |
nested object |
फ़ोरग्राउंड में चलने वाले ऐप्लिकेशन को अपडेट करने का समय तय करने वाली रखरखाव विंडो. | |
policy.maintenanceWindow.durationMs |
long |
रखरखाव विंडो की अवधि, मिलीसेकंड में. यह अवधि 30 मिनट से 24 घंटे के बीच होनी चाहिए. | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
डिवाइस पर आधी रात के बाद, रखरखाव विंडो का शुरुआती समय, मिलीसेकंड में. विंडो आधी रात तक काम कर सकती है. | |
policy.productAvailabilityPolicy |
string |
बताए गए प्रॉडक्ट के लिए डिवाइस को दी गई उपलब्धता. "सभी" अनुमति की स्थिति की परवाह किए बिना, डिवाइस को सभी प्रॉडक्ट का ऐक्सेस देता है. "सभी" "ऐल्फ़ा" की अपने-आप दिखने की सुविधा चालू नहीं करता या "बीटा" ट्रैक करने में मदद मिलती है. "व्हाइटलिस्ट" डिवाइस को productPolicy[] में बताए गए प्रॉडक्ट का ऐक्सेस देता है. सिर्फ़ उन प्रॉडक्ट को अनुमति दी जा सकती है जिन्हें मंज़ूरी मिल चुकी है या जिन प्रॉडक्ट को पहले ही मंज़ूरी मिल चुकी है (जिन प्रॉडक्ट को अनुमति वापस ली गई है). अगर कोई वैल्यू नहीं दी जाती है, तो उपयोगकर्ता के लेवल पर सेट की गई खरीदारी के लिए उपलब्धता डिफ़ॉल्ट रूप से लागू होती है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[] |
list |
प्रॉडक्ट की नीतियों की सूची. प्रॉडक्ट की नीतियां लागू करने के लिए, productAvailabilityPolicy को WHITELIST या ALL पर सेट करना ज़रूरी है. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
प्रॉडक्ट के लिए अपने-आप इंस्टॉल होने की नीति. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
ऐप्लिकेशन के अपने-आप इंस्टॉल होने की सीमाएं. ज़्यादा से ज़्यादा एक कंस्ट्रेंट तय किया जा सकता है. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
चार्जिंग की स्थिति में रुकावट.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
डिवाइस के इनऐक्टिव होने की स्थिति का कंस्ट्रेंट.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
नेटवर्क टाइप कंस्ट्रेंट.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
ऑटो-इंस्टॉल मोड. अगर इस नीति को सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से "doNotAutoInstall" होता है. रखरखाव के लिए तय की गई समयसीमा पर ध्यान दिए बिना, ऐप्लिकेशन अपने-आप इंस्टॉल हो जाता है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
बिना हस्ताक्षर वाले पूर्णांक के तौर पर इंस्टॉल करने की प्राथमिकता. कम संख्या का मतलब है ज़्यादा प्राथमिकता. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
ऐप्लिकेशन का कम से कम वर्शन. अगर ऐप्लिकेशन के पुराने वर्शन को इंस्टॉल किया गया है, तो ऐप्लिकेशन अपने-आप अपडेट होने की सुविधा का इस्तेमाल करने पर अपने-आप अपडेट हो जाएगा. ऐप्लिकेशन को बार-बार अपने-आप अपडेट होने की सुविधा का इंतज़ार नहीं करना पड़ेगा. हर डिवाइस में ज़्यादा से ज़्यादा 20 ऐप्लिकेशन के लिए, कम से कम वर्शन कोड सेट किया जा सकता है. | |
policy.productPolicy[].autoUpdateMode |
string |
प्रॉडक्ट के लिए अपने-आप अपडेट होने वाला मोड. अगर autoUpdateMode का इस्तेमाल किया जाता है, तो इसे हमेशा उपयोगकर्ता की पसंद के मुकाबले प्राथमिकता दी जाती है. इसलिए, जब कोई उपयोगकर्ता डिवाइस की सेटिंग में मैन्युअल तरीके से बदलाव करता है, तो इन बदलावों को अनदेखा कर दिया जाता है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
किसी आइडेंटिटी प्रोवाइडर के पुष्टि करने वाले ऐप्लिकेशन के लिए, पुष्टि करने वाले यूआरएल का कॉन्फ़िगरेशन. इससे, Android वेबव्यू का इस्तेमाल करके किसी निजी ऐप्लिकेशन में पुष्टि करने के दौरान, पहचान देने वाली सेवा का पुष्टि करने वाला ऐप्लिकेशन लॉन्च करने में मदद मिलती है. डिवाइस पर पुष्टि करने वाले यूआरएल के लिए Authenticator ऐप्लिकेशन, पहले से ही डिफ़ॉल्ट हैंडलर होना चाहिए. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
पुष्टि करने वाला यूआरएल. | |
policy.productPolicy[].managedConfiguration |
nested object |
प्रॉडक्ट के लिए मैनेज किया जा रहा कॉन्फ़िगरेशन. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
इसमें, मैनेज की जा रही कॉन्फ़िगरेशन प्रोफ़ाइल का आईडी शामिल होता है. साथ ही, इसमें उपयोगकर्ता के लिए तय किए गए कॉन्फ़िगरेशन वैरिएबल (अगर कोई है) का सेट होता है. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
मैनेज की जा रही कॉन्फ़िगरेशन सेटिंग का आईडी. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
उपयोगकर्ता को एट्रिब्यूट किया जाने वाला वैरिएबल सेट. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
प्लेसहोल्डर स्ट्रिंग; ईएमएम से तय होता है. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
उपयोगकर्ता के लिए खास तौर पर प्लेसहोल्डर की वैल्यू. | |
policy.productPolicy[].managedConfiguration.kind |
string |
अब काम नहीं करता. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
इस कॉन्फ़िगरेशन के लिए, मैनेज की जा रही प्रॉपर्टी का सेट. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
वह खास कुंजी जिससे प्रॉपर्टी की पहचान होती है. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
बूलियन वैल्यू - यह सिर्फ़ तब दिखेगी, जब प्रॉपर्टी का टाइप बूल हो. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
मैनेज की जा रही प्रॉपर्टी का बंडल - यह सिर्फ़ तब मौजूद होगा, जब प्रॉपर्टी का टाइप बंडल हो. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
मैनेज की जा रही प्रॉपर्टी की सूची. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
प्रॉपर्टी के बंडल की सूची - यह सिर्फ़ तब दिखेगी, जब प्रॉपर्टी का टाइप bundle_array है. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
मैनेज की जा रही प्रॉपर्टी की सूची. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
पूर्णांक वैल्यू - यह सिर्फ़ तब दिखेगी, जब प्रॉपर्टी का टाइप पूर्णांक हो. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
स्ट्रिंग की वैल्यू - यह सिर्फ़ तब दिखेगी, जब प्रॉपर्टी का टाइप स्ट्रिंग, विकल्प या छिपा हुआ हो. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
स्ट्रिंग वैल्यू की सूची - यह सूची सिर्फ़ तब दिखेगी, जब प्रॉपर्टी का टाइप एक से ज़्यादा चुनें. | |
policy.productPolicy[].managedConfiguration.productId |
string |
उस प्रॉडक्ट का आईडी जिसके लिए मैनेज किया जा रहा कॉन्फ़िगरेशन है, उदाहरण के लिए, "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
प्रॉडक्ट का आईडी. उदाहरण के लिए, "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
यह नीति, trackIds के बताए गए प्रॉडक्ट के रिलीज़ ट्रैक को डिवाइस पर दिखाने की अनुमति देती है. किसी प्रॉडक्ट के रिलीज़ ट्रैक की सूची, Products.Get को कॉल करके हासिल की जा सकती है. |
|
policy.productPolicy[].tracks[] |
list |
समर्थन नहीं होना या रुकना. इसके बजाय, trackIds का इस्तेमाल करें. |
|
product |
string |
डिवाइस के प्रॉडक्ट का नाम. यह android.os.Build.PRODUCT से मिलता है. |
|
report |
nested object |
डिवाइस की रिपोर्ट को ऐप्लिकेशन की नई स्थितियों के साथ अपडेट किया जाता है. | |
report.appState[] |
list |
ऐप्लिकेशन की उन स्थितियों की सूची जिन्हें डिवाइस पर मैनेज किए जा रहे ऐप्लिकेशन ने सेट किया है. ऐप्लिकेशन की स्थितियां, ऐप्लिकेशन के डेवलपर तय करते हैं. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
report.appState[].keyedAppState[] |
list |
ऐप्लिकेशन की खास स्थितियों की सूची. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
report.appState[].keyedAppState[].data |
string |
मशीन से पढ़े जा सकने वाले डेटा के लिए बनाया गया अतिरिक्त फ़ील्ड. उदाहरण के लिए, कोई संख्या या JSON ऑब्जेक्ट. XSS को रोकने के लिए, हमारा सुझाव है कि डेटा को दिखाने से पहले उससे एचटीएमएल को हटा दें. | |
report.appState[].keyedAppState[].key |
string |
यह बताने वाली कुंजी कि ऐप्लिकेशन किस स्थिति में काम कर रहा है. कुंजी का कॉन्टेंट, ऐप्लिकेशन के डेवलपर सेट करता है. XSS को रोकने के लिए, हमारा सुझाव है कि कुंजी दिखाने से पहले उससे एचटीएमएल को हटा दें. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
report.appState[].keyedAppState[].message |
string |
इस फ़्री फ़ॉर्म में ऐप्लिकेशन की स्थिति के बारे में जानकारी देने वाला ऐसा मैसेज होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए, गड़बड़ी का कोई मैसेज. XSS को रोकने के लिए, हमारा सुझाव है कि मैसेज दिखाने से पहले उससे एचटीएमएल को हटा दें. | |
report.appState[].keyedAppState[].severity |
string |
ऐप्लिकेशन की स्थिति की गंभीरता. यह फ़ील्ड हमेशा मौजूद रहेगा.
ये वैल्यू स्वीकार की जाती हैं:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Epoch के बाद, मिलीसेकंड में स्थिति सेट करने के समय का टाइमस्टैंप. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
report.appState[].packageName |
string |
ऐप्लिकेशन का पैकेज नाम. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
report.lastUpdatedTimestampMillis |
long |
Epoch के बाद से, मिलीसेकंड में रिपोर्ट के आखिरी अपडेट का टाइमस्टैंप. यह फ़ील्ड हमेशा मौजूद रहेगा. | |
retailBrand |
string |
अगर डिवाइस का खुदरा ब्रैंड सेट हो, तो. android.os.Build.BRAND देखें |
|
sdkVersion |
integer |
एपीआई के साथ काम करने वाला वर्शन. |
तरीके
- forceReportUpload
- ऐसी रिपोर्ट अपलोड करता है जिसमें डिवाइस पर, ऐप्लिकेशन की स्थितियों में हुए सभी बदलावों की जानकारी शामिल होती है पिछली रिपोर्ट जनरेट की गई थी. इस तरीके को तीन बार कॉल किया जा सकता है किसी डिवाइस के लिए 24 घंटे.
- पाएं
- डिवाइस की जानकारी हासिल करता है.
- getState
- यह पता लगाता है कि किसी डिवाइस के लिए Google की सेवाओं का ऐक्सेस चालू है या नहीं या बंद किया गया. डिवाइस की स्थिति तब ही लागू होती है, जब Android पर ईएमएम नीतियां लागू होती हैं डिवाइस, Google Admin Console में चालू है. ऐसा न होने पर, डिवाइस की स्थिति को अनदेखा कर दिया जाता है और सभी डिवाइसों को ऐक्सेस करने की अनुमति होती है को ऐक्सेस करने की अनुमति देते हैं. यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें Google मैनेज करता है.
- list
- उपयोगकर्ता के सभी डिवाइसों के आईडी हासिल करता है.
- setState
- सेट करता है कि Google सेवाओं के लिए डिवाइस का ऐक्सेस चालू है या बंद है. डिवाइस की स्थिति तब ही लागू होती है, जब Android पर ईएमएम नीतियां लागू होती हैं डिवाइस, Google Admin Console में चालू है. ऐसा न होने पर, डिवाइस की स्थिति को अनदेखा कर दिया जाता है और सभी डिवाइसों को ऐक्सेस करने की अनुमति होती है को ऐक्सेस करने की अनुमति देते हैं. यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें Google मैनेज करता है.
- अपडेट करें
- डिवाइस नीति को अपडेट करता है.
यह पक्का करने के लिए कि नीति को सही तरीके से लागू किया गया है, आपको मैनेज नहीं की जा रही सेटिंग को रोकना होगा आपके किसी भी खाते को Google Play ऐक्सेस करने से रोकने के लिए, Google के लिए, मैनेज किए जा रहे कॉन्फ़िगरेशन मेंallowed_accounts
पैकेज चलाएं. प्रतिबंधित करें देखें Google Play पर खाते हैं.