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

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

پیش‌نمایش API کلاس درس

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

پیش‌نمایش چرخه حیات

توسعه‌دهندگان می‌توانند نسخه‌هایی از API را که حاوی ویژگی‌های جدید و سازگار با نسخه‌های قبلی هستند، انتخاب کنند. این «نسخه‌های پیش‌نمایش» حداقل به مدت ۹۰ روز به صورت عمومی در دسترس هستند. با توجه به بازخوردها، نسخه پیش‌نمایش و ویژگی‌های آن سپس در API نسخه ۱ موجود گنجانده می‌شوند. نسخه‌های پیش‌نمایش حداقل به مدت ۹۰ روز دیگر قبل از خاموش شدن در دسترس باقی می‌مانند.

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

در پیش‌نمایش‌های API کلاس درس شرکت کنید

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

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

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

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

نسخه‌های قبلی

پس از تأیید ویژگی‌های جدید، آن ویژگی در API نسخه ۱ گنجانده می‌شود و نسخه پیش‌نمایش مربوطه غیرفعال می‌شود. توسعه‌دهندگان حداقل ۹۰ روز فرصت دارند تا قبل از غیرفعال شدن نسخه پیش‌نمایش، به نسخه جدید مهاجرت کنند.

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

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

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

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

بازخورد

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

استفاده از ویژگی‌های پیش‌نمایش API کلاس درس در محیط عملیاتی

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