Enrollmenttokens: create

यह तरीका, एंटरप्राइज़ के लिए रजिस्ट्रेशन टोकन बनाता है. यह तरीका, 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 [ज़रूरी है] रजिस्ट्रेशन टोकन का टाइप.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [ज़रूरी नहीं] वह समयावधि जिसके लिए रजिस्ट्रेशन टोकन मान्य है. यह एक मिनट से लेकर Durations.MAX_VALUE तक हो सकती है. यह करीब 10,000 साल है. अगर कोई अवधि तय नहीं की जाती है, तो डिफ़ॉल्ट अवधि एक घंटा होती है. JSON REST API में, इसे स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, `3600s`.
duration.seconds long समय की अवधि को सेकंड में दिखाया जाता है.
googleAuthenticationOptions nested object [ज़रूरी नहीं] रजिस्ट्रेशन के दौरान, Google से पुष्टि करने से जुड़े विकल्प उपलब्ध कराता है.
googleAuthenticationOptions.authenticationRequirement string [ज़रूरी नहीं] इससे तय होता है कि रजिस्ट्रेशन के दौरान, उपयोगकर्ता को Google से पुष्टि करनी चाहिए या नहीं. अगर यह विकल्प चुना जाता है, तो इस टोकन से डिवाइस रजिस्टर होने पर, GoogleAuthenticationSettings के लिए एंटरप्राइज़ संसाधन को अनदेखा कर दिया जाता है.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
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 [ज़रूरी है] रजिस्ट्रेशन टोकन का टाइप.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [ज़रूरी नहीं] वह समयावधि जिसके लिए रजिस्ट्रेशन टोकन मान्य है. यह एक मिनट से लेकर Durations.MAX_VALUE तक हो सकती है. यह करीब 10,000 साल है. अगर कोई अवधि तय नहीं की जाती है, तो डिफ़ॉल्ट अवधि एक घंटा होती है. JSON REST API में, इसे स्ट्रिंग के तौर पर दिखाया जाता है. जैसे, `3600s`.
duration.seconds long समय की अवधि को सेकंड में दिखाया जाता है.
googleAuthenticationOptions nested object [ज़रूरी नहीं] रजिस्ट्रेशन के दौरान, Google से पुष्टि करने से जुड़े विकल्प उपलब्ध कराता है.
googleAuthenticationOptions.authenticationRequirement string [ज़रूरी नहीं] इससे तय होता है कि रजिस्ट्रेशन के दौरान, उपयोगकर्ता को Google से पुष्टि करनी चाहिए या नहीं. अगर यह सेटिंग तय की जाती है, तो इस टोकन से रजिस्टर किए गए डिवाइसों के लिए, एंटरप्राइज़ संसाधन के लिए तय की गई GoogleAuthenticationSettings को अनदेखा कर दिया जाता है.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [ज़रूरी नहीं] इससे तय होता है कि रजिस्ट्रेशन के दौरान, उपयोगकर्ता को मैनेज किए जा रहे किस Google खाते का इस्तेमाल करना होगा.AuthenticationRequirement कोREQUIRED if this field is set. पर सेट करना ज़रूरी है.