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 من واجهة برمجة التطبيقات لإدارة الخدمات الجوّالة للمؤسسات (EMM) في Play.
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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق 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 ملف عمل على جهاز مملوك للشركة لا تتوفّر هذه الميزة إلا على الأجهزة التي تعمل بالإصدار 11 من نظام التشغيل Android والإصدارات الأحدث.
FULLY_MANAGED جهاز مُدار بالكامل لا تتوفَّر هذه الميزة إلّا على الأجهزة التي تعمل بنظام التشغيل Android 9 والإصدارات الأحدث.

الطُرق

create

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

get

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

list

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