Ścieżka dewelopera

Poniżej znajdziesz krótkie omówienie kroków, które należy wykonać podczas tworzenia dodatku do Classroom.

Ważne: aby otrzymywać informacje o dodatkach i interfejsie Google Classroom API, zasubskrybuj grupę ogłoszeń dla deweloperów Google for Education.

Wprowadzenie

1. Użytkownicy testowi muszą korzystać z wersji Google Workspace for Education Teaching and Learning lub Plus. Jeśli nie masz dostępu administracyjnego do domeny Google Workspace for Education z dowolną z tych licencji, wykonaj czynności opisane w sekcji Uzyskiwanie domeny testowej dla deweloperów, a następnie prześlij formularz prośby o przejście na wyższą wersję domeny. Domena zostanie skonfigurowana z 10 licencjami Google Workspace for Education Plus.

2. Utwórz projekt Google Cloud. Użyjesz go do skonfigurowania dodatku, wysyłania żądań do interfejsu API oraz uwierzytelniania i autoryzowania użytkowników. Możesz też użyć istniejącego projektu w chmurze.

   Ostrzeżenie: zwróć szczególną uwagę na Widoczność aplikacji. To ustawienie określa, czy dodatek będzie dostępny dla użytkowników końcowych. Nie można go zmienić później.

3. Utwórz konta nauczycieli i uczniów na potrzeby testów. Gdy licencja zostanie zatwierdzona dla domeny demonstracyjnej, przypisz miejsca na każdym z kont testowych.

4. Skonfiguruj OAuth w projekcie.

5. Utwórz stronę aplikacji w Google Workspace Marketplace dla projektu demonstracyjnego.

   • Jeśli ustawisz widoczność aplikacji na publiczną, dodaj adresy e-mail wszystkich testerów do listy Testerzy wersji roboczej. Gdy skończysz, wybierz ZAPISZ PROJEKT.
   Ważne: projekt w stanie wersja robocza umożliwia wyświetlanie podglądu i testowanie zmian przed ich opublikowaniem. Więcej informacji o tej funkcji znajdziesz w artykule Aktualizowanie strony aplikacji za pomocą wersji roboczych.

6. Zaloguj się w domenie demonstracyjnej jako użytkownik testowy. Zainstaluj dodatek z adresu URL aplikacji w konfiguracji informacji o aplikacji w Google Workspace Marketplace.

Programowanie

7. Utwórz dodatek i przetestuj go z użytkownikami testowymi.

Publikowanie

8. W projekcie Google Cloud, który chcesz opublikować:
   1. Ekran zgody OAuth:
      1. Typ użytkownika: Zewnętrzny
      2. Stan publikacji: w produkcji
      3. Zakresy: skonfiguruj wszystkie zakresy żądane przez aplikację internetową.
   2. Ekran konfiguracji aplikacji w pakiecie SDK Google Workspace Marketplace:
      1. Widoczność aplikacji: publiczna
      2. Typ strony: Niepubliczna
      3. Zakresy: skonfiguruj wszystkie zakresy żądane przez aplikację internetową.
9. Utwórz listę w Google Workspace Marketplace dla projektu publicznego. Dodaj swoje konta użytkowników testowych jako testerów wersji roboczej SDK Marketplace. Zapisz zmiany jako wersję roboczą.
10. Zaktualizuj publiczny projekt za pomocą kodu dodatku.
11. Jako tester wersji roboczej zainstaluj dodatek, otwierając adres URL jego strony w Marketplace.
12. Prześlij prośbę o weryfikację OAuth dotyczącą publicznego projektu. Musisz nagrać krótki film, w którym zademonstrujesz użycie zakresów dodatków na jednym z kont testowych wersji roboczych.
13. Publikuj publiczny dodatek do sprawdzenia w Marketplace.
14. Po zatwierdzeniu zmień stan na stronie pakietu SDK w Marketplace na listed (wyświetlany).

Wymagane integracje

Aby utworzyć dodatek do Classroom, musisz wykonać te czynności.

1. Logowanie jednokrotne w Google

   • Platforma Google Identity. Google oferuje różne opcje uwierzytelniania.
   • Studia przypadków integracji.

   Informacje o wdrażaniu logowania bez zgłaszania błędów znajdziesz na stronie poświęconej logowaniu bez zgłaszania błędów.

2. Przesyłanie do Google Workspace Marketplace jako dodatku do Classroom

3. Implementacje iframe

   • Odkrywanie załączników
   • Widok nauczyciela
   • Widok ucznia
   • Sprawdzanie prac uczniów. Iframe z oceną pracy ucznia jest wymagany tylko wtedy, gdy załącznik zawiera załącznik typu aktywność.

Google Workspace Marketplace

Google Workspace Marketplace to miejsce, w którym znajdziesz aplikacje dla firm, które można dodać do całej domeny lub do poszczególnych kont Google Workspace. Marketplace jest zintegrowany z konsolą administracyjną Google, dzięki czemu administratorzy domen mogą szybko znajdować, instalować i autoryzować aplikacje dla wybranych użytkowników.

Oto kilka kluczowych pojęć, które warto znać:

• Działanie i wymagania OAuth.
• Dokumentacja dla deweloperów Google Workspace Marketplace.
• sekcja edukacji w Google Workspace Marketplace;