Creates a Registration, causing Classroom to start sending notificationsfrom the provided feed to the destination provided in cloudPubSubTopic.Returns the created Registration. Currently, this will be the same asthe argument, but with server-assigned fields such as expiry_time andid filled in. Note that any value specified for the expiry_time or id fields will beignored. While Classroom may validate the cloudPubSubTopic and return errors on abest effort basis, it is the caller's responsibility to ensure that itexists and that Classroom has permission to publish to it.

gc_registrations_create(Registration)

Arguments

Registration

The gc_registration object to pass to this method

Details

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.

Authentication scopes used by this function are:

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

Set options(googleAuthR.scopes.selected = c("https://www.googleapis.com/auth/classroom.push-notifications") Then run googleAuthR::gar_auth() to authenticate. See gar_auth for details.

See also

Google Documentation

Other Registration functions: gc_registration()