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
  • learningGoals

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

enum (PreviewVersion)

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

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

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

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

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

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

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

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

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

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