إنشاء واجهات Google Drive

يمكن أن تقدّم "إضافات Google Workspace" واجهات مخصّصة عند استخدام المستخدم لتطبيق Google Drive. يتيح لك ذلك تزويد المستخدم بمعلومات إضافية ذات صلة وتنفيذ المهام تلقائيًا وربط أنظمة تابعة لجهات خارجية بخدمة Google Drive.

الوصول إلى واجهة مستخدم الإضافة

يمكنك فتح إضافة Google Workspace في Google Drive إذا ظهر رمزها في عمود الرموز على يسار واجهة مستخدم Drive. يمكن أن تحدِّد إضافة Google Workspace واجهة الصفحة الرئيسية أو واجهة اختيار العناصر أو كليهما:

• إذا نقر المستخدم على أيقونة الإضافة أثناء وجوده في Google Drive، يتم تنفيذ الإضافة drive.homepageTrigger المقابل (إذا كانت موجودة). هذه الدالة تنشئ بطاقة صفحة رئيسية وتعرضها إلى Google Drive للعرض. إذا كانت الإجابة "لا" drive.homepageTrigger يتم عرض بطاقة صفحة رئيسية عامة بدلاً من ذلك.
• إذا اختار المستخدم عنصرًا واحدًا أو أكثر في Google Drive ثم نقر على الإضافة أو تحدد العناصر أثناء فتح الوظيفة الإضافية، تنفذ الإضافة drive.onItemsSelectedTrigger السياقية (إن وجدت). تنشئ هذه الوظيفة حساب Google Drive للإضافة "العناصر المحدّدة" السياقية واحدة وإعادته إلى Google Drive للعرض.

إنشاء واجهة إضافة ميزات Drive

يمكنك إنشاء واجهات توسّع Google Drive من خلال اتّباع الإرشادات العامة التالية: الخطوات:

1. حدِّد ما إذا كنت تريد أن تتضمّن الإضافة صفحة رئيسية خاصة بخدمة Drive. حدِّد أيضًا ما إذا كنت تريد توفير واجهة سياقية عندما يختار المستخدم عناصر Drive.
2. أضف القيمة المناسبة addOns.common و addOns.drive حقل إلى مشروع النص البرمجي للإضافة البيان، بما في ذلك أي نطاقات Drive مطلوبة.
3. إذا كنت تقدّم صفحة رئيسية خاصة بخدمة Drive، نفِّذ الدالة drive.homepageTrigger لإنشاء هذه الواجهة. ويمكنك أيضًا اختيار استخدام common.homepageTrigger لمضيفي Google Workspace متعددين.
4. إذا كنت تقدّم واجهة اختيار عناصر سياقية في Drive، يجب تنفيذ دالة بدء سياقية drive.onItemsSelectedTrigger لإنشاء هذه الواجهة. اطّلِع على واجهة Drive السياقية للعناصر المحدّدة) لمعرفة التفاصيل.
5. نفِّذ دوالّ ردّ الاتصال المرتبطة اللازمة للردّ على تفاعلات مستخدم واجهة المستخدِم، مثل النقرات على الأزرار.

الصفحات الرئيسية في Drive

يتيح Google Drive عرض إضافة Google Workspace. الصفحات الرئيسية. لعرض الصفحة الرئيسية المشتركة للإضافات في Google Drive، ما عليك سوى التأكّد من توفّر حقل addOns.drive في بيان الإضافة.

وبدلاً من ذلك، يمكنك إضافة drive.homepageTrigger إلى بيان الإضافة لتوفير صفحة رئيسية خاصة بـ Drive.

في كلتا الحالتَين، يجب تقديم اسم دالة تنشيط الصفحة الرئيسية في مشروع نص برمجي للإضافات. يتم استدعاء هذه الدالة تلقائيًا لإنشاء صفحة Drive الرئيسية عند الحاجة. يجب عليك تنفيذ هذه الدالة لإنشاء إرجاع واحد Card أو صفيف من Card والكائنات التي تشكل الصفحة الرئيسية. يتمّ تمرير عنصر حدث إلى الدالة المشغّلة للصفحة الرئيسية كمَعلمة تحتوي على بعض المعلومات العامة، مثل منصّة العميل. يمكنك استخدام بيانات عناصر الحدث لتخصيص إنشاء الصفحة الرئيسية.

واجهة سياقية في Drive للعناصر المحدّدة

يعتمد Google Drive على مشغّل سياقي لتحديد الواجهة (إن وجدت) ليتم عرضها عندما يختار المستخدم عنصرًا أو أكثر من عناصر Google Drive. عند بدء مفعول المشغِّل، يتم تنفيذ دالة المشغِّل السياقي المحدَّدة من خلال الحقل drive.onItemsSelectedTrigger.runFunction في بيان الإضافة.

لإنشاء واجهة اختيار عناصر سياقية في Drive، يجب إجراء التالي:

1. تأكَّد من أنّ ملف بيان الإضافة يتضمّن https://www.googleapis.com/auth/drive.addons.metadata.readonly scope.

2. تأكَّد من أنّ ملف البيان يتضمّن قسمًا بعنوان drive.onItemsSelectedTrigger .

3. نفِّذ الدالة المُسمّاة في حقل drive.onItemsSelectedTrigger . تقبل هذه الدالة كائن حدث كوسيطة ويجب أن تعرِض إما كائنًا واحدًا Card أو صفيفًا من كائنات Card.

4. كما هو الحال مع أي بطاقة، عليك تنفيذ أي دوالّ ردّ اتصال مستخدَمة لتوفير تفاعل تطبيقات المصغّرة مع الواجهة. على سبيل المثال، إذا قمت بتضمين زر في الواجهة، ينبغي أن يحتوي على ملف مرفق الإجراء ودالة استدعاء منفّذة تعمل عند النقر على الزر.

عناصر الحدث

إنشاء كائن حدث وتمريره إلى drive.homepageTrigger أو drive.onItemsSelectedTrigger تشغيل الدالة عند استدعاء هذه الدوال. يمكن لدالة المشغل استخدام المعلومات في كائن الحدث هذا لتحديد كيفية إنشاء بطاقات إضافية أو التحكّم في سلوك الإضافة

يتم وصف البنية الكاملة لكائنات الأحداث في كائنات الأحداث. إذا كان Drive هو تطبيق المضيف الحالي للإضافة، كائنات الأحداث السياقية تضمين كائن حدث Drive الذي يتضمن معلومات العميل الخاصة بـ Drive.

تتضمن كائنات أحداث Drive السياقية لمشغّلات اختيار العناصر معلومات. حول العناصر التي اختارها المستخدم عند تنشيط العامل المشغِّل. عندما يختار مستخدم أكثر من عنصر واحد في Drive، يُعتبر أحد العناصر من ملفاته هو ملف الأكثر أهمية، ويُشار إليه باسم عنصر المؤشر النشط.

يوضح المثال التالي كائن حدث Drive يتم تمريره إلى drive.onItemsSelectedTrigger الدالة:

    {
      "commonEventObject": { ... },
      "drive": {
        "activeCursorItem":{
          "addonHasFileScopePermission": true,
          "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
          "iconUrl": "https://drive-thirdparty.googleusercontent.com...",
          "mimeType":"application/pdf",
          "title":"How to get started with Drive"
        },
        "selectedItems": [
          {
            "addonHasFileScopePermission": true,
            "id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
            "iconUrl":"https://drive-thirdparty.googleusercontent.com...",
            "mimeType":"application/pdf",
            "title":"How to get started with Drive"
          },
          ...
        ]
      },
      ...
    }