REST Resource: apps

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

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

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

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

string

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

string

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

string

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

string

قائمة بامتدادات الملفات الثانوية.
icons[]

object

تمثّل هذه السمة الرموز المختلفة للتطبيق.
icons[].size

integer

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

string

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

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

string

عنوان URL الخاص بالرمز
name

string

اسم التطبيق
objectType

string

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

boolean

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

string

رابط يؤدي إلى بطاقة بيانات المتجر الخاصة بهذا التطبيق
id

string

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

boolean

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

boolean

تُستخدَم لتحديد ما إذا كان التطبيق مثبَّتًا.
authorized

boolean

ما إذا كان التطبيق مصرحًا له بالوصول إلى البيانات على حساب المستخدم في Drive
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

تُستخدَم لتحديد ما إذا كان التطبيق لديه نطاق على مستوى Drive. يمكن لتطبيق لديه نطاق على مستوى Drive الوصول إلى جميع الملفات في حساب المستخدم على Drive.

الطُرق

get

 تعرض هذه الطريقة تطبيقًا معيّنًا.

list

 تعرض هذه الطريقة قائمة بالتطبيقات المثبَّتة لدى المستخدم.