Events: insert

একটি ইভেন্ট তৈরি করে। এখনই চেষ্টা করে দেখুন ।

অনুরোধ

HTTP অনুরোধ 

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events

প্যারামিটার

প্যারামিটার নাম মূল্য বর্ণনা
পথের পরামিতি
calendarId string ক্যালেন্ডার শনাক্তকারী। ক্যালেন্ডার আইডিগুলো পেতে calendarList.list মেথডটি কল করুন। আপনি যদি বর্তমানে লগ ইন করা ব্যবহারকারীর প্রাথমিক ক্যালেন্ডার অ্যাক্সেস করতে চান, তাহলে " primary " কীওয়ার্ডটি ব্যবহার করুন।
ঐচ্ছিক কোয়েরি প্যারামিটার
conferenceDataVersion integer এপিআই ক্লায়েন্ট দ্বারা সমর্থিত কনফারেন্স ডেটার সংস্করণ নম্বর। সংস্করণ ০-তে কোনো কনফারেন্স ডেটা সমর্থন নেই বলে ধরে নেওয়া হয় এবং এটি ইভেন্টের বডিতে থাকা কনফারেন্স ডেটা উপেক্ষা করে। সংস্করণ ১, ConferenceData কপি করার পাশাপাশি conferenceData-এর createRequest ফিল্ড ব্যবহার করে নতুন কনফারেন্স তৈরি করার সুবিধা দেয়। ডিফল্ট মান হলো ০। গ্রহণযোগ্য মান হলো 0 থেকে 1 (উভয় সংখ্যাসহ)।
eventLabelVersion integer এপিআই ক্লায়েন্ট দ্বারা সমর্থিত ইভেন্ট লেবেল ফিচারের ভার্সন নম্বর। ভার্সন 0 কোনো ইভেন্ট লেবেল সাপোর্ট নেই বলে ধরে নেওয়া হয় এবং এটি কালার ম্যানেজমেন্টের জন্য colorId ফিল্ডটি প্রসেস করে। ভার্সন 1 ইভেন্ট লেবেলের জন্য সাপোর্ট সক্রিয় করে এবং ইভেন্টের বডিতে থাকা eventLabelId প্রসেস করে। এক্ষেত্রে, colorId ফিল্ডটি উপেক্ষা করা হয়। ডিফল্ট মান হলো 0 গ্রহণযোগ্য মান হলো 0 থেকে 1 পর্যন্ত (উভয় সংখ্যাসহ)।
maxAttendees integer উত্তরে অন্তর্ভুক্ত করার জন্য অংশগ্রহণকারীদের সর্বোচ্চ সংখ্যা। যদি নির্দিষ্ট সংখ্যার চেয়ে বেশি অংশগ্রহণকারী থাকে, তবে শুধুমাত্র অংশগ্রহণকারীকে ফেরত দেওয়া হবে। ঐচ্ছিক।
sendNotifications boolean অপ্রচলিত। এর পরিবর্তে sendUpdates ব্যবহার করুন।

নতুন ইভেন্ট তৈরি হওয়ার বিষয়ে নোটিফিকেশন পাঠানো হবে কিনা। মনে রাখবেন, আপনি মানটি ' false সেট করলেও কিছু ইমেল পাঠানো হতে পারে। ডিফল্ট মান হলো false ।
sendUpdates string নতুন ইভেন্ট তৈরি হওয়ার বিষয়ে নোটিফিকেশন পাঠানো হবে কিনা। উল্লেখ্য যে, কিছু ইমেল তখনও পাঠানো হতে পারে। ডিফল্ট মান হলো false ।

গ্রহণযোগ্য মানগুলো হলো:
  • " all ": সকল অতিথিকে বিজ্ঞপ্তি পাঠানো হয়।
  • " externalOnly ": নোটিফিকেশন শুধুমাত্র গুগল ক্যালেন্ডারের বাইরের অতিথিদের কাছে পাঠানো হয়।
  • " none ": কোনো বিজ্ঞপ্তি পাঠানো হয় না।
supportsAttachments boolean অপারেশন সম্পাদনকারী এপিআই ক্লায়েন্ট ইভেন্ট অ্যাটাচমেন্ট সমর্থন করে কিনা। ঐচ্ছিক। ডিফল্ট মান হলো False।

অনুমোদন

