Method: registrations.create

Erstellt eine Registration, wodurch Classroom Benachrichtigungen von der angegebenen feed an das in cloudPubSubTopic angegebene Ziel sendet.

Gibt die erstellte Registration zurück. Derzeit entspricht sie dem Argument, enthält aber ausgefüllte serverseitig zugewiesene Felder wie expiryTime und id.

Alle für die Felder expiryTime oder id angegebenen Werte werden ignoriert.

Classroom kann die cloudPubSubTopic zwar validieren und Fehler auf Best-Effort-Basis zurückgeben, aber es liegt in der Verantwortung des Aufrufers, dafür zu sorgen, dass sie vorhanden ist und Classroom die Berechtigung hat, dort zu veröffentlichen.

Diese Methode kann die folgenden Fehlercodes zurückgeben:

• PERMISSION_DENIED wenn:
  • der authentifizierte Nutzer keine Berechtigung hat, Benachrichtigungen aus dem angeforderten Feld zu erhalten, oder
  • Der aktuelle Nutzer hat keinen Zugriff auf das aktuelle Cloud-Projekt mit dem entsprechenden Umfang für den angeforderten Feed gewährt. Die domainweite Delegierung von Berechtigungen wird zu diesem Zweck derzeit nicht unterstützt. Wenn die Anfrage den entsprechenden Umfang hat, aber keine Berechtigung vorhanden ist, wird ein [Request Errors][@MissingGrant error] zurückgegeben.
  • ein weiterer Zugriffsfehler auftritt.
• INVALID_ARGUMENT wenn:
  • kein cloudPubsubTopic angegeben ist oder das angegebene cloudPubsubTopic ungültig ist; oder
  • kein feed angegeben ist oder das angegebene feed ungültig ist.
• NOT_FOUND wenn:
  • die angegebene feed nicht gefunden werden kann oder der anfragende Nutzer keine Berechtigung hat, zu prüfen, ob sie vorhanden ist, oder
  • die angegebene cloudPubsubTopic nicht gefunden werden kann oder Classroom nicht die Berechtigung zur Veröffentlichung dort gewährt wurde.