इस संसाधन के लिए उपलब्ध तरीकों की सूची देखने के लिए, इस पेज के आखिर में देखें.
संसाधन निरूपण
उपयोगकर्ता संसाधन, किसी एंटरप्राइज़ से जुड़े खाते को दिखाता है. खाता किसी डिवाइस के लिए या किसी व्यक्तिगत उपयोगकर्ता के लिए हो सकता है (जो उस खाते को एक से ज़्यादा डिवाइसों पर इस्तेमाल कर सकता है). पहचान के मॉडल के आधार पर, खाता सिर्फ़ 'कारोबार के लिए 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 होता है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
displayName |
string |
वह नाम जो यूज़र इंटरफ़ेस में दिखेगा. ईएमएम से मैनेज किए जाने वाले उपयोगकर्ता बनाते समय, इस प्रॉपर्टी को सेट करना ज़रूरी नहीं है. अगर आपको यह प्रॉपर्टी सेट करनी है, तो संगठन से जुड़े किसी सामान्य नियम (जैसे कि "Example, Inc.") या अपने नाम (ईएमएम के तौर पर) का इस्तेमाल करें. इसका इस्तेमाल, Google के मैनेज किए जाने वाले उपयोगकर्ता खातों के लिए नहीं किया जाता. | लिखा जा सकता है |
id |
string |
उपयोगकर्ता का यूनीक आईडी. |
|
kind |
string |
||
managementType |
string |
वह इकाई जो उपयोगकर्ता को मैनेज करती है. googleManaged उपयोगकर्ताओं के होने का स्रोत Google है. इसलिए, ईएमएम को यह पक्का करना होगा कि उस उपयोगकर्ता के लिए कोई Google खाता मौजूद हो. emmManaged उपयोगकर्ताओं के साथ, ईएमएम मुख्य रूप से काम करता है.
ये वैल्यू स्वीकार की जाती हैं:
|
|
primaryEmail |
string |
उपयोगकर्ता का मुख्य ईमेल पता. जैसे, "jsmith@example.com". इसे हमेशा Google की ओर से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए सेट किया जाएगा और ईएमएम से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए सेट नहीं किया जाएगा. |
तरीके
- मिटाएं
- ईएमएम से मैनेज किया जाने वाला उपयोगकर्ता मिटाया गया.
- generateAuthenticationToken
- पुष्टि करने वाला एक टोकन जनरेट करता है. डिवाइस की नीति से जुड़ा क्लाइंट, इस टोकन का इस्तेमाल करके, किसी डिवाइस पर ईएमएम से मैनेज किए जाने वाले उपयोगकर्ता खाते का प्रावधान कर सकता है.
जनरेट किया गया टोकन एक ही बार इस्तेमाल किया जा सकता है. इसकी समयसीमा कुछ मिनट बाद खत्म हो जाती है.
हर उपयोगकर्ता, ज़्यादा से ज़्यादा 10 डिवाइसों का प्रावधान कर सकता है.
यह कॉल, सिर्फ़ ईएमएम से मैनेज किए जाने वाले खातों के साथ काम करता है. - पाएं
- उपयोगकर्ता की जानकारी हासिल की जाती है.
- getAvailableProductSet
- प्रॉडक्ट के उस सेट को हासिल करता है जिसका ऐक्सेस उपयोगकर्ता के पास होता है.
- डालें
- ईएमएम से मैनेज किया जाने वाला नया उपयोगकर्ता खाता बनाता है.
अनुरोध के मुख्य हिस्से में पास किए गए उपयोगकर्ताओं के संसाधन मेंaccountIdentifier
औरaccountType
शामिल होने चाहिए.अगर कोई संबंधित उपयोगकर्ता पहले से ही उसी खाता आइडेंटिफ़ायर के साथ मौजूद है, तो उपयोगकर्ता को संसाधन अपडेट कर दिया जाएगा. इस मामले में, सिर्फ़
displayName
फ़ील्ड को बदला जा सकता है. - list
- उपयोगकर्ता को प्राथमिक ईमेल पते से खोजता है. यह सुविधा सिर्फ़ उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्हें Google मैनेज करता है. EMM की मदद से मैनेज किए जाने वाले उपयोगकर्ताओं के लिए आईडी को देखने की ज़रूरत नहीं है, क्योंकि User.insert कॉल के बाद, आईडी को पहले ही वापस कर दिया जाता है.
- revokeDeviceAccess
- उन सभी डिवाइसों का ऐक्सेस वापस लेता है जिन पर फ़िलहाल उपयोगकर्ता के लिए प्रावधान किया गया है. उपयोगकर्ता
अब अपने मैनेज किए जा रहे किसी भी डिवाइस पर, 'कारोबार के लिए Play Store' का इस्तेमाल
नहीं कर पाएगा.
यह कॉल, सिर्फ़ ईएमएम से मैनेज किए जाने वाले खातों के साथ काम करता है. - setAvailableProductSet
- प्रॉडक्ट के उस सेट में बदलाव किया जाता है जिसे ऐक्सेस करने का अधिकार उपयोगकर्ता के पास है. इसे whitelisted प्रॉडक्ट कहा जाता है. सिर्फ़ उन प्रॉडक्ट को अनुमति दी जा सकती है जिन्हें स्वीकार किया गया हो या जिन्हें पहले ही मंज़ूरी मिल चुकी हो. जैसे, वे प्रॉडक्ट जिन्हें अनुमति वापस ली गई हो.
- अपडेट करें
- ईएमएम से मैनेज किए जाने वाले उपयोगकर्ता की जानकारी अपडेट की जाती है.
इसे सिर्फ़ उन उपयोगकर्ताओं के साथ इस्तेमाल किया जा सकता है जिन्हें ईएमएम मैनेज करता है. इसे उन उपयोगकर्ताओं के साथ इस्तेमाल नहीं किया जा सकता जिन्हें Google मैनेज करता है. अनुरोध के मुख्य हिस्से में, उपयोगकर्ता के संसाधन में नई जानकारी पास करें. सिर्फ़displayName
फ़ील्ड को बदला जा सकता है. दूसरे फ़ील्ड या तो सेट नहीं होनी चाहिए या उनमें इस समय ऐक्टिव वैल्यू होनी चाहिए.