Häufig gestellte Fragen

CourseWork in Classroom ansehen, erstellen und ändern

Was kann ich mit den CourseWork-Endpunkten in der Classroom API erstellen?

Mit den neuen Endpunkten können Entwickler die Aufgaben in einem Kurs ansehen und verwalten. Insbesondere haben Sie folgende Möglichkeiten:

  • Aufgaben und Fragen für einen Nutzer ansehen (zusammenfassend als „CourseWork“ bezeichnet)
  • CourseWork erstellen, ändern und löschen
  • Materialien (Drive-Dateien, YouTube-Videos, Links) an CourseWork anhängen
  • Den Status der abgegebenen Aufgabe eines Schülers/Studenten ändern (z. B. „Abgeben“, „Zurückgeben“, „Zurückfordern“)
  • Note für abgegebene Aufgaben festlegen
  • Materialien (Drive-Dateien, YouTube-Videos, Links) an die Aufgaben anhängen

Hier einige beispielhafte Anwendungsfälle für CourseWork:

  • Mit Notenbüchern, SIS oder Berichtssystemen können Aufgaben und Noten aus Classroom mit den Anwendungen synchronisiert werden, wodurch die manuelle Datenübertragung entfällt.
  • Lernanwendungen können neue Aufgaben erstellen, die im Kursstream angezeigt werden. Während die Schüler oder Studenten ihre Aufgaben erledigen, können Anwendungen sie abgeben, Noten vergeben, die Aufgaben von Schülern/Studenten anhängen und die Aufgaben in entsprechenden Drive-Ordnern speichern.
  • Lehrkräfte können Aufgaben mit Add-on-Anhängen von Ihrer Website oder aus Ihrer Anwendung erstellen.
  • Schüler und Studenten können ihre Aufgaben mit Ihren Add-on-Anhängen abgeben.

Welche Berechtigungen benötigt meine Anwendung, um Aufgaben zu erstellen oder zu ändern?

In der Regel kann eine Anwendung nur die von ihr selbst erstellten Arbeiten ändern. Mit anderen Worten: Alle API-Anfragen zur Zuweisungsänderung müssen dieselbe Google Cloud-Projekt-ID verwenden, die beim Erstellen der Zuweisung gespeichert wurde.

Für Google Classroom-Add-ons gilt eine Ausnahme von dieser Regel. In einem Cloud-Projekt können alle Ankündigungen, Aufgaben oder Materialien mit einem oder mehreren Add-on-Anhängen aufgerufen oder geändert werden. Ein Cloud-Projekt kann auch eine Aufgabe mit einem oder mehreren zugehörigen Add-ons als Anhang abgeben, zurückfordern oder zurückgeben.

API-Anfragen erfordern außerdem die richtigen Nutzerbereiche. Lehrkräfte können Aufgaben ansehen, erstellen, Links an eingereichte Aufgaben anhängen und Noten für abgegebene Aufgaben festlegen. Lernende können Aufgaben ansehen, Links an ihre Aufzeichnungen anhängen und ihre abgegebenen Aufgaben abgeben und zurückfordern. Domainadministratoren können sich CourseWork ansehen, haben aber keine Schreibberechtigungen.

Welche Arten von Elementen kann meine Bewerbung an Aufgaben oder Einreichungen anhängen?

Die API unterstützt das Anhängen von Drive-Dateien, YouTube-Videos und Links. Native Google-Formulare können noch nicht angehängt werden.

Wissen Endnutzer, dass eine Aufgabe in Classroom von meiner Anwendung erstellt wurde?

Ja. In der Classroom-UI werden extern erstellte Aufgaben anhand des Produktnamens des Google Cloud-Projekts identifiziert, in dem die Arbeit erstellt wurde. Nutzer können extern erstellte Arbeit als unerwünscht melden und die Verbindung zu der Anwendung trennen, mit der sie erstellt wurden, indem sie alle Anmeldedaten widerrufen, die der Nutzer für die Anwendung ausgestellt hat.

