Users

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

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

उपयोगकर्ता संसाधन, किसी एंटरप्राइज़ से जुड़े खाते को दिखाता है. खाता किसी डिवाइस के लिए या किसी व्यक्तिगत उपयोगकर्ता के लिए हो सकता है (जो उस खाते को एक से ज़्यादा डिवाइसों पर इस्तेमाल कर सकता है). पहचान के मॉडल के आधार पर, खाता सिर्फ़ 'कारोबार के लिए Google Play' या Google की अन्य सेवाओं को ऐक्सेस दे सकता है:

  • Google से मैनेज किए जाने वाले डोमेन के आइडेंटिटी मॉडल को, primaryEmail के ज़रिए Google खाता सोर्स के साथ सिंक करने की ज़रूरत होती है.
  • 'कारोबार के लिए Google Play खातों' के आइडेंटिटी मॉडल से, एंटरप्राइज़ को ज़रूरत के मुताबिक उपयोगकर्ता या डिवाइस खाते बनाने का बेहतर तरीका मिलता है. ये खाते, कारोबार के लिए Google Play को ऐक्सेस करने की सुविधा देते हैं.

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
प्रॉपर्टी का नाम मान ब्यौरा नोट
accountIdentifier string इस उपयोगकर्ता के लिए आपका बनाया गया यूनीक आइडेंटिफ़ायर, जैसे कि "user342" या "asset#44418" के लिए है. इस प्रॉपर्टी के लिए, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) का इस्तेमाल न करें. ईएमएम से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए हमेशा सेट होना चाहिए. Google से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए सेट नहीं है.
accountType string यह उपयोगकर्ता जिस तरह का खाता दिखाता है. किसी userAccount को कई डिवाइसों पर इंस्टॉल किया जा सकता है, लेकिन deviceAccount को सिर्फ़ एक डिवाइस पर इंस्टॉल किया जा सकता है. ईएमएम से मैनेज किया जाने वाला उपयोगकर्ता (emmManaged) इनमें से किसी भी तरह का हो सकता है (userAccount, deviceAccount), लेकिन Google की ओर से मैनेज किया जाने वाला उपयोगकर्ता (googleManaged) हमेशा userAccount होता है.

ये वैल्यू स्वीकार की जाती हैं:
  • "deviceAccount"
  • "userAccount"
displayName string वह नाम जो यूज़र इंटरफ़ेस में दिखेगा. ईएमएम से मैनेज किए जाने वाले उपयोगकर्ता बनाते समय, इस प्रॉपर्टी को सेट करना ज़रूरी नहीं है. अगर आपको यह प्रॉपर्टी सेट करनी है, तो संगठन से जुड़े किसी सामान्य नियम (जैसे कि "Example, Inc.") या अपने नाम (ईएमएम के तौर पर) का इस्तेमाल करें. इसका इस्तेमाल, Google के मैनेज किए जाने वाले उपयोगकर्ता खातों के लिए नहीं किया जाता. लिखा जा सकता है
id string उपयोगकर्ता का यूनीक आईडी.

kind string
managementType string वह इकाई जो उपयोगकर्ता को मैनेज करती है. googleManaged उपयोगकर्ताओं के होने का स्रोत Google है. इसलिए, ईएमएम को यह पक्का करना होगा कि उस उपयोगकर्ता के लिए कोई Google खाता मौजूद हो. emmManaged उपयोगकर्ताओं के साथ, ईएमएम मुख्य रूप से काम करता है.

ये वैल्यू स्वीकार की जाती हैं:
  • "emmManaged"
  • "googleManaged"
primaryEmail string उपयोगकर्ता का मुख्य ईमेल पता. जैसे, "jsmith@example.com". इसे हमेशा Google की ओर से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए सेट किया जाएगा और ईएमएम से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए सेट नहीं किया जाएगा.

तरीके

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

हर उपयोगकर्ता, ज़्यादा से ज़्यादा 10 डिवाइसों का प्रावधान कर सकता है.

यह कॉल सिर्फ़ ईएमएम से मैनेज किए जाने वाले खातों के साथ काम करता है.
पाएं
उपयोगकर्ता की जानकारी हासिल की जाती है.
getAvailableProductSet
उन प्रॉडक्ट के सेट को हासिल करता है जिनका ऐक्सेस उपयोगकर्ता के पास होता है.
डालें
ईएमएम से मैनेज किया जाने वाला नया उपयोगकर्ता खाता बनाता है.

उपयोगकर्ता संसाधन अनुरोध के मुख्य हिस्से में दिए गए दस्तावेज़ में, accountIdentifier और accountType.

अगर कोई संबंधित उपयोगकर्ता पहले से ही उसी खाता आइडेंटिफ़ायर के साथ मौजूद है, तो उपयोगकर्ता को संसाधन से अपडेट कर दिया जाएगा. इस मामले में, सिर्फ़ displayName फ़ील्ड को बदला जा सकता है.

list
उपयोगकर्ता को प्राथमिक ईमेल पते से खोजता है. यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें Google मैनेज करता है. आईडी का लुकअप नहीं है ईएमएम से प्रबंधित उपयोगकर्ताओं को इसकी ज़रूरत होती है, क्योंकि आईडी पहले से ही User.insert कॉल का नतीजा है.
revokeDeviceAccess
उन सभी डिवाइसों का ऐक्सेस वापस लेता है जिन पर फ़िलहाल उपयोगकर्ता के लिए प्रावधान किया गया है. किसी उपयोगकर्ता मैनेज किए जा रहे Play Store का इस्तेमाल, अपने किसी भी ऐप्लिकेशन पर नहीं कर पाएंगे मैनेज किए जा रहे डिवाइस.

यह कॉल सिर्फ़ ईएमएम से मैनेज किए जाने वाले खातों के साथ काम करता है.
setAvailableProductSet
प्रॉडक्ट के उस सेट में बदलाव करता है जिसे उपयोगकर्ता ऐक्सेस कर सकता है (इसे यहां बताया गया है) अनुमति वाले प्रॉडक्ट के तौर पर. सिर्फ़ वे प्रॉडक्ट जो स्वीकार किया गया या वे प्रॉडक्ट जिन्हें पहले मंज़ूरी दी गई थी (रद्द की गई अनुमति वाले प्रॉडक्ट) को व्हाइटलिस्ट किया जा सकता है.
अपडेट करें
ईएमएम से मैनेज किए जाने वाले उपयोगकर्ता की जानकारी अपडेट की जाती है.

इसे सिर्फ़ ईएमएम से मैनेज किए जाने वाले उपयोगकर्ताओं के साथ इस्तेमाल किया जा सकता है (Google की ओर से मैनेज किए जाने वाले उपयोगकर्ताओं के साथ नहीं). नई जानकारी को उपयोगकर्ता अनुरोध के मुख्य हिस्से में मौजूद संसाधन सिर्फ़ displayName फ़ील्ड बदला जा सकता है. दूसरे फ़ील्ड सेट नहीं होने चाहिए या उनमें फ़िलहाल, ऐक्टिव वैल्यू.