إعدادات مشروع Google Cloud

تتضمّن هذه الصفحة المعلومات التي تحتاج إلى معرفتها حول إنشاء مشاريع Google Cloud وضبطها لإضافات Classroom. يتم استخدام مشاريع Google Cloud لتنفيذ "الدخول الموحّد" من Google من خلال OAuth 2.0 (الدخول الموحّد من Google) للموافقة على الطلبات التي تقدّمها الإضافة ولإدارة بيانات الإضافات في متجر Google Workspace Marketplace.

للحصول على مزيد من المعلومات العامة حول نشر إضافة على Marketplace، يمكنك الاطّلاع على نشر تطبيق.

إنشاء مشروع على Google Cloud

هناك نوعان من المشاريع التي يمكن إنشاؤها: مشروع خاص يُستخدَم للتطوير ومشروع عام يمكن للمستخدمين الوصول إليه. يشير التصنيفان "العام" و"الخاص" إلى إذن ظهور تطبيقك في Google Workspace Marketplace، ولا يمكن تثبيت تطبيق Marketplace الخاص إلا من خلال المستخدمين داخل النطاق الذي تم إنشائه فيه، بينما يكون تطبيق Marketplace العام متاحًا لأي نطاق من نطاقات Google Workspace. يجب أن يكون هذان تطبيقان منفصلان، لأن المشروع لا يمكن أن يكون عامًا وخاصًا في الوقت نفسه. يجب مراجعة الطلبات العامة والموافقة عليها قبل إتاحتها في السوق.

للحصول على معلومات عامة حول إنشاء مشروع على Google Cloud، يُرجى الانتقال إلى إنشاء مشروع على Google Cloud.

إنشاء مشروع متاح للجميع على Google Cloud

يمثل هذا المشروع تطبيق الإضافة التي يمكن للمشرفين والمعلمين والطلاب الوصول إليها. يجب مراجعة المشروع العام والموافقة عليه من قِبل فريق Google Workspace Marketplace قبل إطلاقه أو تثبيته.

  1. أنشِئ مشروعًا جديدًا على Google Cloud في نطاق الإنتاج.

    إنشاء مشروع على Google Cloud

  2. فعِّل Classroom API في مشروعك على Google Cloud.

    تفعيل Classroom API

  3. فعِّل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace في مشروعك على Google Cloud.

    تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace

  4. اضبط إعدادات حِزمة تطوير البرامج (SDK) في Marketplace إعدادات التطبيق مستوى ظهور التطبيق على علني، ثم ضَع علامة في المربّع غير مدرَج.

  5. أكمِل الحقول المطلوبة في صفحة بطاقة بيانات المتجر ضمن حزمة SDK Marketplace وانقر على نشر.

  6. سيراجع فريق Google Workspace Marketplace تطبيقك. سيتواصل معك الفريق باستخدام عنوان البريد الإلكتروني الخاص بالمطوِّر المحدّد في حزمة تطوير البرامج (SDK) للسوق. بعد الموافقة على التطبيق، أزِل العلامة من المربّع غير مدرَج كي يتمكّن المعلّمون والمشرفون من العثور عليه في السوق.

إنشاء مشروع خاص على Google Cloud

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

