Method: enterprises.devices.issueCommand

يُصدر هذا الإجراء أمرًا إلى جهاز. يحتوي المرجع Operation الذي تم عرضه على Command في الحقل metadata. استخدِم طريقة الحصول على العملية للحصول على حالة الأمر.

طلب HTTP

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
name

string

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

نص الطلب

يحتوي نص الطلب على مثال Command.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidmanagement

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

Command

أمر

تمثيل JSON 
{
  "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)
  },
  "addEsimParams": {
    object (AddEsimParams)
  },
  "removeEsimParams": {
    object (RemoveEsimParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  },
  "wipeParams": {
    object (WipeParams)
  }
  // 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)
  },
  "esimStatus": {
    object (EsimCommandStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of list of possible types for union field status.
}
الحقول
type

enum (CommandType)

تمثّل هذه السمة نوع الأمر.
createTime

string (Timestamp format)

الطابع الزمني لوقت إنشاء الأمر يتم إنشاء الطابع الزمني تلقائيًا بواسطة الخادم.

يستخدم RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
duration

string (Duration format)

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

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

string

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

enum (CommandErrorCode)

إذا تعذّر تنفيذ الأمر، سيظهر رمز خطأ يوضّح سبب التعذّر. لا يتم ضبط هذه القيمة عندما يلغي المتصل الأمر. للتفكير في أخطاء الأوامر، يُفضّل استخدام الحقول بالترتيب التالي (الأكثر تفضيلاً أولاً): 1. الحقول الخاصة بالأوامر، مثل clearAppsDataStatus أو startLostModeStatus أو ما شابه ذلك، إذا كانت متوفرة 2. هذا الحقل، إذا تم ضبطه. 3- حقل error العام في Operation الذي يغلّف الأمر
newPassword

string

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

enum (ResetPasswordFlag)

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

حقل الدمج params المَعلمات الخاصة بالأمر يُرجى العِلم أنّ بعض الأوامر لا تستخدم هذا التنسيق، لا سيما LOCK وRESET_PASSWORD وREBOOT وRELINQUISH_OWNERSHIP. وقد تستخدم هذه الأوامر هذه الميزة أيضًا في المستقبل.

في حال ضبط هذا الحقل، يجب عدم ضبط الحقلَين new_password وreset_password_flags. يمكن أن تكون params إحدى القيم التالية فقط:
clearAppsDataParams

object (ClearAppsDataParams)

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

object (StartLostModeParams)

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

object (StopLostModeParams)

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

object (AddEsimParams)

اختيارية: مَعلمات الأمر ADD_ESIM لإضافة ملف شخصي لشريحة eSIM إلى الجهاز في حال ضبط هذه السياسة، يُنصح بعدم ضبط سياسة type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على ADD_ESIM. يمكن أيضًا ضبط type على ADD_ESIM بشكلٍ صريح.
removeEsimParams

object (RemoveEsimParams)

اختيارية: مَعلمات الأمر REMOVE_ESIM لإزالة ملف تعريف eSIM من الجهاز في حال ضبط هذه السياسة، يُنصح بعدم ضبط سياسة type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على REMOVE_ESIM. يمكن أيضًا ضبط type على REMOVE_ESIM بشكلٍ صريح.
requestDeviceInfoParams

object (RequestDeviceInfoParams)

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

object (WipeParams)

اختيارية: مَعلمات الأمر WIPE لحجب البيانات عن الجهاز في حال ضبط هذه السياسة، يُنصح بعدم ضبط سياسة type. في هذه الحالة، يضبط الخادم القيمة تلقائيًا على WIPE. يمكن أيضًا ضبط type على WIPE بشكلٍ صريح.
حقل الدمج status الحالة الخاصة بالأمر يُرجى العِلم أنّ بعض الأوامر لا تستخدم هذا التنسيق، لا سيما LOCK وRESET_PASSWORD وREBOOT وRELINQUISH_OWNERSHIP. وقد تستخدم هذه الأوامر هذه الميزة أيضًا في المستقبل. يمكن أن تكون status إحدى القيم التالية فقط:
clearAppsDataStatus

object (ClearAppsDataStatus)

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

object (StartLostModeStatus)

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

object (StopLostModeStatus)

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

object (EsimCommandStatus)

النتائج فقط. حالة الأمر ADD_ESIM أو REMOVE_ESIM
requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

النتائج فقط. حالة الأمر REQUEST_DEVICE_INFO

CommandType

أنواع الأوامر

عمليات التعداد
COMMAND_TYPE_UNSPECIFIED هذه القيمة غير مسموح بها.
LOCK قفل الجهاز كما لو كانت مهلة قفل الشاشة قد انتهت
RESET_PASSWORD أعِد ضبط كلمة مرور المستخدم.
REBOOT أعِد تشغيل الجهاز. لا تتوفّر إلا على الأجهزة المُدارة بالكامل التي تعمل بالإصدار 7.0 من نظام التشغيل Android (المستوى 24 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.
RELINQUISH_OWNERSHIP تؤدي هذه العملية إلى إزالة ملف العمل وجميع السياسات من جهاز Android 8.0 أو الإصدارات الأحدث المملوك للشركة، ما يتيح استخدام الجهاز شخصيًا. يتم الاحتفاظ بالتطبيقات والبيانات المرتبطة بالملفات الشخصية. سيتم حذف الجهاز من الخادم بعد أن يؤكّد استلام الأمر.
CLEAR_APP_DATA يمحو بيانات التطبيق للتطبيقات المحدّدة. تتوفّر هذه الميزة على الإصدار 9 من نظام التشغيل Android والإصدارات الأحدث. يُرجى العِلم أنّه يمكن لأي تطبيق تخزين البيانات خارج بياناته، مثلاً في وحدة تخزين خارجية أو في قاموس المستخدم. يمكنك أيضًا الاطّلاع على clearAppsDataParams.
START_LOST_MODE يضبط الجهاز على وضع "فقدان الجهاز". لا تتوفّر هذه الميزة إلا على الأجهزة المُدارة بالكامل أو الأجهزة المملوكة للمؤسسة التي تتضمّن ملفًا شخصيًا مُدارًا. يمكنك أيضًا الاطّلاع على startLostModeParams.
STOP_LOST_MODE يؤدي ذلك إلى إيقاف وضع "فقدان الجهاز". لا تتوفّر هذه الميزة إلا على الأجهزة المُدارة بالكامل أو الأجهزة المملوكة للمؤسسة التي تتضمّن ملفًا شخصيًا مُدارًا. يمكنك أيضًا الاطّلاع على stopLostModeParams.
ADD_ESIM تضيف هذه الطريقة ملفًا شخصيًا لشريحة eSIM إلى الجهاز. تتوفّر هذه الميزة على الإصدار 15 من نظام التشغيل Android والإصدارات الأحدث. يمكنك أيضًا الاطّلاع على addEsimParams. لإزالة ملف تعريف شريحة eSIM، استخدِم الأمر REMOVE_ESIM. لتحديد ما يحدث لملف eSIM عند محو بيانات الجهاز، اضبط wipeDataFlags في السياسة. ملاحظة: لتوفير شرائح eSIM متعددة على جهاز واحد، يُنصح بإضافة تأخير لبضع دقائق بين عمليات تنفيذ الأمر المتتالية.
REMOVE_ESIM تتم إزالة ملف تعريف eSIM من الجهاز. تتوفّر هذه الميزة على الإصدار 15 من نظام التشغيل Android والإصدارات الأحدث. يمكنك أيضًا الاطّلاع على removeEsimParams.
REQUEST_DEVICE_INFO طلب معلومات متعلّقة بالجهاز
WIPE محو بيانات الجهاز من خلال إعادة ضبط الإعدادات الأصلية لجهاز مملوك للشركة، أو عن طريق حذف ملف العمل على جهاز شخصي يتضمّن ملف عمل لا تتم عملية محو البيانات إلا بعد أن يقرّ الجهاز باستلام الأمر. ويمكن إلغاء الأمر قبل ذلك.

CommandErrorCode

رمز خطأ في الأمر هذا الحقل مخصّص للقراءة فقط ويتمّ تعبئته بواسطة الخادم.

عمليات التعداد
COMMAND_ERROR_CODE_UNSPECIFIED لم يحدث أي خطأ.
UNKNOWN حدث خطأ غير معروف.
API_LEVEL لا يتوافق مستوى واجهة برمجة التطبيقات للجهاز مع هذا الأمر.
MANAGEMENT_MODE لا يتيح وضع الإدارة (مالك الملف الشخصي أو مالك الجهاز أو غير ذلك) تنفيذ الأمر.
INVALID_VALUE يحتوي الأمر على قيمة مَعلمة غير صالحة.
UNSUPPORTED الجهاز لا يتيح استخدام الأمر. قد يؤدي تحديث تطبيق "سياسة Android" إلى أحدث إصدار إلى حلّ المشكلة.

ResetPasswordFlag

العلامات التي يمكن استخدامها لنوع الأمر RESET_PASSWORD

عمليات التعداد
RESET_PASSWORD_FLAG_UNSPECIFIED يتم تجاهل هذه القيمة.
REQUIRE_ENTRY لا تسمح للمشرفين الآخرين بتغيير كلمة المرور مرة أخرى إلى أن يُدخلها المستخدم.
DO_NOT_ASK_CREDENTIALS_ON_BOOT عدم طلب بيانات اعتماد المستخدم عند تشغيل الجهاز
LOCK_NOW اقفل الجهاز بعد إعادة ضبط كلمة المرور.

ClearAppsDataParams

المَعلمات المرتبطة بالأمر CLEAR_APP_DATA لمحو بيانات التطبيقات المحدّدة من الجهاز

تمثيل JSON 
{
  "packageNames": [
    string
  ]
}
الحقول
packageNames[]

string

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

StartLostModeParams

المَعلمات المرتبطة بالأمر START_LOST_MODE لتفعيل وضع "فقدان الجهاز" يجب توفير مَعلمة واحدة على الأقل، باستثناء اسم المؤسسة، حتى يمكن وضع الجهاز في وضع "الفقدان".

تمثيل JSON 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
الحقول
lostMessage

object (UserFacingMessage)

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

object (UserFacingMessage)

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

string

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

object (UserFacingMessage)

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

object (UserFacingMessage)

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

StopLostModeParams

لا يتضمّن هذا النوع أي حقول.

المَعلمات المرتبطة بالأمر STOP_LOST_MODE لإخراج الجهاز من وضع "فقدان الجهاز"

AddEsimParams

المَعلمات المرتبطة بالأمر ADD_ESIM لإضافة ملف شخصي لشريحة eSIM إلى الجهاز

تمثيل JSON 
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
الحقول
activationCode

string

مطلوب. رمز تفعيل ملف eSIM الشخصي
activationState

enum (ActivationState)

مطلوب. حالة تفعيل ملف eSIM الشخصي بعد تنزيله

ActivationState

حالة تفعيل ملف eSIM الشخصي بعد تنزيله

عمليات التعداد
ACTIVATION_STATE_UNSPECIFIED لم يتم تحديد حالة تفعيل بطاقة eSIM. يكون الإعداد التلقائي لملف eSIM هو NOT_ACTIVATED على الأجهزة الشخصية وACTIVATED على الأجهزة المملوكة للشركة.
ACTIVATED يتم تفعيل شريحة eSIM تلقائيًا بعد تنزيلها. سيؤدي ضبط هذه الحالة كحالة التفعيل للأجهزة المملوكة شخصيًا إلى رفض الأمر.
NOT_ACTIVATED تم تنزيل ملف eSIM الشخصي ولكن لم يتم تفعيله. في هذه الحالة، على المستخدم تفعيل شريحة eSIM يدويًا على الجهاز.

RemoveEsimParams

المَعلمات المرتبطة بالأمر REMOVE_ESIM لإزالة ملف تعريف eSIM من الجهاز

تمثيل JSON 
{
  "iccId": string
}
الحقول
iccId

string

مطلوب. معرّف ICC لملف eSIM الشخصي الذي سيتم حذفه.

RequestDeviceInfoParams

المَعلمات المرتبطة بالأمر REQUEST_DEVICE_INFO للحصول على معلومات ذات صلة بالجهاز

تمثيل JSON 
{
  "deviceInfo": enum (DeviceInfo)
}
الحقول
deviceInfo

enum (DeviceInfo)

مطلوب. نوع معلومات الجهاز المطلوب الحصول عليها

DeviceInfo

نوع معلومات الجهاز المطلوب الحصول عليها

عمليات التعداد
DEVICE_INFO_UNSPECIFIED هذه القيمة غير مسموح بها.
EID اطلب معرّف شريحة eSIM. سيُطلب من المستخدم الموافقة على الإفصاح عن المعلومات قبل أن يتم عرض النتيجة. في حال عدم موافقة المستخدم على بيان الإفصاح، سيتم إرجاع USER_DECLINED. تتوفّر هذه الميزة فقط للأجهزة الشخصية التي تتضمّن ملفات عمل وتعمل بالإصدار 13 من نظام التشغيل Android والإصدارات الأحدث.

WipeParams

المَعلمات المرتبطة بالأمر WIPE لحجب البيانات عن الجهاز

تمثيل JSON 
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
الحقول
wipeDataFlags[]

enum (WipeDataFlag)

اختيارية: علامات لتحديد البيانات المطلوب محوها
wipeReason

object (UserFacingMessage)

اختيارية: رسالة قصيرة يتم عرضها للمستخدم قبل محو بيانات ملف العمل على الأجهزة الشخصية لن يؤثّر ذلك في الأجهزة المملوكة للشركة. الحد الأقصى لطول الرسالة هو 200 حرف.

ClearAppsDataStatus

حالة الأمر CLEAR_APP_DATA لمحو بيانات التطبيقات المحدّدة من الجهاز

تمثيل JSON 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
الحقول
results

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

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

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

PerAppResult

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

تمثيل JSON 
{
  "clearingResult": enum (ClearingResult)
}
الحقول
clearingResult

enum (ClearingResult)

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

ClearingResult

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

عمليات التعداد
CLEARING_RESULT_UNSPECIFIED نتيجة غير محدَّدة
SUCCESS تم محو بيانات هذا التطبيق بنجاح.
APP_NOT_FOUND تعذّر محو بيانات هذا التطبيق لأنّه لم يتم العثور عليه.
APP_PROTECTED تعذّر محو بيانات هذا التطبيق لأنّه محمي. على سبيل المثال، قد ينطبق ذلك على التطبيقات الضرورية لتشغيل الجهاز، مثل "متجر Google Play".
API_LEVEL تعذّر محو بيانات هذا التطبيق لأنّ مستوى واجهة برمجة التطبيقات للجهاز لا يتوافق مع هذا الأمر.

StartLostModeStatus

حالة الأمر START_LOST_MODE لتفعيل وضع "فقدان الجهاز" على الجهاز

تمثيل JSON 
{
  "status": enum (Status)
}
الحقول
status

enum (Status)

تمثّل هذه السمة الحالة. يمكنك الاطّلاع على StartLostModeStatus.

الحالة

تمثّل هذه السمة الحالة. يمكنك الاطّلاع على StartLostModeStatus.

عمليات التعداد
STATUS_UNSPECIFIED غير محدد لا يتم استخدام هذه القيمة.
SUCCESS تم تفعيل وضع "فقدان الجهاز" على الجهاز.
RESET_PASSWORD_RECENTLY تعذّر تفعيل وضع "فقدان الجهاز" لأنّ المشرف أعاد ضبط كلمة مرور الجهاز مؤخرًا.
USER_EXIT_LOST_MODE_RECENTLY تعذّر تفعيل وضع "فقدان الجهاز" لأنّ المستخدم أوقف هذا الوضع مؤخرًا.
ALREADY_IN_LOST_MODE الجهاز في وضع "فقدان الجهاز" حاليًا.

StopLostModeStatus

حالة الأمر STOP_LOST_MODE لإيقاف وضع "فقدان الجهاز"

تمثيل JSON 
{
  "status": enum (Status)
}
الحقول
status

enum (Status)

تمثّل هذه السمة الحالة. يمكنك الاطّلاع على StopLostModeStatus.

الحالة

تمثّل هذه السمة الحالة. يمكنك الاطّلاع على StopLostModeStatus.

عمليات التعداد
STATUS_UNSPECIFIED غير محدد لا يتم استخدام هذه القيمة.
SUCCESS تم إيقاف وضع "فقدان الجهاز" على الجهاز.
NOT_IN_LOST_MODE الجهاز ليس في وضع "فقدان الجهاز".

EsimCommandStatus

حالة وتفاصيل الخطأ (إن وُجدت) لأمر ADD_ESIM أو REMOVE_ESIM

تمثيل JSON 
{
  "status": enum (Status),
  "esimInfo": {
    object (EsimInfo)
  },

  // Union field status_details can be only one of the following:
  "internalErrorDetails": {
    object (InternalErrorDetails)
  }
  // End of list of possible types for union field status_details.
}
الحقول
status

enum (Status)

النتائج فقط. حالة الأمر ADD_ESIM أو REMOVE_ESIM
esimInfo

object (EsimInfo)

النتائج فقط. معلومات عن شريحة eSIM التي تمت إضافتها أو إزالتها لا تتم تعبئة هذا الحقل إلا عندما تكون عملية شريحة eSIM status هي SUCCESS.
حقل الدمج status_details تفاصيل حالة الأمر ADD_ESIM أو REMOVE_ESIM يمكن أن تكون status_details إحدى القيم التالية فقط:
internalErrorDetails

object (InternalErrorDetails)

النتائج فقط. تفاصيل الخطأ إذا تم ضبط status على INTERNAL_ERROR

الحالة

حالة الأمر ADD_ESIM أو REMOVE_ESIM

عمليات التعداد
STATUS_UNSPECIFIED غير محدد لا يتم استخدام هذه القيمة.
SUCCESS تم تنفيذ عملية شريحة eSIM بنجاح على الجهاز.
IN_PROGRESS عملية شريحة eSIM قيد التقدم.
PENDING_USER_ACTION يجب أن يتخذ المستخدم إجراءً لمتابعة عملية eSIM.
ERROR_SETUP_IN_PROGRESS لا يمكن تنفيذ عملية شريحة eSIM عندما تكون عملية الإعداد قيد التقدّم.
ERROR_USER_DENIED رفض المستخدم عملية eSIM.
INTERNAL_ERROR حدث خطأ أثناء محاولة إضافة شريحة eSIM أو إزالتها على الجهاز، يُرجى الاطّلاع على internalErrorDetails.
ERROR_ICC_ID_NOT_FOUND بالنسبة إلى أمر REMOVE_ESIM، لم يتم العثور على iccId لشريحة eSIM التي سيتم إزالتها على الجهاز. قد يعني ذلك أنّ شريحة eSIM لا تنتمي إلى المؤسسة أو أنّ شريحة eSIM المرتبطة بـ iccId غير متوفّرة على الجهاز.
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT تعذّر تنفيذ الأمر ADD_ESIM عند محاولة إضافة شريحة eSIM جديدة بحالة تفعيل ACTIVATED لأنّ منافذ شرائح eSIM المتعددة على الجهاز تحتوي على ملفات شخصية نشطة لشريحة eSIM ولا يتوفّر منفذ مجاني لشريحة eSIM. لحلّ هذه المشكلة، يمكن إضافة شريحة eSIM الجديدة مع ضبط حالة تفعيلها على NOT_ACTIVATED لتفعيلها يدويًا لاحقًا، أو على المستخدم أولاً إيقاف شريحة eSIM نشطة حالية لكي تتم العملية.

InternalErrorDetails

تفاصيل الخطأ الداخلي إذا كانت متوفّرة للأمر ADD_ESIM أو REMOVE_ESIM

تمثيل JSON 
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
الحقول
operationCode

string (int64 format)

النتائج فقط. تمثّل هذه السمة رمز العملية كعدد صحيح كما هو موضّح هنا. يمكنك الاطّلاع على operationCodeDetail لمزيد من التفاصيل.
errorCode

string (int64 format)

النتائج فقط. تمثيل العدد الصحيح لرمز الخطأ كما هو محدّد هنا. يمكنك أيضًا الاطّلاع على OPERATION_SMDX_SUBJECT_REASON_CODE. يمكنك الاطّلاع على errorCodeDetail لمزيد من التفاصيل.
operationCodeDetail

enum (OperationCodeDetail)

النتائج فقط. تفاصيل رمز العملية المقابل operationCode
errorCodeDetail

enum (ErrorCodeDetail)

النتائج فقط. تفاصيل رمز الخطأ المقابل للرمز errorCode.

OperationCodeDetail

تفاصيل رمز العملية المقابل operationCode

عمليات التعداد
OPERATION_CODE_DETAIL_UNSPECIFIED تفاصيل رمز العملية غير محدّدة. لا تتعرّف "واجهة برمجة التطبيقات لإدارة Android" على operationCode. ومع ذلك، يُرجى الاطّلاع على operationCode.
OPERATION_SYSTEM لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_SYSTEM.
OPERATION_SIM_SLOT لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_SIM_SLOT.
OPERATION_EUICC_CARD لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_EUICC_CARD.
OPERATION_SMDX راجِع EuiccManager.OPERATION_SMDX لمعرفة التفاصيل.
OPERATION_SWITCH راجِع EuiccManager.OPERATION_SWITCH لمعرفة التفاصيل.
OPERATION_DOWNLOAD راجِع EuiccManager.OPERATION_DOWNLOAD لمعرفة التفاصيل.
OPERATION_METADATA لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_METADATA.
OPERATION_EUICC_GSMA لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_EUICC_GSMA.
OPERATION_APDU لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_APDU.
OPERATION_SMDX_SUBJECT_REASON_CODE اطّلِع على EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE لمزيد من التفاصيل. يُرجى العِلم أنّه في هذه الحالة، errorCode هي أقل 3 بايتات أهمية في EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE التي تحدّد رمز الموضوع ورمز السبب كما هو موضّح هنا. يتم ضبط البايت الأكثر أهمية في العدد الصحيح على صفر. على سبيل المثال، يتم تمثيل رمز الموضوع 8.11.1 ورمز السبب 5.1 في errorCode على النحو التالي: 0000 0000 1000 1011 0001 0000 0101 0001 في النظام الثنائي، أي 9113681 في النظام العشري.
OPERATION_HTTP لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.OPERATION_HTTP.

ErrorCodeDetail

تفاصيل رمز الخطأ المقابل لـ errorCode

عمليات التعداد
ERROR_CODE_DETAIL_UNSPECIFIED تفاصيل رمز الخطأ غير محدَّدة. لا تتعرّف "واجهة برمجة التطبيقات لإدارة Android" على errorCode. ومع ذلك، يُرجى الاطّلاع على errorCode
ERROR_TIME_OUT لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_TIME_OUT.
ERROR_EUICC_MISSING لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_EUICC_MISSING.
ERROR_UNSUPPORTED_VERSION لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_UNSUPPORTED_VERSION.
ERROR_ADDRESS_MISSING لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_ADDRESS_MISSING.
ERROR_INVALID_CONFIRMATION_CODE لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_INVALID_CONFIRMATION_CODE.
ERROR_CERTIFICATE_ERROR لمزيد من التفاصيل، يمكنك الاطّلاع على EuiccManager.ERROR_CERTIFICATE_ERROR.
ERROR_NO_PROFILES_AVAILABLE لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_NO_PROFILES_AVAILABLE.
ERROR_CONNECTION_ERROR راجِع EuiccManager.ERROR_CONNECTION_ERROR لمعرفة التفاصيل.
ERROR_INVALID_RESPONSE لمزيد من التفاصيل، يمكنك الاطّلاع على EuiccManager.ERROR_INVALID_RESPONSE.
ERROR_CARRIER_LOCKED راجِع EuiccManager.ERROR_CARRIER_LOCKED لمعرفة التفاصيل.
ERROR_DISALLOWED_BY_PPR لمزيد من التفاصيل، يمكنك الاطّلاع على EuiccManager.ERROR_DISALLOWED_BY_PPR.
ERROR_INVALID_ACTIVATION_CODE راجِع EuiccManager.ERROR_INVALID_ACTIVATION_CODE لمعرفة التفاصيل.
ERROR_INCOMPATIBLE_CARRIER لمزيد من التفاصيل، يمكنك الاطّلاع على EuiccManager.ERROR_INCOMPATIBLE_CARRIER.
ERROR_OPERATION_BUSY لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_OPERATION_BUSY.
ERROR_INSTALL_PROFILE لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_INSTALL_PROFILE.
ERROR_EUICC_INSUFFICIENT_MEMORY لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY.
ERROR_INVALID_PORT لمزيد من التفاصيل، يُرجى الاطّلاع على EuiccManager.ERROR_INVALID_PORT.
ERROR_SIM_MISSING لمزيد من التفاصيل، يمكنك الاطّلاع على EuiccManager.ERROR_SIM_MISSING.

EsimInfo

تفاصيل شريحة eSIM التي تمت إضافتها أو إزالتها

تمثيل JSON 
{
  "iccId": string
}
الحقول
iccId

string

النتائج فقط. رقم تعريف شريحة eSIM.

RequestDeviceInfoStatus

حالة الأمر REQUEST_DEVICE_INFO

تمثيل JSON 
{
  "status": enum (Status),

  // Union field device_info can be only one of the following:
  "eidInfo": {
    object (EidInfo)
  }
  // End of list of possible types for union field device_info.
}
الحقول
status

enum (Status)

النتائج فقط. حالة أمر REQUEST_DEVICE_INFO
حقل الدمج device_info تفاصيل حول معلومات الجهاز التي طلبها المشرف لا تتم تعبئة هذا الحقل إلا عندما تكون قيمة status هي SUCCEEDED. يمكن أن تكون device_info إحدى القيم التالية فقط:
eidInfo

object (EidInfo)

معلومات ذات صلة بمعرّفات EID للجهاز

الحالة

حالة أمر REQUEST_DEVICE_INFO

عمليات التعداد
STATUS_UNSPECIFIED غير محدد لا يتم استخدام هذه القيمة.
SUCCEEDED تم إرسال معلومات الجهاز بنجاح.
PENDING_USER_ACTION لم يكمل المستخدم الإجراءات المطلوبة لمشاركة معلومات الجهاز.
USER_DECLINED رفض المستخدم مشاركة معلومات الجهاز.
UNSUPPORTED معلومات الجهاز المطلوبة غير متاحة على هذا الجهاز، مثلاً لا يمكن استخدام شريحة eSIM على الجهاز.

EidInfo

معلومات ذات صلة بمعرّفات EID للجهاز

تمثيل JSON 
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
الحقول
eids[]

object (Eid)

النتائج فقط. معلومات EID لكل شريحة eUICC

عيد الفطر

معلومات EID لكل شريحة eUICC

تمثيل JSON 
{
  "eid": string
}
الحقول
eid

string

النتائج فقط. معرّف شريحة SIM المضمّنة (EID)