Na tej stronie znajdziesz informacje o nadchodzących funkcjach interfejsu Classroom API oraz szczegóły dotyczące udziału w wersji przedpremierowej dla deweloperów.
Wyświetlanie podglądu interfejsu Classroom API
Wersje zapoznawcze funkcji interfejsu Classroom API dają deweloperom możliwość wpływania na kształt rozwoju funkcji dzięki przekazywanym opiniom oraz przygotowania integracji do publicznego użytku przed udostępnieniem ich ogółowi użytkowników.
Cykl życia wersji podglądowej
Deweloperzy mogą włączyć wersje interfejsu API, które zawierają nowe, wstecznie zgodne funkcje. Te „wersje przedpremierowe” są dostępne publicznie przez co najmniej 90 dni. Na podstawie opinii wersja przedpremierowa i jej funkcje są następnie włączane do istniejącego interfejsu API w wersji 1. Wersje podglądowe pozostaną dostępne przez co najmniej kolejne 90 dni, zanim zostaną wyłączone.
Jeśli opinie o wersji podglądowej są na tyle mocne, że wymagają wprowadzenia zmian powodujących niezgodność wsteczną, tworzymy nową wersję, która obsługuje dotychczasowe funkcje. Obie wersje są dostępne przez co najmniej 90 dni, aby umożliwić deweloperom migrację. Zapisz się na listę adresową Classroom API Developer Preview, aby otrzymywać informacje o zmianach w wersji zapoznawczej, i zasubskrybuj listę ogłoszeń, aby otrzymywać bardziej ogólne aktualizacje interfejsu Classroom API.
Uczestniczenie w testach interfejsu Classroom API
Aby wziąć udział w programie, dołącz do Programu testowania aktualizacji dla deweloperów Google Workspace. Dostępne funkcje w Publicznej wersji przedpremierowej są wymienione w aktywnych wersjach przedpremierowych dla deweloperów Google Workspace. Jeśli testujesz funkcję w ramach prywatnego programu testów, może ona nie być wymieniona w żadnej publicznej dokumentacji.
Nadchodzące funkcje
To nasza mapa drogowa z oczekiwanymi funkcjami interfejsu API i ich harmonogramami. Jest on okresowo aktualizowany.
Wartość wersji testowej to oczekiwana data udostępnienia wstępnej wersji testowej. Więcej informacji o korzystaniu z wersji testowych znajdziesz w artykule Uzyskiwanie dostępu do interfejsów API w wersji testowej.
| Funkcja | Opis | Miejsce docelowe podglądu | Cel w GA | Wersja podglądu |
|---|---|---|---|---|
| Możliwości użytkownika | Sprawdź, czy użytkownik ma dostęp do określonych funkcji Classroom. | IV kwartał 2024 r. | Pierwsza połowa 2025 r. | V1_20240930_PREVIEW |
| Grupy uczniów | zarządzać grupami uczniów i ich członkami w imieniu administratorów i nauczycieli; | III kwartał 2025 r. | Do ustalenia | Do ustalenia |
Poprzednie wersje
Po zweryfikowaniu nowych funkcji są one włączane do interfejsu API w wersji 1, a odpowiednia wersja w wersji zapoznawczej jest wyłączana. Deweloperzy mają co najmniej 90 dni na przeprowadzenie migracji, zanim wersja podglądowa zostanie wyłączona.
| Funkcja | Opis | Włączone w Google Analytics | Docelowa data wyłączenia wersji przedpremierowej | Wersja podglądu |
|---|---|---|---|---|
| CRUD ocen cząstkowych | Tworzenie, odczytywanie, aktualizowanie i usuwanie rubryk zajęć w imieniu nauczycieli. | 2024 Dec 05 | 1 kwietnia 2025 r. | V1_20231110_PREVIEW |
| Okresy oceniania | Tworzenie, odczytywanie, aktualizowanie i usuwanie okresów oceniania w imieniu administratorów i nauczycieli. | 2025 Apr 8 | 1 sierpnia 2025 r. | V1_20240401_PREVIEW |
Wskazówki dotyczące migracji
Gdy funkcje z wersji przedpremierowej zostaną włączone do interfejsu API w wersji 1, usuń argument previewVersion z powiązanych wywołań interfejsu API, aby mieć pewność, że aplikacja nadal będzie działać zgodnie z oczekiwaniami. Jeśli na przykład korzystasz z funkcji tworzenia rubryk wprowadzonych w wersji V1_20231110_PREVIEW, wywołania interfejsu API mogą wyglądać tak:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
# Specify the preview version. Rubrics CRUD capabilities are
# supported in V1_20231110_PREVIEW and later.
previewVersion="V1_20231110_PREVIEW"
).execute()
Aby przeprowadzić migrację do interfejsu API w wersji 1 GA, usuń argument previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Jeśli używasz statycznie generowanej biblioteki klienta przeznaczonej specjalnie do uzyskiwania dostępu do funkcji w wersji podglądowej i nie korzystasz z innych funkcji interfejsu API w wersji podglądowej, przejdź na domyślną bibliotekę klienta w swoim języku. Więcej informacji znajdziesz w artykule Dostęp do interfejsów API w wersji testowej.
Prześlij opinię
Przesyłaj opinie o funkcjach próbnych za pomocą linku do narzędzia IssueTracker w sekcji aktywnych wersji próbnych dla deweloperów na stronie przeglądu programu wersji próbnych Google Workspace dla deweloperów.
Korzystanie z funkcji testowych interfejsu Classroom API w środowisku produkcyjnym
Jeśli chcesz korzystać z funkcji wersji przedpremierowej interfejsu Classroom API z użytkownikami, w tym z nauczycielami, administratorami lub uczniami, musisz zaakceptować dodatek do Warunków programu wersji przedpremierowej Google Workspace dla deweloperów dotyczący Classroom. Aby to zrobić, wypełnij i prześlij ten formularz: