Enrollmenttokens: create

ينشئ هذا الطلب رمزًا مميّزًا لتسجيل المؤسسة. هذه الطريقة جزء من EnrollmentTokensService.

طلب

طلب HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
enterpriseId string معرّف المؤسسة.

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

النطاق
https://www.googleapis.com/auth/androidenterprise

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، يجب تقديم بيانات بالبنية التالية:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
اسم السمة القيمة الوصف ملاحظات
kind string
token string قيمة الرمز المميّز الذي يتم تمريره إلى الجهاز ويمنحه إذن التسجيل. هذا الحقل للقراءة فقط وينشئه الخادم.
enrollmentTokenType string [مطلوب] نوع الرمز المميّز للتسجيل.

القيم المقبولة هي:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [اختياري] المدة التي يكون فيها الرمز المميّز للتسجيل صالحًا، وتتراوح بين دقيقة واحدة وDurations.MAX_VALUE، أي حوالي 10,000 عام. إذا لم يتم تحديد مدة، ستكون المدة التلقائية ساعة واحدة. في JSON REST API، يتم تمثيل هذه المدة كسلسلة (مثل `3600s`).
duration.seconds long الثواني الموقَّعة لفترة الوقت.
googleAuthenticationOptions nested object [اختياري] يقدّم خيارات متعلقة بمصادقة Google أثناء التسجيل.
googleAuthenticationOptions.authenticationRequirement string [اختياري] يحدّد ما إذا كان على المستخدم المصادقة باستخدام Google أثناء التسجيل. إذا تم تقديم هذه القيمة، فإنّها تلغي GoogleAuthenticationSettings لمورد المؤسسة عند تسجيل الأجهزة باستخدام هذا الرمز المميّز.

القيم المقبولة هي:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [اختياري] يحدّد حساب Google المُدار الذي يجب أن يستخدمه المستخدم أثناء التسجيل. يجب ضبط AuthenticationRequirement على REQUIRED إذا تم ضبط هذا الحقل.

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
اسم السمة القيمة الوصف ملاحظات
kind string
token string قيمة الرمز المميّز الذي يتم تمريره إلى الجهاز ويمنحه إذن التسجيل. هذا الحقل للقراءة فقط وينشئه الخادم.
enrollmentTokenType string [مطلوب] نوع الرمز المميّز للتسجيل.

القيم المقبولة هي:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [اختياري] المدة التي يكون فيها الرمز المميّز للتسجيل صالحًا، وتتراوح بين دقيقة واحدة وDurations.MAX_VALUE، أي حوالي 10,000 عام. إذا لم يتم تحديد مدة، ستكون المدة التلقائية ساعة واحدة. في JSON REST API، يتم تمثيل هذه المدة كسلسلة (مثل `3600s`).
duration.seconds long الثواني الموقَّعة لفترة الوقت.
googleAuthenticationOptions nested object [اختياري] يقدّم خيارات متعلقة بمصادقة Google أثناء التسجيل.
googleAuthenticationOptions.authenticationRequirement string [اختياري] يحدّد ما إذا كان على المستخدم المصادقة باستخدام Google أثناء التسجيل. إذا تم تحديد هذا الإعداد، يتم تجاهل GoogleAuthenticationSettings المحدّدة لمورد المؤسسة للأجهزة المسجَّلة باستخدام هذا الرمز المميّز.

القيم المقبولة هي:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [اختياري] يحدّد حساب Google المُدار الذي يجب أن يستخدمه المستخدم أثناء التسجيل.AuthenticationRequirement يجب ضبطه علىREQUIRED if this field is set.