REST Resource: enterprises.migrationTokens

משאב: MigrationToken

אסימון להפעלת ההעברה של מכשיר מניהול על ידי DPC של צד שלישי לניהול על ידי Android Management API. אסימון העברה תקף רק למכשיר אחד. פרטים נוספים זמינים במדריך.

ייצוג ב-JSON 
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
שדות
name

string

פלט בלבד. השם של אסימון ההעברה, שנוצר על ידי השרת במהלך היצירה, בפורמט enterprises/{enterprise}/migrationTokens/{migrationToken}.
value

string

פלט בלבד. הערך של אסימון ההעברה.
createTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצר אסימון ההעברה הזה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
userId

string

חובה. לא ניתן לשינוי. מזהה המשתמש של חשבון Google Play המנוהל במכשיר, כמו ב-Play EMM API. הפרמטר הזה תואם לפרמטר userId בקריאה Devices.get של Play EMM API.
deviceId

string

חובה. לא ניתן לשינוי. המזהה של המכשיר, כמו ב-Play EMM API. הפרמטר הזה תואם לפרמטר deviceId בקריאה Devices.get של Play EMM API.
managementMode

enum (ManagementMode)

חובה. לא ניתן לשינוי. מצב הניהול של המכשיר או הפרופיל שמועבר.
policy

string

חובה. לא ניתן לשינוי. שם המדיניות שהוחלו במקור על המכשיר המשויך, בפורמט enterprises/{enterprise}/policies/{policy}.
additionalData

string

לא ניתן לשינוי. נתונים נוספים אופציונליים שצוינו על ידי ה-EMM. אחרי העברת המכשיר, השדה migrationAdditionalData של משאב המכשיר יאוכלס. האורך המקסימלי של השדה הזה הוא 1,024 תווים.
device

string

פלט בלבד. אחרי שמשתמשים באסימון ההעברה הזה כדי להעביר מכשיר, השם של משאב ה-Device שנוצר יאוכלס כאן, בטופס enterprises/{enterprise}/devices/{device}.

שדה האיחוד expiration.

הערך של expiration יכול להיות רק אחת מהאפשרויות הבאות:
expireTime

string (Timestamp format)

לא ניתן לשינוי. המועד שבו יפוג תוקף אסימון ההעברה. התהליך הזה יכול להימשך עד שבעה ימים מרגע היצירה. אסימון ההעברה נמחק שבעה ימים אחרי שתוקפו פג.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
ttl

string (Duration format)

קלט בלבד. פרק הזמן שבו אסימון ההעברה הזה תקף. זהו שדה קלט בלבד, וכדי להחזיר טוקן העברה, השרת יאכלס את השדה expireTime. התהליך עשוי להימשך עד שבעה ימים. ברירת המחדל היא שבעה ימים.

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".

ManagementMode

מצב הניהול של המכשיר או הפרופיל שמועבר.

טיפוסים בני מנייה (enum)
MANAGEMENT_MODE_UNSPECIFIED אסור להשתמש בערך הזה.
WORK_PROFILE_PERSONALLY_OWNED פרופיל עבודה במכשיר בבעלות אישית. התכונה נתמכת רק במכשירים עם Android מגרסה 9 ואילך.
WORK_PROFILE_COMPANY_OWNED פרופיל עבודה במכשיר בבעלות החברה. התכונה נתמכת רק במכשירים עם Android מגרסה 11 ואילך.
FULLY_MANAGED מכשיר מנוהל באופן מלא. התכונה נתמכת רק במכשירים עם Android מגרסה 9 ואילך.

Methods

create

 יצירת אסימון העברה, כדי להעביר מכשיר קיים מהניהול של בקר מדיניות המכשירים (DPC) של ה-EMM לניהול על ידי Android Management API.

get

 מקבל טוקן העברה.

list

 הצגת אסימוני העברה.