REST Resource: enterprises.migrationTokens

المورد: MigrationToken

رمز مميّز لبدء نقل بيانات جهاز من إدارته بواسطة وحدة تحكّم بسياسة الجهاز (DPC) تابعة لجهة خارجية إلى أن يكون مُدارًا بواسطة واجهة برمجة التطبيقات لإدارة Android الرمز المميّز لنقل البيانات صالح لجهاز واحد فقط. يمكنك الاطّلاع على الدليل للمزيد من التفاصيل.

تمثيل 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

userId

string

مطلوب. غير قابل للتغيير. رقم تعريف المستخدم لحساب "Google Play للأعمال" على الجهاز، مثل واجهة برمجة التطبيقات Play EMM API ويتوافق هذا مع المَعلمة userId في طلب Devices.get من واجهة برمجة التطبيقات لإدارة الخدمات الجوّالة للمؤسسات (EMM) في Play.

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

الطُرق

create

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

get

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

list

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