Häufig gestellte Fragen

Kursaufgaben in Classroom ansehen, erstellen und bearbeiten

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

Mit den Endpunkten können Entwickler Aufgaben in einem Kurs ansehen und verwalten. Konkret können Sie Folgendes tun:

  • Aufgaben und Fragen (zusammen als CourseWork bezeichnet) für einen Nutzer ansehen
  • CourseWork erstellen, bearbeiten und löschen
  • CourseWork Materialien (Drive-Dateien, YouTube-Videos, Links) anhängen
  • Den Status einer Abgabe eines Schülers/Studenten ändern (z. B. „Abgeben“, „Zurückgeben“, „Zurücknehmen“)
  • Die Note für eine Aufgabenabgabe festlegen
  • Materialien (Drive-Dateien, YouTube-Videos, Links) an Abgaben von Schülern/Studenten anhängen

Einige Anwendungsbeispiele für CourseWork:

  • Notenbücher, Schüler-/Studenteninformationssysteme oder Berichtssysteme können Aufgaben und Noten aus Classroom mit ihren Anwendungen synchronisieren, sodass keine manuelle Datenübertragung erforderlich ist.
  • Lernanwendungen können neue Aufgaben erstellen, die im Kursstream angezeigt werden. Wenn Schüler/Studenten Aufgaben erledigen, können Anwendungen die Aufgaben abgeben, Noten festlegen, Aufgaben von Schülern/Studenten anhängen und Aufgaben in entsprechenden Drive-Ordnern speichern.
  • Lehrkräfte können Aufgaben mit Add-on-Anhängen von Ihrer Website oder Anwendung erstellen.
  • Schüler/Studenten können ihre Aufgaben mit Ihren Add-on-Anhängen abgeben.

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

In der Regel kann eine Anwendung nur Aufgaben bearbeiten, die sie selbst erstellt hat. Mit anderen Worten: Für alle API-Anfragen zum Bearbeiten von CourseWork muss dieselbe Google Cloud-Projekt-ID verwendet werden, die zum Erstellen von CourseWork verwendet wurde.

Für Google Classroom-Add-ons gilt eine Ausnahme von dieser Regel. Ein Cloud-Projekt kann auf alle Mitteilungen, Aufgaben oder Materialien zugreifen oder diese bearbeiten, die einen oder mehrere Add-on-Anhänge enthalten. Ein Cloud-Projekt kann auch eine Aufgabe abgeben, zurücknehmen oder zurückgeben, die einen oder mehrere Add-on-Anhänge enthält.

Für API-Anfragen sind auch die richtigen Nutzerbereiche scopes erforderlich. Lehrkräfte können Aufgaben ansehen, Aufgaben erstellen, Links an Aufgabenabgaben anhängen und Noten für Abgaben festlegen. Schüler/Studenten können Aufgaben ansehen, Links an ihre Aufgabenaufzeichnungen anhängen und ihre Abgaben abgeben und zurücknehmen. Domainadministratoren können CourseWork ansehen, haben aber keine Schreibberechtigungen.

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

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

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

Ja. In der Classroom-UI werden extern erstellte Aufgaben mit dem Produktnamen des Google Cloud-Projekts gekennzeichnet, mit dem die Aufgabe erstellt wurde. Nutzer können extern erstellte Aufgaben als unerwünscht melden und die Anwendung, mit der die Aufgabe erstellt wurde, trennen, indem sie alle Anmeldedaten widerrufen, die der Anwendung vom Nutzer ausgestellt wurden.

Schaltfläche zum Teilen von Inhalten in Classroom und andere Integrationen

Ich habe die Schaltfläche zum Teilen von Inhalten in Classroom bereits integriert. Kann ich eine Aufgabe bearbeiten, die mit der Schaltfläche zum Teilen erstellt wurde?

Noch nicht. Um eine Aufgabe zu bearbeiten, muss in der 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 bearbeiten.

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?

Nein, 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 das andere 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 zu bündeln. So kann ein einzelner Google Workspace Marketplace-Eintrag mehrere Add-ons darstellen. Wenn Sie über einen solchen Eintrag installieren, werden alle Add-ons im Bundle gleichzeitig installiert. Nutzer müssen bei der Autorisierung allen Bereichen zustimmen, die von den gebündelten Add-ons benötigt werden.

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 für 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 Titelleiste des iFrame für Classroom-Add-ons?

Die Titelleiste des iFrame unterstützt nur ein quadratisches Logo mit 32 × 32 Pixeln. Diese Wahl wurde getroffen, um der Favicon-Form zu entsprechen, die Unternehmen auf ihren Websites verwenden. Wir empfehlen, aus Gründen der Markenkonsistenz dasselbe Logo zu verwenden.

Domains

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

Domainadministratoren können festlegen, welche Lehrkräfte ein installiertes Add-on sehen können. Classroom-Add-ons können nur von Nutzern mit einer Teaching &Learning- oder Education Plus-Lizenz verwendet werden.

Wie interagieren Domainadministratoren mit Add-ons?

Domainadministratoren legen fest, wer Ihr Add-on verwenden kann. Sie können ein Add-on für eine gesamte Domain installieren, indem sie die Option zur Administratorinstallation verwenden. Wenn Ihr Add-on einzeln installiert werden kann, beachten Sie, dass die meisten Administratoren eine Zulassungsliste für Add-ons führen. Lehrkräfte, die auf dieser Liste stehen, können Add-ons selbst installieren. Ein Administrator kann Ihr Add-on auch einzeln installieren, um es zu testen.

Administratoren interessieren sich möglicherweise auch für Nutzungsstatistiken zu Ihrem Add-on. Wenn Ihr Produkt dies unterstützt, sollten Sie Nutzungsstatistiken für Add-ons in einer Administratoransicht auf Ihrer eigenen Website bereitstellen.

API

Wie kann ich zuverlässig feststellen, ob der Add-on-Inhalt in einem iFrame oder einem neuen Tab geladen wird?

Derzeit gibt es keine Methode, um zwischen den beiden zu unterscheiden.

Welche zuweisbaren Aufgaben erhalten ein iFrame zur Überprüfung von Aufgaben von Schülern/Studenten?

Das iFrame zur Überprüfung von Aufgaben von Schülern/Studenten ist nur für Anhänge vom Aktivitätstyp verfügbar. Rufen Sie die courses.courseWork.getAddOnContext Methode auf, um zu prüfen, ob der Beitrag typ Aufgaben von Schülern/Studenten unterstützt. Das Feld supportsStudentWork kann nur für einen Beitragstyp true sein, der eine Aktivität ist.

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

Ja. Sie können get oder patch jedes Announcement, CourseWork oder CourseWorkMaterial abrufen oder patchen, das mindestens einen Ihrer Add-on-Anhänge enthält. Sie können reclaim, return oder turnIn ein CourseWork StudentSubmission.

Einmalanmeldung (SSO)

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

Hat jeder Schüler/Student eine korrekt formatierte E-Mail-Adresse, auch wenn er keinen Zugriff auf Gmail hat?

Jeder Google Workspace for Education-Nutzer hat eine Google-Identität, unabhängig davon, ob er Zugriff auf Gmail hat. Identität und Zugriff auf einen bestimmten Google-Dienst (einschließlich Gmail) sind unterschiedlich. Auch wenn Gmail deaktiviert ist, können sich Schüler/Studenten mit ihrer E-Mail-Adresse in Classroom anmelden. Identitäten werden durch eine Nutzer-ID und eine E-Mail-Adresse dargestellt. Ein Google Workspace for Education-Nutzer kann seine E-Mail-Adresse ändern. Daher empfiehlt es sich, Nutzer-IDs als Primärschlüssel zu verwenden, wenn Sie Nutzerinformationen speichern.

Muss ein Schuladministrator die App vorab genehmigen, damit sich Schüler/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 in der Domain oder einer Organisationseinheit installieren.

Feedback und allgemeine Fragen

Wie kann ich Feature Requests einreichen oder Probleme melden?

Sie können Feature Requests in unserem öffentlichen Issue Tracker einreichen, ansehen und dafür abstimmen.

Wie erfahre ich, wann neue Funktionen in der Classroom API verfügbar sind?

Updates für die API werden im Newsletter für Entwickler 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.