এই অনুরোধটির জন্য নিম্নলিখিত স্কোপগুলির মধ্যে অন্তত একটির অনুমোদন প্রয়োজন:

পরিধি
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

আরও তথ্যের জন্য, প্রমাণীকরণ এবং অনুমোদন পৃষ্ঠাটি দেখুন।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে, নিম্নলিখিত বৈশিষ্ট্যসহ একটি ইভেন্টস রিসোর্স সরবরাহ করুন:

সম্পত্তির নাম মূল্য বর্ণনা নোট
প্রয়োজনীয় বৈশিষ্ট্য
end nested object ঘটনাটির (একচেটিয়া) সমাপ্তির সময়। পুনরাবৃত্তিমূলক ঘটনার ক্ষেত্রে, এটি হলো প্রথম ঘটনার সমাপ্তির সময়।
start nested object ইভেন্টটির (অন্তর্ভুক্ত) শুরুর সময়। পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে, এটি হলো প্রথম বারের শুরুর সময়।
ঐচ্ছিক বৈশিষ্ট্য
anyoneCanAddSelf boolean যে কেউ ইভেন্টে নিজেকে আমন্ত্রণ জানাতে পারবে কিনা (অপ্রচলিত)। ঐচ্ছিক। ডিফল্ট মান হলো False। লেখার যোগ্য
attachments[]. fileUrl string সংযুক্তিটির ইউআরএল লিঙ্ক।

গুগল ড্রাইভ ফাইল অ্যাটাচমেন্ট যোগ করার জন্য, ড্রাইভ এপিআই-এর Files রিসোর্সের alternateLink প্রপার্টিতে ব্যবহৃত ফরম্যাটটিই ব্যবহার করুন।

সংযুক্তি যোগ করার সময় এটি প্রয়োজন।

 লেখার যোগ্য
attendees[] list ইভেন্টের অংশগ্রহণকারীরা। অন্যান্য ক্যালেন্ডার ব্যবহারকারীদের সাথে ইভেন্ট নির্ধারণ করার বিষয়ে আরও তথ্যের জন্য 'অংশগ্রহণকারীদের সাথে ইভেন্ট' নির্দেশিকাটি দেখুন। অংশগ্রহণকারীদের তালিকা পূরণ করার জন্য সার্ভিস অ্যাকাউন্টগুলোকে ডোমেন-ব্যাপী কর্তৃত্ব অর্পণ ব্যবহার করতে হবে। লেখার যোগ্য
attendees[]. additionalGuests integer অতিরিক্ত অতিথির সংখ্যা। ঐচ্ছিক। এর ডিফল্ট মান হলো ০। লেখার যোগ্য
attendees[]. comment string অংশগ্রহণকারীর প্রতিক্রিয়া মন্তব্য। ঐচ্ছিক। লেখার যোগ্য
attendees[]. displayName string অংশগ্রহণকারীর নাম, যদি জানা থাকে। ঐচ্ছিক। লেখার যোগ্য
attendees[]. email string অংশগ্রহণকারীর ইমেল ঠিকানা, যদি থাকে। কোনো অংশগ্রহণকারীকে যুক্ত করার সময় এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে। RFC5322 অনুযায়ী এটি অবশ্যই একটি বৈধ ইমেল ঠিকানা হতে হবে।

অংশগ্রহণকারী যোগ করার সময় এটি আবশ্যক।

 লেখার যোগ্য
attendees[]. optional boolean এই অংশগ্রহণকারী ঐচ্ছিক কিনা। ঐচ্ছিক। ডিফল্ট মান হলো False। লেখার যোগ্য
attendees[]. resource boolean অংশগ্রহণকারী একজন রিসোর্স কিনা। শুধুমাত্র যখন অংশগ্রহণকারীকে প্রথমবার ইভেন্টে যুক্ত করা হয়, তখনই এটি সেট করা যায়। পরবর্তী পরিবর্তনগুলো উপেক্ষা করা হয়। ঐচ্ছিক। ডিফল্ট মান হলো False। লেখার যোগ্য
attendees[]. responseStatus string অংশগ্রহণকারীর প্রতিক্রিয়ার অবস্থা। সম্ভাব্য মানগুলো হলো:
  • " needsAction " - অংশগ্রহণকারী আমন্ত্রণে সাড়া দেননি (নতুন ইভেন্টের জন্য প্রস্তাবিত)।
  • " declined " - অংশগ্রহণকারী আমন্ত্রণটি প্রত্যাখ্যান করেছেন।
  • " tentative " - অংশগ্রহণকারী সাময়িকভাবে আমন্ত্রণটি গ্রহণ করেছেন।
  • " accepted " - অংশগ্রহণকারী আমন্ত্রণটি গ্রহণ করেছেন।
 লেখার যোগ্য
