Najczęstsze pytania

Wyświetlanie, tworzenie i modyfikowanie zadań w Classroom

Co mogę utworzyć za pomocą punktów końcowych zadań w interfejsie Classroom API?

Punkty końcowe umożliwiają deweloperom wyświetlanie zadań w klasie i zarządzanie nimi. Możesz wykonywać te czynności:

  • wyświetlać projekty i pytania (łącznie nazywane CourseWork) użytkownika;
  • tworzyć, modyfikować i usuwać CourseWork;
  • dołączać materiały (pliki z Dysku, filmy z YouTube, linki) do CourseWork;
  • zmieniać stan przesłanego przez ucznia projektu (np. oddanie, zwrot, odzyskanie);
  • ustawiać ocenę za przesłany projekt;
  • dołączać materiały (pliki z Dysku, filmy z YouTube, linki) do przesłanych przez uczniów projektów.

Przykłady zastosowań CourseWork:

  • Dzienniki ocen, systemy informacji o uczniach lub systemy raportowania mogą synchronizować projekty i oceny z Classroom z aplikacjami, eliminując ręczne przesyłanie danych.
  • Aplikacje do nauki mogą tworzyć nowe projekty, które pojawiają się w strumieniu zajęć. Gdy uczniowie ukończą zadanie, aplikacje mogą je oddać, ustawić oceny, dołączyć zadanie ucznia 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 mają załączniki dodatków.

Jakie uprawnienia są potrzebne mojej aplikacji do tworzenia lub modyfikowania projektów?

Zazwyczaj aplikacja może modyfikować tylko te zadania, które sama utworzyła. Innymi słowy, wszystkie żą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 mają wyjątek od tej reguły. Projekt Cloud może uzyskiwać dostęp do dowolnego ogłoszenia, projektu lub materiału, który ma co najmniej 1 załącznik dodatku, lub go modyfikować. Projekt Cloud może też oddać, odzyskać lub zwrócić projekt, który ma co najmniej 1 załącznik dodatku.

Żądania interfejsu API wymagają też odpowiednich zakresów użytkownika scopes. 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 projektów oraz oddawać i odzyskiwać przesłane projekty. Administratorzy domeny mogą wyświetlać CourseWork, ale nie mają uprawnień do zapisu.

Jakie typy elementów może moja aplikacja dołączać do projektów lub przesłanych projektów?

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 projekty utworzone zewnętrznie za pomocą nazwy projektu Google Cloud, który utworzył zadanie. Użytkownicy mogą zgłaszać projekty utworzone zewnętrznie jako niechciane, a także odłączyć aplikację, która je utworzyła, przez odwołanie danych logowania wydanych aplikacji przez użytkownika.

Przycisk udostępniania w Classroom i inne integracje

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

Jeszcze nie. Aby zmodyfikować projekt, żądanie musi używać tego samego projektu Google Cloud, który został użyty do utworzenia projektu.

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, którego mogę używać w środowisku produkcyjnym?

Nie, nie możesz przekonwertować prywatnego projektu Google Cloud na publiczny. Potrzebujesz 2 oddzielnych projektów – jednego do tworzenia, a drugiego do środowiska produkcyjnego.

Czy jeden projekt Google Cloud może mieć 2 wpisy w Google Workspace Marketplace?

Nie. Nie możesz utworzyć 2 wpisów w Google Workspace Marketplace dla jednego projektu Google Cloud.

Możesz jednak łączyć dodatki. Dzięki temu jeden wpis w Google Workspace Marketplace może reprezentować wiele dodatków. Instalacja z takiego wpisu spowoduje zainstalowanie wszystkich dodatków w pakiecie naraz. Podczas autoryzacji użytkownicy będą musieli wyrazić zgodę na wszystkie zakresy wymagane przez połączone dodatki.

Czy klienta OAuth z innego projektu Google Cloud można używać w projekcie Google Cloud na potrzeby dodatków do 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ć oddzielnego klienta OAuth na potrzeby projektu dodatku.

Interfejs użytkownika

Nasze logo nie pasuje do małego kwadratu. Jakie rozmiary logo są dostępne na pasku tytułu elementu 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. Zdecydowaliśmy się na to, aby dopasować kształt favicon do kształtu favicon używanego przez firmy w ich witrynach. Zalecamy używanie 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 domeny mogą określić, którzy nauczyciele mogą widzieć zainstalowany dodatek. Dodatki do Classroom mogą być używane tylko przez użytkowników z licencją Teaching &Learning lub Education Plus.

Jak administratorzy domeny wchodzą w interakcję z dodatkami?

Administratorzy domeny określają, kto może używać Twojego dodatku. Mogą zainstalować dodatek w całej domenie, korzystając z opcji instalacji administratora instalacji opcji. Jeśli Twój 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ć Twój dodatek indywidualnie na potrzeby testowania.

Administratorzy mogą też być zainteresowani statystykami użycia Twojego dodatku. Jeśli Twoja usługa to obsługuje, rozważ udostępnienie statystyk użycia dodatku w widoku administratora w swojej witrynie.

Interfejs API

Jak mogę się dowiedzieć, czy treść dodatku jest wczytywana w elemencie iframe czy w nowej karcie?

Obecnie nie ma metody, która pozwala odróżnić te 2 przypadki.

Które przypisywalne elementy pracy otrzymują element iframe do sprawdzania zadań uczniów?

Element iframe do sprawdzania zadań 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. Pole supportsStudentWork może mieć wartość true tylko w przypadku typu posta, który jest aktywnością.

Czy załącznik dodatku może uzyskać dostęp do elementu strumienia, do którego jest dołączony?

Tak. Możesz użyć metod get lub patch w przypadku dowolnego elementu Announcement, CourseWork lub CourseWorkMaterial, który zawiera co najmniej 1 załącznik dodatku. Możesz użyć metod reclaim, return lub turnIn w przypadku elementu CourseWork StudentSubmission.

Logowanie jednokrotne

Tak, nadal mogą używać logowania 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 konkretnej usługi Google (w tym Gmaila) to 2 różne kwestie. Nawet jeśli Gmail jest wyłączony, uczniowie mogą logować się w Classroom za pomocą swojego 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 zalecamy używanie identyfikatorów użytkowników jako kluczy podstawowych podczas przechowywania informacji o użytkownikach.

Czy administrator szkoły musi wstępnie zatwierdzić aplikację, aby umożliwić uczniom logowanie się?

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 domenie lub jednostce organizacyjnej.

Opinie i pytania ogólne

Jak mogę przesyłać prośby o dodanie funkcji lub zgłaszać problemy?

Prośby o dodanie funkcji możesz przesyłać, wyświetlać i oceniać w naszym publicznym narzędziu do rejestrowania problemów.

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

Informacje o aktualizacjach interfejsu API są publikowane w biuletynie dla deweloperów i w publicznym narzędziu do rejestrowania problemów.

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

Zadawaj pytania na Stack Overflow, dodając tag google-classroom.