Schaltfläche zum Teilen in Classroom und andere Integrationen

Ich habe die Schaltfläche zum Teilen in Classroom bereits integriert. Kann ich eine Aufgabe ändern, die mit der Schaltfläche „Freigeben“ erstellt wurde?

Noch nicht. Wenn Sie eine Zuweisung ändern möchten, muss die Anfrage dasselbe Google Cloud-Projekt verwenden, in dem die Zuweisung erstellt wurde.

Kann ich Fragen in der API beantworten?

Noch nicht. Sie können Fragen erstellen und bearbeiten. Unsere Roadmap ist geplant, um Fragen programmatisch zu beantworten.

Add-ons für Classroom

Projektkonfiguration

Kann ich das private Google Cloud-Projekt, das ich während der Entwicklung verwendet habe, in ein öffentliches Projekt umwandeln, das ich für die Produktion verwenden kann?

Ein privates Google Cloud-Projekt kann nicht in ein öffentliches Projekt umgewandelt werden. Sie benötigen zwei separate Projekte, eines für die Entwicklung und das andere für die Produktion.

Kann ein einzelnes Google Cloud-Projekt zwei GWM-Einträge haben?

Nein. Es ist nicht möglich, zwei GWM-Einträge für ein einzelnes Google Cloud-Projekt zu erstellen.

Es ist jedoch möglich, Add-ons zu bündeln. So kann ein einzelner GWM-Eintrag mehrere Add-ons repräsentieren. Bei der Installation über einen solchen Eintrag werden dann alle Add-ons im Bundle gleichzeitig installiert. Nutzer müssen bei der Autorisierung allen Bereichen zustimmen, die für gebündelte Add-ons erforderlich sind.

Es gibt zwei weitere Überlegungen zu Bündelung:

  1. Classroom-Add-ons sind nur für Abonnenten des Teaching and Learning Upgrades oder der Version Education Plus verfügbar.

  2. Die Add-ons API befindet sich in der Early-Access-Phase und ist auf teilnehmende Entwickler und Google Cloud-Projekte beschränkt. Gebündelte Add-ons funktionieren möglicherweise nicht wie vorgesehen, wenn sie auf nicht teilnehmenden Google Cloud-Projekten basieren.

Kann ein OAuth-Client aus einem anderen Google Cloud-Projekt mit einem Google Cloud-Projekt für Classroom-Add-ons wiederverwendet werden?

Nein. Ein OAuth-Client aus einem anderen Google Cloud-Projekt als dem Google Cloud-Projekt des Classroom-Add-ons funktioniert nicht. Zugriffstokens, die von einem anderen Google Cloud-Projekt generiert wurden, werden von der Classroom API abgelehnt. Sie müssen einen separaten OAuth-Client für das Add-on-Projekt erstellen.

Nutzererfahrung

Unser Logo passt nicht so gut in ein kleines Quadrat. Welche Größenoptionen gibt es für Logos in der iFrame-Titelleiste?

Die iFrame-Titelleiste wurde nur für ein quadratisches Logo im Format 32 x 32 entwickelt. Diese Auswahl wurde an die Favicon-Form angepasst, die Unternehmen auf ihren Websites verwenden. Wir empfehlen, dasselbe Logo im Bereich für Markenkonsistenz zu verwenden.

Domains

Haben alle Lehrkräfte und Schüler/Studenten in derselben Domain Zugriff auf ein installiertes Add-on?

Administratoren von Bildungseinrichtungen können festlegen, welche Lehrkräfte ein installiertes Add-on sehen können.

Wie interagieren Domainadministratoren mit Add-ons?

Domainadministratoren (Administratoren) legen fest, wer Ihr Add-on verwenden darf. Er kann mithilfe der Administrator-Installationsoption ein Add-on für eine ganze Domain installieren. Wenn Ihr Add-on einzeln installiert werden kann, haben die meisten Administratoren eine Zulassungsliste für Add-ons. Lehrkräfte können Add-ons, die sich auf dieser Liste befinden, selbst installieren. Ein Administrator kann das Add-on zu Testzwecken auch einzeln installieren.

