إنشاء واجهات 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 النطاق

  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"
          },
          ...
        ]
      },
      ...
    }