इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

इसे आज़माएं!

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