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 استفاده می کند.

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

مولفه های
courseId

string

ضروری. شناسه دوره

itemId

string

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

attachmentId

string

ضروری. شناسه پیوست

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

مولفه های
postId

string

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

updateMask

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

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