birthdayProperties nested object জন্মদিন বা বিশেষ অনুষ্ঠানের তথ্য। eventType "birthday" হলে এটি ব্যবহৃত হয়। অপরিবর্তনীয়। লেখার যোগ্য
birthdayProperties. type string জন্মদিন বা বিশেষ অনুষ্ঠানের ধরণ। সম্ভাব্য মানগুলো হলো:
  • "anniversary" - জন্মদিন ছাড়া অন্য কোনো বার্ষিকী। এর জন্য সর্বদা একজন contact প্রয়োজন হয়।
  • "birthday" - একটি জন্মদিনের অনুষ্ঠান। এটি ডিফল্ট মান।
  • "custom" - একটি বিশেষ তারিখ যার লেবেল customTypeName ফিল্ডে আরও নির্দিষ্ট করা থাকে। এর সর্বদা একজন contact থাকে।
  • "other" - একটি বিশেষ তারিখ যা অন্য বিভাগগুলির অন্তর্ভুক্ত নয় এবং যার কোনো কাস্টম লেবেল নেই। এর সর্বদা একজন contact থাকে।
  • "self" - ক্যালেন্ডারের মালিকের নিজের জন্মদিন। এর সাথে কোনো contact থাকতে পারবে না।
ক্যালেন্ডার এপিআই শুধুমাত্র "birthday" ধরনের ইভেন্ট তৈরি করা সমর্থন করে। ইভেন্ট তৈরি হয়ে গেলে এর ধরন পরিবর্তন করা যায় না।		 লেখার যোগ্য
colorId string ইভেন্টের রঙ। এটি একটি আইডি যা কালারস ডেফিনিশনের event সেকশনের একটি এন্ট্রিকে নির্দেশ করে ( কালারস এন্ডপয়েন্ট দেখুন)। ঐচ্ছিক। লেখার যোগ্য
conferenceData nested object কনফারেন্স-সম্পর্কিত তথ্য, যেমন একটি গুগল মিট কনফারেন্সের বিবরণ। নতুন কনফারেন্সের বিবরণ তৈরি করতে ` createRequest ফিল্ডটি ব্যবহার করুন। আপনার পরিবর্তনগুলো স্থায়ী করতে, সমস্ত ইভেন্ট পরিবর্তনের অনুরোধের জন্য conferenceDataVersion রিকোয়েস্ট প্যারামিটারটি ` 1 -এ সেট করতে মনে রাখবেন। লেখার যোগ্য
description string ইভেন্টের বিবরণ। এতে HTML থাকতে পারে। ঐচ্ছিক। লেখার যোগ্য
end. date date যদি এটি একটি সারাদিনের অনুষ্ঠান হয়, তাহলে তারিখটি "yyyy-mm-dd" বিন্যাসে দিতে হবে। লেখার যোগ্য
end. dateTime datetime সময়টি একটি সম্মিলিত তারিখ-সময় মান হিসাবে ( RFC3339 অনুযায়ী বিন্যস্ত)। timeZone এ কোনো টাইম জোন স্পষ্টভাবে উল্লেখ না করা থাকলে একটি টাইম জোন অফসেট প্রয়োজন। লেখার যোগ্য
end. timeZone string যে টাইম জোনে সময়টি নির্দিষ্ট করা হয়েছে। (আইএএনএ টাইম জোন ডেটাবেস নাম হিসাবে ফরম্যাট করা, যেমন "ইউরোপ/জুরিখ")। পুনরাবৃত্তিমূলক ইভেন্টের জন্য এই ফিল্ডটি আবশ্যক এবং এটি সেই টাইম জোন নির্দিষ্ট করে যেখানে পুনরাবৃত্তিটি প্রসারিত হবে। একক ইভেন্টের জন্য এই ফিল্ডটি ঐচ্ছিক এবং এটি ইভেন্টের শুরু/শেষের জন্য একটি কাস্টম টাইম জোন নির্দেশ করে। লেখার যোগ্য
eventLabelId string ইভেন্টটিতে নির্ধারিত ইভেন্ট লেবেলের আইডি। ঐচ্ছিক। এটি ক্যালেন্ডারের labelProperties.eventLabels প্রপার্টির কোনো একটি এন্ট্রির আইডিকে নির্দেশ করে ( Calendars.get এন্ডপয়েন্টটি দেখুন)।

