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

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

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

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

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

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

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

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

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

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

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

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

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

הערה: התאריכים בתוכנית הם יעדים, ועשויים להשתנות. באופן דומה, יכול להיות שמזהי גרסאות של תצוגה מקדימה לא מייצגים את התאריך המדויק שבו הגרסה זמינה.

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

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

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

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

תכונה	תיאור	שילוב ב-GA	תאריך סגירת התצוגה המקדימה של היעד	Preview Version
Rubrics CRUD	ליצור, לקרוא, לעדכן ולמחוק קריטריונים להערכה בכיתה בשם המורים.	5 בדצמבר 2024	1 באפריל 2025	V1_20231110_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()

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

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

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

משוב

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

שימוש בתכונות של Classroom API בתצוגה המקדימה בסביבת הייצור

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