ویژگی‌های پیش‌نمایش & نقشه راه

این صفحه حاوی اطلاعاتی درباره ویژگی‌های آتی برای API Classroom و جزئیات نحوه شرکت در پیش‌نمایش برنامه‌نویس است.

پیش نمایش Classroom API

پیش‌نمایش ویژگی‌های Classroom API فرصتی را برای توسعه‌دهندگان فراهم می‌کند تا بر شکل توسعه ویژگی‌ها با بازخورد تأثیر بگذارند و ادغام‌هایی را قبل از در دسترس بودن عمومی برای استفاده عمومی آماده کنند.

پیش نمایش چرخه عمر

توسعه‌دهندگان می‌توانند نسخه‌هایی از API را که حاوی ویژگی‌های جدید و سازگار با عقب هستند، انتخاب کنند. این "نسخه های پیش نمایش" حداقل به مدت 90 روز به صورت عمومی در دسترس هستند. با توجه به بازخورد، نسخه پیش‌نمایش و ویژگی‌های آن در API موجود v1 گنجانده می‌شود. نسخه‌های پیش‌نمایش حداقل تا 90 روز دیگر قبل از بسته شدن در دسترس باقی می‌مانند.

اگر بازخورد یک نسخه پیش‌نمایش آنقدر قوی باشد که نیاز به تغییرات قطعی داشته باشد، نسخه جدیدی برای پشتیبانی از قابلیت‌های موجود ایجاد می‌شود. هر دو نسخه حداقل به مدت 90 روز در دسترس هستند تا امکان مهاجرت توسعه دهندگان فراهم شود. به لیست پستی پیش‌نمایش برنامه‌نویس Classroom API بپیوندید تا از تغییرات پیش‌نمایش مطلع شوید و برای به‌روزرسانی‌های کلی‌تر API Classroom در فهرست اعلامیه مشترک شوید.

توجه: نسخه‌های پیش‌نمایش موقتی هستند در حالی که ویژگی‌ها برای در دسترس بودن عمومی در API v1 تأیید شده‌اند. رفتار نسخه پیش نمایش پس از بسته شدن در معرض تغییر است.

در پیش نمایش های Classroom API شرکت کنید

برای شرکت، به برنامه پیش‌نمایش برنامه‌نویس Google Workspace بپیوندید. ویژگی‌های پیش‌نمایش عمومی موجود در پیش‌نمایش‌های برنامه‌نویس فعال Google Workspace فهرست شده‌اند. اگر در حال آزمایش یک ویژگی پیش‌نمایش خصوصی هستید، ممکن است آن ویژگی را در هیچ سند عمومی فهرست نشده مشاهده کنید.

ویژگی های آینده

این نقشه راه ما از ویژگی های مورد انتظار API و جدول زمانی آنها است. به صورت دوره ای به روز می شود.

مقدار نسخه پیش نمایش تاریخ مورد انتظار برای در دسترس بودن پیش نمایش اولیه نسخه را نشان می دهد. برای آشنایی با نحوه استفاده از نسخه‌های پیش‌نمایش، به APIهای پیش‌نمایش Access مراجعه کنید.

توجه: تاریخ های نقشه راه هدف هستند و ممکن است در معرض تغییر باشند. به طور مشابه، شناسه های نسخه پیش نمایش ممکن است تاریخ دقیقی را که یک نسخه در دسترس است نشان ندهند.

ویژگی	توضیحات	هدف برای پیش نمایش	هدف برای GA	نسخه پیش نمایش
دوره های درجه بندی	ایجاد، خواندن، به روز رسانی و حذف دوره های درجه بندی از طرف مدیران و معلمان.	H1 2024	TBD	V1_20240401_PREVIEW
قابلیت های کاربر	بررسی کنید که آیا کاربر به برخی از ویژگی‌های Classroom دسترسی دارد یا خیر.	2024 Q4	H1 2025	V1_20240930_PREVIEW

نسخه های قبلی

هنگامی که ویژگی های جدید تأیید شد، ویژگی در API v1 گنجانده می شود و نسخه پیش نمایش مربوطه بسته می شود. توسعه دهندگان حداقل 90 روز فرصت دارند تا قبل از بسته شدن نسخه پیش نمایش، مهاجرت کنند.

مهم: تماس‌های API برای خاموش کردن نسخه‌های پیش‌نمایش ممکن است مطابق انتظار عمل نکنند. به طور کلی، تماس‌های API که نسخه‌های پیش‌نمایش پشتیبانی‌نشده را مشخص می‌کنند باید به‌طور خودکار با رفتار API v1 پاسخ دهند، اما توصیه می‌کنیم به طور فعال نسخه‌های API پیش‌نمایش خاموش کردن را انتقال دهید تا از اختلالات غیرمنتظره جلوگیری شود. برای کسب اطلاعات بیشتر به راهنمای مهاجرت مراجعه کنید.

ویژگی	توضیحات	در GA گنجانده شده است	تاریخ خاموش شدن پیش نمایش هدف	نسخه پیش نمایش
Rubrics CRUD	ایجاد، خواندن، به روز رسانی، و حذف روبریک های کلاس درس از طرف معلمان.	05 دسامبر 2024	1 آوریل 2025	V1_20231110_PREVIEW

راهنمایی مهاجرت

هنگامی که ویژگی‌های نسخه پیش‌نمایش در API v1 گنجانده شد، آرگومان 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 v1 GA، آرگومان previewVersion را حذف کنید:

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

اگر از یک کتابخانه سرویس گیرنده ایستا تولید شده به طور خاص برای دسترسی به ویژگی نسخه پیش نمایش داده شده استفاده می کردید، و از دیگر ویژگی های API پیش نمایش استفاده نمی کنید، به کتابخانه مشتری پیش فرض برای زبان خود بروید. برای اطلاعات بیشتر به دسترسی به APIهای پیش‌نمایش مراجعه کنید.

بازخورد

بازخورد خود را برای ویژگی‌های پیش‌نمایش از طریق IssueTracker مرتبط در بخش پیش‌نمایش‌های برنامه‌نویس فعال در صفحه مرور کلی برنامه پیش‌نمایش برنامه‌نویس Google Workspace به اشتراک بگذارید.

از ویژگی های پیش نمایش Classroom API در تولید استفاده کنید

اگر می‌خواهید از ویژگی‌های پیش‌نمایش Classroom API با کاربران نهایی، از جمله معلمان، سرپرستان یا دانش‌آموزان واقعی استفاده کنید، باید با تکمیل و ارسال این فرم، با اصلاحیه Classroom ویژه شرایط برنامه پیش‌نمایش برنامه‌نویس Google Workspace موافقت کنید. :