Calendars: update

किसी कैलेंडर का मेटाडेटा अपडेट करता है. इसे अभी आज़माएं.

अनुरोध

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

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
पाथ पैरामीटर
calendarId string कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी वापस पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको लॉग इन किए हुए उपयोगकर्ता के मुख्य कैलेंडर को ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति लेना ज़रूरी है:

दायरा
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

ज़्यादा जानकारी के लिए, पुष्टि और अनुमति पेज देखें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ कैलेंडर संसाधन दें:

प्रॉपर्टी का नाम वैल्यू ब्यौरा नोट
वैकल्पिक प्रॉपर्टी
description string कैलेंडर की जानकारी. ज़रूरी नहीं. लिखा जा सकता है
labelProperties nested object इस कैलेंडर पर तय की गई लेबल प्रॉपर्टी. अगर इसकी वैल्यू दी जाती है, तो यह मौजूदा लेबल प्रॉपर्टी को ओवरराइट कर देता है. अगर कोई वैल्यू नहीं दी जाती है, तो लेबल की प्रॉपर्टी में कोई बदलाव नहीं होता है. लिखा जा सकता है
labelProperties.eventLabels[] list इस कैलेंडर पर तय किए गए इवेंट के लेबल. अगर कैलेंडर अपडेट करते समय यह मौजूद है, तो यह मौजूदा इवेंट लेबल की जगह ले लेगा.

नया इवेंट लेबल जोड़ने के लिए, सूची को बड़ा करें. साथ ही, कैलेंडर से किसी लेबल को मिटाने के लिए, सूची से इकाइयों को हटाएं.

हर कैलेंडर में ज़्यादा से ज़्यादा 200 लेबल हो सकते हैं.

 लिखा जा सकता है
labelProperties.eventLabels[].backgroundColor string लेबल के बैकग्राउंड का रंग हेक्साडेसिमल फ़ॉर्मैट में होना चाहिए, जैसे कि "#039be5". इस लेबल वाले इवेंट, इस रंग में दिखते हैं. ज़रूरी है. लिखा जा सकता है
labelProperties.eventLabels[].id string लेबल का आईडी. नया लेबल डालते समय ज़रूरी नहीं है. अगर यह जानकारी नहीं दी जाती है, तो एक यूनीक आईडी जनरेट किया जाएगा. लेबल अपडेट करते समय इसकी ज़रूरत होती है.

अगर आईडी दिया गया है, तो वह कैलेंडर में यूनीक होना चाहिए और यूयूआईडी फ़ॉर्मैट के मुताबिक होना चाहिए.

 लिखा जा सकता है
labelProperties.eventLabels[].name string लेबल का नाम. ज़रूरी नहीं.

अगर यह जानकारी दी जाती है, तो इसमें ज़्यादा से ज़्यादा 50 वर्ण होने चाहिए.

 लिखा जा सकता है
location string कैलेंडर की भौगोलिक जगह की जानकारी, फ़्री-फ़ॉर्म टेक्स्ट के तौर पर. ज़रूरी नहीं. लिखा जा सकता है
summary string कैलेंडर का टाइटल. लिखा जा सकता है
timeZone string कैलेंडर का टाइम ज़ोन. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) ज़रूरी नहीं. लिखा जा सकता है
workingHours object इससे उपयोगकर्ता के काम के घंटों की जानकारी मिलती है. यह सुविधा, Google Workspace उपयोगकर्ताओं के प्राइमरी कैलेंडर के लिए ही उपलब्ध है. काम के घंटे अपडेट करने के लिए, काम के घंटे का पूरा ऑब्जेक्ट पास करना होगा. अगर कोई जानकारी नहीं दी गई है (या शून्य या खाली ऑब्जेक्ट के तौर पर पास किया गया है), तो काम के मौजूदा घंटों में कोई बदलाव नहीं होगा. काम के घंटे बंद करने या शेड्यूल मिटाने के लिए, workingHoursEnabled को 'गलत' पर सेट करें. साथ ही, availableTimes को छोड़ दें या खाली सूची पास करें. लिखा जा सकता है
workingHours.availableTimes[] list काम के घंटे. उपलब्धता की हर अवधि, उपयोगकर्ता के काम के घंटों के ब्लॉक को दिखाती है. लिखा जा सकता है
workingHours.availableTimes[].dayOfWeek string हफ़्ते का दिन. ज़रूरी है. संभावित वैल्यू ये हैं:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
लिखा जा सकता है
workingHours.availableTimes[].periodEnd integer दिन के शुरू होने के बाद से, मिनटों में अवधि खत्म होने का समय. इसमें आखिरी मिनट शामिल नहीं होता. ज़रूरी है. लिखा जा सकता है
workingHours.availableTimes[].periodStart integer दिन की शुरुआत से लेकर मिनटों में, अवधि की शुरुआत. इसमें दिन की शुरुआत का समय शामिल है. ज़रूरी है. लिखा जा सकता है
workingHours.workingHoursEnabled boolean इस कैलेंडर के लिए, काम के घंटे दिखाने की सुविधा चालू है या नहीं. availableTimes के खाली होने पर, इसे 'सही है' पर सेट नहीं किया जा सकता. लिखा जा सकता है

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में कैलेंडर संसाधन दिखता है.

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए APIs Explorer का इस्तेमाल करें.