חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API. מידע נוסף

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 שנים. אם לא מציינים משך זמן, ברירת המחדל היא שעה אחת. ב-API בארכיטקטורת REST בפורמט JSON, הערך הזה מיוצג כמחרוזת (לדוגמה, ‎`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 שנים. אם לא מציינים משך זמן, ברירת המחדל היא שעה אחת. ב-API בארכיטקטורת REST בפורמט JSON, הערך הזה מיוצג כמחרוזת (לדוגמה, ‎`3600s`).
`duration.seconds`	`long`	שניות חתומות של טווח הזמן.
`googleAuthenticationOptions`	`nested object`	[אופציונלי] מספק אפשרויות שקשורות לאימות ב-Google במהלך ההרשמה.
`googleAuthenticationOptions.authenticationRequirement`	`string`	[אופציונלי] מציינת אם המשתמש צריך לבצע אימות באמצעות Google במהלך ההרשמה. אם ההגדרה הזו מצוינת, המערכת מתעלמת מההגדרה `GoogleAuthenticationSettings` שצוינה למשאב הארגוני עבור מכשירים שנרשמו באמצעות הטוקן הזה. הערכים הקבילים הם: "`authenticationRequirementUnspecified`" "`optional`" "`required`"
`googleAuthenticationOptions.requiredAccountEmail`	`string`	‫[Optional] מציין את חשבון Google המנוהל שבו המשתמש צריך להשתמש במהלך ההרשמה.`AuthenticationRequirement` צריך להיות מוגדר לערך`REQUIRED if this field is set.`