Method: enterprises.devices.issueCommand

string

اسم الجهاز بالتنسيق enterprises/{enterpriseId}/devices/{deviceId}

{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}

enum (CommandType)

نوع الطلب

string (Timestamp format)

الطابع الزمني الذي تم إنشاء الأمر فيه ينشئ الخادم الطابع الزمني تلقائيًا.

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

string (Duration format)

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

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

string

اسم المورد للمستخدم الذي يملك الجهاز بالتنسيق enterprises/{enterpriseId}/users/{userId}. يتم إنشاء هذا الرمز تلقائيًا من قِبل الخادم استنادًا إلى الجهاز الذي يتم إرسال الأمر إليه.

enum (CommandErrorCode)

إذا تعذّر تنفيذ الأمر، سيظهر رمز خطأ يوضّح سبب التعذّر. لا يتم ضبط هذا الإعداد عندما يلغي المتصل الطلب.

string

بالنسبة إلى الأوامر من النوع RESET_PASSWORD، يحدّد هذا الحقل كلمة المرور الجديدة اختياريًا. ملاحظة: يجب أن تتألف كلمة المرور الجديدة من 6 أحرف على الأقل إذا كانت رقمية في أجهزة Android 14. وإلا سيتعذّر تنفيذ الأمر مع ظهور INVALID_VALUE.

enum (ResetPasswordFlag)

بالنسبة إلى الطلبات من النوع RESET_PASSWORD، يحدِّد هذا الحقل اختياريًا العلامات.

object (ClearAppsDataParams)

مَعلمات الأمر CLEAR_APP_DATA لمحو بيانات تطبيقات محدّدة من الجهاز يمكنك الاطّلاع على ClearAppsDataParams. في حال ضبط هذا الخيار، يُنصح بعدم ضبط type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على CLEAR_APP_DATA. من المقبول أيضًا ضبط type على CLEAR_APP_DATA بشكل صريح.

object (StartLostModeParams)

مَعلمات الأمر START_LOST_MODE لتفعيل وضع "فقدان الجهاز" يمكنك الاطّلاع على StartLostModeParams. في حال ضبط هذا الخيار، يُنصح بعدم ضبط type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على START_LOST_MODE. من المقبول أيضًا ضبط type على START_LOST_MODE بشكل صريح.

object (StopLostModeParams)

مَعلمات الأمر STOP_LOST_MODE لإزالة الجهاز من وضع "فقدان الجهاز" يمكنك الاطّلاع على StopLostModeParams. في حال ضبط هذا الخيار، يُنصح بعدم ضبط type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على STOP_LOST_MODE. من المقبول أيضًا ضبط type على STOP_LOST_MODE بشكل صريح.

object (ClearAppsDataStatus)

النتائج فقط. حالة الأمر CLEAR_APP_DATA لمحو بيانات تطبيقات محدّدة من الجهاز يمكنك الاطّلاع على ClearAppsDataStatus.

object (StartLostModeStatus)

النتائج فقط. حالة الأمر START_LOST_MODE لتفعيل وضع "فقدان الجهاز" يمكنك الاطّلاع على StartLostModeStatus.

object (StopLostModeStatus)

النتائج فقط. حالة الأمر STOP_LOST_MODE لإيقاف وضع "فقدان الجهاز" على الجهاز يمكنك الاطّلاع على StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

أسماء حِزم التطبيقات التي سيتم محو بياناتها عند تنفيذ الأمر

{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}

object (UserFacingMessage)

الرسالة التي تظهر للمستخدم عندما يكون الجهاز في وضع "فقدان الجهاز"

object (UserFacingMessage)

رقم الهاتف الذي سيتم الاتصال به عندما يكون الجهاز في وضع "فقدان الجهاز" ويتم النقر على زر "الاتصال بصاحب الجهاز"

string

عنوان البريد الإلكتروني الذي يظهر للمستخدم عندما يكون الجهاز في وضع "فقدان الجهاز"

object (UserFacingMessage)

عنوان الشارع الذي يظهر للمستخدم عندما يكون الجهاز في وضع "فقدان الجهاز"

object (UserFacingMessage)

اسم المؤسسة الذي يظهر للمستخدم عندما يكون الجهاز في وضع "فقدان الجهاز"

{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}

map (key: string, value: object (PerAppResult))

النتائج لكل تطبيق، وهي تشير إلى تعيين أسماء الحِزم إلى نتيجة الإزالة ذات الصلة.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

نتيجة محاولة محو بيانات تطبيق واحد

{
  "status": enum (Status)
}

enum (Status)

الحالة يمكنك الاطّلاع على StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

الحالة يمكنك الاطّلاع على StopLostModeStatus.