CalendarList: insert

उपयोगकर्ता की कैलेंडर सूची में पहले से मौजूद कैलेंडर को शामिल करता है. इसे अभी आज़माएं या उदाहरण देखें.

अनुरोध करें

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

POST https://www.googleapis.com/calendar/v3/users/me/calendarList

पैरामीटर

पैरामीटर का नाम वैल्यू जानकारी
वैकल्पिक क्वेरी पैरामीटर
colorRgbFormat boolean कैलेंडर के रंग (RGB) लिखने के लिए, foregroundColor और backgroundColor फ़ील्ड का इस्तेमाल करना है या नहीं. अगर इस सुविधा का इस्तेमाल किया जाता है, तो इंडेक्स पर आधारित colorId फ़ील्ड, अपने-आप सबसे अच्छे मैचिंग विकल्प पर सेट हो जाएगा. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है.

अनुमति देना

इस अनुरोध के लिए नीचे दिए गए दायरे की अनुमति चाहिए:

अनुमति देने का
https://www.googleapis.com/auth/calendar

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

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

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

प्रॉपर्टी का नाम वैल्यू जानकारी नोट
ज़रूरी प्रॉपर्टी
id string कैलेंडर का आइडेंटिफ़ायर.
ज़रूरी प्रॉपर्टी नहीं
backgroundColor string हेक्साडेसिमल फ़ॉर्मैट "#0088aa" में कैलेंडर का मुख्य रंग. यह प्रॉपर्टी, इंडेक्स पर आधारित colorId प्रॉपर्टी की जगह लेती है. इस प्रॉपर्टी को सेट करने या बदलने के लिए, आपको insert, update और patch तरीकों के पैरामीटर में, colorRgbFormat=true के बारे में बताना होगा. ज़रूरी नहीं. लिखा जा सकता है
colorId string कैलेंडर का रंग. यह आईडी, कलर डेफ़िनिशन के calendar सेक्शन में की गई एंट्री का रेफ़रंस देती है (रंगों के एंडपॉइंट देखें). इस प्रॉपर्टी की जगह backgroundColor और foregroundColor प्रॉपर्टी ले रही है. इन्हें इस्तेमाल करते समय अनदेखा किया जा सकता है. ज़रूरी नहीं. लिखा जा सकता है
defaultReminders[] list डिफ़ॉल्ट रिमाइंडर, जो पुष्टि किए गए उपयोगकर्ता के पास इस कैलेंडर के लिए हैं. लिखा जा सकता है
defaultReminders[].method string इस रिमाइंडर में इस्तेमाल किया गया तरीका. वैल्यू इस तरह की हो सकती हैं:
  • "email" - रिमाइंडर, ईमेल से भेजे जाते हैं.
  • "popup" - रिमाइंडर, यूज़र इंटरफ़ेस (यूआई) पॉप-अप की मदद से भेजे जाते हैं.

रिमाइंडर जोड़ते समय ज़रूरी है.

लिखा जा सकता है
defaultReminders[].minutes integer रिमाइंडर के ट्रिगर होने का समय, इवेंट शुरू होने से इतने मिनट पहले. वैल्यू, 0 से 40320 (मिनट में चार हफ़्ते) के बीच होती हैं.

रिमाइंडर जोड़ते समय ज़रूरी है.

लिखा जा सकता है
foregroundColor string हेक्साडेसिमल फ़ॉर्मैट "#ffffff" में कैलेंडर का फ़ोरग्राउंड का रंग. यह प्रॉपर्टी, इंडेक्स पर आधारित colorId प्रॉपर्टी की जगह लेती है. इस प्रॉपर्टी को सेट करने या बदलने के लिए, आपको insert, update और patch तरीकों के पैरामीटर में, colorRgbFormat=true के बारे में बताना होगा. ज़रूरी नहीं. लिखा जा सकता है
hidden boolean कैलेंडर को सूची से छिपा दिया गया है. ज़रूरी नहीं. एट्रिब्यूट सिर्फ़ तब दिखता है, जब कैलेंडर छिपा होता है. इस स्थिति में, वैल्यू true होती है. लिखा जा सकता है
notificationSettings object पुष्टि किए गए उपयोगकर्ता को इस कैलेंडर के लिए मिलने वाली सूचनाएं. लिखा जा सकता है
notificationSettings.notifications[].method string सूचना भेजने का तरीका. वैल्यू इस तरह की हो सकती है:
  • "email" - सूचनाएं, ईमेल से भेजी जाती हैं.

कोई सूचना जोड़ते समय ज़रूरी है.

लिखा जा सकता है
notificationSettings.notifications[].type string सूचना किस तरह की है. वैल्यू इस तरह की हो सकती हैं:
  • "eventCreation" - कैलेंडर में कोई नया इवेंट डाले जाने पर सूचना भेजी जाती है.
  • "eventChange" - किसी इवेंट में बदलाव होने पर सूचना भेजी जाती है.
  • "eventCancellation" - इवेंट रद्द होने पर सूचना भेजी जाएगी.
  • "eventResponse" - मेहमान के इवेंट के न्योते का जवाब देने पर सूचना भेजी जाती है.
  • "agenda" - दिन के इवेंट के साथ एजेंडा (सुबह भेजा गया).

कोई सूचना जोड़ते समय ज़रूरी है.

लिखा जा सकता है
selected boolean क्या कैलेंडर का कॉन्टेंट, कैलेंडर के यूज़र इंटरफ़ेस (यूआई) पर दिखता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. लिखा जा सकता है
summaryOverride string वह सारांश जो प्रमाणित उपयोगकर्ता ने इस कैलेंडर के लिए सेट किया है. ज़रूरी नहीं. लिखा जा सकता है

जवाब

अगर यह तरीका काम करता है, तो रिस्पॉन्स के मुख्य हिस्से में CalendarList रिसॉर्स दिखता है.

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

Java

Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.CalendarListEntry;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Create a new calendar list entry
CalendarListEntry calendarListEntry = new CalendarListEntry();
calendarListEntry.setId("calendarId");

// Insert the new calendar list entry
CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute();

System.out.println(createdCalendarListEntry.getSummary());

Python

Python क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

calendar_list_entry = {
    'id': 'calendarId'
}

created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute()

print created_calendar_list_entry['summary']

PHP

PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

$calendarListEntry = new Google_Service_Calendar_CalendarListEntry();
$calendarListEntry->setId("calendarId");

$createdCalendarListEntry = $service->calendarList->insert($calendarListEntry);

echo $createdCalendarListEntry->getSummary();

Ruby

Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

entry = Google::Apis::CalendarV3::CalendarListEntry.new(
 id: 'calendarId'
)

result = client.insert_calendar_list(entry)
print result.summary

इसे आज़माएं!

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