REST Resource: enterprises.enrollmentTokens

रिसॉर्स: EnrollmentToken

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

JSON के काेड में दिखाना
{
  "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)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "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 फ़ील्ड में दिखेगा. डेटा में 1024 या इससे कम वर्ण होने चाहिए. अगर ऐसा नहीं होता है, तो अनुरोध नहीं किया जा सकेगा.

qrCode

string

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

oneTimeOnly

boolean

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

user
(deprecated)

object (User)

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

allowPersonalUsage

enum (AllowPersonalUsage)

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

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

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

निजी तौर पर इस्तेमाल किए जाने वाले डिवाइसों के लिए:

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

तरीके

create

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

delete

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

get

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

list

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