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.