Method: registrations.create

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.