Method: registrations.create

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

Gibt das erstellte Registration zurück. Derzeit entspricht dies dem Argument, allerdings sind die vom Server zugewiesenen Felder wie expiryTime und id ausgefüllt.

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

Classroom kann die cloudPubSubTopic validieren und Fehler nach bestem Wissen zurückgeben. Es liegt jedoch in der Verantwortung des Aufrufers, sicherzustellen, dass die Datei existiert und dass Classroom die Berechtigung zur Veröffentlichung hat.

Bei dieser Methode können die folgenden Fehlercodes zurückgegeben werden:

• PERMISSION_DENIED, wenn:
  • Der authentifizierte Nutzer ist nicht berechtigt, Benachrichtigungen aus dem angeforderten Feld zu erhalten.
  • Der aktuelle Nutzer hat keinen Zugriff auf das aktuelle Cloud-Projekt mit dem entsprechenden Bereich für den angeforderten Feed gewährt. Die domainweite Delegierung von Befugnissen wird für diesen Zweck derzeit nicht unterstützt. Wenn die Anfrage den entsprechenden Geltungsbereich hat, aber keine Berechtigung vorhanden ist, wird ein [Anfragefehler][@MissingGrant] zurückgegeben.
  • ein anderer Zugriffsfehler aufgetreten ist.
• INVALID_ARGUMENT, wenn:
  • Es ist kein cloudPubsubTopic angegeben oder die angegebene cloudPubsubTopic ist ungültig.
  • Es ist kein feed angegeben oder der angegebene feed ist ungültig.
• NOT_FOUND, wenn:
  • das angegebene feed kann nicht gefunden werden oder der anfragende Nutzer ist nicht berechtigt zu bestimmen, ob er existiert oder nicht.
  • Das angegebene cloudPubsubTopic kann nicht gefunden werden oder Classroom wurde nicht berechtigt, Inhalte darin zu veröffentlichen.