REST Resource: apps

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

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

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

تمثيل JSON 
{
  "primaryMimeTypes": [
    string
  ],
  "secondaryMimeTypes": [
    string
  ],
  "primaryFileExtensions": [
    string
  ],
  "secondaryFileExtensions": [
    string
  ],
  "icons": [
    {
      object (Icons)
    }
  ],
  "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)

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

string

اسم التطبيق
objectType

string

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

boolean

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

string

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

string

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

boolean

توضّح هذه السمة ما إذا كان هذا التطبيق يتيح الاستيراد من "مستندات Google".
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 الخاص بالمستخدم.

الرموز

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

integer

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

string

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

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

string

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

الطُرق

get

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

list

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