Ta strona zawiera informacje o nadchodzących funkcjach interfejsu Classroom API oraz szczegóły dotyczące udziału w wersji testowej dla deweloperów.
Podgląd interfejsu Classroom API
Wersja zapoznawcza funkcji interfejsu Classroom API daje deweloperom możliwość wpływania na kształt funkcji za pomocą opinii i uzyskiwania gotowych integracji do publicznego użytku przed udostępnieniem interfejsu na skalę ogólną.
Cykl życia podglądu
Deweloperzy mogą włączyć wersje interfejsu API, które zawierają nowe funkcje zgodne z poprzednimi wersjami. Te „wersje podglądu” są dostępne publicznie przez co najmniej 90 dni. W zależności od opinii wersja w wersji próbnej i jej funkcje zostaną następnie włączone do istniejącego interfejsu API w wersji 1. Wersje w wersji zapoznawczej pozostaną dostępne przez co najmniej 90 dni, zanim zostaną wyłączone.
Jeśli opinie na temat wersji w wersji próbnej są na tyle istotne, że wymagają wprowadzenia zmian, tworzona jest nowa wersja, która będzie obsługiwać dotychczasowe funkcje. Obie wersje są dostępne przez co najmniej 90 dni, aby umożliwić deweloperom migrację. Zasubskrybuj listę adresową Classroom API Developer Preview, aby otrzymywać informacje o zmianach w wersji przedpremierowej, i zasubskrybuj listę ogłoszeń, aby otrzymywać ogólne informacje o aktualizacjach interfejsu Classroom API.
Uczestniczenie w wersji testowej interfejsu Classroom API
Aby wziąć udział w programie, dołącz do Programu testowania wersji dla deweloperów Google Workspace. Dostępne funkcje w Publicznej wersji przedpremierowej są wymienione w aktywnej wersji przedpremierowej Google Workspace. Jeśli testujesz prywatną wersję funkcji, możesz nie znaleźć jej w żadnej dokumentacji publicznej.
Nadchodzące funkcje
Oto nasz plan rozwoju funkcji interfejsu API i ich harmonogram. Jest ona aktualizowana okresowo.
Wartość wersji podglądu to przewidywana data początkowej dostępności wersji w ramach podglądu. Aby dowiedzieć się, jak używać wersji w podglądzie, zapoznaj się z artykułem Dostęp do interfejsów API w wersji podglądu.
| Funkcja | Opis | Docelowy format podglądu | Docelowy cel w GA | Wersja podglądu |
|---|---|---|---|---|
| Okresy oceniania | Tworzenie, odczytywanie, aktualizowanie i usuwanie okresów oceniania w imieniu administratorów i nauczycieli. | I połowa 2024 r. | TBD |
V1_20240401_PREVIEW |
| Możliwości użytkownika | Sprawdź, czy użytkownik ma dostęp do określonych funkcji Classroom. | IV kwartał 2024 r. | I poł. 2025 r. | V1_20240930_PREVIEW |
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 migrację przed wyłączeniem wersji w podglądzie.
| Funkcja | Opis | Wbudowane w GA | Docelowa data wyłączenia wersji przedpremierowej | Wersja podglądu |
|---|---|---|---|---|
| Operacje CRUD na ocenach cząstkowych | Tworzenie, odczytywanie, aktualizowanie i usuwanie kart oceny w Classroom w imieniu nauczycieli. | 5 grudnia 2024 r. | 1 kwietnia 2025 r. | V1_20231110_PREVIEW |
Wskazówki dotyczące migracji
Gdy funkcje z wersji wstępnej zostaną włączone do interfejsu API w wersji 1, usuń argument previewVersion z powiązanych wywołań interfejsu API, aby aplikacja nadal działała prawidłowo. Jeśli np. korzystasz z funkcji tworzenia kryteriów wprowadzonych w wersji V1_20231110_PREVIEW, wywołania interfejsu API mogły 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 przejść na interfejs GA API w wersji 1, usuń argument previewVersion:
rubric = service.courses().courseWork().rubrics().create(
courseId=course_id, courseWorkId=coursework_id, body=body,
).execute()
Jeśli używasz generowanej statycznie biblioteki klienta w celu uzyskania dostępu do danej funkcji wersji w podglądzie, a nie korzystasz z innych funkcji interfejsu API w podglądzie, przejdź do domyślnej biblioteki klienta dla danego języka. Więcej informacji znajdziesz w artykule Dostęp do interfejsów API w wersji testowej.
Prześlij opinię
Przesyłaj opinie na temat funkcji w wersji próbnej za pomocą połączonego narzędzia IssueTracker w sekcji aktywne wersje próbne dla deweloperów na stronie przeglądu programu Google Workspace Developer Preview.
Korzystanie z funkcji Classroom API w wersji podglądu w środowisku produkcyjnym
Jeśli chcesz korzystać z funkcji interfejsu Classroom API w wersji testowej z użytkownikami końcowymi, w tym z prawdziwymi nauczycielami, administratorami lub uczniami, musisz zaakceptować poprawkę dotyczącą Classroom do Warunków programu Google Workspace dla deweloperów. Aby to zrobić, wypełnij i prześlij ten formularz: