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. يجب ألا يزيد عدد أحرف البيانات عن 1024 حرفًا، وإلا سيتعذّر إكمال طلب الإنشاء.

string

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

boolean

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

object (User)

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

enum (AllowPersonalUsage)

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

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

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

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

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