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

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

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

अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ 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".) ज़रूरी नहीं. लिखा जा सकता है

जवाब

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

इसे आज़माएं!

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