يجب أن يكون لديك إذن بالوصول إلى نطاق Google Workspace for Education باستخدام الترخيص Teaching & Learning أو Plus لإنشاء مشروع خاص. إذا لم يكن لديك إذن بالوصول إلى هذا النطاق، يُرجى اتّباع الخطوات التالية لإعداد نطاق تجريبي على Google Workspace for Education، وترقيته إلى ترخيص Plus، والسماح له بالوصول إلى واجهة برمجة تطبيقات إضافات Classroom:

  1. أكمِل الخطوات من أجل الحصول على نطاق تجريبي للمطوّرين.

  2. بعد تسجيل الدخول بصفتك مشرفًا في النطاق التجريبي، أنشِئ مشروعًا جديدًا على Google Cloud.

    إنشاء مشروع على Google Cloud

    إذا لم تتمكّن من الوصول إلى وحدة تحكّم Google Cloud أو إنشاء مشاريع على السحابة الإلكترونية، عليك التحقّق مما يلي في وحدة تحكّم المشرف:

    • انتقِل إلى إعدادات الحساب > إعدادات الوصول المستندة إلى العمر وحدِّد الخيار تبلغ أعمار كل المستخدمين في هذه المجموعة أو الوحدة التنظيمية 18 عامًا أو أكبر.
    • ضمن التطبيقات > خدمات Google الإضافية:
    • خدمة Google Cloud Platform مفعّلة للجميع.
    • إعدادات إنشاء المشاريع هي السماح للمستخدمين بإنشاء مشاريع.
    • إعدادات الوصول إلى Cloud Shell هي السماح بالوصول إلى Cloud Shell.

  3. أكمِل نموذج طلب ترقية النطاق التجريبي وأرسِله. يؤدي إرسال هذا النموذج إلى طلب ترقية النطاق التجريبي إلى Google Workspace for Education Plus من خلال عشرة تراخيص والسماح لمشروعك على السحابة الإلكترونية بالوصول إلى واجهة برمجة تطبيقات إضافات Classroom.

    ستصلك رسالة إلكترونية عند اكتمال عمليات الترقية والقائمة المسموح بها. يمكنك منح تراخيص Plus لحسابات المعلّمين الاختبارية في وحدة تحكّم المشرف. ضمن الدليل > المستخدمون، أنشئ أو اختَر حسابات المعلّمين الاختبارية. في تراخيص كل معلّم، تأكَّد من أنّه تم منح Google Workspace for Education Plus.

  4. فعِّل Classroom API في مشروعك على Google Cloud.

    تفعيل Classroom API

  5. فعِّل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace في مشروعك على Google Cloud.

    تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace

  6. اضبط إعدادات حزمة تطوير البرامج (SDK) للسوق على إعدادات التطبيق مستوى رؤية التطبيق على خاص.

  7. أكمِل الحقول المطلوبة في صفحة بطاقة بيانات المتجر ضمن حزمة SDK Marketplace وانقر على نشر. وبعد نشر بطاقة بيانات التطبيق، يمكن للمستخدمين في النطاق العثور على التطبيق وتثبيته في Google Workspace Marketplace أو من خلال الانتقال إلى عنوان URL للتطبيق المعروض في صفحة بطاقة بيانات المتجر.

OAuth 2.0

يتطلب الوصول إلى Classroom API الحصول على موافقة للوصول إلى بيانات المستخدمين. يتم الحصول عليها من خلال طلب دخول Google إلى نطاقات OAuth للمستخدم الذي سجّل الدخول، وتلقّي رمز مميّز يمكن استخدامه لإجراء طلبات البيانات من واجهة برمجة التطبيقات إلى Google Classroom. يجب ضبط النطاقات في بطاقة بيانات المتجر على Google Workspace Marketplace حتى يتمكّن مشرف النطاق من تقديم الموافقة نيابةً عن مستخدمي النطاق في حال تثبيت الإضافة.

راجِع صفحة نطاقات OAuth لواجهات Google APIs للحصول على قائمة تفصيلية بجميع النطاقات المتاحة واستخداماتها. راجِع صفحة ضبط بروتوكول OAuth في وثائق Workspace للحصول على معلومات عامة عن إعدادات بروتوكول OAuth.

أذونات المستخدمين

يجب أن يطلب تطبيق الويب نطاقًا واحدًا على الأقل من النطاقات التالية:

  • https://www.googleapis.com/auth/userinfo.email، والذي يسمح للتطبيق بعرض عنوان البريد الإلكتروني للمستخدم.
  • https://www.googleapis.com/auth/userinfo.profile، والذي يسمح للتطبيق بالاطّلاع على المعلومات الشخصية، مثل الاسم الشخصي والاسم الأول واسم العائلة والمعلومات الشخصية الأخرى التي جعلها المستخدم متاحة للجميع

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

login_hint هي معلمات OpenID Connect عادية يمكنك تمريرها إلى Google اختياريًا عند استخدام تسجيل الدخول بحساب Google أو طلب رمز OAuth مميز. الغرض منه هو جعل تجربة التفويض أكثر سلاسة للمستخدم النهائي.

نطاقات إضافات Classroom

النطاقات التالية مخصَّصة لإضافات Classroom:

  • https://www.googleapis.com/auth/classroom.addons.teacher: يتيح هذا الإذن الوصول إلى جميع طرق واجهات برمجة التطبيقات.
  • https://www.googleapis.com/auth/classroom.addons.student: يتيح هذا الإذن الوصول لبدء عمليات التحقّق وقراءة المرفقات.

