تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على مستندات الإضافات للحصول على مزيد من المعلومات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ترقية مرفقات الرابط إلى مرفقات إضافة Classroom

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

نظرة عامة

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

بمجرد موافقة المعلّم على ترقية الرابط إلى مرفق إضافة، يضبط الرابط تم بدء ترقية إطار iframe باستخدام معلَمات طلب البحث التالية:

courseId
itemId
itemType
addOnToken
urlToUpgrade
login_hint (فقط إذا سبق أن فوَّض المستخدم تطبيقك)

تعكس معلمات الاستعلام الأربع الأولى معلمات الاستعلام التي تم إطلاقها في إطار iframe لاكتشاف المرفقات. معلَمة طلب البحث urlToUpgrade جديدة ويمكنها في تقييم كيفية إنشاء مرفق الإضافة. بعد ذلك، يمكنك استخدام مَعلمات طلب البحث الأخرى للتحقّق من تسجيل دخول المستخدم واستدعاء طريقة CreateAddOnAttachment بقيمة courseWork أو courseWorkMaterials أو announcements استنادًا إلى القيمة itemType. داخل iframe، يمكنك عرض شاشة تحميل لإعلام المدرس بأنّ الإضافة المرفقة يتم إنشاؤها.

بعد إنشاء مرفق الإضافة، يتم إغلاق إطار iframe يمكن للمعلم عرض المرفق في التكليف الدراسي كما يفعل عادةً.

تفاصيل التنفيذ الفني

يلقي هذا القسم الضوء على بعض التفاصيل الفنية المهمة للميزة.

قراءة مَعلمة طلب البحث "`urlToUpgrade`"

إنّ معلَمة طلب البحث "urlToUpgrade" هي معرّف موارد منتظم (URI) تم ترميزه عند تمريرها إلى الرابط. ترقية إطار iframe يجب فك ترميز عنوان URL للحصول عليه بشكله الأصلي. في حال حذف كنت تستخدم JavaScript، على سبيل المثال، يمكنك استخدام السمة decodeURIComponent() لإجراء ذلك.

إغلاق إطار iframe الخاص بترقية الرابط

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

تفاصيل الإعدادات

يجب ضبط الإعدادات التالية لدمج هذه الميزة في الوظيفة الإضافية:

عنوان URL لإطار iframe الخاص بترقية الروابط: هذا هو عنوان URL الذي يفتح في إطار iframe عندما يوافق المعلّم على الترقية
أنماط عناوين URL التي يجب أن يرصدها Classroom ويحاول ترقية: يمكن أن تتألف أنماط عناوين URL من مضيف ومسارات متعددة والبادئات.
- يمكنك توفير أنماط عناوين URL متعددة.
- إذا لم تقدّم أي بادئات مسار، أيّ عنوان URL يتطابق مع المضيف يمكن ترقيته.
- لا يمكن ترقية سوى عناوين URL التي تستخدم المخطط https.
- يجب ألا تحتوي أنماط عناوين URL على localhost.
- يجب ألا تحتوي بادئات المسار على معلَمات طلب بحث أو أجزاء من عنوان URL.
- ويمكن أن تتيح بادئات المسار استخدام أحرف البدل في الوقت الحالي، ولكن لا يمكن للمضيفين:
  - example.com هو مضيف صالح، و/foo و/bar/*/baz هما بادئتا مسار صالحتان.
  - example.*.host.com ليس مضيف صالح.
- يتطابق حرف البدل بين مكونات بادئة المسار مع حقل واحد فقط ولا تتطابق مع مكونات متعددة مفصولة بشرطة مائلة. ننصحك باستخدام نمط عنوان URL يتضمّن المضيف example.com وبادئة المسار /bar/*/baz:
  - تمثل https://example.com/bar/123/baz مطابقة صالحة لعنوان URL النمط.
  - تمثل https://example.com/bar/123/baz/456/789 مطابقة صالحة نمط عنوان URL.
  - لا تمثل https://example.com/bar/123/456/baz مطابقة صالحة نمط عنوان URL بسبب عدم تطابق حرف البدل في بادئة المسار /123/456/

عملية التطوير

يمكنك إرسال عنوان URL لإطار iframe لترقية الرابط وأنماط عناوين URL للاختبار أو الإنتاج. الإضافية من خلال إرسال رسالة إلكترونية إلى classroom-link-upgrade-external@google.com.

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

سيصلك ردّ على رسالتك الإلكترونية بعد إكمال الإعدادات. مفعّلة. يُرجى العلم أنّ أنماط عناوين URL التي تستخدِم localhost غير متاحة لهذا الغرض. الجديدة.

يجب تنسيق رسالة البريد الإلكتروني لتتضمّن ما يلي:

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

استبدِل ما يلي:

GCP_PROJECT_NUMBER: رقم مشروع Google Cloud التي ترتبط بها الإضافة.
LINK_UPGRADE_IFRAME_URL: عنوان URL الذي يجب فتحه في إطار iframe لترقية الرابط
HOST_1: مضيف يجب أن يرصده Classroom. فقط المخطط https متاح.
PATH_PREFIX_1 وPATH_PREFIX_2: المسار البادئات المرتبطة بالنطاق HOST_1 والتي يجب على Classroom رصدها ومحاولة للترقية.
HOST_2: مضيف يجب أن يرصده Classroom. فقط المخطط https متاح.
PATH_PREFIX_3 وPATH_PREFIX_4: المسار البادئات المرتبطة بالنطاق HOST_2 والتي يجب على Classroom رصدها ومحاولة للترقية.

تجربة المستخدم التي ننصح بها

في ما يلي بعض الاقتراحات التي يجب أخذها في الاعتبار عند استخدام هذه الميزة.

تجنُّب العمل الإضافي على المعلّمين

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

تضمين رسائل خطأ بشأن الوصول السهل

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