Method: courses.courseWork.studentSubmissions.return

ارسالی دانشجو را برمی گرداند.

بازگرداندن ارسال دانشجو، مالکیت فایل‌های Drive پیوست شده را به دانش‌آموز منتقل می‌کند و همچنین ممکن است وضعیت ارسال را به‌روزرسانی کند. برخلاف برنامه Classroom، برگرداندن ارسالی دانش‌آموز، assignedGrade را روی مقدار draftGrade تنظیم نمی‌کند.

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

این درخواست باید توسط پروژه Developer Console از شناسه مشتری OAuth که برای ایجاد مورد کار دوره مربوطه استفاده می‌شود، انجام شود.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED اگر کاربر درخواست کننده اجازه دسترسی به دوره یا کار دوره درخواستی را نداشته باشد، ارسالی دانشجوی درخواستی را برگرداند، یا برای خطاهای دسترسی .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • NOT_FOUND اگر دوره درخواستی، کار دوره، یا ارسال دانشجو وجود نداشته باشد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
courseId

string

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

courseWorkId

string

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

id

string

شناسه ارسال دانشجو.

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.

محدوده مجوز

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

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

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