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

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

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

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

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

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

אם המשוב על גרסת טרום-השקה מספיק משמעותי כדי לדרוש שינויים שעלולים לשבור את התאימות לאחור, נוצרת גרסה חדשה שתומכת ביכולות הקיימות. שתי הגרסאות זמינות למשך 90 יום לפחות כדי לאפשר למפתחים לבצע העברה. כדי להתעדכן בשינויים בגרסת הטרום-השקה, אפשר להצטרף לרשימת התפוצה 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 של שנת 2026 רבעון 4 של שנת 2026 V1_20260316_PREVIEW

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

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

תכונה תיאור משולב ב-GA תאריך הפסקת התצוגה המקדימה של היעד Preview Version
Rubrics CRUD יצירה, קריאה, עדכון ומחיקה של קריטריונים להערכה בכיתה בשם המורים. ‫2024 Dec 05 ‫2025-04-01 V1_20231110_PREVIEW
תקופות למתן ציונים יצירה, קריאה, עדכון ומחיקה של תקופות למתן ציונים בשם אדמינים ומורים. ‫2025 Apr 08 ‫2025 Aug 01 V1_20240401_PREVIEW
קבוצות תלמידים ניהול של קבוצות תלמידים והחברים בהן בשם האדמינים והמורים. ‫26 בינואר 2026 ‫2026 Jun 01 V1_20250630_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 בגרסה 1 של GA, מסירים את הארגומנט previewVersion:

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

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

משוב

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

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

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