Method: registrations.create

ينشئ هذا الإعداد Registration، ما يؤدي إلى بدء Classroom بإرسال إشعارات من feed المتوفرة إلى الوجهة المقدَّمة في cloudPubSubTopic.

تعرض Registration التي تم إنشاؤها. في الوقت الحالي، سيكون هذا الإعداد مطابقًا للوسيطة، ولكن مع ملء الحقول التي خصصها الخادم، مثل expiryTime وid.

يُرجى العلم أنّه سيتم تجاهل أي قيمة محدّدة للحقلَين expiryTime أو id.

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

قد تعرض هذه الطريقة رموز الخطأ التالية:

• PERMISSION_DENIED في حال:
  • ليس لدى المستخدم الذي تمت المصادقة عليه إذن بتلقي إشعارات من الحقل المطلوب، أو
  • عدم منح المستخدم الحالي إذن الوصول إلى المشروع الحالي على السحابة الإلكترونية باستخدام النطاق المناسب للخلاصة المطلوبة يُرجى العلم أنّ تفويض المرجع على مستوى النطاق غير متوافق حاليًا لهذا الغرض. إذا كان الطلب يتضمّن النطاق المناسب ولكن لا يتوفّر منحة، سيتم عرض [طلب أخطاء][خطأ @MissingGrant].
  • حدوث خطأ وصول آخر.
• INVALID_ARGUMENT في حال:
  • لم يتم تحديد cloudPubsubTopic، أو أن cloudPubsubTopic المحددة غير صالحة.
  • لم يتم تحديد feed، أو قيمة feed المحددة غير صالحة.
• NOT_FOUND في حال:
  • يتعذّر تحديد موقع feed المحدد، أو أنّ المستخدم الذي قدّم الطلب ليس لديه إذن لتحديد ما إذا كان موجودًا أم لا.
  • لا يمكن تحديد موقع cloudPubsubTopic المحدد، أو لم يتم منح Classroom الإذن بالنشر فيه.