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`	‫[Required] סוג טוקן ההרשמה. הערכים הקבילים הם: "`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`	‫[Required] סוג טוקן ההרשמה. הערכים הקבילים הם: "`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.`