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