Google Cloud-Projektkonfiguration

Auf dieser Seite finden Sie Informationen zum Erstellen und Konfigurieren von Google Cloud-Projekten für Classroom-Add-ons. Google Cloud-Projekte werden verwendet, um die Google-Einmalanmeldung über OAuth 2.0 (Google SSO) zu implementieren, Anfragen Ihres Add-ons zu autorisieren und den Eintrag eines Add-ons im Google Workspace Marketplace zu verwalten.

Allgemeine Informationen zum Veröffentlichen eines Add-ons im Marketplace finden Sie unter App veröffentlichen.

Google Cloud-Projekt erstellen

Wichtig: Die Sichtbarkeit Ihrer Produktions-Add-on-Anwendung muss im Google Workspace Marketplace SDK auf öffentlich festgelegt sein. Ein privates Projekt kann für die Entwicklung und das Testen Ihres Add-ons nützlich sein, aber nur ein öffentliches Projekt ist erforderlich.

Es gibt zwei Arten von Projekten: ein privates Projekt, das für die Entwicklung verwendet wird, und ein öffentliches Projekt, das von Endnutzern aufgerufen werden kann. Die Labels „öffentlich“ und „privat“ beziehen sich auf die Sichtbarkeit Ihrer Anwendung im Google Workspace Marketplace. Eine private Marketplace-Anwendung kann nur von Nutzern in der Domain installiert werden, in der sie erstellt wurde, während eine öffentliche Marketplace-Anwendung für jede Google Workspace-Domain verfügbar ist. Es müssen zwei separate Anwendungen sein, da ein Projekt nicht gleichzeitig öffentlich und privat sein kann. Öffentliche Anwendungen müssen überprüft und genehmigt werden, bevor sie im Marketplace verfügbar sind.

Wichtig: Sie können ein privates Projekt nicht in ein öffentliches Projekt umwandeln.

Allgemeine Informationen zum Erstellen von Google Cloud-Projekten finden Sie unter Google Cloud-Projekt erstellen.

Öffentliches Google Cloud-Projekt erstellen

Dieses Projekt stellt die Add-on-Anwendung dar, auf die Administratoren, Lehrkräfte und Schüler/Studenten zugreifen können. Ein öffentliches Projekt muss vom Google Workspace Marketplace-Team geprüft und genehmigt werden, bevor es veröffentlicht oder installiert werden kann.

1. Erstellen Sie ein neues Google Cloud-Projekt in Ihrer Produktionsdomain.

   Google Cloud-Projekt erstellen

   Wichtig:Das Projekt muss zu Ihrer Produktionsdomain gehören und Sie müssen als Nutzer dieser Domain in der Google Cloud Console angemeldet sein.
   Warnung:Sie müssen die Draft-Version Ihres Projekts für den Test verwenden. Derzeit ist die Funktion „Entwurf“ nur über das Google Workspace-Entwickler-Vorabprogramm verfügbar. Nachdem Sie Ihr Cloud-Projekt erstellt haben, füllen Sie das Antragsformular aus, um die Funktionen des Google Workspace-Entwickler-Vorabprogramms zu aktivieren. Weitere Informationen finden Sie unter App-Eintrag mit Entwürfen aktualisieren.

2. Aktivieren Sie die Classroom API in Ihrem Cloud-Projekt.

   Classroom API aktivieren

3. Aktivieren Sie das Google Workspace Marketplace SDK in Ihrem Cloud-Projekt.

   Google Workspace Marketplace SDK aktivieren

4. Legen Sie im Marketplace SDK unter App-Konfiguration die App-Sichtbarkeit auf Öffentlich fest und klicken Sie das Kästchen Nicht gelistet an.

   Wichtiger Hinweis: Sie können ein privates Projekt, das bei der internen Entwicklung und Tests verwendet wurde, nicht freigeben oder konvertieren.
   Wichtiger Hinweis: Nicht aufgeführte Apps können im Google Workspace Marketplace nicht durch Stöbern oder Suchen gefunden werden. In der Marketplace SDK-Konfiguration finden Sie eine direkte URL, über die das Add-on installiert werden kann. Nur Google und der Entwickler können den Store-Eintrag finden. Ihre App sollte erst veröffentlicht werden, wenn Sie sie der Allgemeinheit präsentieren möchten. Sie können festlegen, ob ein Add-on auf der Seite „App-Konfiguration“ des Marketplace SDK aufgeführt werden soll.

