للحصول على قائمة بالطرق لهذا المورد، اطلع على نهاية هذه الصفحة.
تمثيلات الموارد
يشير وجود مورد لعمليات التثبيت إلى أنه تم تثبيت التطبيق على جهاز معين (أو أنه في انتظار التثبيت).
يمكن استخدام واجهة برمجة التطبيقات لإنشاء مورد تثبيت باستخدام طريقة التحديث. سيؤدي هذا إلى تشغيل التثبيت الفعلي للتطبيق على الجهاز. إذا لم يكن لدى المستخدم استحقاق للتطبيق، يتم إجراء محاولة لإنشاء واحد. وإذا أخفق هذا (على سبيل المثال، نظرًا لأن التطبيق ليس مجانيًا وليس هناك ترخيص متاح)، فسيفشل إنشاء التثبيت.
يمكن أيضًا استخدام واجهة برمجة التطبيقات لتحديث تطبيق مثبّت. إذا تم استخدام طريقة التحديث على عملية تثبيت حالية، سيتم تحديث التطبيق إلى أحدث إصدار متاح.
يُرجى ملاحظة أنه لا يمكن فرض تثبيت إصدار مُحدَّد من التطبيق لأن رمز الإصدار للقراءة فقط.
في حال ثبَّت مستخدم تطبيقًا بنفسه (كما هو مسموح به من قِبل المؤسسة)، سيتم تلقائيًا إنشاء مورد تثبيت وربما مورد استحقاق.
ويمكن أيضًا استخدام واجهة برمجة التطبيقات لحذف مورد تثبيت، ما يؤدي إلى إزالة التطبيق من الجهاز. وتجدر الإشارة إلى أن حذف عملية تثبيت لا يؤدي تلقائيًا إلى إزالة الاستحقاق المقابل لها، حتى إذا لم تكن هناك عمليات تثبيت متبقية. كما سيتم حذف مورد التثبيت إذا ألغى المستخدم تثبيت التطبيق بنفسه.
{ "kind": "androidenterprise#install", "productId": string, "versionCode": integer, "installState": string }
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
installState |
string |
حالة التثبيت. تعني الحالة "installPending" أنه تم مؤخرًا إجراء طلب تثبيت وجارٍ التنزيل على الجهاز. تعني الحالة "installed" أنه تم تثبيت التطبيق. هذا الحقل للقراءة فقط.
القيم المقبولة هي:
|
|
kind |
string |
||
productId |
string |
رقم تعريف المنتج الذي تم تثبيت التطبيق له. مثلاً: "app:com.google.android.gm" |
|
versionCode |
integer |
إصدار المنتج المثبّت. ويضمن تعيين هذه السياسة فقط إذا كانت حالة التثبيت هي "installed" . |
الطُرق
- حذف
- طلب إزالة تطبيق من جهاز. ستستمر مكالمة
get
أوlist
في عرض التطبيق باعتباره مثبتًا على الجهاز حتى تتم إزالته. - الحصول
- يسترد تفاصيل تثبيت تطبيق على جهاز
- list
- يسترد تفاصيل جميع التطبيقات المثبتة على الجهاز المحدد
- تحديث
- يطلب هذا المستخدم تثبيت أحدث إصدار من التطبيق على أحد الأجهزة. إذا كان التطبيق مثبتًا من قبل، يتم تحديثه إلى أحدث إصدار إذا لزم الأمر.