এই প্রপার্টিটি ইনডেক্স-ভিত্তিক colorId প্রপার্টিকে প্রতিস্থাপন করে। এই প্রপার্টিটি সেট বা পরিবর্তন করতে, আপনাকে insert , import , update , এবং patch মেথডগুলোর প্যারামিটারে eventLabelVersion=1 উল্লেখ করতে হবে।

খালি স্ট্রিং সেট করলে, অথবা এই ফিল্ডটি একেবারেই সেট না করলে, ইভেন্ট থেকে বিদ্যমান লেবেলটি মুছে যাবে।

 লেখার যোগ্য
eventType string ইভেন্টের নির্দিষ্ট ধরণ। ইভেন্টটি তৈরি হয়ে গেলে এটি পরিবর্তন করা যায় না। সম্ভাব্য মানগুলো হলো:
  • birthday - একটি বিশেষ দিনব্যাপী অনুষ্ঠান যা প্রতি বছর অনুষ্ঠিত হয়।
  • " default " - একটি নিয়মিত ঘটনা অথবা আরও নির্দিষ্ট করা হয়নি।
  • " focusTime " - একটি ফোকাস-টাইম ইভেন্ট।
  • " fromGmail " - জিমেইল থেকে আসা একটি ইভেন্ট। এই ধরনের ইভেন্ট তৈরি করা যায় না।
  • " outOfOffice " - অফিসের বাইরে ঘটা কোনো ঘটনা।
  • " workingLocation " - একটি কর্মস্থল সংক্রান্ত ঘটনা।
 লেখার যোগ্য
extendedProperties. private object এই ক্যালেন্ডারে প্রদর্শিত ইভেন্টের অনুলিপিটির জন্য স্বতন্ত্র বৈশিষ্ট্যসমূহ। লেখার যোগ্য
extendedProperties. shared object অন্যান্য অংশগ্রহণকারীদের ক্যালেন্ডারে থাকা ইভেন্টের কপিগুলোর মধ্যে যে বৈশিষ্ট্যগুলো অভিন্ন থাকে। লেখার যোগ্য
focusTimeProperties nested object ফোকাস টাইম ইভেন্টের ডেটা। যদি eventType focusTime হয়, তবে এটি ব্যবহৃত হয়। লেখার যোগ্য
gadget. display string গ্যাজেটটির ডিসপ্লে মোড। অপ্রচলিত। সম্ভাব্য মানগুলো হলো:
  • " icon " - এই গ্যাজেটটি ক্যালেন্ডার ভিউতে ইভেন্টের শিরোনামের পাশে প্রদর্শিত হয়।
  • " chip " - ইভেন্টটিতে ক্লিক করা হলে গ্যাজেটটি প্রদর্শিত হয়।
 লেখার যোগ্য