5. Füllen Sie die Pflichtfelder auf der Seite Store-Eintrag des Marketplace SDK aus und klicken Sie auf PUBLISH (VERÖFFENTLICHEN).

6. Ihre App wird vom Google Workspace Marketplace-Team geprüft. Sie kommunizieren mit Ihnen über die im Marketplace SDK angegebene E-Mail-Adresse des Entwicklers. Entfernen Sie nach der Genehmigung das Häkchen aus dem Kästchen Nicht gelistet, damit Lehrkräfte und Administratoren die App im Marketplace finden können.

Privates Google Cloud-Projekt erstellen

Dieses private Projekt stellt die Add-on-Anwendung dar, die für die Entwicklung verwendet wird. Sie ist für Nutzer außerhalb der Domain, in der sie erstellt wurde, nicht zugänglich, muss aber vor der Installation nicht genehmigt werden. Google empfiehlt daher, dieses Projekt zu verwenden, um Ihr Add-on in einer kontrollierten Umgebung zu entwickeln und zu testen.

Sie benötigen Zugriff auf eine Google Workspace for Education-Domain mit der Teaching and Learning- oder Plus-Lizenz, um ein privates Projekt zu erstellen. Wenn Sie noch keinen Zugriff auf eine solche Domain haben, folgen Sie dieser Anleitung, um eine Google Workspace for Education-Demodomain einzurichten, ein Upgrade auf eine Plus-Lizenz durchzuführen und der Domain Zugriff auf die Classroom Add-ons API zu gewähren:

1. Führen Sie die Schritte aus, um eine Entwicklertestdomain zu erhalten.

2. Erstellen Sie als Administrator in der Demodomain ein neues Google Cloud-Projekt.

   Google Cloud-Projekt erstellen

   Warnung :Das Projekt muss zur Demodomain gehören und Sie müssen mit einem Administratorkonto der Demodomain in der Google Cloud Console angemeldet sein.

   Wenn Sie nicht auf die Google Cloud Console zugreifen oder Cloud-Projekte erstellen können, prüfen Sie in der Admin-Konsole Folgendes:

   • Rufen Sie die Seite Kontoeinstellungen > Einstellungen für altersabhängigen Zugriff auf und wählen Sie die Option Alle Nutzer in dieser Gruppe oder Organisationseinheit sind mindestens 18 Jahre alt aus.
   • Gehen Sie unter Apps > Zusätzliche Google-Dienste so vor:
   • Die Google Cloud Platform ist für alle aktiviert.
   • Die Einstellungen für die Projekterstellung sind Nutzer dürfen Projekte erstellen.
   • Die Cloud Shell-Zugriffseinstellungen sind Zugriff auf Cloud Shell erlauben.

3. Füllen Sie das Antragsformular für das Upgrade einer Demodomain aus und senden Sie es ab. Wenn Sie dieses Formular einreichen, wird Google gebeten, Ihre Demodomain auf Google Workspace for Education Plus mit zehn Lizenzen umzustellen und Ihrem Cloud-Projekt Zugriff auf die Classroom Add-ons API zu gewähren.

   Sie erhalten eine E-Mail, sobald die Umstellung und die Aufnahme in die Zulassungsliste abgeschlossen sind. Weisen Sie Ihren Testlehrkraftkonten in der Admin-Konsole Plus-Lizenzen zu. Erstellen oder wählen Sie unter Verzeichnis > Nutzer die Konten der Testlehrkräfte aus. Prüfen Sie unter Lizenzen für jeden Lehrer, ob Google Workspace for Education Plus zugewiesen ist.

4. Aktivieren Sie die Classroom API in Ihrem Cloud-Projekt.

   Classroom API aktivieren

