REST Resource: apps

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

يوفّر المرجع 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": [
    {
      object (Icons)
    }
  ],
  "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

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

boolean

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

boolean

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

object (Icons)

الرموز المختلفة للتطبيق
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 الخاص بالمستخدم.

الرموز

تمثيل JSON 
{
  "size": integer,
  "category": string,
  "iconUrl": string
}
الحقول
size

integer

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

string

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

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

string

عنوان URL للرمز

الطُرق

get

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

list

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