Method: registrations.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יוצרת Registration, וכתוצאה מכך מערכת Classroom מתחילה לשלוח התראות מה-feed שצוין ליעד שצוין ב-cloudPubSubTopic.
הפונקציה מחזירה את ה-Registration שנוצר. בשלב זה, הערך הזה יהיה זהה לארגומנט, אבל עם שדות שהוקצו על ידי השרת, כמו expiryTime ו-id, שמולאו.
הערה: המערכת תתעלם מכל ערך שצוין בשדות expiryTime או id.
מערכת Classroom עשויה לאמת את cloudPubSubTopic ולהחזיר שגיאות על בסיס 'לפי יכולתה', אבל באחריות מבצע הקריאה לוודא שהיא קיימת ושמערכת Classroom מורשית לפרסם בה.
שיטת ה-method הזו עשויה להחזיר את קודי השגיאה הבאים:
PERMISSION_DENIED אם:
- למשתמש המאומת אין הרשאה לקבל התראות מהשדה המבוקש.
- המשתמש הנוכחי לא העניק גישה לפרויקט הנוכחי ב-Cloud עם ההיקף המתאים לפיד המבוקש. לתשומת ליבכם: בשלב הזה אין תמיכה בהענקת גישה ברמת הדומיין למטרה הזו. אם הבקשה כוללת את ההיקף המתאים אבל אין הרשאה, תוחזר [שגיאת בקשה][שגיאה
@MissingGrant].
- נתקלתם בשגיאת גישה אחרת.
INVALID_ARGUMENT אם:
- לא צוין
cloudPubsubTopic או שהערך של cloudPubsubTopic שצוין לא חוקי.
- לא צוין
feed או שה-feed שצוין לא חוקי.
NOT_FOUND אם:
- לא ניתן לאתר את
feed שצוין, או שלמשתמש המבקש אין הרשאה לקבוע אם הוא קיים או לא.
- לא ניתן לאתר את
cloudPubsubTopic שצוין, או שלא הוקצה ל-Classroom הרשאה לפרסם בו.
בקשת HTTP
POST https://classroom.googleapis.com/v1/registrations
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
גוף הבקשה
גוף הבקשה מכיל מופע של Registration.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Registration.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/classroom.push-notifications
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],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)."]]
