Devices

इस संसाधन के लिए उपलब्ध तरीकों की सूची देखने के लिए, इस पेज के आखिर में देखें.

संसाधन निरूपण

डिवाइस का संसाधन, ऐसे मोबाइल डिवाइस को दिखाता है जिसे ईएमएम मैनेज करता है और जो किसी खास एंटरप्राइज़ उपयोगकर्ता से जुड़ा होता है.

{
  "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 के ईएमएम से डिवाइस को किस हद तक कंट्रोल किया जाता है.

संभावित वैल्यू में ये शामिल हैं:
  • "managedDevice" एक ऐसा डिवाइस है जिसमें डिवाइस के मालिक के तौर पर, ईएमएम की डिवाइस नीति कंट्रोलर (डीपीसी) मौजूद है.
  • "managedProfile" एक ऐसा डिवाइस है जिसकी प्रोफ़ाइल को DPC मैनेज करता है (DPC, प्रोफ़ाइल का मालिक होता है). साथ ही, इसकी एक अलग, निजी प्रोफ़ाइल होती है जो DPC के लिए उपलब्ध नहीं होती.
  • "containerApp", अब इस्तेमाल नहीं किया जा रहा है (अब सेवा में नहीं है).
  • "unmanagedProfile" एक ऐसा डिवाइस है जिसे 'कारोबार के लिए Google Play' का इस्तेमाल करने की अनुमति (डोमेन के एडमिन ने, Admin console का इस्तेमाल करके) दिया है. हालांकि, DPC के पास प्रोफ़ाइल का मालिकाना हक नहीं होता.


ये वैल्यू स्वीकार की जाती हैं:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
model string डिवाइस के मॉडल का नाम. यह android.os.Build.MODEL से मिलता है.
policy nested object डिवाइस पर नीति लागू की गई.
policy.autoUpdatePolicy string यह नीति कंट्रोल करती है कि डिवाइस पर ऐप्लिकेशन अपने-आप अपडेट कब-कब लागू किए जा सकते हैं.

सुझाया गया विकल्प: autoUpdateMode के लिए, हर ऐप्लिकेशन के हिसाब से सेट किया गया समय. इससे, अपडेट होने के अंतराल में ज़्यादा बदलाव किए जा सकते हैं.

जब autoUpdateMode को AUTO_UPDATE_POSTPONED या AUTO_UPDATE_HIGH_PRIORITY पर सेट किया जाता है, तो autoUpdatePolicy का कोई असर नहीं होता.

"choiceToTheUser" डिवाइस के उपयोगकर्ता को ऐप्लिकेशन अपडेट नीति कॉन्फ़िगर करने देता है. "हमेशा" अपने-आप अपडेट होने की सुविधा चालू करता है. "कभी नहीं" अपने-आप अपडेट होने की सुविधा बंद कर देता है. "वाई-फ़ाई ओनली" अपने-आप अपडेट होने की सुविधा को सिर्फ़ तब चालू करें, जब डिवाइस वाई-फ़ाई से कनेक्ट हो.

ये वैल्यू स्वीकार की जाती हैं:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string डिवाइस, ईएमएम से जुड़ी जानकारी की रिपोर्ट करता है या नहीं. इसके लिए, डिफ़ॉल्ट वैल्यू "device ReportEnabled" है.

ये वैल्यू स्वीकार की जाती हैं:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
policy.maintenanceWindow nested object फ़ोरग्राउंड में चलने वाले ऐप्लिकेशन को अपडेट करने का समय तय करने वाली रखरखाव विंडो.
policy.maintenanceWindow.durationMs long रखरखाव विंडो की अवधि, मिलीसेकंड में. यह अवधि 30 मिनट से 24 घंटे के बीच होनी चाहिए.
policy.maintenanceWindow.startTimeAfterMidnightMs long डिवाइस पर आधी रात के बाद, रखरखाव विंडो का शुरुआती समय, मिलीसेकंड में. विंडो आधी रात तक काम कर सकती है.
policy.productAvailabilityPolicy string बताए गए प्रॉडक्ट के लिए डिवाइस को दी गई उपलब्धता. "सभी" अनुमति की स्थिति की परवाह किए बिना, डिवाइस को सभी प्रॉडक्ट का ऐक्सेस देता है. "सभी" "ऐल्फ़ा" की अपने-आप दिखने की सुविधा चालू नहीं करता या "बीटा" ट्रैक करने में मदद मिलती है. "व्हाइटलिस्ट" डिवाइस को productPolicy[] में बताए गए प्रॉडक्ट का ऐक्सेस देता है. सिर्फ़ उन प्रॉडक्ट को अनुमति दी जा सकती है जिन्हें मंज़ूरी मिल चुकी है या जिन प्रॉडक्ट को पहले ही मंज़ूरी मिल चुकी है (जिन प्रॉडक्ट को अनुमति वापस ली गई है). अगर कोई वैल्यू नहीं दी जाती है, तो उपयोगकर्ता के लेवल पर सेट की गई खरीदारी के लिए उपलब्धता डिफ़ॉल्ट रूप से लागू होती है.

ये वैल्यू स्वीकार की जाती हैं:
  • "all"
  • "whitelist"
policy.productPolicy[] list प्रॉडक्ट की नीतियों की सूची. प्रॉडक्ट की नीतियां लागू करने के लिए, productAvailabilityPolicy को WHITELIST या ALL पर सेट करना ज़रूरी है.
policy.productPolicy[].autoInstallPolicy nested object प्रॉडक्ट के लिए अपने-आप इंस्टॉल होने की नीति.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] list ऐप्लिकेशन के अपने-आप इंस्टॉल होने की सीमाएं. ज़्यादा से ज़्यादा एक कंस्ट्रेंट तय किया जा सकता है.

policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint string चार्जिंग की स्थिति में रुकावट.

ये वैल्यू स्वीकार की जाती हैं:
  • "chargingNotRequired"
  • "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string डिवाइस के इनऐक्टिव होने की स्थिति का कंस्ट्रेंट.

ये वैल्यू स्वीकार की जाती हैं:
  • "deviceIdleNotRequired"
  • "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string नेटवर्क टाइप कंस्ट्रेंट.

ये वैल्यू स्वीकार की जाती हैं:
  • "anyNetwork"
  • "unmeteredNetwork"
policy.productPolicy[].autoInstallPolicy.autoInstallMode string ऑटो-इंस्टॉल मोड. अगर इस नीति को सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से "doNotAutoInstall" होता है. रखरखाव के लिए तय की गई समयसीमा पर ध्यान दिए बिना, ऐप्लिकेशन अपने-आप इंस्टॉल हो जाता है.

ये वैल्यू स्वीकार की जाती हैं:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority integer बिना हस्ताक्षर वाले पूर्णांक के तौर पर इंस्टॉल करने की प्राथमिकता. कम संख्या का मतलब है ज़्यादा प्राथमिकता.
policy.productPolicy[].autoInstallPolicy.minimumVersionCode integer ऐप्लिकेशन का कम से कम वर्शन. अगर ऐप्लिकेशन के पुराने वर्शन को इंस्टॉल किया गया है, तो ऐप्लिकेशन अपने-आप अपडेट होने की सुविधा का इस्तेमाल करने पर अपने-आप अपडेट हो जाएगा. ऐप्लिकेशन को बार-बार अपने-आप अपडेट होने की सुविधा का इंतज़ार नहीं करना पड़ेगा. हर डिवाइस में ज़्यादा से ज़्यादा 20 ऐप्लिकेशन के लिए, कम से कम वर्शन कोड सेट किया जा सकता है.
policy.productPolicy[].autoUpdateMode string प्रॉडक्ट के लिए अपने-आप अपडेट होने वाला मोड. अगर autoUpdateMode का इस्तेमाल किया जाता है, तो इसे हमेशा उपयोगकर्ता की पसंद के मुकाबले प्राथमिकता दी जाती है. इसलिए, जब कोई उपयोगकर्ता डिवाइस की सेटिंग में मैन्युअल तरीके से बदलाव करता है, तो इन बदलावों को अनदेखा कर दिया जाता है.

ये वैल्यू स्वीकार की जाती हैं:
  • "autoUpdateDefault"
  • "autoUpdateHighPriority"
  • "autoUpdatePostponed"
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 ऐप्लिकेशन की स्थिति की गंभीरता. यह फ़ील्ड हमेशा मौजूद रहेगा.

ये वैल्यू स्वीकार की जाती हैं:
  • "severityError"
  • "severityInfo"
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 पर खाते हैं.