Method: registrations.create
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un Registration, ce qui permet à Classroom de commencer à envoyer des notifications à partir du feed fourni vers la destination indiquée dans cloudPubSubTopic.
Renvoie le Registration créé. Actuellement, il s'agit de la même valeur que l'argument, mais avec des champs attribués par le serveur tels que expiryTime et id renseignés.
Notez que toute valeur spécifiée pour les champs expiryTime ou id sera ignorée.
Bien que Classroom puisse valider le cloudPubSubTopic et renvoyer des erreurs dans la mesure du possible, il est de la responsabilité de l'appelant de s'assurer qu'il existe et que Classroom est autorisé à y publier.
Cette méthode peut renvoyer les codes d'erreur suivants:
PERMISSION_DENIED si :
- l'utilisateur authentifié n'est pas autorisé à recevoir des notifications du champ demandé ; ou
- l'utilisateur actuel n'a pas accordé l'accès au projet Cloud actuel avec le champ d'application approprié pour le flux demandé. Notez que la délégation d'autorité au niveau du domaine n'est pas actuellement prise en charge à cette fin. Si la requête a le champ d'application approprié, mais qu'aucune autorisation n'existe, une [erreur de requête][erreur
@MissingGrant] est renvoyée.
- une autre erreur d'accès se produit.
INVALID_ARGUMENT si :
- Aucune
cloudPubsubTopic n'est spécifiée ou la cloudPubsubTopic spécifiée n'est pas valide.
- Aucune
feed n'est spécifiée ou la feed spécifiée n'est pas valide.
NOT_FOUND si :
- l'
feed spécifié ne peut pas être localisé, ou l'utilisateur à l'origine de la requête n'est pas autorisé à déterminer s'il existe ou non ; ou
- L'
cloudPubsubTopic spécifiée ne peut pas être trouvée, ou Classroom n'a pas été autorisé à y publier.
Requête HTTP
POST https://classroom.googleapis.com/v1/registrations
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient une instance de Registration.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Registration.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/classroom.push-notifications
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