gadget. height integer গ্যাজেটটির উচ্চতা পিক্সেলে। উচ্চতাটি অবশ্যই ০ অপেক্ষা বড় একটি পূর্ণসংখ্যা হতে হবে। ঐচ্ছিক। অপ্রচলিত। লেখার যোগ্য
gadget. preferences object পছন্দসমূহ। লেখার যোগ্য
gadget. title string গ্যাজেটটির শিরোনাম। অপ্রচলিত। লেখার যোগ্য
gadget. type string গ্যাজেটটির ধরণ। অপ্রচলিত। লেখার যোগ্য
gadget. width integer গ্যাজেটটির প্রস্থ পিক্সেলে। প্রস্থটি অবশ্যই ০ অপেক্ষা বড় একটি পূর্ণসংখ্যা হতে হবে। ঐচ্ছিক। অপ্রচলিত। লেখার যোগ্য
guestsCanInviteOthers boolean আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা অনুষ্ঠানে অন্যদের আমন্ত্রণ জানাতে পারবেন কিনা। ঐচ্ছিক। ডিফল্ট মান হলো True। লেখার যোগ্য
guestsCanModify boolean আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা ইভেন্টটি পরিবর্তন করতে পারবে কিনা। এটি ঐচ্ছিক। ডিফল্ট মান হলো False। লেখার যোগ্য
guestsCanSeeOtherGuests boolean আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা ইভেন্টের অংশগ্রহণকারীদের দেখতে পারবেন কিনা। ঐচ্ছিক। ডিফল্ট মান হলো True। লেখার যোগ্য
id string ইভেন্টের অস্বচ্ছ শনাক্তকারী। নতুন একক বা পুনরাবৃত্তিমূলক ইভেন্ট তৈরি করার সময়, আপনি সেগুলোর আইডি নির্দিষ্ট করে দিতে পারেন। প্রদত্ত আইডিগুলোকে অবশ্যই নিম্নলিখিত নিয়মগুলো অনুসরণ করতে হবে:
  • আইডিতে বেস৩২হেক্স এনকোডিং-এ ব্যবহৃত অক্ষরগুলোই অনুমোদিত, অর্থাৎ ছোট হাতের অক্ষর av এবং ০-৯ পর্যন্ত অঙ্ক, RFC2938- এর ৩.১.২ অনুচ্ছেদ দেখুন।
  • আইডিটির দৈর্ঘ্য অবশ্যই ৫ থেকে ১০২৪ অক্ষরের মধ্যে হতে হবে।
  • প্রতিটি ক্যালেন্ডারের জন্য আইডি অবশ্যই অনন্য হতে হবে।
সিস্টেমটির বিশ্বব্যাপী বিস্তৃত প্রকৃতির কারণে, আমরা এই নিশ্চয়তা দিতে পারি না যে ইভেন্ট তৈরির সময়ে আইডি সংঘর্ষ শনাক্ত করা হবে। সংঘর্ষের ঝুঁকি কমানোর জন্য আমরা RFC4122- এ বর্ণিত একটি প্রতিষ্ঠিত UUID অ্যালগরিদম ব্যবহার করার সুপারিশ করি।

আপনি যদি কোনো আইডি নির্দিষ্ট না করেন, তবে সার্ভার থেকে এটি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যাবে।

মনে রাখবেন যে icalUID এবং id অভিন্ন নয় এবং ইভেন্ট তৈরির সময় এদের মধ্যে কেবল একটিই সরবরাহ করা উচিত। এদের অর্থগত একটি পার্থক্য হলো, পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে, একটি ইভেন্টের সমস্ত পুনরাবৃত্তির id ভিন্ন ভিন্ন হয়, যদিও তাদের সকলের icalUID একই থাকে।

 লেখার যোগ্য
location string অনুষ্ঠানটির ভৌগোলিক অবস্থান (মুক্ত পাঠ্য হিসেবে)। ঐচ্ছিক। লেখার যোগ্য
originalStartTime. date date যদি এটি একটি সারাদিনের অনুষ্ঠান হয়, তাহলে তারিখটি "yyyy-mm-dd" বিন্যাসে দিতে হবে। লেখার যোগ্য
originalStartTime. dateTime datetime সময়টি একটি সম্মিলিত তারিখ-সময় মান হিসাবে ( RFC3339 অনুযায়ী বিন্যস্ত)। timeZone এ কোনো টাইম জোন স্পষ্টভাবে উল্লেখ না করা থাকলে একটি টাইম জোন অফসেট প্রয়োজন। লেখার যোগ্য
originalStartTime. timeZone string যে টাইম জোনে সময়টি নির্দিষ্ট করা হয়েছে। (আইএএনএ টাইম জোন ডেটাবেস নাম হিসাবে ফরম্যাট করা, যেমন "ইউরোপ/জুরিখ")। পুনরাবৃত্তিমূলক ইভেন্টের জন্য এই ফিল্ডটি আবশ্যক এবং এটি সেই টাইম জোন নির্দিষ্ট করে যেখানে পুনরাবৃত্তিটি প্রসারিত হবে। একক ইভেন্টের জন্য এই ফিল্ডটি ঐচ্ছিক এবং এটি ইভেন্টের শুরু/শেষের জন্য একটি কাস্টম টাইম জোন নির্দেশ করে। লেখার যোগ্য
outOfOfficeProperties nested object অফিসের অনুপস্থিতি সংক্রান্ত ইভেন্টের তথ্য। eventType outOfOffice হলে এটি ব্যবহৃত হয়। লেখার যোগ্য
recurrence[] list RFC5545- এ উল্লেখিত একটি পুনরাবৃত্তিমূলক ইভেন্টের জন্য RRULE, EXRULE, RDATE এবং EXDATE লাইনগুলির তালিকা। উল্লেখ্য যে, এই ফিল্ডে DTSTART এবং DTEND লাইন অনুমোদিত নয়; ইভেন্টের শুরু এবং শেষের সময় start এবং end ফিল্ডে উল্লেখ করা হয়। একক ইভেন্ট বা পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে এই ফিল্ডটি বাদ দেওয়া হয়। লেখার যোগ্য
reminders. overrides[] list যদি ইভেন্টটি ডিফল্ট রিমাইন্ডার ব্যবহার না করে, তবে এটি ইভেন্টটির জন্য নির্দিষ্ট রিমাইন্ডারগুলো তালিকাভুক্ত করে, অথবা, সেট করা না থাকলে, নির্দেশ করে যে এই ইভেন্টের জন্য কোনো রিমাইন্ডার সেট করা নেই। ওভাররাইড রিমাইন্ডারের সর্বোচ্চ সংখ্যা হলো ৫। লেখার যোগ্য
reminders.overrides[]. method string এই রিমাইন্ডারে ব্যবহৃত পদ্ধতি। সম্ভাব্য মানগুলো হলো:
  • " email " - রিমাইন্ডার ইমেলের মাধ্যমে পাঠানো হয়।
  • " popup " - রিমাইন্ডারগুলো একটি UI পপআপের মাধ্যমে পাঠানো হয়।

