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.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Registration.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Registration appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.