Method: registrations.create

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 valore cloudPubsubTopic specificato non è valido; oppure
    • nessun feed specificato oppure il valore feed specificato non è valido.
  • 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.

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.