للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
يشير وجود مورد عمليات التثبيت إلى أنّ التطبيق مثبَّت على جهاز معيّن (أو أنّ التثبيت في انتظار المراجعة).
يمكن استخدام واجهة برمجة التطبيقات لإنشاء مورد تثبيت باستخدام طريقة update. يؤدي هذا إلى بدء التثبيت الفعلي للتطبيق على الجهاز. إذا لم يكن لدى المستخدم إذن الوصول إلى التطبيق من قبل، ستتم محاولة إنشاء إذن وصول له. إذا تعذّر ذلك (على سبيل المثال، بسبب أنّ التطبيق غير مجاني ولا يتوفّر ترخيص)، سيتعذر إنشاء عملية التثبيت.
يمكن أيضًا استخدام واجهة برمجة التطبيقات لتحديث تطبيق مثبَّت. وفي حال استخدام الطريقة update على عملية تثبيت حالية، سيتم تحديث التطبيق إلى أحدث إصدار متاح.
تجدر الإشارة إلى أنّه لا يمكن فرض تثبيت إصدار معيّن من تطبيق لأنّ رمز الإصدار متاح للقراءة فقط.
في حال ثبَّت المستخدم تطبيقًا بنفسه (وفقًا لما تسمح به المؤسسة)، سيتم تلقائيًا إنشاء مورد تثبيت وربما مورد استحقاق.
يمكن أيضًا استخدام واجهة برمجة التطبيقات لحذف مورد التثبيت، ما يؤدي إلى إزالة التطبيق من الجهاز. يُرجى العِلم أنّ حذف عملية تثبيت لا يؤدي تلقائيًا إلى إزالة الأذونات المقابلة، حتى إذا لم تتبقّ أيّ عمليات تثبيت. كما سيتم حذف مورد التثبيت في حال إلغاء المستخدم تثبيت التطبيق بنفسه.
{
"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
- لاسترداد تفاصيل جميع التطبيقات المثبّتة على الجهاز المحدد.
- تعديل
- طلبات تثبيت أحدث إصدار من التطبيق على الجهاز. إذا كان التطبيق مثبت بالفعل، فسيتم تحديثه إلى أحدث إصدار إذا اللازمة.