REST Resource: apps

المرجع: التطبيق

يقدّم مورد التطبيقات قائمة بالتطبيقات التي ثبَّتها المستخدم، مع معلومات عن أنواع MIME وأنواع الملفات والإضافات المتوافقة مع كل تطبيق، وغيرها من التفاصيل.

تتطلّب بعض طرق الموارد (مثل apps.get) استخدام appId. استخدِم الطريقة apps.list لاسترداد معرّف تطبيق مثبَّت.

تمثيل JSON 
{
  "name": string,
  "objectType": string,
  "supportsCreate": boolean,
  "productUrl": string,
  "primaryMimeTypes": [
    string
  ],
  "secondaryMimeTypes": [
    string
  ],
  "primaryFileExtensions": [
    string
  ],
  "secondaryFileExtensions": [
    string
  ],
  "id": string,
  "supportsImport": boolean,
  "installed": boolean,
  "authorized": boolean,
  "icons": [
    {
      "size": integer,
      "category": string,
      "iconUrl": string
    }
  ],
  "useByDefault": boolean,
  "kind": string,
  "shortDescription": string,
  "longDescription": string,
  "supportsMultiOpen": boolean,
  "productId": string,
  "openUrlTemplate": string,
  "createUrl": string,
  "createInFolderTemplate": string,
  "supportsOfflineCreate": boolean,
  "hasDriveWideScope": boolean
}
الحقول
name

string

اسم التطبيق
objectType

string

نوع العنصر الذي ينشئه هذا التطبيق (مثل الرسم البياني) إذا كانت فارغة، يجب استخدام اسم التطبيق بدلاً منها.
supportsCreate

boolean

ما إذا كان هذا التطبيق يتيح إنشاء عناصر جديدة
productUrl

string

رابط يؤدي إلى بطاقة بيانات المنتج لهذا التطبيق
primaryMimeTypes[]

string

قائمة أنواع MIME الأساسية
secondaryMimeTypes[]

string

قائمة أنواع MIME الثانوية
primaryFileExtensions[]

string

قائمة بامتدادات الملفات الأساسية
secondaryFileExtensions[]

string

قائمة بامتدادات الملفات الثانوية
id

string

رقم تعريف التطبيق
supportsImport

boolean

ما إذا كان هذا التطبيق يتيح الاستيراد من "أدوات تحرير المستندات"
installed

boolean

ما إذا كان التطبيق مثبَّتًا
authorized

boolean

ما إذا كان التطبيق مفوَّضًا بالوصول إلى البيانات على Drive الخاص بالمستخدم
icons[]

object

الرموز المختلفة للتطبيق
icons[].size

integer

حجم الرمز يتم تمثيله على أنّه الحد الأقصى للعرض والارتفاع.
icons[].category

string

فئة الرمز القيم المسموح بها هي:

  • application - رمز التطبيق
  • document - رمز ملف مرتبط بالتطبيق
  • documentShared: رمز ملف مشترَك مرتبط بالتطبيق
icons[].iconUrl

string

عنوان URL للرمز
useByDefault

boolean

ما إذا كان التطبيق قد تم اختياره كمعالج تلقائي للأنواع التي يتوافق معها
kind

string

يكون هذا الخيار دائمًا drive#app.
shortDescription

string

وصف موجز للتطبيق
longDescription

string

وصف مفصّل للتطبيق
supportsMultiOpen

boolean

ما إذا كان هذا التطبيق يتيح فتح أكثر من ملف واحد
productId

string

معرّف بطاقة بيانات المنتج لهذا التطبيق
openUrlTemplate

string

عنوان URL للنموذج لفتح الملفات باستخدام هذا التطبيق. سيحتوي النموذج على {ids} و/أو {exportIds} ليتم استبدالهما بمعرّفات الملفات الفعلية. راجِع فتح الملفات للاطّلاع على المستندات الكاملة.
createUrl

string

عنوان URL لإنشاء ملف جديد باستخدام هذا التطبيق
createInFolderTemplate

string

عنوان URL للنموذج لإنشاء ملف جديد باستخدام هذا التطبيق في مجلد معيّن. سيحتوي النموذج على {folderId} ليتم استبداله بالمجلد الذي سيتم إنشاء الملف الجديد فيه.
supportsOfflineCreate

boolean

ما إذا كان هذا التطبيق يتيح إنشاء ملفات جديدة بلا إنترنت
hasDriveWideScope

boolean

ما إذا كان التطبيق يملك نطاقًا على مستوى مساحة التخزين يمكن للتطبيق الذي يملك نطاقًا على مستوى مساحة التخزين السحابي الوصول إلى جميع الملفات في مساحة التخزين السحابي للمستخدم.

الطُرق

get

 الحصول على تطبيق معيّن

list

 يعرض التطبيقات المثبّتة للمستخدم.