Method: enterprises.devices.issueCommand

دستوری را برای دستگاه صادر می کند. منبع Operation بازگردانده شده حاوی یک Command در قسمت metadata خود است. برای بدست آوردن وضعیت دستور از روش عملیات get استفاده کنید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

نام دستگاه به شکل enterprises/{enterpriseId}/devices/{deviceId} .

درخواست بدن

بدنه درخواست شامل یک نمونه از Command است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

فرمان

یک دستور

نمایندگی 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 نرمال می شود و از 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 ، به صورت اختیاری رمز عبور جدید را مشخص می کند. نکته: رمز عبور جدید در صورت عددی بودن در دستگاه‌های اندروید 14 باید حداقل 6 کاراکتر باشد. در غیر این صورت دستور با 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

انواع دستورات

Enums
COMMAND_TYPE_UNSPECIFIED این مقدار مجاز نیست.
LOCK دستگاه را قفل کنید، گویی مهلت زمانی قفل صفحه به پایان رسیده است.
RESET_PASSWORD رمز عبور کاربر را بازنشانی کنید.
REBOOT دستگاه را راه اندازی مجدد کنید. فقط در دستگاه های کاملاً مدیریت شده دارای Android 7.0 (سطح API 24) یا بالاتر پشتیبانی می شود.
RELINQUISH_OWNERSHIP نمایه کاری و همه خط‌مشی‌ها را از دستگاه Android 8.0 و بالاتر متعلق به شرکت حذف می‌کند و دستگاه را برای استفاده شخصی واگذار می‌کند. برنامه ها و داده های مرتبط با نمایه(های) شخصی حفظ می شوند. دستگاه پس از تأیید فرمان از سرور حذف می شود.
CLEAR_APP_DATA داده های برنامه برنامه های مشخص شده را پاک می کند. این در اندروید 9 و بالاتر پشتیبانی می شود. توجه داشته باشید که یک برنامه می تواند داده ها را خارج از داده های برنامه خود ذخیره کند، به عنوان مثال در حافظه خارجی یا در فرهنگ لغت کاربر. همچنین clearAppsDataParams ببینید.
START_LOST_MODE دستگاه را در حالت گم شده قرار می دهد. فقط در دستگاه های کاملاً مدیریت شده یا دستگاه های متعلق به سازمان با نمایه مدیریت شده پشتیبانی می شود. startLostModeParams نیز ببینید.
STOP_LOST_MODE دستگاه را از حالت گم شده خارج می کند. فقط در دستگاه های کاملاً مدیریت شده یا دستگاه های متعلق به سازمان با نمایه مدیریت شده پشتیبانی می شود. stopLostModeParams نیز ببینید.
ADD_ESIM یک نمایه eSIM به دستگاه اضافه می کند. این در اندروید 15 و بالاتر پشتیبانی می شود. همچنین به addEsimParams مراجعه کنید. برای حذف نمایه eSIM، از دستور REMOVE_ESIM استفاده کنید. برای تعیین اینکه هنگام پاک شدن دستگاه چه اتفاقی برای نمایه eSIM می‌افتد، wipeDataFlags در خط‌مشی تنظیم کنید. توجه: برای ارائه چندین eSIM در یک دستگاه، توصیه می شود بین اجرای متوالی دستور چند دقیقه تاخیر ایجاد کنید.
REMOVE_ESIM نمایه eSIM را از دستگاه حذف می کند. این در اندروید 15 و بالاتر پشتیبانی می شود. همچنین removeEsimParams ببینید.
REQUEST_DEVICE_INFO اطلاعات مربوط به دستگاه را درخواست کنید.
WIPE دستگاه را از طریق بازنشانی کارخانه‌ای برای دستگاه متعلق به شرکت یا با حذف نمایه کاری دستگاه شخصی با نمایه کاری پاک می‌کند. پاک کردن فقط زمانی رخ می دهد که دستگاه فرمان را تأیید کند. فرمان را می توان قبل از آن لغو کرد.

CommandErrorCode

کد خطای دستوری این یک فیلد فقط خواندنی است که توسط سرور پر شده است.

Enums
COMMAND_ERROR_CODE_UNSPECIFIED هیچ خطایی وجود نداشت.
UNKNOWN یک خطای ناشناخته رخ داد.
API_LEVEL سطح API دستگاه از این دستور پشتیبانی نمی کند.
MANAGEMENT_MODE حالت مدیریت (مالک نمایه، صاحب دستگاه و غیره) از این فرمان پشتیبانی نمی کند.
INVALID_VALUE دستور دارای مقدار پارامتر نامعتبر است.
UNSUPPORTED دستگاه از دستور پشتیبانی نمی کند. به‌روزرسانی خط‌مشی دستگاه Android به آخرین نسخه ممکن است مشکل را حل کند.

ResetPasswordFlag

پرچم هایی که می توانند برای نوع دستور RESET_PASSWORD استفاده شوند.

Enums
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 پس از دانلود.

وضعیت فعال سازی

وضعیت فعال‌سازی نمایه eSIM پس از دانلود.

