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

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

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

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

هناك نوعان من المشروعات التي يجب إنشاؤها: مشروع خاص يُستخدم وتطويره ومشروع عام يمكن للمستخدمين الوصول إليه. "الجمهور" أو "خاص" تشير التصنيفات إلى مستوى رؤية طلبك في Google Workspace 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) للسوق إعدادات التطبيق ضبط مستوى رؤية التطبيق على علني ووضع علامة في المربّع غير مُدرَج.

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

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

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

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

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

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

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

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

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

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

  3. أكمِل نموذج طلب ترقية النطاق التجريبي وأرسِله. إرسال هذا النموذج من Google تطلب من Google ترقية نطاقك التجريبي إلى 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. أكمِل الحقول المطلوبة في Marketplace SDK. بطاقة بيانات المتجر وانقر على نشر: بعد نشر بطاقة بيانات التطبيق، يبدأ المستخدمون في النطاق. العثور على التطبيق وتثبيته في Google Workspace Marketplace أو عن طريق الانتقال إلى عنوان URL للتطبيق المعروض في صفحة بطاقة بيانات المتجر.

OAuth 2.0

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

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

راجِع صفحة نطاقات 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 APIs للوصول إلى حسابات مستخدمي Google البيانات.

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

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

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

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

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

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

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

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

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

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

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

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

التكامل مع خدمات الترخيص والفوترة من 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. موقع رابط إنشاء مجموعة داخل وحدة تحكم المشرف.