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)

النتائج فقط. الوقت الذي تم فيه إنشاء هذا الرمز المميّز للنقل.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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 لمورد الجهاز. يجب ألا يزيد عدد الأحرف عن 1024 حرفًا.
device

string

النتائج فقط. بعد استخدام هذا الرمز المميّز لنقل بيانات جهاز، ستتم تعبئة اسم مورد Device الناتج هنا، بالصيغة enterprises/{enterprise}/devices/{device}.

حقل الاتحاد expiration

يمكن أن يكون الحقل "expiration" واحدًا فقط مما يلي:
expireTime

string (Timestamp format)

غير قابل للتغيير. الوقت الذي تنتهي فيه صلاحية الرمز المميّز للنقل هذا. يمكن أن يكون ذلك سبعة أيام على الأكثر من وقت الإنشاء. يتم حذف الرمز المميز للنقل بعد سبعة أيام من انتهاء صلاحيته.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
ttl

string (Duration format)

الإدخال فقط. الوقت الذي يكون فيه الرمز المميّز للنقل هذا صالحًا. هذا الإدخال فقط. لإرجاع الرمز المميز للنقل، سيملأ الخادم الحقل expireTime. يمكن أن تكون المدة سبعة أيام على الأكثر. المدة التلقائية هي سبعة أيام.

مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ "s". مثال: "3.5s".

ManagementMode

وضع إدارة الجهاز أو الملف الشخصي الذي يتم نقل بياناته

عمليات التعداد
MANAGEMENT_MODE_UNSPECIFIED يجب عدم استخدام هذه القيمة.
WORK_PROFILE_PERSONALLY_OWNED ملف شخصي للعمل على جهاز يملكه مستخدم شخصي لا تتوفّر هذه الميزة إلا على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأحدث.
WORK_PROFILE_COMPANY_OWNED ملف شخصي للعمل على جهاز تملكه الشركة لا تتوفّر هذه الميزة إلا على الأجهزة التي تعمل بنظام التشغيل Android 11 والإصدارات الأحدث.
FULLY_MANAGED جهاز مُدار بالكامل لا تتوفّر هذه الميزة إلا على الأجهزة التي تعمل بالإصدار 9 من نظام التشغيل Android والإصدارات الأحدث.

الطُرق

create

 ينشئ رمزًا مميزًا لنقل البيانات لنقل جهاز حالي من أن تتم إدارته من خلال وحدة التحكّم بسياسة الجهاز (DPC) التابعة لإدارة الخدمات الجوّالة للمؤسسات (EMM) إلى أن تتم إدارته بواسطة "واجهة برمجة التطبيقات لإدارة Android".

get

 الحصول على رمز مميّز للنقل

list

 يسرد الرموز المميّزة لنقل البيانات.