Devices

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

संसाधन के तौर पर दिखाए जाने वाले आइटम

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

{
  "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,
    "policyId": 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 से मिलता है. (logs/wireless/android/android_checkin.proto के हिसाब से, "device" नाम का फ़ील्ड)
kind string
latestBuildFingerprint string अगर डिवाइस का बिल्ड फ़िंगरप्रिंट पता है, तो वह.
maker string डिवाइस बनाने वाली कंपनी. यह android.os.Build.MANUFACTURER से मिला है.
managementType string इससे पता चलता है कि डिवाइस को, डिप्लॉयमेंट के अलग-अलग कॉन्फ़िगरेशन में, मैनेज किए जा रहे Google Play EMM से कितनी हद तक कंट्रोल किया जाता है.

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


ये वैल्यू डाली जा सकती हैं:
  • "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, अपने-आप अपडेट होने की सुविधा चालू करता है.
  • never, अपने-आप अपडेट होने की सुविधा बंद कर देता है.
  • wifiOnly सिर्फ़ वाई-फ़ाई से कनेक्ट होने पर, ऐप्लिकेशन अपने-आप अपडेट होने की सुविधा चालू करता है.


ये वैल्यू डाली जा सकती हैं:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string डिवाइस, EMM को ऐप्लिकेशन की स्थिति की रिपोर्ट करता है या नहीं. इसकी डिफ़ॉल्ट वैल्यू "deviceReportDisabled" है.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
policy.maintenanceWindow nested object रखरखाव के लिए तय की गई समयावधि, जिसमें फ़ोरग्राउंड में चल रहे ऐप्लिकेशन अपडेट किए जाने चाहिए.
policy.maintenanceWindow.durationMs long मेंटेनेंस विंडो की अवधि, मिलीसेकंड में. यह अवधि 30 मिनट से 24 घंटे के बीच होनी चाहिए.
policy.maintenanceWindow.startTimeAfterMidnightMs long डिवाइस पर मध्यरात्रि के बाद, मेंटेनेंस विंडो के शुरू होने का समय मिलीसेकंड में. विंडो, मध्यरात्रि तक हो सकती हैं.
policy.policyId string नीति का आइडेंटिफ़ायर, जिसे Play Store से भेजे गए ऐप्लिकेशन इंस्टॉल करने के सुझाव/राय/शिकायत के साथ भेजा जाएगा.
policy.productAvailabilityPolicy string चुने गए प्रॉडक्ट के लिए, डिवाइस पर उपलब्धता की अनुमति. "सभी" से डिवाइस को सभी प्रॉडक्ट का ऐक्सेस मिलता है. भले ही, प्रॉडक्ट को मंज़ूरी मिली हो या नहीं. "सभी" सेटिंग, "अल्फा" या "बीटा" ट्रैक के अपने-आप दिखने की सुविधा चालू नहीं करती. "whitelist", डिवाइस को 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 बूलियन वैल्यू - यह सिर्फ़ तब मौजूद होगी, जब प्रॉपर्टी का टाइप bool हो.
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 ऑब्जेक्ट. एक्सएसएस से बचने के लिए, हमारा सुझाव है कि डेटा दिखाने से पहले, उससे एचटीएमएल को हटा दें.
report.appState[].keyedAppState[].key string यह कुंजी बताती है कि ऐप्लिकेशन किस चीज़ के लिए स्टेटस दे रहा है. पासकोड का कॉन्टेंट, ऐप्लिकेशन का डेवलपर सेट करता है. एक्सएसएस से बचने के लिए, हमारा सुझाव है कि कुंजी को दिखाने से पहले उससे सभी एचटीएमएल को हटा दें. यह फ़ील्ड हमेशा मौजूद रहेगा.
report.appState[].keyedAppState[].message string ऐप्लिकेशन की स्थिति के बारे में बताने वाला फ़्री फ़ॉर्म मैसेज, जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. उदाहरण के लिए, गड़बड़ी का मैसेज. XSS को रोकने के लिए, हमारा सुझाव है कि मैसेज दिखाने से पहले उससे एचटीएमएल को हटा दें.
report.appState[].keyedAppState[].severity string ऐप्लिकेशन की स्थिति की गंभीरता. यह फ़ील्ड हमेशा मौजूद रहेगा.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "severityError"
  • "severityInfo"
report.appState[].keyedAppState[].stateTimestampMillis long ऐप्लिकेशन ने स्टेटस को सेट करने के समय का टाइमस्टैंप, जो कि युग के बाद के मिलीसेकंड में होता है. यह फ़ील्ड हमेशा मौजूद रहेगा.
report.appState[].packageName string ऐप्लिकेशन का पैकेज नाम. यह फ़ील्ड हमेशा मौजूद रहेगा.
report.lastUpdatedTimestampMillis long रिपोर्ट के आखिरी अपडेट का टाइमस्टैंप, माइलीसेकंड में. यह फ़ील्ड हमेशा मौजूद रहेगा.
retailBrand string अगर सेट किया गया है, तो डिवाइस का रीटेल ब्रैंड. android.os.Build.BRAND देखें
sdkVersion integer एपीआई के साथ काम करने वाला वर्शन.

तरीके

forceReportUpload
पिछली रिपोर्ट जनरेट होने के बाद से, डिवाइस पर ऐप्लिकेशन की स्थितियों में हुए किसी भी बदलाव की जानकारी देने वाली रिपोर्ट अपलोड करता है. किसी डिवाइस के लिए, इस तरीके को हर 24 घंटे में ज़्यादा से ज़्यादा तीन बार कॉल किया जा सकता है.
get
किसी डिवाइस की जानकारी हासिल करता है.
getState
यह पता लगाता है कि किसी डिवाइस के पास Google की सेवाओं का ऐक्सेस चालू है या नहीं. डिवाइस की स्थिति सिर्फ़ तब लागू होती है, जब Google Admin Console में Android डिवाइसों पर ईएमएम नीतियों को लागू करने की सुविधा चालू हो. ऐसा न करने पर, डिवाइस की स्थिति को अनदेखा कर दिया जाता है और सभी डिवाइसों को Google की सेवाओं का ऐक्सेस दिया जाता है. यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें Google मैनेज करता है.
list
उपयोगकर्ता के सभी डिवाइसों के आईडी हासिल करता है.
setState
यह सेट करता है कि किसी डिवाइस के पास Google की सेवाओं का ऐक्सेस चालू है या नहीं. डिवाइस की स्थिति सिर्फ़ तब लागू होती है, जब Google Admin console में Android डिवाइसों पर EMM की नीतियां लागू करने की सुविधा चालू हो. ऐसा न करने पर, डिवाइस की स्थिति को अनदेखा कर दिया जाता है और सभी डिवाइसों को Google की सेवाओं का ऐक्सेस दिया जाता है. यह सुविधा सिर्फ़ Google के मैनेज किए जा रहे उपयोगकर्ताओं के लिए उपलब्ध है.
अपडेट करें
डिवाइस नीति को अपडेट करता है.

यह पक्का करने के लिए कि नीति को सही तरीके से लागू किया जा रहा है, आपको मैनेज किए जा रहे खातों को Google Play को ऐक्सेस करने से रोकना होगा. इसके लिए, Google Play पैकेज के लिए मैनेज किए जा रहे कॉन्फ़िगरेशन में allowed_accounts सेट करें. Google Play में खातों पर पाबंदी लगाना देखें.