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

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