حتى باستخدام رمز دخول OAuth صالح يشير إلى بيانات اعتماد المستخدم، تخضع طلبات البيانات من واجهة برمجة التطبيقات لمتطلبات إضافية وهي:

  • تتطلّب جميع الطرق أن يكون المستخدم معلِّمًا أو طالبًا في الدورة التدريبية المحددة في السمة courseId في الطلب.
  • تتطلب عملية إنشاء المرفقات وتحديثها وحذفها وتراجع العلامات أن يكون المستخدم مدرسًا.
  • تخضع المكالمات الواردة إلى مشاركة محدّدة على Google Classroom إلى عمليات التحقّق التالية.
    • عندما تحتوي الإضافة على مرفق واحد على الأقل في مشاركة، يمكنها تقديم طلبات بشأن:
      • التحقّق من صحة إطلاق إطار iframe
      • عمليات قراءة المرفقات وتحديثها وحذفها
      • تعديل الدرجات في هذه المشاركة
    • عند فتح إطار iframe لاكتشاف المرفقات لأول مرة، قد لا تحتوي الإضافة على مرفق في المشاركة بعد. يتم توفير مَعلمة طلب بحث addOnToken يمكن استخدامها لتقديم طلبات لما يلي:
      • إنشاء مرفق أسفل المشاركة (حقل addOnToken مطلوب)
      • التحقّق من صحة الإطلاق (يتم التحقّق من صحة addOnToken إذا تم توفيرها، وهو مطلوب عندما لا تحتوي الإضافة على مرفق حالي في المشاركة)

التحقّق من OAuth

تستخدم إحدى إضافات Classroom "واجهات برمجة تطبيقات Google" للوصول إلى بيانات مستخدمي Google.

يمكنك الرجوع إلى الأسئلة الشائعة حول إثبات الملكية من خلال واجهة برمجة تطبيقات OAuth للحصول على مزيد من المعلومات عن عملية إثبات الملكية.

بطاقة بيانات Google Workspace Marketplace

للحصول على معلومات عامة حول ضبط حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، يُرجى الانتقال إلى تفعيل وضبط حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وإنشاء بطاقة بيانات متجر على Google Workspace Marketplace.

الاعتبارات المتعلقة ببطاقة البيانات

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

اتبع الإرشادات التالية في بطاقات بيانات المتجر الخاصة بك:

  • ضمن تفاصيل التطبيق:

    • تجنَّب علامات الترقيم في "اسم التطبيق". على سبيل المثال، استخدِم "إضافتي من شركتي" بدلاً من "شركتي: إضافتي" أو "إضافتي من شركتي".

    • يجب ألا يتضمن كل من الوصف الموجز والوصف التفصيلي النص نفسه بالضبط.

    + تأكَّد من اختيار قيمة لحقل Price (التسعير). يتضمّن هذا الحقل خيارات المجانية والمدفوعة باستخدام فترة تجريبية مجانية والمدفوعة مع ميزات مجانية وأسعار المدفوعة. ولست بحاجة إلى تحديد مبلغ التكلفة في بيانات السوق.

    • تأكَّد من أنّك اخترت قيمة للحقل Category (الفئة). قد تكون الموارد الأكاديمية أو أدوات المعلّمين والمشرفين خيارات جيدة لإضافة Classroom.

    • راجع العناصر المدرجة في وصف تفاصيل التطبيق في Marketplace للحصول على مزيد من المعلومات.

  • ضمن أصول الرسومات:

  • ضمن روابط الدعم:

    • تأكَّد من تقديم رابط إلى بنود الخدمة الخاصة بتطبيقك.

  • تأكَّد من الالتزام بإرشادات العلامة التجارية في Google API التي تشمل الأسماء والأوصاف المسموح بها.

  • إذا كنت تشير إلى أيّ من منتجات Google في بياناتك، استخدِم اسمها بالتنسيق الوارد في قائمة العلامات التجارية. تأكَّد من إدراج رمز العلامة التجارية (TM) إذا تم تحديده، واستخدِم "Google DocsTM" وليس "مستندات Google".

التكامل مع خدمات الترخيص والفوترة من Google

إذا أردت دمج تطبيقات Google Workspace Marketplace مع خدمات الترخيص والفوترة من Google، انتقِل إلى Marketplace API.

إعدادات التثبيت

