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 للنموذج لإنشاء ملف جديد باستخدام هذا التطبيق في مجلد معيّن. سيحتوي القالب على {columnId} ليحل محله المجلد لإنشاء الملف الجديد فيه.
supportsOfflineCreate

boolean

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

boolean

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

الطُرق

get

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

list

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