Method: registrations.create

Creates a Registration, causing Classroom to start sending notifications from the provided feed to the provided destination.

Returns the created Registration. Currently, this will be the same as the argument, but with server-assigned fields such as expiryTime and id filled in.

Note that any value specified for the expiryTime or id fields will be ignored.

While Classroom may validate the destination 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.

This method may return the following error codes:

  • PERMISSION_DENIED if:
    • the authenticated user does not have permission to receive notifications from the requested field; or
    • the credential provided does not include the appropriate scope for the requested feed.
    • another access error is encountered.
  • INVALID_ARGUMENT if:
    • no destination is specified, or the specified destination is not valid; or
    • no feed is specified, or the specified feed is not valid.
  • NOT_FOUND if:
    • the specified feed cannot be located, or the requesting user does not have permission to determine whether or not it exists; or
    • the specified destination cannot be located, or Classroom has not been granted permission to publish to it.

HTTP request

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

The URL uses Google API HTTP annotation syntax.

Request body

The request body contains an instance of Registration.

Response body

If successful, the response body contains a newly created instance of Registration.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the Auth Guide.

Try it!

发送以下问题的反馈:

此网页
Classroom API
Classroom API
需要帮助?请访问我们的支持页面