এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

CalDAV API বিকাশকারীর নির্দেশিকা৷

১ মে, ২০২৬ তারিখ থেকে এই এপিআই-এর ব্যবহারের সীমা হালনাগাদ করা হয়েছে। যে সকল গুগল ক্লাউড প্রজেক্ট নভেম্বর ২০২৫ থেকে এপ্রিল ২০২৬-এর মধ্যে এই এপিআই ব্যবহার করেছে, সেগুলোতে পূর্বে নির্ধারিত ব্যবহারের কোটা বহাল থাকবে। ১ মে, ২০২৬ বা তার পরে তৈরি হওয়া ক্লাউড প্রজেক্টগুলো নতুন এপিআই কোটার আওতাভুক্ত হবে।

সময়সীমা সহ আরও তথ্যের জন্য, এজেন্ট টুল এবং এপিআই-এর জন্য গুগল ওয়ার্কস্পেসের প্রমিত মডেল দেখুন।

সম্পূর্ণ ঘোষণার জন্য, গুগল ওয়ার্কস্পেস ডেভেলপারদের জন্য এজেন্ট টুলস এবং নিরাপত্তা আপডেট দেখুন।

CalDAV হলো WebDAV-এর একটি সম্প্রসারণ, যা ক্লায়েন্টদের দূরবর্তী সার্ভারে থাকা ক্যালেন্ডারের তথ্য অ্যাক্সেস করার জন্য একটি মান প্রদান করে।

গুগল একটি CalDAV ইন্টারফেস প্রদান করে, যা ব্যবহার করে আপনি CalDAV প্রোটোকলের মাধ্যমে ক্যালেন্ডার দেখতে ও পরিচালনা করতে পারেন।

CalDAV API-এর কোটা সীমা Calendar API-এর সমান। আরও তথ্যের জন্য, ব্যবহারের সীমা (Usage limits) দেখুন।

স্পেসিফিকেশন

প্রাসঙ্গিক প্রতিটি স্পেসিফিকেশনের জন্য গুগলের CalDAV সাপোর্ট নিম্নরূপ:

rfc4918: ওয়েব ডিস্ট্রিবিউটেড অথরিং এবং ভার্সনিং (WebDAV) এর জন্য HTTP এক্সটেনশন
- HTTP মেথড GET , PUT , HEAD , DELETE , POST , OPTIONS , PROPFIND , এবং PROPPATCH সমর্থন করে।
- HTTP মেথড LOCK , UNLOCK , COPY , MOVE , MKCOL , অথবা If* হেডার ( If-Match ব্যতীত) সমর্থন করে না।
- যথেচ্ছ (ব্যবহারকারী-সংজ্ঞায়িত) WebDAV প্রোপার্টি সমর্থন করে না।
- WebDAV অ্যাক্সেস কন্ট্রোল (rfc3744) সমর্থন করে না।
rfc4791: WebDAV-এর ক্যালেন্ডারিং এক্সটেনশন (CalDAV)
- HTTP মেথড REPORT সমর্থন করে। free-busy-query ছাড়া বাকি সব রিপোর্ট বাস্তবায়ন করা হয়েছে।
- MKCALENDAR HTTP মেথডটি সমর্থন করে না।
- AUDIO অ্যাকশনটি সমর্থন করে না।
rfc5545: আইক্যালেন্ডার
- CalDAV ইন্টারফেসে প্রদর্শিত ডেটা iCalendar স্পেসিফিকেশন অনুযায়ী ফরম্যাট করা হয়।
- VTODO বা VJOURNAL ডেটা সমর্থন করে না।
- ব্যবহারকারী-নির্ধারিত ইউআরএল বৈশিষ্ট্য যোগ করার জন্য অ্যাপল আইক্যাল এক্সটেনশনটি সমর্থন করে না।
rfc6578: WebDAV-এর জন্য সংগ্রহ সিঙ্ক্রোনাইজেশন
- প্রাথমিক সিঙ্কের পর ক্লায়েন্ট অ্যাপ্লিকেশনগুলোকে অবশ্যই এই কার্যপ্রণালীতে পরিবর্তিত হতে হবে।
rfc6638: CalDAV-এর সময়সূচী সম্প্রসারণ
- একটি সাধারণ 'ইনবক্স' রয়েছে, যা সর্বদা খালি থাকে।
- আপনি যে আমন্ত্রণপত্রগুলো পান, সেগুলো আপনার 'ইনবক্স'-এ যুক্ত না হয়ে স্বয়ংক্রিয়ভাবে আপনার 'ইভেন্টস' সংগ্রহে পৌঁছে যায়।
- free-busy লুকআপ সমর্থন করে না।
caldav-ctag-02: CalDAV-এ ক্যালেন্ডার সংগ্রহ সত্তা ট্যাগ (CTag)।
- ক্যালেন্ডার ctag হলো একটি রিসোর্স etag মতো; ক্যালেন্ডারের কোনো কিছুতে পরিবর্তন হলে এটিও পরিবর্তিত হয়। এর ফলে ক্লায়েন্ট অ্যাপ্লিকেশন দ্রুত বুঝতে পারে যে, পরিবর্তিত কোনো ইভেন্ট সিঙ্ক্রোনাইজ করার প্রয়োজন নেই।
ক্যালেন্ডার-প্রক্সি: CalDAV-এ ক্যালেন্ডার ব্যবহারকারী প্রক্সি কার্যকারিতা
- ক্যালেন্ডার সিঙ্ক পারফরম্যান্স উন্নত করার জন্য, যে অনুরোধগুলিতে calendar-proxy-read-for বা calendar-proxy-write-for প্রপার্টি অন্তর্ভুক্ত থাকে, সেগুলি একটি iOS UserAgent-এর সাথে ব্যর্থ হবে, কারণ iOS ডিভাইসগুলি ডেলিগেশন সমর্থন করে না।

