Najczęstsze pytania

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świetlać przypisane zadania i pytania (zwane zbiorczo CourseWork) dla użytkownika;
  • Tworzenie, modyfikowanie i usuwanie CourseWork
  • Załącz materiały (pliki z Dysku, filmy z YouTube, linki) do CourseWork
  • Zmiana stanu przesłania przez ucznia (np. oddania, zwrócenia, odzyskania)
  • Ustawianie oceny za przesłanie projektu
  • Dołącz materiały (pliki z Dysku, filmy z YouTube, linki) do prac przesyłanych przez studentów

Kilka przykładowych zastosowań słowa CourseWork:

  • Systemy dziennika ocen, systemy informacji o uczniach i systemy raportowania mogą synchronizować projekty i oceny z Classroom z aplikacjami, co eliminuje konieczność ręcznego przesyłania danych.
  • Aplikacje edukacyjne mogą tworzyć nowe projekty, które pojawiają się w strumieniu zajęć. Gdy uczniowie ukończą zadania, aplikacje mogą je oddać, ustawić oceny, załączyć prace uczniów i zapisać je w odpowiednich folderach na Dysku.
  • Nauczyciele mogą tworzyć projekty z załącznikami dodatków z Twojej witryny lub aplikacji.
  • Uczniowie mogą oddawać projekty, które zawierają załączniki z Twojego dodatku.

Jakich uprawnień potrzebuje moja aplikacja, aby tworzyć i modyfikować zadania?

Zazwyczaj aplikacja może modyfikować tylko utworzone przez siebie treści. Innymi słowy, wszystkie żądania interfejsu API dotyczące modyfikacji przypisania muszą używać tego samego identyfikatora projektu Google Cloud, który został zapisany w momencie utworzenia przypisania.

Wyjątkiem od tej reguły są dodatki do Google Classroom. Projekt Cloud może mieć dostęp do ogłoszeń, projektów i materiałów, które zawierają co najmniej 1 dodatek. Użytkownik projektu w usłudze Cloud może też oddać, odzyskać lub zwrócić projekt, który zawiera co najmniej jeden dodatek.

Żądania interfejsu API wymagają też prawidłowego zakresu uprawnień użytkownika. Nauczyciele mogą wyświetlać projekty, tworzyć projekty, dołączać linki do projektów przesłanych przez uczniów oraz ustawiać oceny projektów. Uczniowie mogą wyświetlać projekty, dołączać linki do swoich projektów oraz przesyłać i odzyskiwać swoje prace. Administratorzy domeny mogą wyświetlać CourseWork, ale nie mają uprawnień do zapisu.

Jakiego typu elementy aplikacja może dołączać do projektów i materiałów?

Interfejs API obsługuje dołączanie plików z Dysku, filmów w 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 produktu projektu Google Cloud, który je utworzył. Użytkownicy mogą zgłaszać utworzone w innym miejscu treści jako niechciane, a także odłączać aplikację, która je utworzyła, przez cofnięcie wszelkich danych uwierzytelniających wydanych przez użytkownika.

Przycisk udostępniania w Classroom i inne integracje

Mam już integrację z przyciskiem udostępniania w Classroom. Czy mogę zmodyfikować projekt utworzony za pomocą przycisku udostępniania?

Jeszcze nie. Aby zmodyfikować przypisanie, prośba musi używać tego samego projektu Google Cloud, w którym zostało utworzone to przypisanie.

Czy mogę odpowiadać na pytania w interfejsie API?

Jeszcze nie. Możesz tworzyć i modyfikować pytania.

Dodatki do Classroom

Konfiguracja projektu

Czy mogę przekonwertować prywatny projekt Google Cloud, którego używałem podczas tworzenia, na projekt publiczny, z którego mogę korzystać w środowisku produkcyjnym?

Nie możesz przekonwertować prywatnego projektu Google Cloud na publiczny. Potrzebujesz 2 oddzielnych projektów: jeden do tworzenia, a drugi do produkcji.

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 związać dodatki. Dzięki temu jedna pozycja w Google Workspace Marketplace może reprezentować wiele dodatków. Zainstalowanie dodatku z takiej strony spowoduje jednoczesną instalację wszystkich dodatków w pakiecie. Podczas autoryzacji użytkownicy będą musieli wyrazić zgodę na wszystkie zakresy niezbędne do działania pakietów dodatków.

