Method: registrations.create

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

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

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

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

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

  • PERMISSION_DENIED إذا:
    • لا يملك المستخدم الذي تمّت المصادقة عليه إذنًا لتلقّي إشعارات من الحقل المطلوب.
    • لم يمنح المستخدم الحالي إذن الوصول إلى مشروع Cloud الحالي باستخدام النطاق المناسب للخلاصة المطلوبة. يُرجى العِلم أنّ تفويض السلطة على مستوى النطاق غير متاح حاليًا لهذا الغرض. إذا كان الطلب يتضمّن النطاق المناسب، ولكن لم يكن هناك إذن، يتم عرض [Request Errors][@MissingGrant error] (أخطاء الطلب).
    • حدث خطأ آخر في الوصول.
  • 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.