Wyświetlanie, tworzenie i modyfikowanie zadań w Classroom
Co mogę tworzyć za pomocą punktów końcowych CourseWork w interfejsie Classroom API?
Punkty końcowe umożliwiają programistom wyświetlanie zadań na zajęciach i zarządzanie nimi. W szczególności możesz:
- Wyświetlanie projektów i pytań (łącznie nazywanych
CourseWork) użytkownika. - Tworzenie, modyfikowanie i usuwanie
CourseWork. - Dołącz materiały (pliki z Dysku, filmy z YouTube, linki) do
CourseWork. - zmieniać stan przesłanej pracy ucznia (np. oddać, zwrócić, cofnąć);
- Ustaw ocenę za przesłany projekt.
- załączać materiały (pliki z Dysku, filmy z YouTube, linki) do przesłanych przez uczniów projektów;
Przykładowe przypadki użycia CourseWork:
- Dzienniki ocen, systemy informacji o uczniach i systemy raportowania mogą synchronizować projekty i oceny z Classroom z aplikacjami, eliminując ręczne przesyłanie danych.
- Aplikacje edukacyjne mogą tworzyć nowe projekty, które pojawiają się w strumieniu zajęć. Gdy uczniowie ukończą zadanie, aplikacje mogą je oddać, ustawić ocenę, załączyć pracę ucznia i zapisać ją w odpowiednich folderach na Dysku.
- Nauczyciele mogą tworzyć projekty z załącznikami dodatków z Twojej witryny lub aplikacji.
- Uczniowie mogą oddawać projekty z załącznikami z Twojego dodatku.
Jakie uprawnienia są potrzebne mojej aplikacji do tworzenia i modyfikowania zadań?
Zazwyczaj aplikacja może modyfikować tylko utworzone przez siebie zadania. Innymi słowy, wszelkie żądania interfejsu API dotyczące modyfikowania CourseWork muszą używać tego samego identyfikatora projektu Google Cloud, który został użyty do utworzenia CourseWork.
Dodatki do Google Classroom są wyjątkiem od tej reguły. Projekt Google Cloud może uzyskiwać dostęp do dowolnego ogłoszenia, projektu lub materiału, który ma co najmniej 1 załącznik dodatku, i go modyfikować. Projekt w Google Cloud może też oddać, odzyskać lub zwrócić projekt, który ma co najmniej 1 załącznik w postaci dodatku.
Żądania API wymagają też odpowiednich zakresów użytkownika. Nauczyciele mogą wyświetlać projekty, tworzyć projekty, dołączać linki do przesłanych projektów i ustawiać oceny za przesłane projekty. Uczniowie mogą wyświetlać projekty, dołączać linki do swoich rekordów projektów oraz oddawać i cofać przesłane pliki. Administratorzy domeny mogą wyświetlać CourseWork, ale nie mają uprawnień do zapisu.
Jakie typy elementów może dołączać aplikacja do projektów lub przesłanych prac?
Interfejs API umożliwia dołączanie plików z Dysku, filmów z YouTube i linków. Dołączanie natywnych formularzy Google nie jest jeszcze obsługiwane.
Czy użytkownicy wiedzą, że projekt w Classroom został utworzony przez moją aplikację?
Tak. Interfejs Classroom identyfikuje zadania utworzone zewnętrznie za pomocą nazwy usługi projektu Google Cloud, w którym utworzono zadanie. Użytkownicy mogą zgłaszać treści utworzone zewnętrznie jako niechciane, a także odłączać aplikację, która je utworzyła, cofając wszelkie dane logowania wydane jej przez użytkownika.
Przycisk udostępniania w Classroom i inne integracje
Mam już zintegrowany przycisk udostępniania w Classroom. Czy mogę modyfikować zadanie utworzone za pomocą przycisku udostępniania?
Jeszcze nie. Aby zmodyfikować przypisanie, w żądaniu musisz użyć tego samego projektu Google Cloud, w którym zostało utworzone przypisanie.
Czy mogę odpowiadać na pytania w interfejsie API?
Jeszcze nie. Możesz tworzyć i modyfikować pytania.
Dodatki do Classroom
Konfiguracja projektu
Czy mogę przekształcić prywatny projekt Google Cloud, którego używałem(-am) podczas programowania, w projekt publiczny, którego mogę używać w środowisku produkcyjnym?
Nie, nie możesz przekształcić prywatnego projektu Google Cloud w publiczny. Potrzebujesz 2 osobnych projektów: jednego do tworzenia aplikacji, a drugiego do jej wdrażania.
Czy jeden projekt Google Cloud może mieć 2 pozycje w Google Workspace Marketplace?
Nie. Nie możesz utworzyć 2 pozycji w Google Workspace Marketplace dla jednego projektu Google Cloud.
Można jednak łączyć dodatki w pakiety. Dzięki temu jedna pozycja w Google Workspace Marketplace może reprezentować wiele dodatków. Instalacja z takiej strony spowoduje zainstalowanie wszystkich dodatków w pakiecie jednocześnie. Podczas autoryzacji użytkownicy muszą wyrazić zgodę na wszystkie zakresy wymagane przez pakiety dodatków.
Czy klienta OAuth z innego projektu Google Cloud można ponownie wykorzystać w projekcie Google Cloud dla dodatków do Google Classroom?
Nie, klient OAuth z projektu Google Cloud innego niż projekt Google Cloud dodatku do Classroom nie będzie działać. Interfejs Classroom API odrzuca tokeny dostępu wygenerowane przez inny projekt Google Cloud. Musisz utworzyć osobnego klienta OAuth dla projektu dodatku.
Interfejs użytkownika
Nasze logo nie mieści się w małym kwadracie. Jakie są opcje rozmiaru logo na pasku tytułu ramki iframe dodatków do Classroom?
Pasek tytułu elementu iframe został zaprojektowany tak, aby obsługiwać tylko kwadratowe logo o wymiarach 32 x 32 piksele. Taki wybór został dokonany, aby dopasować kształt ikony do kształtu ikony używanej przez firmy na ich stronach internetowych. Zalecamy używanie tego samego logo w przestrzeni, aby zachować spójność marki.
Domeny
Czy wszyscy nauczyciele i uczniowie w tej samej domenie mają dostęp do zainstalowanego dodatku?
Administratorzy domeny mogą kontrolować, którzy nauczyciele mogą wyświetlać zainstalowany dodatek. Dodatki do Classroom są dostępne tylko dla użytkowników z licencją Teaching & Learning lub Education Plus.
Jak administratorzy domeny wchodzą w interakcję z dodatkami?
Administratorzy domeny kontrolują, kto może używać Twojego dodatku. Mogą oni zainstalować dodatek w całej domenie, korzystając z opcji instalacji dla administratora. Jeśli dodatek można zainstalować indywidualnie, pamiętaj, że większość administratorów prowadzi listę dozwolonych dodatków. Nauczyciele, którzy znajdują się na tej liście, mogą samodzielnie instalować dodatki. Administrator może też zainstalować dodatek indywidualnie w celu przeprowadzenia testów.
Administratorów mogą też interesować statystyki dotyczące korzystania z Twojego dodatku. Jeśli Twój produkt to umożliwia, rozważ udostępnienie statystyk korzystania z dodatków w widoku administratora w swojej witrynie.
Interfejs API
Jak wiarygodnie sprawdzić, czy treść dodatku jest wczytywana w ramce iframe czy w nowej karcie?
Obecnie nie ma metody, która pozwalałaby odróżnić te 2 rodzaje.
Które elementy pracy do przypisania mają ramkę iframe do sprawdzania zadań uczniów?
Ramka iframe do sprawdzania prac uczniów jest dostępna tylko w przypadku załączników typu aktywność.
Wywołaj metodę courses.courseWork.getAddOnContext, aby sprawdzić, czy typ posta obsługuje zadania uczniów. Pole supportsStudentWork może mieć wartość true tylko w przypadku typu posta, 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 dowolny Announcement, CourseWork lub CourseWorkMaterial, który zawiera co najmniej 1 załącznik dodatku.
Możesz reclaim, return lub turnIn CourseWork StudentSubmission.
Logowanie jednokrotne
Czy uczniowie, którzy używają plakietek Clever lub Classlink do logowania się na Chromebooku, mogą logować się za pomocą Google?
Tak, nadal mogą korzystać z logowania się przez Google.
Czy każdy uczeń ma prawidłowo 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ść i dostęp do dowolnej usługi Google (w tym Gmaila) są odrębne. Nawet jeśli Gmail jest wyłączony, uczniowie mogą logować się w Classroom za pomocą adresu e-mail. Tożsamości są reprezentowane przez identyfikator użytkownika i adres e-mail. Użytkownik Google Workspace for Education może zmienić swój adres e-mail, dlatego podczas przechowywania informacji o użytkownikach zalecamy używanie identyfikatorów użytkowników jako kluczy podstawowych.
Czy administrator szkoły musi wstępnie zatwierdzić aplikację, aby umożliwić uczniom zalogowanie się?
Aby można było zainstalować dodatek, administratorzy domeny muszą go dodać do listy dozwolonych. Opcjonalnie administratorzy domeny mogą zainstalować dodatek dla wszystkich użytkowników w domenie lub jednostce organizacyjnej.
Opinie i pytania ogólne
Jak mogę przesłać prośbę o dodanie funkcji lub zgłosić problem?
Prośby o dodanie funkcji możesz przesyłać, wyświetlać i oceniać w naszym publicznym narzędziu do rejestrowania błędów.
Skąd mam wiedzieć, kiedy w interfejsie Classroom API pojawią się nowe funkcje?
Informacje o aktualizacjach interfejsu API są publikowane w newsletterze dla deweloperów i w publicznym narzędziu do rejestrowania problemów.
Korzystam z interfejsu API Classroom. Jak mogę zadawać pytania techniczne?
Zadaj pytania na Stack Overflow, dodając google-classroom tag.