Method: registrations.create

Tworzy Registration, przez co Classroom zaczyna wysyłać powiadomienia z podanego feed do miejsca docelowego w cloudPubSubTopic.

Zwraca utworzony element Registration. Obecnie wartość ta będzie taka sama jak argument, ale z wypełnionymi polami przypisanymi przez serwer, takimi jak expiryTime i id.

Pamiętaj, że wartości podane w polach expiryTime i id będą ignorowane.

Classroom może sprawdzać poprawność cloudPubSubTopic i zwracać błędy na podstawie najlepszych starań, ale osoba dzwoniąca musi upewnić się, że plik istnieje, a usługa Classroom ma uprawnienia do jego publikowania.

Ta metoda może zwracać takie kody błędów:

• PERMISSION_DENIED, jeśli:
  • uwierzytelniony użytkownik nie ma uprawnień do otrzymywania powiadomień z żądanego pola lub
  • bieżący użytkownik nie przyznał dostępu do bieżącego projektu Cloud w odpowiednim zakresie dla żądanego pliku danych. Pamiętaj, że w tym celu nie jest obecnie obsługiwane przekazywanie uprawnień w całej domenie. Jeśli żądanie ma właściwy zakres, ale nie ma uwierzytelnienia, zwracany jest błąd [Request Errors][@MissingGrant error].
  • wystąpi kolejny błąd dostępu.
• INVALID_ARGUMENT, jeśli:
  • nie określono cloudPubsubTopic lub cloudPubsubTopic jest nieprawidłowy albo
  • nie określono feed lub feed jest nieprawidłowy.
• NOT_FOUND, jeśli:
  • określonego elementu feed nie można znaleźć lub użytkownik wysyłający prośbę nie ma uprawnień do określenia, czy taki element istnieje; lub
  • Nie można znaleźć określonego elementu cloudPubsubTopic lub Classroom nie ma uprawnień do jego publikowania.