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
किसी कैलेंडर का मेटाडेटा अपडेट करता है.