রিমাইন্ডার যোগ করার সময় এটি আবশ্যক।

 লেখার যোগ্য
reminders.overrides[]. minutes integer ইভেন্ট শুরু হওয়ার কত মিনিট আগে রিমাইন্ডারটি চালু হবে। বৈধ মান হলো ০ থেকে ৪০৩২০ (মিনিটে ৪ সপ্তাহ)।

রিমাইন্ডার যোগ করার সময় এটি আবশ্যক।

 লেখার যোগ্য
reminders. useDefault boolean ক্যালেন্ডারের ডিফল্ট রিমাইন্ডারগুলো ইভেন্টটির ক্ষেত্রে প্রযোজ্য হবে কিনা। লেখার যোগ্য
sequence integer আইক্যালেন্ডার অনুযায়ী ক্রমিক সংখ্যা। লেখার যোগ্য
source. title string উৎসের শিরোনাম; যেমন একটি ওয়েব পেজের শিরোনাম বা একটি ইমেলের বিষয়। লেখার যোগ্য
source. url string কোনো রিসোর্স নির্দেশকারী উৎসের URL। URL স্কিমটি অবশ্যই HTTP বা HTTPS হতে হবে। লেখার যোগ্য
start. date date যদি এটি একটি সারাদিনের অনুষ্ঠান হয়, তাহলে তারিখটি "yyyy-mm-dd" বিন্যাসে দিতে হবে। লেখার যোগ্য
start. dateTime datetime সময়টি একটি সম্মিলিত তারিখ-সময় মান হিসাবে ( RFC3339 অনুযায়ী বিন্যস্ত)। timeZone এ কোনো টাইম জোন স্পষ্টভাবে উল্লেখ না করা থাকলে একটি টাইম জোন অফসেট প্রয়োজন। লেখার যোগ্য
start. timeZone string যে টাইম জোনে সময়টি নির্দিষ্ট করা হয়েছে। (আইএএনএ টাইম জোন ডেটাবেস নাম হিসাবে ফরম্যাট করা, যেমন "ইউরোপ/জুরিখ")। পুনরাবৃত্তিমূলক ইভেন্টের জন্য এই ফিল্ডটি আবশ্যক এবং এটি সেই টাইম জোন নির্দিষ্ট করে যেখানে পুনরাবৃত্তিটি প্রসারিত হবে। একক ইভেন্টের জন্য এই ফিল্ডটি ঐচ্ছিক এবং এটি ইভেন্টের শুরু/শেষের জন্য একটি কাস্টম টাইম জোন নির্দেশ করে। লেখার যোগ্য
status string ইভেন্টের অবস্থা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
  • " confirmed " - ইভেন্টটি নিশ্চিত করা হয়েছে। এটিই ডিফল্ট স্ট্যাটাস।
  • " tentative " - ​​অনুষ্ঠানটি প্রাথমিকভাবে নিশ্চিত করা হয়েছে।
  • " cancelled " - ইভেন্টটি বাতিল (মুছে ফেলা) করা হয়েছে। লিস্ট মেথডটি শুধুমাত্র ইনক্রিমেন্টাল সিঙ্কের সময় (যখন syncToken বা updatedMin নির্দিষ্ট করা থাকে) অথবা showDeleted ফ্ল্যাগটি true সেট করা থাকলে বাতিল হওয়া ইভেন্টগুলো রিটার্ন করে। গেট মেথডটি সবসময় সেগুলো রিটার্ন করে।

    ইভেন্টের প্রকারভেদের উপর নির্ভর করে একটি বাতিল স্ট্যাটাস দুটি ভিন্ন অবস্থা নির্দেশ করে:

    1. একটি বাতিল না করা পুনরাবৃত্তিমূলক ইভেন্টের বাতিল করা ব্যতিক্রমগুলি নির্দেশ করে যে এই দৃষ্টান্তটি আর ব্যবহারকারীর কাছে উপস্থাপন করা উচিত নয়। ক্লায়েন্টদের উচিত মূল পুনরাবৃত্তিমূলক ইভেন্টের জীবনকাল পর্যন্ত এই ইভেন্টগুলি সংরক্ষণ করা।

      বাতিল করা ব্যতিক্রমগুলির ক্ষেত্রে শুধুমাত্র id , recurringEventId এবং originalStartTime ফিল্ডগুলিতে মান থাকা নিশ্চিত। অন্যান্য ফিল্ডগুলি খালি থাকতে পারে।

    2. অন্যান্য সমস্ত বাতিল ইভেন্ট হলো মুছে ফেলা ইভেন্ট। ক্লায়েন্টদের উচিত তাদের স্থানীয়ভাবে সিঙ্ক করা কপিগুলো মুছে ফেলা। এই ধরনের বাতিল ইভেন্টগুলো অবশেষে অদৃশ্য হয়ে যাবে, তাই এগুলো অনির্দিষ্টকালের জন্য উপলব্ধ থাকবে এমনটা ধরে নেবেন না।

      মুছে ফেলা ইভেন্টগুলোর ক্ষেত্রে শুধুমাত্র id ফিল্ডটি পূরণ করা থাকবে, এটি নিশ্চিত।

    আয়োজকের ক্যালেন্ডারে, বাতিল করা ইভেন্টগুলোর বিবরণ (সারাংশ, অবস্থান, ইত্যাদি) দেখা যেতে থাকে, যাতে সেগুলোকে পুনরুদ্ধার (আনডিলিট) করা যায়। একইভাবে, যে ইভেন্টগুলোতে ব্যবহারকারীকে আমন্ত্রণ জানানো হয়েছিল এবং যা তিনি নিজে থেকে মুছে ফেলেছেন, সেগুলোর বিবরণও পাওয়া যেতে থাকে। তবে, showDeleted `false` সেট করা ইনক্রিমেন্টাল সিঙ্ক রিকোয়েস্টগুলো এই বিবরণগুলো ফেরত দেবে না।

    যদি কোনো ইভেন্টের আয়োজক পরিবর্তিত হয় (উদাহরণস্বরূপ, স্থান পরিবর্তনের মাধ্যমে) এবং মূল আয়োজক অংশগ্রহণকারীদের তালিকায় না থাকেন, তাহলে একটি বাতিল ইভেন্ট তৈরি হবে, যেখানে শুধুমাত্র id ফিল্ডটি পূরণ করা থাকবে বলে নিশ্চিত থাকা যায়।

 লেখার যোগ্য