যদিও আমাদের CalDAV বাস্তবায়নটি প্রতিটি স্পেসিফিকেশন পূরণ করে না, তবুও এটি অ্যাপল ক্যালেন্ডার সহ অনেক ক্লায়েন্টের জন্য সঠিকভাবে কাজ করে।

আপনার ক্লায়েন্ট আইডি তৈরি করুন

CalDAV API ব্যবহার করার জন্য আপনার একটি গুগল অ্যাকাউন্ট থাকতে হবে।

CalDAV API-তে অনুরোধ পাঠানোর আগে, আপনাকে অবশ্যই একটি প্রজেক্ট তৈরি করে Google Cloud কনসোলে আপনার ক্লায়েন্টকে রেজিস্টার করতে হবে।

Google API কনসোলে যান। 'Create project'-এ ক্লিক করুন, একটি নাম লিখুন এবং 'Create'-এ ক্লিক করুন।

এরপরে আপনাকে CalDAV API সক্রিয় করতে হবে।

আপনার প্রোজেক্টের জন্য একটি API সক্রিয় করতে, নিম্নলিখিতগুলি করুন:

গুগল এপিআই কনসোলে এপিআই লাইব্রেরি খুলুন । অনুরোধ করা হলে, একটি প্রজেক্ট নির্বাচন করুন অথবা একটি নতুন প্রজেক্ট তৈরি করুন। এপিআই লাইব্রেরিতে প্রোডাক্ট ফ্যামিলি এবং জনপ্রিয়তা অনুসারে শ্রেণীবদ্ধ করে সমস্ত উপলব্ধ এপিআই-এর তালিকা দেওয়া থাকে।
আপনি যে API-টি সক্রিয় করতে চান তা যদি তালিকায় না থাকে, তবে সেটি খুঁজে পেতে সার্চ ব্যবহার করুন।
যে API-টি সক্রিয় করতে চান, সেটি নির্বাচন করুন, তারপর ' Enable' বোতামে ক্লিক করুন।
অনুরোধ করা হলে, বিলিং চালু করুন।
অনুরোধ করা হলে, এপিআই-এর পরিষেবার শর্তাবলী গ্রহণ করুন।

