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

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

যখন একটি কোয়েরি প্যারামিটারে সেট করা হয়, তখন এই ক্ষেত্রটি এইভাবে নির্দিষ্ট করা উচিত

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

এটি সম্পূর্ণরূপে যোগ্য ক্ষেত্রগুলির নামের একটি কমা দ্বারা পৃথক তালিকা। উদাহরণ: "user.displayName,photo" ।

অনুরোধের মূল অংশ

অনুরোধের মূল অংশে Course এর একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া মূল অংশ

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

অনুমোদনের সুযোগ

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

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

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