Method: courses.courseWork.addOnAttachments.patch

یک پیوست افزودنی را به روز می کند.

نیاز دارد که افزونه سازنده اصلی پیوست باشد.

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

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

درخواست HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}

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

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

پارامترها
course Id

string

مورد نیاز. شناسه دوره

item Id

string

شناسه پستی که پیوست زیر آن ضمیمه شده است.

attachment Id

string

مورد نیاز. شناسه پیوست

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

پارامترها
post Id

string

مورد نیاز. شناسه پستی که پیوست زیر آن ضمیمه شده است.

update Mask

string ( FieldMask format)

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

فیلدهای زیر ممکن است توسط معلمان مشخص شود:

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

درخواست بدن

بدنه درخواست شامل یک نمونه از AddOnAttachment است.

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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