यह फ़ंक्शन, एंटरप्राइज़ के लिए रजिस्ट्रेशन टोकन बनाता है. यह तरीका, EnrollmentTokensService का हिस्सा है.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens
पैरामीटर
पैरामीटर का नाम | मान | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
enterpriseId |
string |
कंपनी का आईडी. |
अनुमति देना
इस अनुरोध के लिए, यहां दिए गए स्कोप के साथ अनुमति ज़रूरी है:
दायरा |
---|
https://www.googleapis.com/auth/androidenterprise |
ज़्यादा जानकारी के लिए, पुष्टि और अनुमति पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल करें:
{ "kind": "androidenterprise#enrollmentToken", "token": string, "enrollmentTokenType": string, "duration": { "seconds": long, "nanos": integer }, "googleAuthenticationOptions": { "authenticationRequirement": string, "requiredAccountEmail": string } }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
kind |
string |
||
token |
string |
यह टोकन वैल्यू, डिवाइस को भेजी जाती है. इससे डिवाइस को रजिस्टर करने की अनुमति मिलती है. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है. | |
enrollmentTokenType |
string |
[ज़रूरी है] एनरोलमेंट टोकन का टाइप.
इन वैल्यू का इस्तेमाल किया जा सकता है:
|
|
duration |
nested object |
[ज़रूरी नहीं] यह वह समय होता है जब तक डिवाइस का नाम दर्ज करने वाला टोकन मान्य रहता है. इसकी अवधि एक मिनट से लेकर Durations.MAX_VALUE तक होती है. यह अवधि करीब 10,000 साल होती है. अगर कोई अवधि तय नहीं की जाती है, तो डिफ़ॉल्ट अवधि एक घंटे की होती है. | |
duration.seconds |
long |
समय की अवधि के सेकंड. | |
googleAuthenticationOptions |
nested object |
[ज़रूरी नहीं] इससे, रजिस्ट्रेशन के दौरान Google की पुष्टि करने से जुड़े विकल्प मिलते हैं. | |
googleAuthenticationOptions.authenticationRequirement |
string |
[ज़रूरी नहीं] इससे यह तय होता है कि रजिस्ट्रेशन के दौरान, उपयोगकर्ता को Google से पुष्टि करनी चाहिए या नहीं. अगर यह वैल्यू दी गई है, तो इस टोकन से डिवाइसों को रजिस्टर करने पर, यह एंटरप्राइज़ संसाधन के लिए GoogleAuthenticationSettings को बदल देती है.
इन वैल्यू का इस्तेमाल किया जा सकता है:
|
|
googleAuthenticationOptions.requiredAccountEmail |
string |
[ज़रूरी नहीं] इससे मैनेज किए जा रहे उस Google खाते के बारे में पता चलता है जिसका इस्तेमाल उपयोगकर्ता को रजिस्ट्रेशन के दौरान करना होगा. अगर यह फ़ील्ड सेट है, तो AuthenticationRequirement को REQUIRED पर सेट किया जाना चाहिए. |
जवाब
अगर यह तरीका काम करता है, तो यह जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर दिखाता है:
{ "kind": "androidenterprise#enrollmentToken", "token": string, "enrollmentTokenType": string, "duration": { "seconds": long, "nanos": integer }, "googleAuthenticationOptions": { "authenticationRequirement": string, "requiredAccountEmail": string } }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
kind |
string |
||
token |
string |
यह टोकन वैल्यू, डिवाइस को भेजी जाती है. इससे डिवाइस को रजिस्टर करने की अनुमति मिलती है. यह सर्वर से जनरेट किया गया रीड-ओनली फ़ील्ड है. | |
enrollmentTokenType |
string |
[ज़रूरी है] एनरोलमेंट टोकन का टाइप.
इन वैल्यू का इस्तेमाल किया जा सकता है:
|
|
duration |
nested object |
[ज़रूरी नहीं] यह वह समय होता है जब तक डिवाइस का नाम दर्ज करने वाला टोकन मान्य रहता है. इसकी अवधि एक मिनट से लेकर Durations.MAX_VALUE तक होती है. यह अवधि करीब 10,000 साल होती है. अगर कोई अवधि तय नहीं की जाती है, तो डिफ़ॉल्ट अवधि एक घंटे की होती है. | |
duration.seconds |
long |
समय की अवधि के सेकंड. | |
googleAuthenticationOptions |
nested object |
[ज़रूरी नहीं] इससे, रजिस्ट्रेशन के दौरान Google की पुष्टि करने से जुड़े विकल्प मिलते हैं. | |
googleAuthenticationOptions.authenticationRequirement |
string |
[ज़रूरी नहीं] इससे यह तय होता है कि रजिस्ट्रेशन के दौरान, उपयोगकर्ता को Google से पुष्टि करनी चाहिए या नहीं. अगर यह सेटिंग तय की गई है, तो एंटरप्राइज़ संसाधन के लिए तय की गई GoogleAuthenticationSettings को इस टोकन के साथ रजिस्टर किए गए डिवाइसों के लिए अनदेखा कर दिया जाता है.
इन वैल्यू का इस्तेमाल किया जा सकता है:
|
|
googleAuthenticationOptions.requiredAccountEmail |
string |
[ज़रूरी नहीं] इससे मैनेज किए जा रहे उस Google खाते के बारे में पता चलता है जिसका इस्तेमाल उपयोगकर्ता को रजिस्ट्रेशन के दौरान करना होगा.AuthenticationRequirement को REQUIRED पर सेट किया जाना चाहिए |