یک Registration ایجاد می کند و باعث می شود Classroom شروع به ارسال اعلان ها از feed ارائه شده به مقصد ارائه شده در cloudPubSubTopic کند.
Registration ایجاد شده را برمی گرداند. در حال حاضر، این همان آرگومان خواهد بود، اما با پر کردن فیلدهای اختصاص داده شده توسط سرور مانند expiryTime و id .
توجه داشته باشید که هر مقدار مشخص شده برای فیلدهای expiryTime یا id نادیده گرفته می شود.
در حالی که Classroom ممکن است cloudPubSubTopic را تأیید کند و خطاها را بر اساس بهترین تلاش بازگرداند، مسئولیت تماس گیرنده است که از وجود آن اطمینان حاصل کند و Classroom مجوز انتشار در آن را دارد.
این روش ممکن است کدهای خطای زیر را برگرداند:
-
PERMISSION_DENIEDاگر:- کاربر احراز هویت شده اجازه دریافت اعلان ها از قسمت درخواستی را ندارد. یا
- کاربر فعلی اجازه دسترسی به پروژه Cloud فعلی را با محدوده مناسب برای فید درخواستی نداده است. توجه داشته باشید که در حال حاضر تفویض اختیار در سطح دامنه برای این منظور پشتیبانی نمی‌شود. اگر درخواست دارای محدوده مناسب باشد، اما هیچ کمکی وجود نداشته باشد، یک [خطاهای درخواست] [خطای
@MissingGrant] برگردانده می شود. - یک خطای دسترسی دیگر مواجه می شود.
-
INVALID_ARGUMENTاگر:- هیچ
cloudPubsubTopicمشخص نشده است یاcloudPubsubTopicمشخص شده معتبر نیست. یا - هیچ
feedمشخص نشده است، یاfeedمشخص شده معتبر نیست.
- هیچ
-
NOT_FOUNDاگر:-
feedمشخص شده قابل یافتن نیست، یا کاربر درخواست کننده اجازه تعیین وجود یا عدم وجود آن را ندارد. یا -
cloudPubsubTopicمشخص شده قابل یافتن نیست، یا به Classroom اجازه انتشار در آن داده نشده است.
-
درخواست HTTP
POST https://classroom.googleapis.com/v1/registrations
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست شامل نمونه ای از Registration است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از Registration است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.push-notifications
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.