Method: courses.courseWork.studentSubmissions.reclaim

از طرف دانش‌آموزی که مالک آن است، یک درخواست دانش‌آموز را پس می‌گیرد.

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

فقط دانشجویی که مالک درخواست ارسال دانشجو است، می‌تواند این متد را فراخوانی کند، و فقط برای دانشجویی که درخواستش ارسال شده است.

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

این متد کدهای خطای زیر را برمی‌گرداند:

  • اگر کاربر درخواست‌کننده اجازه دسترسی به دوره یا تکالیف دوره درخواستی، لغو ارسال درخواستی دانشجو یا خطاهای دسترسی را نداشته باشد، PERMISSION_DENIED داده می‌شود.
  • اگر فرم ارسالی دانش‌آموز تحویل داده نشده باشد، FAILED_PRECONDITION .
  • اگر درخواست ناقص باشد، INVALID_ARGUMENT .
  • اگر دوره، کار دوره یا ارائه دانشجو درخواستی وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
courseId

string

شناسه دوره. این شناسه می‌تواند شناسه اختصاص داده شده توسط کلاس درس یا یک alias باشد.

courseWorkId

string

شناسه‌ی کار دوره.

id

string

شناسه‌ی ارائه‌ی دانشجو.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ یک شیء JSON خالی خواهد بود.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.coursework.me

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.