Calendars

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

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

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

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}

प्रॉपर्टी का नाम	मान	ब्यौरा	नोट
autoAcceptInvitations	boolean	यह कैलेंडर, न्योते अपने-आप स्वीकार करता है या नहीं. यह सुविधा सिर्फ़ रिसॉर्स कैलेंडर के लिए उपलब्ध है.
conferenceProperties	nested object	इस कैलेंडर के लिए कॉन्फ़्रेंसिंग प्रॉपर्टी. जैसे, किस तरह की कॉन्फ़्रेंस की अनुमति है.
conferenceProperties.allowedConferenceSolutionTypes[]	list	इस कैलेंडर के लिए, कॉन्फ़्रेंस के किन समाधानों का इस्तेमाल किया जा सकता है. संभावित वैल्यू ये हैं: "eventHangout" "eventNamedHangout" "hangoutsMeet" ज़रूरी नहीं.
dataOwner	string	कैलेंडर के मालिक का ईमेल. यह सिर्फ़ सेकंडरी कैलेंडर के लिए सेट किया जाता है. सिर्फ़ पढ़ने के लिए.
description	string	कैलेंडर की जानकारी. ज़रूरी नहीं.	लिखा जा सकता है
etag	etag	संसाधन का ETag.
id	string	कैलेंडर का आइडेंटिफ़ायर. आईडी पाने के लिए, calendarList.list() तरीके का इस्तेमाल करें.
kind	string	संसाधन का टाइप ("calendar#calendar").
location	string	कैलेंडर की भौगोलिक जगह. इसे किसी भी फ़ॉर्मैट में लिखा जा सकता है. ज़रूरी नहीं.	लिखा जा सकता है
summary	string	कैलेंडर का टाइटल.	लिखा जा सकता है
timeZone	string	कैलेंडर का टाइम ज़ोन. (इसे आईएएनए टाइम ज़ोन डेटाबेस के नाम के फ़ॉर्मैट में लिखा जाता है. जैसे, "Europe/Zurich".) ज़रूरी नहीं.	लिखा जा सकता है

तरीके

clear

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

delete

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

get

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

insert

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

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

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

patch

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

transferOwnership

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

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

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

update

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