يمكن أن تسمح الإضافات بالتثبيت الفردي بالإضافة إلى تثبيت المشرف. وتوضح هذه الصفحة بعض الاختلافات بين نوعي التثبيت، حيث إنها ليست مخصصة للترويج لأي من نوعي التثبيت. يمكنك اختيار ما إذا كنت تريد السماح بالتثبيت الفردي في صفحة إعداد التطبيق لحزمة تطوير البرامج (SDK) لـ Google Workspace Marketplace.

التثبيت من خلال المشرف

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

في ما يلي بعض الاعتبارات بشأن تثبيت المشرف.

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

لمزيد من المعلومات حول الوحدات التنظيمية والمجموعات الحاصلة على إذن الوصول، يُرجى الاطّلاع على مقالة تثبيت تطبيقات Marketplace في نطاقك لمزيد من المعلومات عن طريقة تنفيذ عمليات التثبيت التي أجراها المشرفون، وكيفية عمل البنية التنظيمية.

تركيب فردي

تضيف عمليات التثبيت الفردية إضافة إلى حساب المستخدم. ويُطلب من المستخدم الموافقة على نطاقات وصول الإضافة أثناء التثبيت.

في ما يلي بعض الاعتبارات بشأن التركيب الفردي.

  • تسهيل الاستخدام: يمكن لمزيد من المستخدمين الاطّلاع على الإضافة وتثبيتها من Google Workspace Marketplace. قد يؤدي السماح بالتثبيت الفردي إلى مطالبة المزيد من المعلمين بتبني منتجك أو الدفاع عنه.
  • اختبار المشرف: يمكن للمشرف تثبيت إضافة بشكل فردي لاختبارها أو تقييمها قبل الموافقة عليها أو تثبيتها لمجموعة أوسع.

بالإضافة إلى تثبيت الإضافات نيابةً عن المستخدمين، يمكن للمشرفين أيضًا الاحتفاظ بقائمة مسموح بها للسماح للمستخدمين بتثبيت الإضافات التي تسمح بالتثبيت الفردي. إذا لم تكن إحدى الإضافات مُدرَجة في القائمة المسموح بها، سيظل بإمكان المستخدمين الاطّلاع على بيانات الإضافة في Google Workspace Marketplace ولكن لا يمكنهم تثبيت الإضافة. وبدلاً من ذلك، ستظهر لهم رسالة توضّح أنّ مشرف النطاق لم يسمح بتثبيت الإضافة. يُرجى الاطّلاع على مقالة إدارة تطبيقات Google Workspace Marketplace في القائمة المسموح بها لمزيد من المعلومات عن هذا السلوك.

راجِع مستندات إعدادات تثبيت Google Workspace Marketplace للحصول على مزيد من المعلومات.

تكامل التطبيقات

يجب توفير عنوان URL لإطار iframe للتشغيل في الحقل معرّف الموارد المنتظم (URI) لإعداد المرفق. يتم استخدام عنوان URL هذا كقيمة src لإطار iframe في إطار iframe لاكتشاف المرفقات. يتم استخدام إطار iframe لاكتشاف المرفقات من قبل المعلمين للعثور على محتوى أو أنشطة لإرفاقها بالمهمة.

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

راجِع صفحة دليل إطارات iframe للحصول على مزيد من التفاصيل بخصوص هذه الحقول.

اختبار الحسابات

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

الحسابات الاختبارية المقترَحة:

  • تميمة المُعلّمة، tammy.مِن@<نطاقك التجريبي>
  • سام طالب، sam.student@<نطاقك التجريبي>
  • سالي طالب، sally.student@<نطاقك التجريبي>

اتّبِع هذا الإجراء لإنشاء حساب تجريبي جديد:

  1. سجِّل الدخول إلى وحدة تحكُّم المشرف.
  2. انتقِل إلى المستخدمون.
  3. انقر على إضافة مستخدم جديد (انظر الشكل 1).
  4. إدخال معلومات المستخدم وتعيين الأدوار المناسبة

انقر على &quot;إضافة مستخدم جديد&quot;. الشكل 1. موقع رابط إضافة مستخدم جديد في وحدة تحكم المشرف.

اتّبِع هذا الإجراء لإنشاء مجموعة اختبار جديدة:

  1. سجِّل الدخول إلى وحدة تحكُّم المشرف.
  2. انتقِل إلى المجموعات.
  3. انقر على إنشاء مجموعة (انظر الشكل 2).
  4. أدخِل أعضاء المجموعة ومالكيها.

انقر على &quot;إنشاء مجموعة&quot;. الشكل 2. موقع رابط إنشاء مجموعة في وحدة تحكم المشرف.