Crea un Registration
e quindi Classroom inizia a inviare notifiche dal feed
indicato alla destinazione indicata in cloudPubSubTopic
.
Restituisce il valore Registration
creato. Attualmente, è 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.
Anche se Classroom può convalidare i cloudPubSubTopic
e restituire errori sulla base del migliore tentativo, è responsabilità del chiamante assicurarsi che esista e che Classroom abbia l'autorizzazione a pubblicare contenuti.
Questo metodo potrebbe restituire i seguenti codici di errore:
PERMISSION_DENIED
se:- l'utente autenticato non dispone dell'autorizzazione per ricevere notifiche dal campo richiesto; oppure
- L'utente corrente non ha concesso l'accesso al progetto Cloud attuale con l'ambito appropriato per il feed richiesto. Tieni presente che al momento la delega dell'autorità a livello di dominio non è supportata a questo scopo. Se la richiesta rientra nell'ambito appropriato, ma non esiste alcuna concessione, viene restituito un [errore della richiesta][
@MissingGrant
errore]. - si è verificato un altro errore di accesso.
INVALID_ARGUMENT
se:- nessun
cloudPubsubTopic
specificato o il valorecloudPubsubTopic
specificato non è valido; oppure - nessun
feed
specificato oppure il valorefeed
specificato non è valido.
- nessun
NOT_FOUND
se:- Impossibile individuare l'elemento
feed
specificato o l'utente richiedente non dispone dell'autorizzazione per determinare se esiste o meno; oppure - Impossibile trovare l'elemento
cloudPubsubTopic
specificato oppure Classroom non ha ottenuto l'autorizzazione a pubblicare contenuti nell'elemento.
- Impossibile individuare l'elemento
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 alle autorizzazioni.