ملاحظة مهمة: لم نعد نقبل عمليات التسجيل الجديدة لواجهة برمجة تطبيقات Play لخدمة إدارة الأجهزة الجوّالة للمؤسسات (EMM). مزيد من المعلومات

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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 عام. إذا لم يتم تحديد مدة، تكون المدة التلقائية ساعة واحدة.
`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 عام. إذا لم يتم تحديد مدة، تكون المدة التلقائية ساعة واحدة.
`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.`