summary string অনুষ্ঠানের শিরোনাম। লেখার যোগ্য
transparency string ইভেন্টটি ক্যালেন্ডারে সময় ব্লক করবে কিনা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
  • " opaque " - ডিফল্ট মান। ইভেন্টটি ক্যালেন্ডারে সময় আটকে রাখে। এটি ক্যালেন্ডার UI-তে 'আমাকে ব্যস্ত হিসেবে দেখান' বিকল্পটিকে 'ব্যস্ত' হিসেবে সেট করার সমতুল্য।
  • " transparent " - ইভেন্টটি ক্যালেন্ডারে কোনো সময় ব্লক করে না। এটি ক্যালেন্ডার UI-তে 'আমাকে দেখান' বিকল্পটিকে 'উপলব্ধ' হিসেবে সেট করার সমতুল্য।
 লেখার যোগ্য
visibility string ইভেন্টের দৃশ্যমানতা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
  • " default " - ক্যালেন্ডারে ইভেন্টগুলির জন্য ডিফল্ট দৃশ্যমানতা ব্যবহার করে। এটিই ডিফল্ট মান।
  • " public " - অনুষ্ঠানটি সর্বজনীন এবং এর বিবরণ ক্যালেন্ডারের সকল পাঠকের কাছে দৃশ্যমান।
  • " private " - অনুষ্ঠানটি ব্যক্তিগত এবং শুধুমাত্র অনুষ্ঠানে অংশগ্রহণকারীরাই এর বিস্তারিত বিবরণ দেখতে পারবেন।
  • " confidential " - ইভেন্টটি ব্যক্তিগত। সামঞ্জস্যতার কারণে এই মানটি প্রদান করা হয়েছে।
 লেখার যোগ্য
