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 मैनेज करता है. EMM की मदद से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए आईडी को देखने की ज़रूरत नहीं है, क्योंकि User.insert कॉल के बाद, आईडी को पहले ही वापस कर दिया जाता है.
revokeDeviceAccess
उन सभी डिवाइसों का ऐक्सेस वापस लेता है जिन पर फ़िलहाल उपयोगकर्ता के लिए प्रावधान किया गया है. उपयोगकर्ता अब अपने मैनेज किए जा रहे किसी भी डिवाइस पर, 'कारोबार के लिए Play Store' का इस्तेमाल नहीं कर पाएगा.

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

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