CalDAV API অনুরোধগুলি সম্পাদন করার জন্য আপনার একটি ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট প্রয়োজন।

আপনার প্রোজেক্টের ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট খুঁজে পেতে, নিম্নলিখিতগুলি করুন:

বিদ্যমান কোনো OAuth 2.0 ক্রেডেনশিয়াল নির্বাচন করুন অথবা ক্রেডেনশিয়াল পৃষ্ঠাটি খুলুন।
যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে Create credentials > OAuth client ID-তে ক্লিক করে এবং ক্রেডেনশিয়াল তৈরির জন্য প্রয়োজনীয় তথ্য প্রদান করে আপনার প্রোজেক্টের OAuth 2.0 ক্রেডেনশিয়াল তৈরি করুন।
OAuth 2.0 ক্লায়েন্ট আইডি বিভাগে ক্লায়েন্ট আইডিটি খুঁজুন। বিস্তারিত জানতে ক্লায়েন্ট আইডিটিতে ক্লিক করুন।

গুগলের CalDAV সার্ভারের সাথে সংযোগ করুন

CalDAV ইন্টারফেস ব্যবহার করার জন্য, একটি ক্লায়েন্ট প্রোগ্রাম প্রথমে দুটি প্রারম্ভিক বিন্দুর যেকোনো একটি থেকে ক্যালেন্ডার সার্ভারের সাথে সংযোগ স্থাপন করে। উভয় ক্ষেত্রেই, সংযোগটি অবশ্যই HTTPS-এর মাধ্যমে এবং OAuth 2.0 অথেনটিকেশন স্কিম ব্যবহার করে করতে হবে। যদি কোনো অনুরোধ একটি গুগল অ্যাকাউন্টের OAuth 2.0 অথেনটিকেশন সহ HTTPS-এর মাধ্যমে না আসে, তবে CalDAV সার্ভার সেই অনুরোধটি প্রমাণীকরণ করতে অস্বীকার করে। HTTP বা বেসিক অথেনটিকেশন ব্যবহার করে সংযোগ করার চেষ্টা করলে একটি HTTP 401 Unauthorized স্ট্যাটাস কোড দেখা যায়।

যদি ক্লায়েন্ট প্রোগ্রামের (যেমন অ্যাপলের ক্যালেন্ডার অ্যাপ) প্রারম্ভিক বিন্দু হিসেবে কোনো প্রিন্সিপাল কালেকশনের প্রয়োজন হয়, তাহলে সংযোগ করার জন্য URI-টি হলো:

https://apidata.googleusercontent.com/caldav/v2/CALENDAR_ID/user

যে ক্যালেন্ডারটি অ্যাক্সেস করতে হবে, তার আইডি দিয়ে CALENDAR_ID প্রতিস্থাপন করুন।

ওয়েব ইন্টারফেসের মাধ্যমে ক্যালেন্ডার আইডি খুঁজে পেতে, ক্যালেন্ডারের নামের পাশে থাকা ড্রপ-ডাউন মেনু থেকে **ক্যালেন্ডার সেটিংস** নির্বাচন করুন। ক্যালেন্ডার আইডিটি 'ক্যালেন্ডার অ্যাড্রেস' নামক একটি বিভাগে দেখানো হয়। একজন ব্যবহারকারীর প্রাথমিক ক্যালেন্ডারের ক্যালেন্ডার আইডিটি সেই ব্যবহারকারীর ইমেল অ্যাড্রেসের মতোই হয়।

যদি কোনো ক্লায়েন্ট প্রোগ্রামের (যেমন মোজিলা থান্ডারবার্ড ) প্রারম্ভিক বিন্দু হিসেবে কোনো ক্যালেন্ডার সংগ্রহের প্রয়োজন হয়, তাহলে নিম্নলিখিত URI ব্যবহার করুন:

https://apidata.googleusercontent.com/caldav/v2/CALENDAR_ID/events