Wyświetlanie, tworzenie i modyfikowanie zadań edukacyjnych w Classroom
Co mogę tworzyć przy użyciu punktów końcowych CourseWork w interfejsie API Classroom?
Nowe punkty końcowe umożliwiają programistom wyświetlanie zadań w ramach zajęć i zarządzanie nimi. Konkretnie mówiąc, możesz wykonać wszystkie te czynności:
- Wyświetlanie projektów i pytań użytkownika (łącznie nazywanych „CourseWork”)
- Tworzenie, modyfikowanie i usuwanie zadań edukacyjnych
- Dołączanie materiałów (plików z Dysku, filmów z YouTube, linków) do CourseWork
- Zmiana stanu zadania przesłanego przez ucznia (np. oddanie, zwrot, odbiór)
- Ustawianie oceny za przesłany projekt
- Dołączaj materiały (pliki z Dysku, filmy w YouTube, linki) do prac
Przykładowe przypadki użycia narzędzia CourseWork:
- Dzienniki ocen, system informacji o uczniach lub systemy raportowania mogą synchronizować projekty i oceny z Classroom z aplikacjami, eliminując ręczne przenoszenie danych.
- Aplikacje edukacyjne mogą tworzyć nowe projekty, które będą widoczne w strumieniu zajęć. Aplikacje mogą oddawać prace uczniów, ustawiać oceny, dołączać zadania uczniów i przechowywać je w odpowiednich folderach na Dysku.
- Nauczyciele mogą tworzyć projekty z załącznikami dodatków z poziomu witryny lub aplikacji.
- Użytkownicy mogą oddawać projekty z załącznikami.
Jakich uprawnień potrzebuje moja aplikacja, aby tworzyć i modyfikować przypisania?
Zwykle aplikacja może modyfikować tylko własne utwory. Oznacza to, że wszystkie żądania do interfejsu API mutacji przypisania muszą używać tego samego identyfikatora projektu Google Cloud, który był zapisany w momencie tworzenia przypisania.
Wyjątkiem od tej reguły są dodatki do Google Classroom. Projekt w chmurze ma dostęp do dowolnych ogłoszeń, projektów i materiałów z co najmniej jednym załącznikiem oraz może je modyfikować. Projekt w chmurze może też oddać, odzyskać lub zwrócić projekt, który ma co najmniej jeden załącznik dodatków.
Żądania do interfejsu API wymagają też prawidłowych zakresów użytkownika. Nauczyciele mogą wyświetlać projekty, tworzyć projekty, dołączać linki do przesłanych projektów oraz ustawiać oceny za projekty. Uczniowie mogą wyświetlać projekty, dołączać linki do swoich rekordów projektów oraz oddawać projekty i je odbierać. Administratorzy domeny mogą wyświetlać zadania CourseWork, ale nie mają uprawnień do zapisu.
Jakiego typu elementy mogę dołączać do projektów lub zadań?
Interfejs API obsługuje załączanie plików z Dysku, filmów z YouTube i linków. Na razie nie można dołączać natywnych Formularzy Google.
Czy użytkownicy wiedzą, że projekty w Classroom zostały utworzone przez moją aplikację?
Tak. Interfejs Classroom rozpoznaje projekty utworzone zewnętrznie, korzystając z nazwy projektu Google Cloud, w którym zostało utworzone zadanie. Użytkownicy mogą zgłaszać prace utworzone zewnętrznie jako niechciane, a także odłączać aplikacje, które utworzyły daną pracę, unieważniając wszystkie dane logowania przyznane aplikacji przez użytkownika.
Przycisk udostępniania Classroom i inne integracje
Integracja z przyciskiem udostępniania Classroom jest już zakończona. Czy mogę zmodyfikować projekt utworzony za pomocą przycisku udostępniania?
Jeszcze nie. Aby można było zmodyfikować przypisanie, żądanie musi dotyczyć tego samego projektu Google Cloud, za pomocą którego utworzono przypisanie.
Czy mogę odpowiadać na pytania w interfejsie API?
Jeszcze nie. Możesz tworzyć i modyfikować pytania. Wprowadzamy automatyczne odpowiadanie na pytania.
Dodatki do Classroom
Konfiguracja projektu
Czy mogę przekształcić prywatny projekt Google Cloud używany podczas programowania w projekt publiczny, którego mogę używać w środowisku produkcyjnym?
Nie możesz przekształcić prywatnego projektu Google Cloud w publiczny. Potrzebujesz 2 osobnych projektów – jednego na potrzeby programowania, a drugiego – produkcyjnego.
Czy 1 projekt Google Cloud może zawierać 2 wizytówki GWM?
Nie. Nie można utworzyć 2 wizytówek GWM dla jednego projektu Google Cloud.
Możliwe jest jednak grupowanie dodatków. Dzięki temu jedna wizytówka GWM może reprezentować wiele dodatków. Instalacja z takiej strony spowoduje zainstalowanie wszystkich dodatków w pakiecie jednocześnie. Podczas autoryzacji użytkownicy będą musieli wyrazić zgodę na wszystkie zakresy wymagane przez pakiety dodatków.
Istnieją 2 dodatkowe kwestie dotyczące grupowania:
Dodatki do Classroom są dostępne tylko dla subskrybentów usługi Teaching and Learning Upgrade lub wersji Education Plus.
Interfejs API dodatków jest w fazie wcześniejszego dostępu i mogą z niego korzystać tylko uczestniczący deweloperzy i projekty Google Cloud. Dodatki w pakiecie mogą nie działać zgodnie z oczekiwaniami, jeśli wymagają projektów Google Cloud, które nie uczestniczą w nich.
Czy można używać klienta OAuth z innego projektu Google Cloud w przypadku dodatków do Classroom?
Nie. Klient OAuth z projektu Google Cloud innego niż projekt Google Cloud dodatku do Classroom nie może działać. Tokeny dostępu wygenerowane przez inny projekt Google Cloud są odrzucane przez interfejs Classroom API. Musisz utworzyć osobnego klienta OAuth na potrzeby projektu dodatkowego.
Interfejs użytkownika
Nasze logo nie pasuje do małego kwadratu. Jakie opcje rozmiaru są dostępne na pasku tytułu elementu iframe?
Pasek tytułu elementu iframe został zaprojektowany do obsługi kwadratowego logo o wymiarach 32 x 32. Wybór padł na kształt favikony, z której korzystają firmy w swoich witrynach. Zgodnie z naszymi wskazówkami należy używać tego samego logo w tym miejscu, aby zachować spójność marki.
Domeny
Czy wszyscy nauczyciele i uczniowie w tej samej domenie mają dostęp do zainstalowanego dodatku?
Administratorzy szkoły mają kontrolę nad tym, którzy nauczyciele mogą zobaczyć zainstalowany dodatek.
Jak administratorzy domeny mogą korzystać z dodatków?
Administratorzy domeny (administratorzy) decydują o tym, kto może korzystać z dodatku. Mogą oni zainstalować dodatek w całej domenie, korzystając z opcji instalacji administratora. Jeśli dodatek można zainstalować samodzielnie, pamiętaj, że większość administratorów obsługuje listę dozwolonych dodatków, a nauczyciele mogą samodzielnie instalować dodatki z tej listy. Administrator może też zdecydować się na samodzielne zainstalowanie Twojego dodatku na potrzeby testów.
Administratorzy mogą być też zainteresowani statystykami użytkowania Twojego dodatku. Jeśli Twoja usługa obsługuje tę funkcję, rozważ udostępnienie statystyk użytkowania dodatków w widoku administratora w Twojej witrynie.
API
Jak możesz w niezawodny sposób sprawdzić, czy strona partnera jest wczytywana w elemencie iframe, czy w wyskakującym okienku?
Obecnie nie ma metody rozróżniania między nimi.
Które elementy do przypisania otrzymują element iframe z ocenami zadań uczniów?
Element iframe sprawdzania zadań uczniów jest dostępny tylko w przypadku załączników typu aktywność.
Wywołaj metodę courses.courseWork.getAddOnContext, aby określić, czy typ posta wspiera pracę uczniów. Pole supportsStudentWork może zawierać wartość true tylko w przypadku typu posta, który jest aktywnością.
Czy w programie wcześniejszego dostępu mogą pojawić się zmiany powodujące niezgodność w interfejsie API?
Nadal pracujemy nad interfejsem API dodatków. Dlatego mogą wystąpić zmiany powodujące niezgodność w interfejsie API, przez co wcześniej udane żądania kończą się niepowodzeniem lub działają inaczej. W przypadku zmian powodujących niezgodność możesz z wyprzedzeniem otrzymywać powiadomienia na forum dla deweloperów.
Czy załącznik dodatku ma dostęp do elementu strumienia, do którego jest dołączony?
Tak. Możesz get lub patch dowolny element Announcement, CourseWork lub
CourseWorkMaterial, który zawiera przynajmniej jeden z załączników Twojego dodatku.
Możesz reclaim, return lub turnIn CourseWork StudentSubmission.
Kiedy dodatki do Classroom będą dostępne publicznie?
Dodatki do Classroom są dostępne dla wszystkich użytkowników od lata 2022 roku. Przewidujemy, że w 2024 roku interfejs API dodatków stanie się ogólnie dostępny dla deweloperów.
Logowanie jednokrotne
Czy uczniowie, którzy używają plakietek Clever lub Classlink do logowania się na Chromebooku, mogą korzystać z logowania przez Google?
Tak, mogą nadal korzystać z Logowania przez Google.
Czy każdy uczeń ma poprawnie sformatowany adres e-mail, nawet jeśli nie ma dostępu do Gmaila?
Każdy użytkownik Google Workspace for Education ma tożsamość Google niezależnie od tego, czy ma dostęp do Gmaila. Tożsamości są reprezentowane przez adresy e-mail. Tożsamość i dostęp do poszczególnych usług Google (w tym Gmaila) różnią się od siebie. Dzięki temu uczniowie mogą logować się przy użyciu swoich adresów e-mail nawet wtedy, gdy Gmail jest wyłączony.
Czy administrator szkoły musi wstępnie zatwierdzić aplikację, aby umożliwić uczniom logowanie się?
Administratorzy domeny muszą dodać dodatek do listy dozwolonych, aby go zainstalować. Opcjonalnie administratorzy domeny mogą zainstalować dodatek dla wszystkich użytkowników w domenie lub jednostce organizacyjnej.
Opinie i pytania ogólne
Jak mogę przesyłać prośby o dodanie funkcji lub zgłaszać problemy?
Możesz przesyłać i wyświetlać prośby o dodanie funkcji oraz na nie głosować, korzystając z naszego publicznego narzędzia do śledzenia problemów.
Skąd mam wiedzieć, kiedy będą dostępne nowe funkcje interfejsu API Classroom?
Informacje o aktualizacjach interfejsu API można znaleźć na stronie z informacjami o wersji, na naszym forum dla deweloperów i w publicznym narzędziu do rejestrowania problemów.
Używam interfejsu API Classroom. Jak mogę zadawać pytania techniczne?
Opublikuj swoje pytania na Stack Overflow, korzystając z tagu google-classroom.