REST Resource: enterprises.migrationTokens

المرجع: MigrationToken

رمز مميّز لبدء نقل بيانات جهاز من أن يُدار من خلال وحدة تحكّم بسياسة جهاز تابعة لجهة خارجية إلى أن يُدار من خلال 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 أرقام عشرية. يتم أيضًا قبول العناصر غير "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 لمورد الجهاز. يجب ألا يزيد عدد الأحرف عن 1024 حرفًا.
device

string

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

حقل الربط expiration

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

string (Timestamp format)

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

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "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

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

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

الطُرق

create

 لإنشاء رمز مميّز لنقل البيانات، لنقل بيانات جهاز حالي من إدارة وحدة التحكّم بسياسة الجهاز (DPC) في إدارة الخدمات الجوّالة للمؤسسات (EMM) إلى إدارة Android Management API.

get

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

list

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