5. Aktivieren Sie das Google Workspace Marketplace SDK in Ihrem Cloud-Projekt.

   Google Workspace Marketplace SDK aktivieren

6. Legen Sie für das Marketplace SDK unter App-Konfiguration die App-Sichtbarkeit auf privat fest.

7. Füllen Sie die Pflichtfelder auf der Seite Store-Eintrag des Marketplace SDK aus und klicken Sie auf PUBLISH (VERÖFFENTLICHEN). Nachdem der App-Eintrag veröffentlicht wurde, können Nutzer in der Domain die App im Google Workspace Marketplace finden und installieren oder die App-URL aufrufen, die auf der Seite des Store-Eintrags angezeigt wird.

oauth 2.0

Für den Zugriff auf die Classroom API ist die Einwilligung zum Zugriff auf Nutzerdaten erforderlich. Sie werden durch Anfordern des Google-Zugriffs auf OAuth-Bereiche für den angemeldeten Nutzer und Empfang eines Tokens erhalten, mit dem anschließend API-Aufrufe an Google Classroom gesendet werden können. Die Bereiche müssen im Store-Eintrag des Google Workspace Marketplace konfiguriert werden, damit der Domainadministrator im Namen seiner Domainnutzer die Einwilligung erteilen kann, wenn er das Add-on installiert.

Wichtig: Wenn Ihr Add-on zusätzliche Bereiche anfordert, fügen Sie diese auf dem OAuth-Bildschirm für die Einwilligung, auf dem Tab „App-Konfiguration“ des Marketplace SDK und im Anwendungscode Ihres Add-ons hinzu. Nicht übereinstimmende Bereiche an diesen Stellen können bei der Installation von Add-ons zu Problemen für Nutzer führen.

Da Classroom-Bereiche vertraulich sind, müssen Sie vor der Veröffentlichung Ihres Add-ons die OAuth-Bestätigung beantragen. Andernfalls wird Nutzern eine Warnung angezeigt, dass die Anwendung nicht bestätigt wurde, und nur eine kleine Anzahl von Nutzern kann auf Ihr Produkt zugreifen. Weitere Informationen zur Überprüfung finden Sie in der Übersicht über die Überprüfungsabfolge.

Warnung :Wenn Sie ein vorhandenes Google Cloud-Projekt für die Entwicklung eines Add-ons verwenden, fordern Sie die neuen Zugriffsbereiche im Code für vorhandene Produkte erst an, nachdem die Überprüfung abgeschlossen ist. Verwenden Sie einen separaten Autorisierungsablauf, eine Testumgebung oder legen Sie ein Feature-Flag fest, um diese Zugriffsbereiche nur für die zu Ihren Add-ons gehörenden Routen anzufordern, bevor Sie die Bestätigung abschließen.

Auf der Seite OAuth-Bereiche für Google APIs finden Sie eine detaillierte Liste aller verfügbaren Bereiche und ihrer Verwendung. Allgemeine Informationen zur OAuth-Konfiguration finden Sie in der Workspace-Dokumentation auf der Seite OAuth konfigurieren.

Nutzerberechtigungen

Ihre Webanwendung sollte mindestens einen der folgenden Gültigkeitsbereiche anfordern:

• https://www.googleapis.com/auth/userinfo.email, mit dem eine Anwendung die E-Mail-Adresse des Nutzers abrufen kann.
• https://www.googleapis.com/auth/userinfo.profile, über die eine App personenbezogene Daten wie ein Porträt, den Vor- und Nachnamen sowie andere personenbezogene Daten sehen kann, die der Nutzer öffentlich zugänglich gemacht hat.

Nachdem ein Nutzer einen dieser Bereiche in Ihrem Add-on autorisiert hat, wird er über den Abfrageparameter login_hint identifiziert. Dieser Parameter wird an alle URLs Ihrer Web-App übergeben, wenn ein iFrame geöffnet wird. Wenn ein Nutzer keinen dieser Bereiche autorisiert hat, wird login_hint nicht gesendet.

