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