Wyświetlanie, tworzenie i modyfikowanie obiektu CourseWork w Classroom
Co mogę tworzyć przy użyciu punktów końcowych CourseWork w interfejsie Classroom API?
Nowe punkty końcowe pozwalają programistom wyświetlać pracę w klasie i nią zarządzać. Konkretnie: możesz wykonać wszystkie te czynności:
- Wyświetlanie projektów i pytań (nazywanych razem
CourseWork) dla użytkownika - Tworzenie, modyfikowanie i usuwanie listy
CourseWork - Załączanie materiałów (plików z Dysku, filmów w YouTube, linków) do
CourseWork - zmieniać stan zadania przesłanego przez ucznia (np. oddać, zwrócić, odzyskać)
- Ustawianie oceny za przesłany projekt
- Załączanie materiałów (plików z Dysku, filmów w YouTube, linków) do zadania przesłane przez uczniów
Przykładowe przypadki użycia funkcji CourseWork:
- Dzienniki ocen, system informacji o uczniach i systemy raportowania mogą synchronizować projekty i oceny z Classroom z aplikacjami, eliminując konieczność zbierania danych ręcznie. przesiadka
- Aplikacje edukacyjne mogą tworzyć nowe projekty, które pojawią się w zajęciach . Po zakończeniu pracy przez uczniów aplikacje mogą oddawać zadanie, ustawiać wystawiaj oceny, dołączaj prace uczniów i przechowuj je w odpowiednich Foldery na Dysku.
- Nauczyciele mogą tworzyć projekty z załącznikami dodatków z witryny lub aplikacji.
- Uczniowie mogą oddawać projekty z Twoim dodatkiem załączniki.
Jakie uprawnienia musi mieć moja aplikacja do tworzenia lub modyfikowania przypisań?
Zwykle aplikacja może modyfikować tylko utworzone przez siebie materiały. Innymi słowy, wszystkie żądania interfejsu API mutacji przypisań muszą używać tego samego identyfikatora projektu Google Cloud, w momencie tworzenia projektu.
Dodatki do Google Classroom mają wyjątek od tej reguły. O Projekt Cloud może uzyskiwać dostęp do dowolnych ogłoszeń, projektów i ich projektów oraz modyfikować ich ustawienia. który zawiera co najmniej jeden z dodatków. O Projekt w chmurze może też oddać, odzyskać lub zwrócić projekt, który ma co najmniej jeden z załączników.
Żądania do interfejsu API wymagają też prawidłowych zakresów użytkownika. Nauczyciele mogą wyświetlać
projekty, tworzenie projektów, dołączanie linków do przesłanych projektów oraz ustawianie
ocen przesłanych zadań. Uczniowie mogą wyświetlać projekty, dołączać linki do swoich
zapisy projektów oraz oddawanie i odzyskiwanie przesłanych zadań. Domena
administratorzy mogą wyświetlać plik CourseWork, ale nie mają uprawnień do zapisu.
Jakiego typu elementy mogę dołączać do projektów lub przesyłanych zadań?
Interfejs API obsługuje załączanie plików z Dysku, filmów z YouTube . Dołączanie natywnych Formularzy Google nie jest jeszcze obsługiwane.
Czy użytkownicy wiedzą, że projekty w Classroom zostały utworzone przez moją aplikację?
Tak. Interfejs Classroom identyfikuje projekty utworzone zewnętrznie używając nazwy usługi projektu Google Cloud, który utworzył dane zadanie. Użytkownicy mogą zgłaszaj niechciane prace, a także odłącz aplikacji, w której utworzono dzieło, przez unieważnienie wszelkich danych logowania wystawionych przez użytkownika.
Przycisk udostępniania Classroom i inne integracje
Moje rozwiązanie jest już zintegrowane z przyciskiem udostępniania w Classroom. Czy mogę zmodyfikować projekt utworzony za pomocą przycisku udostępniania?
Jeszcze nie. Aby można było zmodyfikować przypisanie, żądanie musi korzystać z tej samej usługi Google Cloud w ramach projektu, w którym utworzono przypisanie.
Czy mogę odpowiadać na pytania z poziomu interfejsu API?
Jeszcze nie. Możesz tworzyć i modyfikować pytania. Odpowiadanie na pytania w sposób zautomatyzowany.
Dodatki do Classroom
Konfiguracja projektu
Czy mogę przekonwertować prywatny projekt Google Cloud użyty podczas programowania na projekt publiczny, którego mogę używać w środowisku produkcyjnym?
Nie możesz przekonwertować prywatnego projektu Google Cloud na projekt publiczny. Potrzebne są 2 osobne projekty – jeden na potrzeby programowania, a drugi produkcyjny.
Czy jeden projekt Google Cloud może mieć 2 wizytówki w Google Workspace Marketplace?
Nie. Nie można utworzyć 2 wizytówek w Google Workspace Marketplace dla jednego projektu Google Cloud.
Możesz jednak tworzyć pakiety dodatków. Powoduje to, że użytkownicy mogą Informacje o aplikacji w Google Workspace Marketplace reprezentujące wiele dodatków. Instaluję z listy spowodowałoby zainstalowanie wszystkich dodatków z pakietu raz. Użytkownicy będą musieli wyrazić zgodę na wszystkie zakresy wymagane przez dodatki zawarte w pakiecie podczas autoryzacji.
Czy klienta OAuth z innego projektu Google Cloud można użyć ponownie w projekcie Google Cloud z dodatkami 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. Dla projektu dodatku musisz utworzyć osobnego klienta OAuth.
Interfejs użytkownika
Nasze logo nie pasuje dobrze do małego kwadratu. Jakie opcje rozmiaru są dostępne dla logo na pasku tytułu elementu iframe?
Pasek tytułu w elemencie iframe obsługuje tylko kwadratowe logo o wymiarach 32 x 32. Ten Dokonano wyboru kształtu favikony, którego firmy używają w swoich witrynach Zalecamy używanie tego samego logo w danym miejscu, aby zachować spójność marki.
Domeny
Czy wszyscy nauczyciele i uczniowie w tej samej domenie mają dostęp do zainstalowanego dodatku?
Szkolni administratorzy mogą decydować, którzy nauczyciele mogą wyświetlać zainstalowany dodatek. Dodatki do Classroom mogą używać tylko użytkownicy dzięki narzędziu Teaching & Learning lub Education Plus,
W jaki sposób administratorzy domeny korzystają z dodatków?
Administratorzy domeny (administratorzy) decydują o tym, kto może korzystać z Twojego dodatku. Mogą Zainstalowanie dodatku w całej domenie przy użyciu instalacji administratora . Jeśli dodatek możesz zainstalować osobno, pamiętaj, że większość Administratorzy mają listę dozwolonych dodatków. nauczyciele mogą instalować dodatki którzy znajdują się na tej liście. Administrator może też określić, pojedynczo instalować dodatek na potrzeby testów.
Administratorzy mogą być również zainteresowani statystykami użytkowania dotyczącymi Google Analytics. Zastanów się nad udostępnieniem statystyk użytkowania dodatku, jeśli Twoja usługa go obsługuje. w widoku administratora w swojej witrynie.
Interfejs API
Jak można w niezawodny sposób sprawdzić, czy strona partnera jest ładowana w elemencie iframe czy w wyskakującej karcie?
Nie ma obecnie metody ich rozróżnienia.
Które elementy robocze, które można przypisać, otrzymują element iframe z oceną pracy ucznia?
Element iframe z oceną pracy ucznia jest dostępny tylko w przypadku załączników typu aktywność.
Wywołaj metodę courses.courseWork.getAddOnContext, aby ujawnić, czy post
który obsługuje zadania uczniów. Pole supportsStudentWork może zawierać tylko wartość true
w przypadku wpisu, który jest aktywnością.
Czy załącznik dodatku ma dostęp do elementu strumienia, do którego jest dołączony?
Tak. Możesz get lub patch dowolne Announcement, CourseWork lub
CourseWorkMaterial, który zawiera co najmniej jeden z załączników Twojego dodatku.
Możesz reclaim, return lub turnIn CourseWork StudentSubmission.
Jednokrotne logowanie
Czy uczniowie korzystający z plakietek Clever lub Classlink do logowania się na Chromebookach mogą używać logowania przez Google?
Tak, nadal mogą 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 swoją tożsamość Google, niezależnie od tego czy mają oni dostęp do Gmaila. Tożsamości są reprezentowane przez adres e-mail adresu. Tożsamość i dostęp do poszczególnych usług Google (w tym Gmaila). różnią się od siebie. Dzięki temu nawet jeśli Gmail jest wyłączony, użytkownicy studenci mogą logować się za pomocą swojego adresu e-mail.
Czy administrator szkoły musi wstępnie zatwierdzić aplikację, aby umożliwić uczniom logowanie?
Administratorzy domeny muszą dodać dodatek do listy dozwolonych, zanim będzie można go zainstalować. Opcjonalnie administratorzy domeny mogą zainstalować dodatek dla wszystkich użytkowników w w domenie lub jednostce organizacyjnej.
Opinie i pytania ogólne
Jak przesyłać prośby o dodanie funkcji lub zgłoszenia problemów?
Możesz przesyłać i wyświetlać prośby o dodanie funkcji, a także na nie głosować w naszym publicznym wydaniu .
Skąd mam wiedzieć, że są dostępne nowe funkcje interfejsu Classroom API?
Informacje o aktualizacjach interfejsu API publikujemy na stronie z informacjami o wersji na naszym forum dla programistów. oraz publicznego narzędzia do rejestrowania problemów.
Korzystam z interfejsu API Classroom. Jak mogę zadawać pytania techniczne?
Publikuj swoje pytania na Stack Overflow, używając tagu google-classroom.