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 ، تقریباً ۱۰۰۰۰ سال، متغیر است. در صورت عدم تعیین، مدت زمان پیش‌فرض ۱ ساعت است. در JSON REST API، این به صورت یک رشته (مثلاً `۳۶۰۰s`) نمایش داده می‌شود.
duration. seconds long ثانیه‌های امضا شده از بازه زمانی.
googleAuthenticationOptions nested object [اختیاری] گزینه‌های مربوط به احراز هویت گوگل را در طول ثبت‌نام ارائه می‌دهد.
googleAuthenticationOptions. authenticationRequirement string [اختیاری] مشخص می‌کند که آیا کاربر باید هنگام ثبت‌نام با گوگل احراز هویت کند یا خیر. در صورت ارائه، تنظیمات GoogleAuthenticationSettings را برای منبع سازمانی ، هنگام ثبت‌نام دستگاه‌ها با این توکن، لغو می‌کند.

مقادیر قابل قبول عبارتند از:
  • " authenticationRequirementUnspecified "
  • « optional »
  • « required »
googleAuthenticationOptions. requiredAccountEmail string [اختیاری] حساب گوگل مدیریت‌شده‌ای را که کاربر باید هنگام ثبت‌نام از آن استفاده کند، مشخص می‌کند. در صورت تنظیم این فیلد، 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 ، تقریباً ۱۰۰۰۰ سال، متغیر است. در صورت عدم تعیین، مدت زمان پیش‌فرض ۱ ساعت است. در JSON REST API، این به صورت یک رشته (مثلاً `۳۶۰۰s`) نمایش داده می‌شود.
duration. seconds long ثانیه‌های امضا شده از بازه زمانی.
googleAuthenticationOptions nested object [اختیاری] گزینه‌های مربوط به احراز هویت گوگل را در طول ثبت‌نام ارائه می‌دهد.
googleAuthenticationOptions. authenticationRequirement string [اختیاری] مشخص می‌کند که آیا کاربر باید در طول ثبت‌نام با گوگل احراز هویت کند یا خیر. این تنظیم، در صورت مشخص شدن، GoogleAuthenticationSettings مشخص شده برای منبع سازمانی، برای دستگاه‌های ثبت‌نام شده با این توکن نادیده گرفته می‌شود.

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