Method: registrations.create

Crea un Registration, in modo che Classroom inizi a inviare notifiche dal feed fornito alla destinazione indicata in cloudPubSubTopic.

Restituisce l'Registration creato. Al momento, sarà uguale all'argomento, ma con i campi assegnati dal server, come expiryTime e id, compilati.

Tieni presente che qualsiasi valore specificato per i campi expiryTime o id verrà ignorato.

Sebbene Classroom possa convalidare il cloudPubSubTopic e restituire errori secondo il criterio del "best effort", è responsabilità dell'utente chiamante assicurarsi che esista e che Classroom abbia l'autorizzazione a pubblicare in questo canale.

Questo metodo può restituire i seguenti codici di errore:

• PERMISSION_DENIED se:
  • l'utente autenticato non ha l'autorizzazione per ricevere notifiche dal campo richiesto.
  • L'utente corrente non ha concesso l'accesso al progetto Cloud corrente con l'ambito appropriato per il feed richiesto. Tieni presente che la delega dell'autorità a livello di dominio non è attualmente supportata per questo scopo. Se la richiesta ha l'ambito appropriato, ma non esiste alcuna concessione, viene restituito un [errore della richiesta][@MissingGrant errore].
  • si verifica un altro errore di accesso.
• INVALID_ARGUMENT se:
  • non è specificato alcun cloudPubsubTopic o il cloudPubsubTopic specificato non è valido; oppure
  • non è specificato alcun feed o il feed specificato non è valido.
• NOT_FOUND se:
  • non è possibile individuare feed specificato o l'utente che effettua la richiesta non dispone dell'autorizzazione per determinare se esiste o meno; oppure
  • cloudPubsubTopic specificato non può essere trovato o a Classroom non è stata concessa l'autorizzazione per la pubblicazione.