Administratoren sind möglicherweise auch an Nutzungsstatistiken zu Ihrem Add-on interessiert. Sofern Ihr Produkt dies unterstützt, sollten Sie die Add-on-Nutzungsstatistiken in einer Administratoransicht auf Ihrer eigenen Website zur Verfügung stellen.

API

Wie können Sie zuverlässig feststellen, ob die Partnerseite innerhalb eines iFrames oder eines Pop-out-Tabs geladen wird?

Derzeit gibt es keine Möglichkeit, zwischen den beiden zu unterscheiden.

Welche zuweisbaren Aufgaben erhalten einen iFrame für die Prüfung der Aufgabe von Schülern/Studenten?

Der iFrame für die Prüfung der Aufgabe von Schülern/Studenten ist nur für Anhänge vom Typ „Aktivität“ verfügbar. Rufen Sie die Methode courses.courseWork.getAddOnContext auf, um herauszufinden, ob der Beitragstyp die Aufgaben von Schülern oder Studenten unterstützt. Das Feld supportsStudentWork kann nur bei einem Beitragstyp, der eine Aktivität ist, den Wert true haben.

Kommt es während des Early Access-Programms zu funktionsgefährdenden Änderungen an der API?

Die Add-on-API befindet sich noch in der Entwicklungsphase. Daher können funktionsgefährdende Änderungen an der API dazu führen, dass zuvor erfolgreiche Anfragen fehlschlagen oder sich anders verhalten. Sie können vorab über das Entwicklerforum über funktionsgefährdende Änderungen informiert werden.

Kann ein Add-on-Anhang auf das Stream-Element zugreifen, an das er angehängt ist?

Ja. Sie können alle Announcement, CourseWork oder CourseWorkMaterial, die mindestens einen Ihrer Add-on-Anhänge enthalten, mit get oder patch versehen. Sie können eine CourseWork StudentSubmission mit reclaim, return oder turnIn.

Wann werden Classroom-Add-ons veröffentlicht?

Classroom-Add-ons stehen seit Sommer 2022 allen Endnutzern zur Verfügung. Die Add-ons API soll 2024 voraussichtlich irgendwann allgemein für Entwickler verfügbar sein.

Einmalanmeldung (SSO)

Ja, sie können Google Log-in weiterhin verwenden.

Haben alle Schüler und Studenten eine korrekt formatierte E-Mail-Adresse, auch wenn sie keinen Zugriff auf Gmail haben?

Jeder Google Workspace for Education-Nutzer hat eine Google-Identität, auch wenn er Zugriff auf Gmail hat. Identitäten werden durch eine E-Mail-Adresse dargestellt. Die Identität und der Zugriff auf einen bestimmten Google-Dienst (einschließlich Gmail) sind unterschiedlich. Dadurch können sich Schüler und Studenten mit ihrer E-Mail-Adresse anmelden, auch wenn Gmail deaktiviert ist.

Muss der Administrator der Bildungseinrichtung die App vorab genehmigen, damit sich Schüler und Studenten anmelden können?

Domainadministratoren müssen ein Add-on auf die Zulassungsliste setzen, bevor es installiert werden kann. Optional können Domainadministratoren ein Add-on für alle Nutzer innerhalb der Domain oder einer Organisationseinheit installieren.

Feedback und allgemeine Fragen

Wie kann ich Funktionsanfragen stellen oder Probleme melden?

In unserer öffentlichen Issue Tracker können Sie Funktionsanfragen stellen, ansehen und darüber abstimmen.

Woher weiß ich, ob neue Funktionen in der Classroom API verfügbar sind?

Updates für die API werden auf der Seite mit den Versionshinweisen, in unserem Entwicklerforum und im öffentlichen Issue Tracker veröffentlicht.

Ich verwende die Classroom API. Wie kann ich technische Fragen stellen?

Posten Sie Ihre Fragen auf Stack Overflow mit dem google-classroom-Tag.