workingLocationProperties nested object কর্মস্থলের ইভেন্টের ডেটা। লেখার যোগ্য
workingLocationProperties. customLocation object উপস্থিত থাকলে, এটি নির্দেশ করে যে ব্যবহারকারী একটি নিজস্ব অবস্থান থেকে কাজ করছেন। লেখার যোগ্য
workingLocationProperties.customLocation. label string অতিরিক্ত তথ্যের জন্য একটি ঐচ্ছিক অতিরিক্ত লেবেল। লেখার যোগ্য
workingLocationProperties. homeOffice any value উপস্থিত থাকলে, এটি নির্দেশ করে যে ব্যবহারকারী বাড়িতে থেকে কাজ করছেন। লেখার যোগ্য
workingLocationProperties. officeLocation object উপস্থিত থাকলে, এটি নির্দেশ করে যে ব্যবহারকারী একটি অফিস থেকে কাজ করছেন। লেখার যোগ্য
workingLocationProperties.officeLocation. buildingId string একটি ঐচ্ছিক ভবন শনাক্তকারী। এটি প্রতিষ্ঠানের রিসোর্স ডেটাবেসে থাকা একটি বিল্ডিং আইডিকে নির্দেশ করবে। লেখার যোগ্য
workingLocationProperties.officeLocation. deskId string একটি ঐচ্ছিক ডেস্ক শনাক্তকারী। লেখার যোগ্য
workingLocationProperties.officeLocation. floorId string একটি ঐচ্ছিক তলা শনাক্তকারী। লেখার যোগ্য
workingLocationProperties.officeLocation. floorSectionId string একটি ঐচ্ছিক ফ্লোর সেকশন শনাক্তকারী। লেখার যোগ্য
workingLocationProperties.officeLocation. label string ক্যালেন্ডার ওয়েব এবং মোবাইল ক্লায়েন্টগুলিতে অফিসের যে নামটি প্রদর্শিত হয়। আমরা আপনাকে প্রতিষ্ঠানের রিসোর্স ডেটাবেস থেকে ভবনের নামটি উল্লেখ করার পরামর্শ দিই। লেখার যোগ্য
workingLocationProperties. type string কর্মস্থলের ধরণ। সম্ভাব্য মানগুলো হলো:
  • " homeOffice " - ব্যবহারকারী বাড়িতে বসে কাজ করছেন।
  • " officeLocation " - ব্যবহারকারী একটি অফিস থেকে কাজ করছেন।
  • " customLocation " - ব্যবহারকারী একটি নিজস্ব স্থান থেকে কাজ করছেন।
যেকোনো বিবরণ নির্দিষ্ট নামের একটি উপ-ক্ষেত্রে উল্লেখ করা হয়, কিন্তু এই ক্ষেত্রটি খালি থাকলে অনুপস্থিত থাকতে পারে। অন্য যেকোনো ক্ষেত্র উপেক্ষা করা হয়।

ওয়ার্কিং লোকেশন প্রোপার্টি যোগ করার সময় এটি প্রয়োজন।

 লেখার যোগ্য

প্রতিক্রিয়া

সফল হলে, এই মেথডটি রেসপন্স বডিতে একটি ইভেন্টস রিসোর্স রিটার্ন করে।

চেষ্টা করে দেখুন!

লাইভ ডেটার উপর এই মেথডটি কল করতে এবং প্রতিক্রিয়া দেখতে নিচের এপিআই এক্সপ্লোরারটি ব্যবহার করুন।