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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אחרי שתכונות מגרסת טרום-השקה ישולבו ב-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).

משוב

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

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

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