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)

مدة صلاحية الرمز المميّز للتسجيل، والتي تتراوح بين دقيقة واحدة وDurations.MAX_VALUE، أي 10,000 عام تقريبًا إذا لم يتم تحديد مدة، تكون المدة التلقائية ساعة واحدة. يُرجى العلم أنّه إذا كانت المدة المطلوبة تؤدي إلى تجاوز expirationTimestamp الناتج Timestamps.MAX_VALUE، سيتم إجبار expirationTimestamp على Timestamps.MAX_VALUE.

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".
expirationTimestamp

string (Timestamp format)

وقت انتهاء صلاحية الرمز المميّز هذا حقل للقراءة فقط يتم إنشاؤه من قِبل الخادم.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
policyName

string

اسم السياسة التي تم تطبيقها في البداية على الجهاز المسجَّل، بالتنسيق enterprises/{enterpriseId}/policies/{policyId}. في حال عدم تحديدها، يتم تطبيق policyName لمستخدم الجهاز. إذا لم يتم تحديد userName أيضًا، يتم تطبيق enterprises/{enterpriseId}/policies/default تلقائيًا. عند تعديل هذا الحقل، يمكنك تحديد policyId فقط ما دام policyId لا يحتوي على أي شرطات مائلة. سيتم استنتاج بقية اسم السياسة.
additionalData

string

بيانات اختيارية عشوائية مرتبطة برمز التسجيل يمكن أن يحتوي هذا الحقل، على سبيل المثال، على رقم تعريف وحدة تنظيمية يتم إسناد الجهاز إليها بعد التسجيل. بعد تسجيل جهاز باستخدام الرمز المميّز، ستظهر هذه البيانات في حقل enrollmentTokenData لمصدر Device. يجب أن تتألف البيانات من 1024 حرفًا أو أقل، وإلا سيتعذّر إكمال طلب الإنشاء.
qrCode

string

سلسلة JSON التي يمكن استخدام تمثيلها بترميز UTF-8 لإنشاء رمز استجابة سريعة لتسجيل جهاز باستخدام رمز الاشتراك هذا لتسجيل جهاز باستخدام NFC، يجب أن يحتوي سجلّ NFC على تمثيل java.util.Properties متسلسل للسمات في ملف JSON.
oneTimeOnly

boolean

ما إذا كان الرمز المميّز للتسجيل مخصّصًا للاستخدام مرة واحدة فقط في حال ضبط العلامة على "صحيح"، يمكن لجهاز واحد فقط استخدامها للتسجيل.
user
(deprecated)

object (User)

تم إيقاف هذا الحقل نهائيًا ويتم تجاهل القيمة.
allowPersonalUsage

enum (AllowPersonalUsage)

تتحكّم هذه السمة في ما إذا كان يُسمح بالاستخدام الشخصي على جهاز تم إعداده باستخدام رمز تسجيل هذا الجهاز.

بالنسبة إلى الأجهزة المملوكة للشركة:

  • يتيح تفعيل الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • يتطلّب إيقاف الاستخدام الشخصي من المستخدم إعداد الجهاز كجهاز مُدار بالكامل.

بالنسبة إلى الأجهزة الشخصية:

  • يتيح تفعيل الاستخدام الشخصي للمستخدم إعداد ملف عمل على الجهاز.
  • سيؤدي إيقاف الاستخدام الشخصي إلى منع الجهاز من الإعداد. لا يمكن إيقاف ميزة "الاستخدام الشخصي" على الجهاز المملوك شخصيًا.

الطُرق

create

 لإنشاء رمز مميّز للتسجيل لمؤسسة معيّنة

delete

 لحذف رمز مميّز للتسجيل

get

 الحصول على رمز مميَّز نشط للتسجيل لم تنته صلاحيته

list

 يعرض هذا الإجراء الرموز المميّزة النشطة وغير المنتهية الصلاحية لتسجيل مؤسسة معيّنة.