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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי לעבור ל-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: