תצוגה מקדימה של תכונות ומפת דרכים

בדף הזה מפורטות תכונות חדשות שצפויות ב-Classroom API, ומוסבר איך להשתתף בגרסת טרום-השקה למפתחים.

תצוגה מקדימה של Classroom API

התצוגה המקדימה של תכונות Classroom API מאפשרת למפתחים להשפיע על פיתוח התכונות באמצעות משוב, ולהכין שילובים לשימוש ציבורי לפני שהתכונות יהיו זמינות לכלל המשתמשים.

תצוגה מקדימה של מחזור החיים

מפתחים יכולים להצטרף לגרסאות של ה-API שמכילות תכונות חדשות שתואמות לאחור. הגרסאות האלה של התצוגה המקדימה זמינות לציבור למשך 90 יום לפחות. בהתאם למשוב שנקבל, גרסת הטרום-השקה והתכונות שלה ישולבו בגרסה הקיימת של API v1. גרסאות התצוגה המקדימה יישארו זמינות למשך 90 ימים לפחות לפני שיושבתו.

אם המשוב על גרסת טרום-השקה מספיק משמעותי כדי לדרוש שינויים שעלולים לשבור את התאימות לאחור, תיצור גרסה חדשה שתתמוך ביכולות הקיימות. שתי הגרסאות זמינות למשך 90 יום לפחות כדי לאפשר למפתחים לבצע העברה. כדי להתעדכן בשינויים בגרסת ה-Preview, אפשר להירשם לרשימת התפוצה של Classroom API Developer Preview. כדי לקבל עדכונים כלליים יותר לגבי Classroom API, אפשר להירשם לרשימת התפוצה של ההודעות.

השתתפות בגרסאות טרום-השקה של Classroom API

כדי להשתתף, צריך להצטרף לתוכנית ההפצה המקדימה למפתחים של Google Workspace. תכונות בתוכנית Public Preview שזמינות מפורטות בגרסאות טרום-השקה פעילות למפתחים של Google Workspace. אם אתם בודקים תכונת תצוגה מקדימה פרטית, יכול להיות שהתכונה לא תופיע באף מסמך ציבורי.

תכונות חדשות שיושקו בקרוב

זוהי מפת הדרכים שלנו לתכונות API צפויות ולוחות הזמנים שלהן. הוא מתעדכן מעת לעת.

הערך של גרסת התצוגה המקדימה מייצג את התאריך הצפוי של הזמינות הראשונית של התצוגה המקדימה של הגרסה. במאמר גישה ל-API בגרסת טרום-השקה מוסבר איך משתמשים בגרסאות טרום-השקה.

תכונה	תיאור	יעד לתצוגה מקדימה	יעד ל-GA	Preview Version
יכולות משתמש	בודקים אם למשתמש יש גישה לתכונות מסוימות ב-Classroom.	רבעון 4 של שנת 2024	2025 H1	`V1_20240930_PREVIEW`
קבוצות תלמידים	ניהול של קבוצות תלמידים והחברים בהן בשם האדמינים והמורים.	רבעון 3 של שנת 2025	טרם נקבע	`V1_20250630_PREVIEW`

גרסאות קודמות

אחרי שתכונות חדשות עוברות אימות, הן משולבות ב-API בגרסה 1 וגרסת התצוגה המקדימה המתאימה מושבתת. למפתחים יש לפחות 90 יום להעביר את האפליקציות לפני שגרסת התצוגה המקדימה תושבת.

תכונה	תיאור	משולב ב-GA	תאריך הפסקת התצוגה המקדימה של היעד	Preview Version
Rubrics CRUD	יצירה, קריאה, עדכון ומחיקה של קריטריונים להערכה בכיתה בשם המורים.	‫2024 Dec 05	‫2025 Apr 1	`V1_20231110_PREVIEW`
תקופות למתן ציונים	יצירה, קריאה, עדכון ומחיקה של תקופות למתן ציונים בשם אדמינים ומורים.	2025 Apr 8	‫2025 Aug 1	`V1_20240401_PREVIEW`

הנחיות להעברה

אחרי שתכונות מגרסת טרום-השקה ישולבו ב-API בגרסה 1, צריך להסיר את הארגומנט previewVersion מקריאות ה-API שקשורות אליהן כדי לוודא שהאפליקציה תמשיך להתנהג כצפוי. לדוגמה, אם ניגשתם ליכולות ליצירת קריטריונים להערכה שהוצגו בגרסה V1_20231110_PREVIEW, יכול להיות שהקריאות ל-API נראו כך:

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()

כדי לעבור ל-API בגרסת GA‏ v1, מסירים את הארגומנט previewVersion:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

אם השתמשתם בספריית לקוח שנוצרה באופן סטטי במיוחד כדי לגשת לתכונה מסוימת בגרסת טרום-השקה, ואתם לא משתמשים בתכונות אחרות של API בגרסת טרום-השקה, עברו לספריית הלקוח שמוגדרת כברירת מחדל לשפה שלכם. מידע נוסף זמין במאמר בנושא גישה לממשקי API בגרסת טרום-השקה.

משוב

אפשר לשתף משוב על תכונות בתצוגה מקדימה דרך הכלי IssueTracker שמקושר בקטע תצוגות מקדימות פעילות למפתחים בדף הסקירה הכללית של תוכנית התצוגה המקדימה למפתחים של Google Workspace.

שימוש בתכונות של Classroom API בגרסת Preview בסביבת ייצור

אם אתם רוצים להשתמש בתכונות של Classroom API בגרסת טרום-השקה עם משתמשי קצה, כולל מורים, אדמינים או תלמידים אמיתיים, אתם צריכים להסכים לתיקון ספציפי ל-Classroom בתנאים של תוכנית טרום-ההשקה למפתחים של Google Workspace. כדי לעשות זאת, צריך למלא את הטופס הזה ולשלוח אותו: