ينشئ هذا الإعداد 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 الإذن بالنشر فيه.
- يتعذّر تحديد موقع
طلب HTTP
POST https://classroom.googleapis.com/v1/registrations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على مثال Registration.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Registration تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.push-notifications
لمزيد من المعلومات، راجِع دليل التفويض.