REST Resource: enterprises.enrollmentTokens

संसाधन: EnrollmentToken

रजिस्ट्रेशन टोकन.

जेएसओएन के काेड में दिखाना
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
फ़ील्ड
name

string

रजिस्ट्रेशन टोकन का नाम, जिसे सर्वर बनाए जाने के दौरान enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} फ़ॉर्म में जनरेट करता है.

value

string

टोकन की वह वैल्यू जो डिवाइस को दी जाती है और डिवाइस को रजिस्टर करने की अनुमति देती है. यह रीड-ओनली फ़ील्ड है, जिसे सर्वर जनरेट करता है.

duration

string (Duration format)

रजिस्ट्रेशन टोकन के मान्य रहने की अवधि, 1 मिनट से Durations.MAX_VALUE के बीच, करीब 10,000 साल तक की हो सकती है. अगर इसके बारे में जानकारी नहीं दी गई है, तो डिफ़ॉल्ट अवधि एक घंटा होती है. कृपया ध्यान दें कि अगर अनुरोध किए गए समय की वजह से, expirationTimestamp की वैल्यू Timestamps.MAX_VALUE से ज़्यादा हो जाती है, तो expirationTimestamp को Timestamps.MAX_VALUE पर लागू किया जाएगा.

सेकंड में दी गई अवधि, जिसमें नौ भिन्नांक हो सकते हैं. साथ ही, यह 's' पर खत्म होता है. उदाहरण: "3.5s".

expirationTimestamp

string (Timestamp format)

टोकन के खत्म होने की अवधि. यह रीड-ओनली फ़ील्ड है, जिसे सर्वर जनरेट करता है.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

policyName

string

रजिस्टर किए गए डिवाइस पर, शुरुआत में लागू की गई नीति का नाम, जो enterprises/{enterpriseId}/policies/{policyId} फ़ॉर्म में होता है. अगर इसके बारे में नहीं बताया गया है, तो डिवाइस के उपयोगकर्ता के लिए policyName लागू किया जाता है. अगर userName के बारे में भी जानकारी नहीं दी गई है, तो enterprises/{enterpriseId}/policies/default डिफ़ॉल्ट रूप से लागू होता है. इस फ़ील्ड को अपडेट करते समय, सिर्फ़ policyId तय किया जा सकता है. ऐसा तब तक किया जा सकता है, जब तक policyId में कोई स्लैश न हो. नीति के बाकी नाम का अनुमान लगाया जाएगा.

additionalData

string

रजिस्ट्रेशन टोकन से जुड़ा आर्बिट्रेरी डेटा, ज़रूरी नहीं है. उदाहरण के लिए, इसमें संगठन की उस इकाई का आईडी शामिल हो सकता है जिसे रजिस्टर करने के बाद डिवाइस को असाइन किया गया है. जब कोई डिवाइस टोकन के साथ रजिस्टर हो जाता है, तो यह डेटा Device संसाधन के enrollmentTokenData फ़ील्ड में दिखता है. डेटा में 1,024 या इससे कम वर्ण होने चाहिए. ऐसा न करने पर, डेटा बनाने का अनुरोध स्वीकार नहीं किया जाएगा.

qrCode

string

ऐसी JSON स्ट्रिंग जिसके UTF-8 वर्शन का इस्तेमाल, क्यूआर कोड जनरेट करने के लिए किया जा सकता है. इससे, इस रजिस्ट्रेशन टोकन वाले डिवाइस को रजिस्टर किया जा सकता है. एनएफ़सी का इस्तेमाल करके किसी डिवाइस को रजिस्टर करने के लिए, यह ज़रूरी है कि एनएफ़सी रिकॉर्ड में JSON में प्रॉपर्टी का सीरियल नंबर वाला java.util.Properties वर्शन मौजूद हो.

oneTimeOnly

boolean

रजिस्ट्रेशन टोकन का इस्तेमाल सिर्फ़ एक बार किया जा सकता है या नहीं. अगर फ़्लैग सही पर सेट है, तो रजिस्ट्रेशन के लिए सिर्फ़ एक डिवाइस ही इसका इस्तेमाल कर सकता है.

user
(deprecated)

object (User)

यह फ़ील्ड काम नहीं करता और वैल्यू को अनदेखा कर दिया जाता है.

allowPersonalUsage

enum (AllowPersonalUsage)

यह नीति कंट्रोल करती है कि रजिस्ट्रेशन टोकन वाले डिवाइस पर निजी इस्तेमाल की अनुमति है या नहीं.

कंपनी के मालिकाना हक वाले डिवाइसों के लिए:

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

निजी मालिकाना हक वाले डिवाइसों के लिए:

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

तरीके

create

दिए गए एंटरप्राइज़ के लिए, रजिस्ट्रेशन टोकन बनाता है.

delete

रजिस्ट्रेशन टोकन मिटा दिया जाता है.

get

आपको एक चालू, ऐसा रजिस्ट्रेशन टोकन मिलता है जिसकी समयसीमा खत्म नहीं हुई है.

list

यह किसी दिए गए एंटरप्राइज़ के लिए, चालू और ऐसे रजिस्ट्रेशन टोकन की सूची बनाता है जिनकी समयसीमा खत्म नहीं हुई हो.