Method: registrations.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[],[],null,["# Method: registrations.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates a `Registration`, causing Classroom to start sending notifications from the provided `feed` to the destination provided in `cloudPubSubTopic`.\n\nReturns the created `Registration`. Currently, this will be the same as the argument, but with server-assigned fields such as `expiryTime` and `id` filled in.\n\nNote that any value specified for the `expiryTime` or `id` fields will be ignored.\n\nWhile Classroom may validate the `cloudPubSubTopic` and return errors on a best effort basis, it is the caller's responsibility to ensure that it exists and that Classroom has permission to publish to it.\n\nThis method may return the following error codes:\n\n- `PERMISSION_DENIED` if:\n - the authenticated user does not have permission to receive notifications from the requested field; or\n - the current user has not granted access to the current Cloud project with the appropriate scope for the requested feed. Note that domain-wide delegation of authority is not currently supported for this purpose. If the request has the appropriate scope, but no grant exists, a \\[Request Errors\\]\\[`@MissingGrant` error\\] is returned.\n - another [access error](/workspace/classroom/reference/Access.Errors) is encountered.\n- `INVALID_ARGUMENT` if:\n - no `cloudPubsubTopic` is specified, or the specified `cloudPubsubTopic` is not valid; or\n - no `feed` is specified, or the specified `feed` is not valid.\n- `NOT_FOUND` if:\n - the specified `feed` cannot be located, or the requesting user does not have permission to determine whether or not it exists; or\n - the specified `cloudPubsubTopic` cannot be located, or Classroom has not been granted permission to publish to it.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/registrations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Registration](/workspace/classroom/reference/rest/v1/registrations#Registration).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.push-notifications`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
