افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
Method: registrations.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک 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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
