صفحات رئيسية

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الصفحات الرئيسية هي ميزة جديدة في إضافات Google Workspace توفّر إمكانية تحديد بطاقة أو أكثر من البطاقات غير السياقية. يتم استخدام البطاقات غير السياقية لعرض واجهة مستخدم عندما يكون المستخدم خارج سياق محدد، على سبيل المثال عندما يشاهد المستخدم البريد الوارد في Gmail ولكنه لم يفتح رسالة أو مسودة.

تتيح لك الصفحات الرئيسية عرض محتوى غير سياقي، تمامًا مثل تطبيقات Google في اللوحة الجانبية للوصول السريع (Keep و"تقويم Google"و"مهام Google"). يمكن أن توفّر الصفحات الرئيسية أيضًا نقطة بداية مبدئية يمكن للمستخدم فيها فتح الإضافة لأول مرة، وتفيد في تعليم المستخدمين الجدد كيفية التفاعل مع الإضافة.

يمكنك تحديد صفحة رئيسية للإضافة من خلال تحديدها في بيان المشروع وتنفيذ دالة homepageTrigger أو أكثر (يُرجى الاطّلاع على ضبط الصفحة الرئيسية).

يمكن أن تكون لديك صفحات رئيسية متعددة، صفحة واحدة لكل تطبيق مضيف تعمل على توسيع الإضافة. يمكنك أيضًا تحديد صفحة رئيسية تلقائية شائعة شائعة يتم استخدامها في مضيفات لم تحدّد فيها صفحة رئيسية مخصّصة.

يتم عرض الصفحة الرئيسية للإضافة عند استيفاء أحد الشروط التالية:

  • عند فتح الإضافة لأول مرة في المضيف (بعد التفويض).
  • عندما ينتقل المستخدم من سياق سياقي إلى سياق غير سياقي، عندما تكون الإضافة مفتوحة. على سبيل المثال، من تعديل حدث في التقويم إلى التقويم الرئيسي.
  • عندما ينقر المستخدم على زر الرجوع مرات كافية لإبراز كل بطاقة أخرى عن الحزم الداخلية.
  • عندما يؤدي تفاعل واجهة المستخدم في بطاقة غير سياقية إلى إجراء مكالمة Navigation.popToRoot().

إنّ تصميم صفحة رئيسية ليس إلزاميًا ولكن يُنصح به بشدة، وفي حال عدم تحديد أي منها، يتم استخدام بطاقة عامة تتضمّن اسم الإضافة عند انتقال المستخدم إلى الصفحة الرئيسية.

ضبط الصفحة الرئيسية

تستخدم إضافات Google Workspace الحقل addOns.common.homepageTrigger لضبط محتوى الإضافة التلقائي للصفحة الرئيسية (بدون سياق) لجميع تطبيقات المضيف في ملف البيان:

    {
      // ...
      "addOns": {
        // ...
        "common": {
          // ...
          "homepageTrigger": {
            "runFunction": "myFunction",
            "enabled": true
          }
        }
      }
    }
  • runFunction: اسم دالة"برمجة تطبيقات Google"التي يستدعيها إطار عمل Google Workspace لعرض بطاقات إضافات الصفحة الرئيسية. هذه الدالة هي دالة تشغيل الصفحة الرئيسية. ويجب أن تقدّم هذه الدالة مجموعة من كائنات Card التي تشكّل واجهة مستخدم الصفحة الرئيسية وتعرضها. في حال عرض أكثر من بطاقة واحدة، يعرض تطبيق المضيف عناوين البطاقة في قائمة يمكن للمستخدم الاختيار منها (راجِع عرض بطاقات متعددة).

  • enabled: يجب تفعيل بطاقات الصفحة الرئيسية لهذا النطاق. هذا الحقل اختياري، ويتم ضبطه تلقائيًا على true. يؤدي ضبط السياسة على false إلى إيقاف بطاقات الصفحة الرئيسية لجميع المضيفين (ما لم يتم إلغاء هذا المضيف، يرجى الاطّلاع على المعلومات أدناه).

بالإضافة إلى الإعدادات الشائعة، تتوفّر أيضًا إجراءات تنظيم لكل مضيف بشكل منظَّم في كل إعداد لتطبيق المضيف، على addOns.gmail.homepageTrigger وaddOns.calendar.homepageTrigger وما إلى ذلك:

    {
      ...
      "addOns": {
        ...
        "common": {
          // By default, call 'buildHomePage' to render homepage content
          // in all hosts. Since calendar.homepageTrigger below overrides
          // this in Calendar and Drive and the homepageTrigger is disabled
          // for Gmail, this homepage function never executes.
          "homepageTrigger": { "runFunction": "buildHomePage" }
        },
        "calendar": {
          // Show customized homepage content for Calendar only.
          "homepageTrigger": { "runFunction": "buildCalendarHomepage" }
        },
        "drive": {
          // Show customized homepage content for Drive only.
          "homepageTrigger": { "runFunction": "buildDriveHomepage" }
        }
        "gmail": {
          // Disable homepage add-on content in Gmail.
          "homepageTrigger": { "enabled": false }
        },
        ...
      }
    }

يُرجى العِلم أنّ هذا المسار يعادل مقتطف البيان التالي:

    {
      ...
      "addOns": {
        ...
        "common": { /* ... */ }, // Omitted a default homepageTrigger specification.
        "calendar": {
          // Show customized homepage content for Calendar only.
          "homepageTrigger": { "runFunction": "myCalendarFunction" }
        },
        "drive": {
          // Show customized homepage content for Drive only.
          "homepageTrigger": { "runFunction": "myDriveFunction" }
        }
        "gmail": { /* ... */ },
        ...
      }
    }

ولا يلزم استخدام أي من أقسام homepageTrigger. ومع ذلك، تعتمد واجهة المستخدم المعروضة للإضافة في أي منتج مضيف معيّن على توفّر حقل البيان المقابل، وما إذا كان هناك ملف homepageTrigger مرتبط أم لا. يوضّح المثال التالي دوال مشغِّل الإضافات التي يتم تنفيذها (إن وجدت) لإنشاء واجهة مستخدم للصفحة الرئيسية لضبطات البيان المختلفة:

مسار الصفحة الرئيسية

كائنات أحداث الصفحة الرئيسية

عند الاتصال، تعمل وظيفة تشغيل الصفحة الرئيسية (runFunction) الموضحة أعلاه على تمرير كائن حدث يحتوي على بيانات من سياق الاستدعاء.

لا تتضمّن كائنات أحداث الصفحة الرئيسية معلومات الأداة أو السياق، لأنّ المعلومات التي يتم تمريرها تقتصر على حقول كائن الحدث الشائع التالية:

يمكنك الاطّلاع على كائن الحدث لمزيد من التفاصيل.

بطاقات أخرى غير سياقية

يمكن أن تتضمن واجهة مستخدم الإضافة بطاقات إضافية غير سياقية وليست صفحات رئيسية. على سبيل المثال، قد تتضمن صفحتك الرئيسية زرًا يفتح بطاقة ""الإعدادات&quot؛ حيث يمكن للمستخدم ضبط إعدادات الإضافة (وتكون هذه الإعدادات في معظم الحالات مستقلة عن السياق ومن ثمّ غير سياقية).

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