Warnung: Ihre App muss mindestens einen der Bereiche userinfo.email oder userinfo.profile anfordern, um login_hint bei nachfolgenden Besuchen desselben Nutzers zu erhalten.

login_hint ist ein Standard-OpenID Connect-Parameter, den Sie optional an Google weitergeben können, wenn Sie Google Log-in verwenden oder ein OAuth-Token anfordern. Sie soll die Autorisierung für den Endnutzer vereinfachen.

Bereiche für Classroom-Add-ons

Die folgenden Zugriffsbereiche gelten speziell für Classroom-Add-ons:

• https://www.googleapis.com/auth/classroom.addons.teacher, mit dem Sie auf alle API-Methoden zugreifen können.
• https://www.googleapis.com/auth/classroom.addons.student, die den Zugriff auf die Validierung des Starts und das Lesen von Anhängen ermöglicht.

Auch wenn ein gültiges OAuth-Zugriffstoken die Anmeldedaten des Nutzers angibt, sind API-Aufrufe an zusätzliche Anforderungen gebunden:

• Für alle Methoden muss der Nutzer eine Lehrkraft oder ein Schüler/Student im Kurs sein, der durch das courseId in der Anfrage angegeben ist.
• Zum Erstellen, Aktualisieren, Löschen und Zurückgeben von Noten müssen Nutzer Lehrkräfte sein.
• Aufrufe eines bestimmten Google Classroom-Beitrags sind an die folgenden Prüfungen gebunden.
  • Wenn ein Add-on bereits mindestens einen Anhang in einem Beitrag hat, kann es Anfragen für Folgendes stellen:
    • Validierung der iFrame-Einrichtung
    • Lese-, Aktualisierungs- und Löschvorgänge für Anhänge
    • Notenaktualisierungen für diesen Beitrag
  • Wenn der Attachment Discovery-Iframe zum ersten Mal geöffnet wird, hat das Add-on möglicherweise noch keinen Anhang für den Beitrag. Es wird ein Abfrageparameter addOnToken bereitgestellt, mit dem Anfragen für Folgendes gestellt werden können:
    • Einen Anhang unter dem Beitrag erstellen (addOnToken erforderlich)
    • Validierung des Starts (addOnToken wird validiert, wenn angegeben, und ist erforderlich, wenn für das Add-on kein Anhang im Beitrag vorhanden ist)

OAuth-Überprüfung

Hinweis: Sie können kein Demovideo erstellen, das Sie im Rahmen der OAuth-Bestätigung einreichen können. Veröffentlichen Sie das Add-on stattdessen ohne OAuth-Bestätigung. Dadurch wird das Google Workspace Marketplace-Überprüfungsteam benachrichtigt, ein Demovideo in Ihrem Namen zu erstellen. Das Überprüfungsteam stellt Ihnen dann das Video zur Verfügung, damit Sie es in Ihre OAuth-Bestätigung einreichen können.

Ein Classroom-Add-on verwendet Google APIs, um auf die Daten von Google-Nutzern zuzugreifen.

• Bestätigen Sie Ihre Markenidentität.
• Sensible OAuth-Bereiche überprüfen

Weitere Informationen zum Überprüfungsprozess finden Sie in den häufig gestellten Fragen zur OAuth API-Überprüfung.

Google Workspace Marketplace-Eintrag

Warnung: Nachdem Sie die Sichtbarkeitsoption während des Veröffentlichungsvorgangs gespeichert haben, können Sie Ihre Auswahl nicht mehr ändern.

Allgemeine Informationen zur Konfiguration des Google Workspace Marketplace SDK finden Sie unter Google Workspace Marketplace SDK aktivieren und konfigurieren und Google Workspace Marketplace-Store-Eintrag erstellen.

Hinweise zu Einträgen

Im Marketplace SDK Store-Eintrag Ihres öffentlichen Google Cloud-Projekts werden der Name und die Beschreibungen Ihrer Anwendung für Endnutzer angegeben. Sie können diese Details unter App-Details in mehreren Sprachen angeben.