Enums
ACTIVATION_STATE_UNSPECIFIED وضعیت فعال سازی eSIM مشخص نشده است. پیش‌فرض این است که نمایه eSIM در دستگاه‌های متعلق به شخصی NOT_ACTIVATED و در دستگاه‌های متعلق به شرکت ACTIVATED شود.
ACTIVATED eSIM به طور خودکار پس از دانلود فعال می شود. تنظیم این حالت به‌عنوان حالت فعال‌سازی برای دستگاه‌های شخصی منجر به رد شدن فرمان می‌شود.
NOT_ACTIVATED نمایه eSIM دانلود شده است اما فعال نشده است. در این صورت کاربر باید eSIM را به صورت دستی روی دستگاه فعال کند.

EsimParams را حذف کنید

پارامترهای مرتبط با فرمان REMOVE_ESIM برای حذف نمایه eSIM از دستگاه.

نمایندگی JSON 
{
  "iccId": string
}
فیلدها
iccId

string

مورد نیاز. شناسه ICC نمایه eSIM که باید حذف شود.

RequestDeviceInfoParams

پارامترهای مرتبط با فرمان REQUEST_DEVICE_INFO برای دریافت اطلاعات مربوط به دستگاه.

نمایندگی JSON 
{
  "deviceInfo": enum (DeviceInfo)
}
فیلدها
deviceInfo

enum ( DeviceInfo )

مورد نیاز. نوع اطلاعات دستگاه مورد درخواست

اطلاعات دستگاه

نوع اطلاعات دستگاه مورد درخواست

Enums
DEVICE_INFO_UNSPECIFIED این مقدار مجاز نیست.
EID شناسه eSIM را درخواست کنید. قبل از بازگرداندن نتیجه، از کاربر خواسته می شود تا افشای اطلاعات را تأیید کند. اگر کاربر افشاگری را تأیید نکند، USER_DECLINED برگردانده خواهد شد. این فقط برای دستگاه‌های شخصی با نمایه‌های کاری و نسخه‌های Android 13 و بالاتر پشتیبانی می‌شود.

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 )

نتیجه تلاش برای پاک کردن داده های یک برنامه واحد.

Clearing Result

نتیجه تلاش برای پاک کردن داده های یک برنامه واحد.

Enums
CLEARING_RESULT_UNSPECIFIED نتیجه نامشخص
SUCCESS داده های این برنامه با موفقیت پاک شد.
APP_NOT_FOUND داده‌های این برنامه پاک نشد زیرا برنامه پیدا نشد.
APP_PROTECTED داده‌های این برنامه پاک نشد زیرا برنامه محافظت شده است. برای مثال، این ممکن است برای برنامه‌هایی که برای عملکرد دستگاه حیاتی هستند، مانند فروشگاه Google Play اعمال شود.
API_LEVEL داده‌های این برنامه پاک نشد زیرا سطح API دستگاه از این دستور پشتیبانی نمی‌کند.

StartLostModeStatus

وضعیت فرمان START_LOST_MODE برای قرار دادن دستگاه در حالت گمشده.

نمایندگی JSON 
{
  "status": enum (Status)
}
فیلدها
status

enum ( Status )

وضعیت. StartLostModeStatus ببینید.

وضعیت

وضعیت. StartLostModeStatus ببینید.

Enums
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 را ببینید.

Enums
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 اضافه یا حذف شده است. این فقط زمانی پر می شود که status عملکرد eSIM SUCCESS باشد.

status_details فیلد اتحادیه جزئیات وضعیت یک فرمان ADD_ESIM یا REMOVE_ESIM . status_details فقط می تواند یکی از موارد زیر باشد:
internalErrorDetails

object ( InternalErrorDetails )

فقط خروجی جزئیات خطا اگر status روی INTERNAL_ERROR تنظیم شده باشد.

وضعیت

وضعیت یک دستور ADD_ESIM یا REMOVE_ESIM .

Enums
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 مربوط به iccId در دستگاه وجود ندارد.
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT فرمان ADD_ESIM هنگام تلاش برای افزودن یک eSIM جدید با وضعیت فعال‌سازی آن روی ACTIVATED ناموفق بود، زیرا چندین اسلات eSIM روی دستگاه حاوی نمایه‌های eSIM فعال هستند و هیچ اسلات eSIM رایگان در دسترس نیست. برای حل این مشکل، می‌توان eSIM جدید را با وضعیت فعال‌سازی آن به‌عنوان NOT_ACTIVATED برای فعال‌سازی دستی بعدی اضافه کرد، یا کاربر باید ابتدا یک eSIM فعال موجود را غیرفعال کند تا عملیات ادامه یابد.

جزئیات خطای داخلی

جزئیات خطای داخلی در صورت وجود برای دستور 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 .

Enums
OPERATION_CODE_DETAIL_UNSPECIFIED جزئیات کد عملیاتی مشخص نشده است. operationCode توسط Android Management API شناسایی نمی شود. با این حال، 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 .

Enums
ERROR_CODE_DETAIL_UNSPECIFIED جزئیات کد خطا مشخص نشده است. errorCode توسط Android Management API شناسایی نمی شود. با این حال، 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

فقط خروجی شناسه ICC سیم کارت.

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 .

Enums
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

فقط خروجی EID