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 الإذن بنشره.

طلب HTTP

POST https://classroom.googleapis.com/v1/registrations

يستخدم عنوان URL بنية gRPC Transcode.

نص الطلب

يحتوي نص الطلب على مثال Registration.

نص الاستجابة

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.push-notifications

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