يتم إنشاء 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
لمزيد من المعلومات، اطّلِع على دليل التفويض.