REST Resource: enterprises.migrationTokens

منبع: MigrationToken

یک توکن برای شروع مهاجرت یک دستگاه از مدیریت توسط DPC شخص ثالث به مدیریت توسط API مدیریت اندروید. یک توکن مهاجرت فقط برای یک دستگاه معتبر است. برای جزئیات بیشتر به راهنما مراجعه کنید.

نمایش JSON 
{
  "name": string,
  "value": string,
  "createTime": string,
  "userId": string,
  "deviceId": string,
  "managementMode": enum (ManagementMode),
  "policy": string,
  "additionalData": string,
  "device": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "expireTime": string,
  "ttl": string
  // End of mutually exclusive fields.
}
فیلدها
name

string

فقط خروجی. نام توکن مهاجرت، که توسط سرور در حین ایجاد، به شکل enterprises/{enterprise}/migrationTokens/{migrationToken} تولید می‌شود.

value

string

فقط خروجی. مقدار توکن مهاجرت.

createTime

string ( Timestamp format)

فقط خروجی. زمانی که این توکن مهاجرت ایجاد شده است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

userId

string

الزامی. تغییرناپذیر. شناسه کاربری حساب مدیریت‌شده گوگل پلی روی دستگاه، همانند API مربوط به Play EMM. این شناسه معادل پارامتر userId در فراخوانی Devices.get از API مربوط به Play EMM است.

deviceId

string

الزامی. تغییرناپذیر. شناسه دستگاه، مانند آنچه در API مربوط به Play EMM وجود دارد. این مربوط به پارامتر deviceId در فراخوانی Devices.get از API مربوط به Play EMM است.

managementMode

enum ( ManagementMode )

الزامی. تغییرناپذیر. حالت مدیریت دستگاه یا پروفایلی که قرار است منتقل شود.

policy

string

الزامی. تغییرناپذیر. نام سیاستی که در ابتدا برای دستگاه ثبت‌شده اعمال شده است، به شکل enterprises/{enterprise}/policies/{policy} .

additionalData

string

تغییرناپذیر. داده‌های اضافی اختیاری مشخص شده توسط EMM. پس از انتقال دستگاه، این داده‌ها در فیلد migrationAdditionalData از منبع دستگاه قرار داده می‌شوند. این مقدار باید حداکثر ۱۰۲۴ کاراکتر باشد.

device

string

فقط خروجی. پس از استفاده از این توکن مهاجرت برای مهاجرت یک دستگاه، نام منبع Device حاصل در اینجا، به شکل enterprises/{enterprise}/devices/{device} قرار داده می‌شود.

در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از این فیلدها در پاسخ تنظیم خواهد شد:
expireTime

string ( Timestamp format)

تغییرناپذیر. زمان انقضای این توکن مهاجرت. این زمان می‌تواند حداکثر هفت روز از زمان ایجاد باشد. توکن مهاجرت هفت روز پس از انقضا حذف می‌شود.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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" .

پایان میدان‌های ناسازگار.

حالت مدیریت

حالت مدیریت دستگاه یا پروفایلی که قرار است منتقل شود.

انوم‌ها
MANAGEMENT_MODE_UNSPECIFIED این مقدار نباید استفاده شود.
WORK_PROFILE_PERSONALLY_OWNED یک پروفایل کاری روی دستگاه شخصی. فقط روی دستگاه‌هایی که اندروید ۹ و بالاتر دارند پشتیبانی می‌شود.
WORK_PROFILE_COMPANY_OWNED یک پروفایل کاری روی دستگاه متعلق به شرکت. فقط روی دستگاه‌هایی که اندروید ۱۱ و بالاتر دارند پشتیبانی می‌شود.
FULLY_MANAGED یک دستگاه کاملاً مدیریت‌شده. فقط در دستگاه‌هایی که اندروید ۹ و بالاتر دارند پشتیبانی می‌شود.

روش‌ها

create

 یک توکن مهاجرت ایجاد می‌کند تا یک دستگاه موجود را از حالت مدیریت‌شده توسط کنترل‌کننده‌ی سیاست دستگاه (DPC) در EMM به حالت مدیریت‌شده توسط API مدیریت اندروید منتقل کند.

get

 یک توکن مهاجرت دریافت می‌کند.

list

 توکن‌های مهاجرت را فهرست می‌کند.