ज़रूरी जानकारी: अब हम Play EMM API (एपीआई) के लिए नए रजिस्ट्रेशन स्वीकार नहीं कर रहे हैं. ज़्यादा जानें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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 सेवाएं' का Android आईडी, जिसे लोअरकेस हेक्स स्ट्रिंग के तौर पर एन्कोड किया गया है. उदाहरण के लिए, `"123456789abcdef0"`.
`device`	`string`	डिवाइस का इंटरनल हार्डवेयर कोडनेम. यह `android.os.Build.DEVICE` से मिली है. (प्रति लॉग/वायरलेस/android/android_checkin.proto पर "डिवाइस" नाम वाला फ़ील्ड)
`kind`	`string`
`latestBuildFingerprint`	`string`	अगर डिवाइस के बिल्ड फ़िंगरप्रिंट की जानकारी है, तो वह फ़िंगरप्रिंट.
`maker`	`string`	डिवाइस का मैन्युफ़ैक्चरर. यह `android.os.Build.MANUFACTURER` से मिली है.
`managementType`	`string`	इससे पता चलता है कि अलग-अलग डिप्लॉयमेंट कॉन्फ़िगरेशन में, 'कारोबार के लिए Google Play ईएमएम' से डिवाइस को किस हद तक कंट्रोल किया जाता है. संभावित वैल्यू में ये शामिल हैं: "`managedDevice`", ऐसा डिवाइस जिसमें डिवाइस के मालिक के तौर पर ईएमएम के डिवाइस नीति कंट्रोलर (डीपीसी) का इस्तेमाल होता है. "`managedProfile`" एक ऐसा डिवाइस है जिसकी प्रोफ़ाइल को डीपीसी मैनेज करता है (डीपीसी, प्रोफ़ाइल का मालिक होता है). साथ ही, यह एक अलग निजी प्रोफ़ाइल होती है जो डीपीसी के लिए उपलब्ध नहीं होती. "`containerApp`", अब इस्तेमाल नहीं किया जाता (अब सेवा में नहीं है). "`unmanagedProfile`", एक ऐसा डिवाइस है जिसे 'कारोबार के लिए Google Play' का इस्तेमाल करने की अनुमति दी गई है. इसे डोमेन के एडमिन ने एडमिन कंसोल की मदद से 'कारोबार के लिए Google Play' का इस्तेमाल करने की अनुमति दी है. हालांकि, 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" की मदद से, डिवाइस का इस्तेमाल करने वाला व्यक्ति ऐप्लिकेशन को अपडेट करने की नीति को कॉन्फ़िगर कर सकता है. "हमेशा" विकल्प, अपने-आप अपडेट होने की सुविधा देता है. "कभी नहीं" अपने-आप अपडेट होने की सुविधा को बंद करता है. " WifiOnly" डिवाइस के अपने-आप अपडेट होने की सुविधा सिर्फ़ तब चालू होती है, जब डिवाइस वाई-फ़ाई से कनेक्ट होता है. ये वैल्यू डाली जा सकती हैं: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	डिवाइस, ईएमएम को ऐप्लिकेशन की जानकारी देता है या नहीं. डिफ़ॉल्ट वैल्यू "devicereportWhatd" है. ये वैल्यू डाली जा सकती हैं: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	मेंटेनेंस विंडो. यह तय करती है कि फ़ोरग्राउंड में चल रहे ऐप्लिकेशन कब अपडेट किए जाने चाहिए.
`policy.maintenanceWindow.durationMs`	`long`	रखरखाव विंडो की अवधि, मिलीसेकंड में. समयावधि 30 मिनट से 24 घंटे (दोनों शामिल) के बीच होनी चाहिए.
`policy.maintenanceWindow.startTimeAfterMidnightMs`	`long`	डिवाइस पर आधी रात के बाद रखरखाव विंडो की शुरुआत का समय, मिलीसेकंड में. Windows आधी रात तक काम कर सकता है.
`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 ऐप्लिकेशन को लॉन्च करने में मदद मिलती है. डिवाइस पर पुष्टि करने वाले यूआरएल के लिए, 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`	प्रॉपर्टी के बंडल की सूची - यह सिर्फ़ तब मौजूद होगी, जब प्रॉपर्टी का टाइप बंडल_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` से पहचाने गए खास प्रॉडक्ट रिलीज़ ट्रैक पर डिवाइस दिखने की अनुमति देता है. Product.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 की सेवाएं ऐक्सेस करने की अनुमति दे दी जाती है. यह सिर्फ़ उन उपयोगकर्ताओं के लिए काम करता है जिन्हें Google मैनेज करता है.
list: उपयोगकर्ता के सभी डिवाइसों के आईडी फिर से हासिल करता है.
setState: सेट करती है कि Google सेवाओं के लिए डिवाइस का ऐक्सेस चालू है या बंद है. डिवाइस की स्थिति सिर्फ़ तब लागू होती है, जब Android डिवाइसों पर ईएमएम नीतियों को Google Admin Console में चालू किया गया हो. ऐसा न होने पर, डिवाइस की स्थिति को अनदेखा कर दिया जाता है और सभी डिवाइसों को Google की सेवाएं ऐक्सेस करने की अनुमति दे दी जाती है. यह सिर्फ़ उन उपयोगकर्ताओं के लिए काम करता है जिन्हें Google मैनेज करता है.
अपडेट करें: डिवाइस से जुड़ी नीति को अपडेट करता है.

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