Method: courses.courseWorkMaterials.patch

यह कोर्स वर्क के किसी मटीरियल के एक या उससे ज़्यादा फ़ील्ड को अपडेट करता है.

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

  • अगर अनुरोध करने वाले डेवलपर प्रोजेक्ट को ऐक्सेस करने में गड़बड़ियां होती हैं, तो PERMISSION_DENIED.
  • अगर अनुरोध गलत तरीके से किया गया है, तो INVALID_ARGUMENT.
  • अगर अनुरोध किया गया कोर्स वर्क मटीरियल पहले ही मिटा दिया गया है, तो FAILED_PRECONDITION.
  • अगर अनुरोध किया गया कोर्स या कोर्स वर्क मटीरियल मौजूद नहीं है, तो NOT_FOUND

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
courseId

string

कोर्स का आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, Classroom से असाइन किया गया आइडेंटिफ़ायर या कोई alias हो सकता है.
id

string

कोर्स वर्क मटीरियल का आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

मास्क, जिससे यह पता चलता है कि कोर्स वर्क मटीरियल के किन फ़ील्ड को अपडेट करना है. अपडेट करने के लिए, यह फ़ील्ड ज़रूरी है. अगर गलत फ़ील्ड की जानकारी दी जाती है, तो अपडेट नहीं हो पाता. अगर किसी फ़ील्ड में खाली वैल्यू डाली जा सकती है, तो उसे अपडेट मास्क में डालकर और कोर्स वर्क मटीरियल ऑब्जेक्ट में शामिल न करके, साफ़ किया जा सकता है. अगर किसी ऐसे फ़ील्ड को अपडेट मास्क में शामिल किया जाता है जिसमें खाली वैल्यू नहीं डाली जा सकती और उसे कोर्स वर्क मटीरियल ऑब्जेक्ट में सेट नहीं किया जाता, तो INVALID_ARGUMENT गड़बड़ी दिखती है.

शिक्षक, ये फ़ील्ड तय कर सकते हैं:

  • title
  • description
  • state
  • scheduledTime
  • topicId

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एंडपॉइंट का प्रीव्यू वर्शन.

PREVIEW_VERSION_9001 में नई सुविधाएं शामिल हैं: * मटीरियल को अपडेट किया जा सकता है. मटीरियल को अपडेट करने के लिए, "materials" अपडेटमास्क का इस्तेमाल करें. अनुरोध के CourseWorkMaterial ऑब्जेक्ट में दिया गया मटीरियल, मौजूदा सूची की जगह लेगा. मटीरियल फ़ील्ड को अपडेट मास्क में "materials" डालकर और CourseWorkMaterial ऑब्जेक्ट में शामिल न करके, साफ़ किया जा सकता है. फ़िलहाल, PUBLISHED CourseWorkMaterial को अपडेट नहीं किया जा सकता.

अनुरोध का मुख्य हिस्सा

अनुरोध के मुख्य भाग में CourseWorkMaterial का उदाहरण है.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में CourseWorkMaterial का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.