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

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