Calendars

सभी मौजूदा कैलेंडर का कलेक्शन. Calendars बनाम CalendarList भी देखें.

इस संसाधन के लिए तरीकों की सूची देखने के लिए, इस पेज के आखिर में जाएं.

संसाधन दिखाए जाने के तरीके

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean,
  "workingHours": {
    "workingHoursEnabled": boolean,
    "availableTimes": [
      {
        "dayOfWeek": string,
        "periodStart": integer,
        "periodEnd": integer
      }
    ]
  }
}

प्रॉपर्टी का नाम	वैल्यू	ब्यौरा	नोट
autoAcceptInvitations	boolean	क्या यह कैलेंडर, न्योते अपने-आप स्वीकार करता है. यह सिर्फ़ संसाधन कैलेंडर के लिए मान्य है.
conferenceProperties	nested object	इस कैलेंडर के लिए कॉन्फ़्रेंसिंग प्रॉपर्टी. उदाहरण के लिए, किस तरह की कॉन्फ़्रेंस की अनुमति है.
conferenceProperties.allowedConferenceSolutionTypes[]	list	इस कैलेंडर के लिए, कॉन्फ़्रेंसिंग के किस तरह के विकल्प इस्तेमाल किए जा सकते हैं. ये वैल्यू इस्तेमाल की जा सकती हैं: "eventHangout" "eventNamedHangout" "hangoutsMeet" ज़रूरी नहीं.
dataOwner	string	कैलेंडर के मालिक का ईमेल पता. इसे सिर्फ़ सेकंडरी कैलेंडर के लिए सेट किया जाता है. सिर्फ़ पढ़ने के लिए.
description	string	कैलेंडर की जानकारी. ज़रूरी नहीं.	लिखा जा सकता है
etag	etag	संसाधन का ई-टैग.
id	string	कैलेंडर का आइडेंटिफ़ायर. आईडी वापस पाने के लिए, calendarList.list() तरीके को कॉल करें.
kind	string	संसाधन का टाइप ("calendar#calendar").
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 को false पर सेट करें. साथ ही, 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 के खाली होने पर, इसे 'सही है' पर सेट नहीं किया जा सकता.	लिखा जा सकता है

तरीके

हटाएं

मुख्य कैलेंडर को मिटाता है. इस कार्रवाई से, किसी खाते के मुख्य कैलेंडर से जुड़े सभी इवेंट मिट जाते हैं.

मिटाएं

सेकंडरी कैलेंडर मिटाता है. मुख्य कैलेंडर के सभी इवेंट मिटाने के लिए, calendars.clear का इस्तेमाल करें.

get

यह फ़ंक्शन, किसी कैलेंडर का मेटाडेटा दिखाता है.

शामिल करें

सेकंडरी कैलेंडर बनाता है.

अनुरोध करने वाले उपयोगकर्ता को नए कैलेंडर के डेटा का मालिक बना दिया जाता है.

ध्यान दें: हमारा सुझाव है कि कैलेंडर के डेटा के मालिक के तौर पर पुष्टि करें. पूरे डोमेन के लोगों को डेटा का ऐक्सेस दें सुविधा का इस्तेमाल करके, ऐप्लिकेशन को किसी उपयोगकर्ता की ओर से काम करने की अनुमति दी जा सकती है. पुष्टि करने के लिए, सेवा खाते का इस्तेमाल न करें. अगर पुष्टि करने के लिए किसी सेवा खाते का इस्तेमाल किया जाता है, तो सेवा खाता ही डेटा का मालिक होता है. इससे, डेटा सोर्स के काम करने के तरीके में अनचाहे बदलाव हो सकते हैं. उदाहरण के लिए, अगर कोई सेवा खाता डेटा का मालिक है, तो डेटा का मालिकाना हक ट्रांसफ़र नहीं किया जा सकता.

patch

किसी कैलेंडर का मेटाडेटा अपडेट करता है. इस तरीके में, पैच सिमैंटिक का इस्तेमाल किया जा सकता है. ध्यान दें कि हर पैच अनुरोध में, कोटे की तीन यूनिट इस्तेमाल होती हैं. इसलिए, get के बाद update का इस्तेमाल करें. आपके दिए गए फ़ील्ड की वैल्यू, मौजूदा वैल्यू की जगह ले लेती हैं. अनुरोध में जिन फ़ील्ड की जानकारी नहीं दी जाती है उनमें कोई बदलाव नहीं होता. अगर अरे फ़ील्ड की जानकारी दी गई है, तो वे मौजूदा अरे को ओवरराइट कर देते हैं. इससे, अरे के पिछले सभी एलिमेंट खारिज हो जाते हैं.

transferOwnership

Google Workspace संगठन के उपयोगकर्ताओं के बीच सेकंडरी कैलेंडर ट्रांसफ़र करता है. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है. साथ ही, उसके पास कैलेंडर मैनेज करने का एडमिन अधिकार और इनमें से कोई एक अनुमति होनी चाहिए:

• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/calendar.calendars

अनुरोध में, useAdminAccess को true पर सेट करें. सेकंडरी कैलेंडर को ट्रांसफ़र करने के लिए, यह ज़रूरी है कि वह चालू हो. बंद या मिटाए गए कैलेंडर ट्रांसफ़र नहीं किए जा सकते.

अपडेट

किसी कैलेंडर का मेटाडेटा अपडेट करता है.