Installs

للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.

تمثيلات الموارد

يشير وجود مورد عمليات التثبيت إلى أنّ التطبيق مثبَّت على جهاز معيّن (أو أنّ التثبيت في انتظار المراجعة).

يمكن استخدام واجهة برمجة التطبيقات لإنشاء مورد تثبيت باستخدام الطريقة update. يؤدي هذا إلى بدء التثبيت الفعلي للتطبيق على الجهاز. إذا لم يكن لدى المستخدم إذن الوصول إلى التطبيق من قبل، ستتم محاولة إنشاء إذن وصول له. إذا تعذّر ذلك (على سبيل المثال، بسبب أنّ التطبيق غير مجاني ولا يتوفّر ترخيص)، سيتعذر إنشاء عملية التثبيت.

يمكن أيضًا استخدام واجهة برمجة التطبيقات لتحديث تطبيق مثبَّت. في حال استخدام طريقة update في عملية تثبيت حالية، سيتم تحديث التطبيق إلى أحدث إصدار متاح.

تجدر الإشارة إلى أنّه لا يمكن فرض تثبيت إصدار معيّن من تطبيق لأنّ رمز الإصدار متاح للقراءة فقط.

في حال ثبَّت المستخدم تطبيقًا بنفسه (وفقًا لما تسمح به المؤسسة)، سيتم تلقائيًا إنشاء مورد تثبيت وربما مورد استحقاق.

يمكن أيضًا استخدام واجهة برمجة التطبيقات لحذف مورد التثبيت، ما يؤدي إلى إزالة التطبيق من الجهاز. يُرجى العِلم أنّ حذف عملية تثبيت لا يؤدي تلقائيًا إلى إزالة الأذونات المقابلة، حتى إذا لم تتبقّ أيّ عمليات تثبيت. كما سيتم حذف مورد التثبيت في حال إلغاء المستخدم تثبيت التطبيق بنفسه.

{
  "kind": "androidenterprise#install",
  "productId": string,
  "versionCode": integer,
  "installState": string
}
اسم الموقع القيمة الوصف Notes
installState string حالة التثبيت. تعني الحالة "installPending" أنّه تم مؤخرًا تقديم طلب تثبيت وتنزيله على الجهاز. تعني الحالة "installed" أنّه تم تثبيت التطبيق. هذا الحقل للقراءة فقط.

في ما يلي القيم المقبولة:
  • "installPending"
  • "installed"
kind string
productId string معرّف المنتج المراد التركيب له. مثلاً: "app:com.google.android.gm"
versionCode integer إصدار المنتج المثبَّت. لا نضمن ضبط السياسة إلا إذا كانت حالة التثبيت هي "installed".

الطُرق

حذف
طلبات إزالة تطبيق من أحد الأجهزة سيستمر الاتصال بـ get أو list في عرض التطبيق على أنه مثبّت على الجهاز إلى أن تتم إزالته فعليًا.
الحصول على
استرداد تفاصيل تثبيت تطبيق على الجهاز
list
استرداد تفاصيل جميع التطبيقات المثبّتة على الجهاز المحدّد
تعديل
يطلب المستخدم تثبيت أحدث إصدار من التطبيق على جهاز. إذا كان التطبيق مثبتًا من قبل، فسيتم تحديثه إلى أحدث إصدار إذا لزم الأمر.