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 [اختیاری] مدت زمانی که رمز ثبت نام معتبر است، از 1 دقیقه تا Durations.MAX_VALUE ، تقریباً 10000 سال متغیر است. اگر مشخص نشده باشد، مدت زمان پیش فرض 1 ساعت است.
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 [اختیاری] مدت زمانی که رمز ثبت نام معتبر است، از 1 دقیقه تا Durations.MAX_VALUE ، تقریباً 10000 سال متغیر است. اگر مشخص نشده باشد، مدت زمان پیش فرض 1 ساعت است.
duration. seconds long ثانیه های امضا شده از بازه زمانی.
googleAuthenticationOptions nested object [اختیاری] گزینه های مربوط به احراز هویت Google را در طول ثبت نام ارائه می دهد.
googleAuthenticationOptions. authenticationRequirement string [اختیاری] مشخص می کند که آیا کاربر باید در حین ثبت نام با Google احراز هویت کند. این تنظیم، اگر مشخص شده باشد، GoogleAuthenticationSettings مشخص شده برای منبع سازمانی برای دستگاه‌های ثبت‌شده با این نشانه نادیده گرفته می‌شود.

مقادیر قابل قبول عبارتند از:
  • " authenticationRequirementUnspecified "
  • " optional "
  • " required "
googleAuthenticationOptions. requiredAccountEmail string [اختیاری] حساب مدیریت شده Google را مشخص می کند که کاربر باید هنگام ثبت نام از آن استفاده کند. REQUIRED if this field is set. AuthenticationRequirement باید روی REQUIRED تنظیم شود.