Beachten Sie dabei die folgenden Richtlinien:

• Unter App-Details:

  • Verwenden Sie im Namen der Anwendung keine Satzzeichen. Verwenden Sie beispielsweise Mein Add-on von Mein Unternehmen anstelle von „Mein Unternehmen: Mein Add-on“ oder „Mein Add-on von Mein Unternehmen“.

  • Die Kurzbeschreibung und die Detaillierte Beschreibung dürfen nicht genau denselben Text enthalten.

  + Achten Sie darauf, dass Sie einen Wert für das Feld Preise ausgewählt haben. Dieses Feld enthält die Optionen Kostenlos, Mit einem kostenlosen Testzeitraum bezahlt, Mit kostenlosen Funktionen bezahlt und Bezahlt. Sie müssen den Kostenbetrag nicht im Marketplace-Eintrag angeben.

  • Achten Sie darauf, dass Sie einen Wert für das Feld Kategorie ausgewählt haben. Bildungsressourcen oder Tools für Lehrkräfte und Administratoren sind gute Optionen für ein Classroom-Add-on.

  • Weitere Informationen finden Sie in den App-Details im Marketplace.

Wichtig :Prüfen Sie die App-Details für jede Sprache, in der Sie Ihr Add-on anbieten.

• Unter Grafikinhalte:

  • Alle bereitgestellten Grafik-Assets sind scharf und entsprechen den in den Google Workspace Marketplace-Standards angegebenen Größen.

  • Alle bereitgestellten Screenshots müssen die Verwendung des Add-ons korrekt darstellen.

• Unter Supportlinks:

  • Sie müssen einen Link zu den Nutzungsbedingungen Ihrer App angeben.

• Achten Sie darauf, dass Sie die Branding-Richtlinien für Google APIs einhalten, die zulässige Namen und Beschreibungen umfassen.

• Wenn Sie in Ihrem Eintrag auf Google-Produkte verweisen, verwenden Sie den Namen im Format, das in der Liste der Marken angegeben ist. Geben Sie gegebenenfalls das Markensymbol (™) an. Verwenden Sie „Google Docs™“, nicht „Google Docs“.

Lizenz- und Abrechnungsdienste von Google einbinden

Wenn Sie Ihre Google Workspace Marketplace-Anwendungen in die Lizenz- und Abrechnungsdienste von Google einbinden möchten, besuchen Sie die Marketplace API.

Installationseinstellungen

Add-ons können neben der Installation durch Administratoren auch die individuelle Installation zulassen. Auf dieser Seite werden einige Unterschiede zwischen den beiden Installationstypen hervorgehoben. Es ist nicht beabsichtigt, für einen der beiden Installationstypen zu werben. Sie können auf der Seite App-Konfiguration des Google Workspace Marketplace SDK festlegen, ob die individuelle Installation zulässig ist.

Administrator installation

Mit Administratorinstallationen können Administratoren allen Konten in einer Domain oder bestimmten Zugriffsgruppen oder Organisationseinheiten ein Add-on hinzufügen. Nur Domainadministratoren können eine Administratorinstallation ausführen. Der Administrator kann optional im Namen aller Nutzer in der Domain allen Zugriffsbereichen zustimmen. In diesem Fall werden die Nutzer nicht aufgefordert, einer Einwilligung zuzustimmen.

Im Folgenden finden Sie einige Hinweise zur Installation durch Administratoren.

• Strengere Kontrollen Administratoren können einschränken, welche Nutzer auf ein Add-on zugreifen dürfen.
• Kompatibilität mit der Lizenzierung Wenn für Ihre Anwendung eine Lizenz erforderlich ist, kann die Installation über einen Administrator dazu beitragen, dass Lizenzen ordnungsgemäß an die entsprechende Bildungseinrichtung verteilt und verwendet werden.
• Weniger Aufwand für Endnutzer. Eine Administratorinstallation reduziert den Einrichtungsaufwand für Lehrkräfte und Schüler oder Studenten. Das kann zu einer besseren Nutzerfreundlichkeit mit weniger Klicks und weniger Verwirrung führen.

