فرادادههای افزونههای Classroom را در زمینه یک پست خاص دریافت میکند.
برای حفظ یکپارچگی داده ها و مدل مجوزهای خود، یک افزونه باید این را فراخوانی کند تا پارامترهای پرس و جو و نقش کاربر درخواست کننده را هر زمان که افزونه در iframe باز می شود، تأیید کند.
اختیاری. منسوخ شده است، به جای آن از itemId استفاده کنید.
پارامترهای پرس و جو
مولفه های
itemId
string
شناسه اعلامیه، courseWork، یا courseWorkMaterial که پیوست تحت آن پیوست شده است. این فیلد الزامی است، اما زمانی که ما از postId مهاجرت می کنیم، به این صورت علامت گذاری نمی شود.
addOnToken
string
اختیاری. رمزی که درخواست را تأیید می کند.
هنگامی که کاربر از Classroom به URL افزونه هدایت می شود، این رمز به عنوان یک پارامتر پرس و جو ارسال می شود.
زمانی که هیچ یک از موارد زیر صحیح نباشد، کد مجوز لازم است:
این افزونه دارای پیوست هایی در پست است.
پروژه توسعه دهنده ای که درخواست را صادر می کند، همان پروژه ای است که پست را ایجاد کرده است.
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از AddOnContext است.