REST Resource: enterprises.enrollmentTokens

المورد: SUBSCRIPTIONToken

رمز مميَّز للتسجيل

تمثيل 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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "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

بيانات اختيارية عشوائية مرتبطة بالرمز المميّز للتسجيل وقد يحتوي هذا مثلاً على رقم تعريف الوحدة التنظيمية التي يتم تخصيص الجهاز لها بعد التسجيل. بعد تسجيل جهاز باستخدام الرمز المميّز، ستظهر هذه البيانات في حقل 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

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