Method: courses.patch

কোর্সের এক বা একাধিক ফিল্ড আপডেট করে।

এই পদ্ধতিটি নিম্নলিখিত ত্রুটি কোডগুলি ফেরত দেয়:

  • অনুরোধকারী ব্যবহারকারীর অনুরোধকৃত কোর্সটি পরিবর্তন করার অনুমতি না থাকলে অথবা অ্যাক্সেস সংক্রান্ত ত্রুটির ক্ষেত্রে PERMISSION_DENIED ।
  • অনুরোধকৃত আইডি দিয়ে কোনো কোর্স বিদ্যমান না থাকলে NOT_FOUND ।
  • আপডেট মাস্কে অবৈধ ফিল্ড নির্দিষ্ট করা থাকলে অথবা কোনো আপডেট মাস্ক সরবরাহ করা না হলে INVALID_ARGUMENT ।
  • নিম্নলিখিত অনুরোধ ত্রুটিগুলির জন্য FAILED_PRECONDITION :
    • কোর্স পরিবর্তনযোগ্য নয়
    • নিষ্ক্রিয় কোর্স মালিক
    • অযোগ্য মালিক
    • কোর্সের শিরোনামে ইউআরএল থাকতে পারে না

HTTP অনুরোধ

PATCH https://classroom.googleapis.com/v1/courses/{id}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
id

string

যে কোর্সটি আপডেট করতে হবে তার শনাক্তকারী। এই শনাক্তকারীটি ক্লাসরুম-নির্ধারিত শনাক্তকারী অথবা একটি alias হতে পারে।

কোয়েরি প্যারামিটার

প্যারামিটার
updateMask

string ( FieldMask format)

কোর্সের কোন ফিল্ডগুলো আপডেট করতে হবে তা চিহ্নিত করার জন্য মাস্ক। আপডেট করার জন্য এই ফিল্ডটি আবশ্যক। ভুল ফিল্ড উল্লেখ করলে আপডেটটি ব্যর্থ হবে। নিম্নলিখিত ফিল্ডগুলো বৈধ:

  • courseState
  • description
  • descriptionHeading
  • name
  • ownerId
  • room
  • section
  • subject
  • learningStandardSettings
  • levels

দ্রষ্টব্য: ownerId-তে করা পরিবর্তনগুলো তাৎক্ষণিকভাবে কার্যকর বলে গণ্য করা হয়, কিন্তু বাস্তবে প্রভাবিত সমস্ত রিসোর্সের মালিকানা হস্তান্তর সম্পন্ন হতে কিছুটা সময় লাগতে পারে।

কোয়েরি প্যারামিটারে সেট করা হলে, এই ফিল্ডটি নিম্নরূপে নির্দিষ্ট করতে হবে

updateMask=<field1>,<field2>,...

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

previewVersion

enum ( PreviewVersion )

ঐচ্ছিক। এপিআই-এর প্রিভিউ সংস্করণ। প্রিভিউ প্রোগ্রামে ডেভেলপারদের জন্য উপলব্ধ করা নতুন এপিআই সক্ষমতাগুলো অ্যাক্সেস করার জন্য এটি অবশ্যই সেট করতে হবে।

অনুরোধকারী শরীর

অনুরোধের বডিতে Course এর একটি ইনস্ট্যান্স থাকে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Course এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.courses

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।