Weitere Informationen zu Administratorinstallationen finden Sie unter Marketplace-Apps in Ihrer Domain installieren. Unter Funktionsweise der Organisationsstruktur erfahren Sie mehr über Organisationseinheiten und Zugriffsgruppen.

Individuelle Installation

Bei individuellen Installationen wird dem Konto des Nutzers ein Add-on hinzugefügt. Der Nutzer wird während der Installation aufgefordert, den Zugriffsbereichen des Add-ons zuzustimmen.

Im Folgenden finden Sie einige Hinweise zur individuellen Installation.

• Einführung erleichtern Mehr Nutzer können Ihr Add-on im Google Workspace Marketplace sehen und installieren. Wenn Sie die individuelle Installation zulassen, werden möglicherweise mehr Lehrkräfte Ihr Produkt verwenden oder dafür werben.
• Administratortests Ein Administrator kann ein Add-on einzeln installieren, um es zu testen oder zu bewerten, bevor er es für eine größere Gruppe genehmigt oder installiert.

Administratoren können nicht nur Add-ons im Namen von Nutzern installieren, sondern auch eine Zulassungsliste führen, mit der Nutzer Add-ons installieren können, die eine individuelle Installation zulassen. Wenn sich ein Add-on nicht auf der Zulassungsliste befindet, sehen Nutzer zwar den Eintrag des Add-ons im Google Workspace Marketplace, können es aber nicht installieren. Stattdessen wird ihnen eine Meldung angezeigt, dass die Installation des Add-ons von einem Domainadministrator nicht zugelassen wurde. Weitere Informationen zu diesem Verhalten finden Sie im Hilfeartikel Google Workspace Marketplace-Apps auf der Zulassungsliste verwalten.

Weitere Informationen finden Sie in der Dokumentation zu den Installationseinstellungen im Google Workspace Marketplace.

App-Einbindung

Sie müssen im Feld Anhangeinrichtungs-URI eine Iframe-Start-URL angeben. Diese URL wird als iframe-src-Wert für den iframe für die Suche nach Anhängen verwendet. Über den Attachment Discovery-Iframe können Lehrkräfte Inhalte oder Aktivitäten finden, die sie an ihre Aufgabe anhängen können.

Außerdem müssen Sie alle URI-Präfixe angeben, von denen aus Anhänge über Ihr Add-on zulässig sind. Diese Funktion erhöht die Sicherheit, da Anhänge aus nicht autorisierten Quellen verhindert werden.

Weitere Informationen zu diesen Feldern finden Sie auf der Seite mit dem IFrame-Leitfaden.

Testkonten

Erstellen Sie Testkonten in Ihrer Demodomain, um das korrekte Verhalten Ihres privaten Add-ons zu überprüfen. Für den Test des Wechsels zwischen Schülern/Studenten im iframe für die Bewertung der Schüler-/Studentenarbeit sind zwei Schüler-/Studentenkonten erforderlich.

Vorgeschlagene Testkonten:

• Frau Schmitt, tammy.lehrer@<Ihre Demodomain>
• Sam Student, sam.student@<your demo domain>
• Sally Student, sally.student@<your demo domain>

So erstellen Sie ein neues Testkonto:

1. Melden Sie sich in der Admin-Konsole an.
2. Gehen Sie zu Nutzer.
3. Klicken Sie auf Neuen Nutzer hinzufügen (siehe Abbildung 1).
4. Geben Sie die Informationen des Nutzers ein und weisen Sie ihm die entsprechenden Rollen zu.

Abbildung 1 Speicherort des Links Neuen Nutzer hinzufügen in der Admin-Konsole

So erstellen Sie eine neue Testgruppe:

1. Melden Sie sich in der Admin-Konsole an.
2. Gehen Sie zu Gruppen.
3. Klicken Sie auf Gruppe erstellen (siehe Abbildung 2).
4. Geben Sie die Mitglieder und Inhaber der Gruppe ein.

Abbildung 2 Speicherort des Links Gruppe erstellen in der Admin-Konsole