REST Resource: enterprises.enrollmentTokens

{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}

string

تمثّل هذه السمة اسم الرمز المميّز للتسجيل الذي ينشئه الخادم أثناء عملية الإنشاء، بالصيغة enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

string

قيمة الرمز المميّز التي يتم تمريرها إلى الجهاز وتسمح للجهاز بالتسجيل. هذا حقل للقراءة فقط ينشئه الخادم.

string (Duration format)

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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

string

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

string

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

string

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

boolean

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

object (User)

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

enum (AllowPersonalUsage)

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

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

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

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

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