Häufig gestellte Fragen

KursArbeit in Classroom ansehen, erstellen und ändern

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

Mit den neuen Endpunkte können Entwickler die Aufgaben in einem Kurs ansehen und verwalten. Genauer gesagt: können Sie Folgendes tun:

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

Einige beispielhafte Anwendungsfälle für CourseWork:

• Notenbücher, SIS oder Berichterstellungssysteme können Aufgaben und Noten von Classroom zu ihren Anwendungen hinzufügen, sodass manuelle Daten überflüssig werden. Übertragung
• Mithilfe von Lernanwendungen können neue Aufgaben erstellt werden, die im Kurs angezeigt werden. . Wenn die Schüler oder Studenten eine Aufgabe erledigen, können Anwendungen diese abgeben, Aufgaben von Schülern/Studenten anhängen und sie an geeigneten Stellen Google Drive-Ordner.
• Lehrkräfte können Aufgaben mit Add-on-Anhängen über Ihr Website oder App.
• Schüler/Studenten können ihre Aufgaben mit Ihrem Add-on abgeben Anhänge.

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

In der Regel kann eine Anwendung nur erstellte Arbeiten ändern. Mit anderen Worten: Für Anfragen einer Assignment Mutation API muss dieselbe Google Cloud-Projekt-ID verwendet werden, wurde zum Zeitpunkt der Aufgabenerstellung gespeichert.

Für Google Classroom-Add-ons gilt eine Ausnahme von dieser Regel. A Cloud-Projekt kann auf alle Ankündigungen, Aufgaben oder Material mit einem oder mehreren Add-on-Anhängen. A Cloud-Projekt kann auch Aufgaben abgeben, zurückfordern oder zurückgeben, die hat mindestens eines seiner Add-on-Anhänge.

Für API-Anfragen sind außerdem die richtigen Nutzerbereiche erforderlich. Lehrkräfte dürfen ansehen Aufgaben erstellen, Links zu abgegebenen Aufgaben anhängen und abgegebenen Aufgaben benoten. Schüler/Studenten können sich Aufgaben ansehen und Links an ihre Aufgabenaufzeichnungen zu erstellen, eingereichte Aufgaben einzureichen und zurückzufordern. Domain Administratoren können CourseWork ansehen, haben aber keine Schreibberechtigungen.

Welche Arten von Elementen kann meine Bewerbung an Aufgaben 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 mit meiner Anwendung erstellt wurde?

Ja. Die Classroom-Benutzeroberfläche identifiziert extern erstellte Aufgaben unter Verwendung des Produktnamens des Google Cloud-Projekts, in dem die Arbeit erstellt wurde. Nutzer können extern erstellte Arbeit als unerwünscht melden und die die das Werk erstellt hat, indem es alle Anmeldedaten, die an die Anwendung durch den Nutzer.

Schaltfläche zum Teilen von Inhalten 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 dieselbe Google Cloud-Anwendung verwenden Projekt erstellen, über das die Aufgabe erstellt wurde.

Kann ich Fragen in der API beantworten?

Noch nicht. Sie können Fragen erstellen und ändern. Fragen beantworten Programmatik in unserer Roadmap.

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. Du brauchst 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 keine zwei Google Workspace Marketplace-Einträge für einen für ein einzelnes Google Cloud-Projekt.

Es ist jedoch möglich, Add-ons zu bündeln. Dadurch kann eine einzelne Person Google Workspace Marketplace-Eintrag, der mehrere Add-ons repräsentiert. Installieren aus einem solchen Eintrag würden dann alle Add-ons im Bundle einmal. Nutzer müssen allen Bereichen zustimmen, die von gebündelten Add-ons benötigt werden bei der Autorisierung an.

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 Das Google Cloud-Projekt des Classroom-Add-ons funktioniert nicht. Zugriffstokens die von einem anderen Google Cloud-Projekt generiert wurden, von der Classroom API abgelehnt werden. 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 unterstützt nur quadratische Logos im Format 32 x 32. Dieses wurde an die Favicon-Form angepasst, die die Unternehmen auf ihren Websites verwenden. und es ist unsere Empfehlung, im Raum für 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 das Add-on installiert haben. Classroom-Add-ons können nur von Nutzern verwendet werden mit einer Lehrkraft und Learning- oder Education Plus-Lizenz.

Wie interagieren Domainadministratoren mit Add-ons?

Domainadministratoren (Administratoren) legen fest, wer Ihr Add-on verwenden kann. Sie können Installation eines Add-ons für eine gesamte Domain mithilfe des Administrators . Wenn Ihr Add-on einzeln installiert werden kann, beachten Sie, dass die meisten Administratoren haben eine Add-on-Zulassungsliste. können Lehrkräfte Add-ons für die auf dieser Liste stehen. Ein Administrator kann auch Installieren Sie das Add-on zu Testzwecken einzeln.

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

API

Wie lässt sich zuverlässig feststellen, ob die Partnerseite innerhalb eines iFrames oder eines Pop-out-Tabs geladen wird?

Es gibt keine aktuelle Methode, um zwischen den beiden zu unterscheiden.

Welche zuweisbaren Aufgaben erhalten einen iFrame mit der Aufgabe „Aufgaben von Schülern/Studenten“?

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 festzustellen, ob der Beitrag die Aufgaben von Schülern/Studenten unterstützt. Das Feld „supportsStudentWork“ darf nur true enthalten für den Beitragstyp "Aktivität".

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

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

Einmalanmeldung (SSO)

Können Schüler und Studenten, die sich mit Clever-Abzeichen oder Classlink auf ihrem Chromebook anmelden, die Google-Anmeldung verwenden?

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

Hat jeder Schüler oder Student eine richtig 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 von unabhängig davon, ob sie Zugriff auf Gmail haben. Identitäten werden durch eine E-Mail-Adresse repräsentiert Adresse. Identität und Zugriff auf einen bestimmten Google-Dienst (einschließlich Gmail) unterscheiden. Selbst wenn Gmail deaktiviert ist, können sich Schüler und Studenten mit ihre E-Mail-Adresse.

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

Domainadministratoren müssen Add-ons auf die Zulassungsliste setzen, bevor sie installiert werden können. Optional können Domain-Administratoren ein Add-on für alle Nutzer im Domain oder einer Organisationseinheit gehören.

Feedback und allgemeine Fragen

Wie kann ich Funktionsanfragen stellen oder Probleme anfragen?

Sie können Funktionsanfragen in unserer öffentlichen Ausgabe Tracker.

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

API-Updates werden auf der Seite mit den Versionshinweisen und in unserem Entwicklerforum veröffentlicht. und in der öffentlichen Problemverfolgung.

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

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