Häufig gestellte Fragen

Kursaufgaben in Classroom ansehen, erstellen und ändern

Was kann ich mit den Endpunkten für Kursarbeit in der Classroom API erstellen?

Über die Endpunkte können Entwickler die Arbeit in einem Kurs ansehen und verwalten. Sie haben folgende Möglichkeiten:

  • Aufgaben und Fragen (zusammen CourseWork) für einen Nutzer ansehen
  • CourseWork erstellen, ändern und löschen
  • Materialien (Drive-Dateien, YouTube-Videos, Links) an CourseWork anhängen
  • Status der Abgabe eines Schülers/Studenten ändern (z. B. Abgabe, Rückgabe, Rücknahme)
  • Note für abgegebene Aufgaben festlegen
  • Materialien (Drive-Dateien, YouTube-Videos, Links) an die Einreichungen von Schülern/Studenten anhängen

Beispiele für Anwendungsfälle für CourseWork:

  • Notenbücher, SIS oder Berichtssysteme können Aufgaben und Noten aus Classroom mit ihren Anwendungen synchronisieren, sodass eine manuelle Datenübertragung entfällt.
  • Lernanwendungen können neue Aufgaben erstellen, die im Kursstream angezeigt werden. Während die Schüler und Studenten Aufgaben erledigen, können Anwendungen diese Aufgaben abgeben, Noten festlegen, Aufgaben von Schülern/Studenten anhängen und die Aufgaben in den entsprechenden Drive-Ordnern speichern.
  • Lehrkräfte können Aufgaben mit Add-on-Anhängen über Ihre Website oder Anwendung erstellen.
  • Schüler und Studenten können ihre Aufgaben mit Ihrem Add-on-Anhang abgeben.

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

In der Regel kann eine Anwendung nur erstellte Arbeiten ändern. Mit anderen Worten: Für alle API-Anfragen zur Aufgabenänderung muss dieselbe Google Cloud-Projekt-ID verwendet werden, die beim Erstellen der Aufgabe gespeichert wurde.

Für Google Classroom-Add-ons gilt eine Ausnahme von dieser Regel. Ein Cloud-Projekt kann auf alle Ankündigungen, Aufgaben oder Materialien zugreifen oder diese ändern, die einen oder mehrere seiner Add-on-Anhänge enthalten. In einem Cloud-Projekt können auch Aufgaben mit einem oder mehreren Add-on-Anhängen abgegeben, zurückgefordert oder zurückgegeben werden.

Für API-Anfragen sind außerdem die richtigen Nutzerbereiche erforderlich. Lehrkräfte können Aufgaben ansehen, Aufgaben erstellen, Links an Aufgabenanhänge anhängen und Noten für abgegebene Aufgaben festlegen. Schüler und Studenten können sich Aufgaben ansehen, Links an ihre Aufgabendatensätze anhängen, ihre Aufgaben einreichen und zurückfordern. Domainadministratoren können CourseWork aufrufen, haben aber keine Schreibberechtigungen.

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

Die API unterstützt das Anhängen von Drive-Dateien, YouTube-Videos und Links. Das Anhängen nativer Google-Formulare wird noch nicht unterstützt.

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

Ja. In der Classroom-Benutzeroberfläche werden extern erstellte Aufgaben anhand des Produktnamens des Google Cloud-Projekts identifiziert, in dem die Aufgabe erstellt wurde. Nutzer können extern erstellte Arbeiten als unerwünscht melden und die Verbindung zur Anwendung trennen, in der die Arbeit erstellt wurde. Dazu widerrufen sie alle Anmeldedaten, die der Nutzer an die Anwendung ausgegeben hat.

Schaltfläche „Mit Classroom teilen“ und andere Integrationen

Ich habe die Schaltfläche „Mit Classroom teilen“ bereits eingebunden. Kann ich eine Aufgabe ändern, die ich über die Schaltfläche „Teilen“ erstellt habe?

Noch nicht. Wenn Sie eine Aufgabe ändern möchten, muss für die Anfrage dasselbe Google Cloud-Projekt verwendet werden, mit dem die Aufgabe erstellt wurde.

Kann ich Fragen in der API beantworten?

Noch nicht. Sie können Fragen erstellen und ändern.

Add-ons für Classroom

Projektkonfiguration

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

Sie können ein privates Google Cloud-Projekt nicht in ein öffentliches Projekt umwandeln. Sie benötigen zwei separate Projekte, eines für die Entwicklung und eines für die Produktion.

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

Nein. Sie können nicht zwei Google Workspace Marketplace-Einträge für ein einzelnes Google Cloud-Projekt erstellen.

Es ist jedoch möglich, Add-ons in einem Set zusammenzufassen. So kann ein einzelner Google Workspace Marketplace-Eintrag mehrere Add-ons repräsentieren. Wenn Sie über ein solches Eintrag installieren, werden alle Add-ons im Bundle gleichzeitig installiert. Nutzer müssen bei der Autorisierung allen Bereichen zustimmen, die für die in Bundles enthaltenen Add-ons erforderlich sind.

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 gut in ein kleines Quadrat. Welche Größenoptionen gibt es für Logos in der iFrame-Titelleiste?

Die Titelleiste des iFrames wurde nur für ein quadratisches Logo mit einer Größe von 32 × 32 Pixeln entwickelt. Diese Auswahl wurde an die Favicon-Form angepasst, die Unternehmen auf ihren Websites verwenden, und wir empfehlen, im Bereich zur Markenkonsistenz dasselbe Logo 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. Classroom-Add-ons können nur von Nutzern mit einer Teaching and Learning- oder Education Plus-Lizenz verwendet werden.

Wie interagieren Domainadministratoren mit Add-ons?

Domainadministratoren (Administratoren) legen fest, wer Ihr Add-on verwenden darf. Er kann ein Add-on mithilfe der Installationsoption als Administrator für eine gesamte Domain installieren. Wenn Ihr Add-on einzeln installiert werden kann, beachten Sie, dass die meisten Administratoren eine Add-on-Zulassungsliste haben. Lehrkräfte können Add-ons, die auf dieser Liste stehen, selbst installieren. Ein Administrator kann Ihr Add-on auch einzeln installieren, um es zu testen.

Administratoren sind möglicherweise auch an Nutzungsstatistiken zu Ihrem Add-on interessiert. Wenn von Ihrem Produkt unterstützt, sollten Sie Statistiken zur Add-on-Nutzung in einer Administratoransicht auf Ihrer eigenen Website bereitstellen.

API

Wie kann ich zuverlässig feststellen, ob die Partnerseite in einem IFrame oder einem Pop-out-Tab geladen wird?

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

Für welche zuweisbaren Arbeitselemente wird ein IFrame für die Überprüfung der Schüler-/Studentenarbeit verwendet?

Der iFrame von „Aufgaben 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 Arbeit von Schülern/Studenten unterstützt. Das Feld supportsStudentWork kann nur für einen Beitragstyp festgelegt werden, der eine Aktivität ist.true

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

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

Einmalanmeldung (SSO)

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

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

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

Muss ein 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 anfragen?

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

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

API-Updates werden auf der Seite mit den Versionshinweisen, in unserem Entwicklerforum und in der öffentlichen Problemverfolgung 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.