Method: registrations.create

Tworzy Registration, co powoduje, że Classroom zacznie wysyłać powiadomienia z podanego feed do miejsca docelowego podanego w cloudPubSubTopic.

Zwraca utworzony Registration. Obecnie będzie to takie samo pole, co argument, ale z wypełnionymi polami przypisanymi przez serwer, takimi jak expiryTime i id.

Pamiętaj, że wszystkie wartości określone w polach expiryTime lub id zostaną zignorowane.

Chociaż Classroom może weryfikować cloudPubSubTopic i zwracać błędy w ramach dostępnych możliwości, to na dzwoniącym spoczywa odpowiedzialność za to, aby plik istniał i Classroom miał do niego uprawnienia do publikowania.

Ta metoda może zwrócić te kody błędów:

• PERMISSION_DENIED jeśli:
  • uwierzytelniony użytkownik nie ma uprawnień do otrzymywania powiadomień z wybranego pola;
  • bieżący użytkownik nie przyznał dostępu do bieżącego projektu Cloud w odpowiednim zakresie dla żądanego pliku danych. Pamiętaj, że delegowanie uprawnień w całej domenie nie jest obecnie obsługiwane w tym celu. Jeśli żądanie ma odpowiedni zakres, ale nie ma uprawnień, zwracany jest błąd [Request Errors][@MissingGrant error].
  • wystąpił inny błąd dostępu.
• INVALID_ARGUMENT jeśli:
  • nie określono właściwości cloudPubsubTopic lub określona wartość cloudPubsubTopic jest nieprawidłowa;
  • nie określono właściwości feed lub określona wartość feed jest nieprawidłowa.
• NOT_FOUND jeśli:
  • nie można znaleźć określonego feed lub użytkownik nie ma uprawnień do sprawdzenia, czy istnieje;
  • nie można znaleźć określonego cloudPubsubTopic lub usługa Classroom nie ma uprawnień do publikowania w nim treści.