Creates a Registration
, causing Classroom to start sending
notifications from the provided feed
to the destination provided in
cloudPubSubTopic
.
Returns the created Registration
. Currently, this will be the
same as the argument, but with server-assigned fields such as
expiry_time
and id
filled in.
Note that any value specified for the expiry_time
or
id
fields will be ignored.
While 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.
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 cloudPubsubTopic
is specified, or the specified
cloudPubsubTopic
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 cloudPubsubTopic
cannot be located, or
Classroom has not been granted permission to publish to it.
(registrations.create)
Parameters
- $postBody
- $optParams
- Optional parameters.
Returns