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.

Żądanie HTTP

POST https://classroom.googleapis.com/v1/registrations

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera wystąpienie elementu Registration.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Registration.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.push-notifications

Więcej informacji znajdziesz w przewodniku po autoryzacji.