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

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

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