Czy klienta OAuth z innego projektu Google Cloud można ponownie użyć w projekcie Google Cloud dla dodatków Classroom?

Nie. Klient OAuth z projektu Google Cloud innego niż projekt Google Cloud dodatku Classroom nie może działać. Tokeny dostępu wygenerowane przez inny projekt Google Cloud są odrzucane przez interfejs Classroom API. Musisz utworzyć oddzielnego klienta OAuth dla projektu dodatku.

Interfejs użytkownika

Nasze logo nie mieści się w małym kwadracie. Jakie opcje rozmiarów logo są dostępne w pasku tytułu ramki iframe?

Pasek tytułu elementu iframe został zaprojektowany tak, aby obsługiwał tylko kwadratowe logo o wymiarach 32 x 32. Ta decyzja została podjęta, aby pasować do kształtu ikony favicon, której firmy używają na swoich stronach internetowych. Zgodnie z naszymi wytycznymi w tym miejscu powinno się używać tego samego logo, aby zachować spójność marki.

Domeny

Czy wszyscy nauczyciele i uczniowie w tej samej domenie mają dostęp do zainstalowanego dodatku?

Administratorzy szkół mogą kontrolować, którzy nauczyciele mogą zobaczyć zainstalowany dodatek. Dodatki do Classroom są dostępne tylko dla użytkowników z licencją Teaching and Learning lub Education Plus.

Jak administratorzy domen mogą korzystać z dodatków?

Administratorzy domeny określają, kto może korzystać z Twojego dodatku. Mogą zainstalować dodatek w całej domenie, korzystając z opcji instalacji administratora. Jeśli dodatek można zainstalować indywidualnie, pamiętaj, że większość administratorów prowadzi listę dozwolonych dodatków. Nauczyciele mogą instalować dla siebie dodatki, które znajdują się na tej liście. Administrator może też zainstalować Twój dodatek osobno na potrzeby testowania.

Administratorzy mogą też być zainteresowani statystykami dotyczącymi użytkowania Twojego dodatku. Jeśli jest to obsługiwane przez Twój produkt, rozważ udostępnienie statystyk dotyczących dodatku w widoku administratora w swojej witrynie.

Interfejs API

Jak można sprawdzić, czy strona partnera jest wczytana w ramce iframe czy na wyskakującym panelu?

Obecnie nie ma metody, która pozwalałaby odróżnić te dwa typy.

Które elementy przypisane do projektu mają ramkę iframe Sprawdzanie zadań uczniów?

Iframe do sprawdzania prac uczniów jest dostępny tylko w przypadku załączników typu aktywność. Aby sprawdzić, czy typ posta obsługuje zadania uczniów, wywołaj metodę courses.courseWork.getAddOnContext. W przypadku typu wpisu, który jest aktywnością, pole supportsStudentWork może mieć tylko wartość true.

Czy załącznik dodatku może uzyskać 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

Tak, nadal mogą używać 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. Identyfikatory są reprezentowane przez adres e-mail. Tożsamość i dostęp do konkretnej usługi Google (w tym Gmaila) są od siebie odrębne. Nawet jeśli Gmail jest wyłączony, uczniowie mogą logować się za pomocą swojego adresu e-mail.

Czy administrator szkoły musi wcześniej zatwierdzić aplikację, aby umożliwić uczniom logowanie?

Zanim można zainstalować dodatek, administratorzy domen muszą go dopuszczać. Opcjonalnie administratorzy domen mogą zainstalować dodatek dla wszystkich użytkowników w domenie lub jednostce organizacyjnej.

Opinie i pytania ogólne

Jak przesłać prośbę o dodanie funkcji lub zgłosić problem?

W naszym publicznym narzędziu do rejestrowania błędów możesz przesyłać prośby o nowe funkcje, wyświetlać je i głosować na nie.

Jak mogę dowiedzieć się, kiedy nowe funkcje są dostępne w interfejsie Classroom API?

Aktualizacje interfejsu API są publikowane na stronie z informacjami o wersji, na forum dla deweloperów oraz w publicznym narzędziu do śledzenia problemów.

Używam interfejsu Classroom API. Jak mogę zadawać pytania techniczne?

Opublikuj swoje pytania na Stack Overflow, używając tagu google-classroom.