একটি ইভেন্ট ইম্পোর্ট করে। এই অপারেশনটি একটি ক্যালেন্ডারে বিদ্যমান কোনো ইভেন্টের একটি ব্যক্তিগত অনুলিপি যোগ করতে ব্যবহৃত হয়। শুধুমাত্র ' default ' eventType ইভেন্টগুলোই ইম্পোর্ট করা যাবে।
অপ্রচলিত আচরণ: যদি কোনো নন- default ইভেন্ট ইম্পোর্ট করা হয়, তাহলে তার টাইপ default পরিবর্তিত হয়ে যাবে এবং এর যদি কোনো ইভেন্ট-টাইপ-নির্দিষ্ট প্রোপার্টি থেকে থাকে, তবে তা বাদ দেওয়া হবে।
অনুরোধ
HTTP অনুরোধ
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/importপ্যারামিটার
| প্যারামিটার নাম | মূল্য | বর্ণনা |
|---|---|---|
| পথের পরামিতি | ||
calendarId | string | ক্যালেন্ডার শনাক্তকারী। ক্যালেন্ডার আইডিগুলো পেতে calendarList.list মেথডটি কল করুন। আপনি যদি বর্তমানে লগ ইন করা ব্যবহারকারীর প্রাথমিক ক্যালেন্ডার অ্যাক্সেস করতে চান, তাহলে " primary " কীওয়ার্ডটি ব্যবহার করুন। |
| ঐচ্ছিক কোয়েরি প্যারামিটার | ||
conferenceDataVersion | integer | এপিআই ক্লায়েন্ট দ্বারা সমর্থিত কনফারেন্স ডেটার সংস্করণ নম্বর। সংস্করণ ০-তে কোনো কনফারেন্স ডেটা সমর্থন নেই বলে ধরে নেওয়া হয় এবং এটি ইভেন্টের বডিতে থাকা কনফারেন্স ডেটা উপেক্ষা করে। সংস্করণ ১, ConferenceData কপি করার পাশাপাশি conferenceData-এর createRequest ফিল্ড ব্যবহার করে নতুন কনফারেন্স তৈরি করার সুবিধা দেয়। ডিফল্ট মান হলো ০। গ্রহণযোগ্য মান হলো 0 থেকে 1 (উভয় সংখ্যাসহ)। |
eventLabelVersion | integer | এপিআই ক্লায়েন্ট দ্বারা সমর্থিত ইভেন্ট লেবেল ফিচারের ভার্সন নম্বর। ভার্সন 0 কোনো ইভেন্ট লেবেল সাপোর্ট নেই বলে ধরে নেওয়া হয় এবং এটি কালার ম্যানেজমেন্টের জন্য colorId ফিল্ডটি প্রসেস করে। ভার্সন 1 ইভেন্ট লেবেলের জন্য সাপোর্ট সক্রিয় করে এবং ইভেন্টের বডিতে থাকা eventLabelId প্রসেস করে। এক্ষেত্রে, colorId ফিল্ডটি উপেক্ষা করা হয়। ডিফল্ট মান হলো 0 গ্রহণযোগ্য মান হলো 0 থেকে 1 পর্যন্ত (উভয় সংখ্যাসহ)। |
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 | ঘটনাটির (একচেটিয়া) সমাপ্তির সময়। পুনরাবৃত্তিমূলক ঘটনার ক্ষেত্রে, এটি হলো প্রথম ঘটনার সমাপ্তির সময়। | |
iCalUID | string | RFC5545- এ সংজ্ঞায়িত ইভেন্টের অনন্য শনাক্তকারী। এটি ক্যালেন্ডারিং সিস্টেম জুড়ে ইভেন্টগুলিকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহৃত হয় এবং ইম্পোর্ট পদ্ধতির মাধ্যমে ইভেন্ট ইম্পোর্ট করার সময় অবশ্যই সরবরাহ করতে হবে। মনে রাখবেন যে | |
start | nested object | ইভেন্টটির (অন্তর্ভুক্ত) শুরুর সময়। পুনরাবৃত্তিমূলক ইভেন্টের ক্ষেত্রে, এটি হলো প্রথম বারের শুরুর সময়। | |
| ঐচ্ছিক বৈশিষ্ট্য | |||
anyoneCanAddSelf | boolean | যে কেউ ইভেন্টে নিজেকে আমন্ত্রণ জানাতে পারবে কিনা (অপ্রচলিত)। ঐচ্ছিক। ডিফল্ট মান হলো False। | লেখার যোগ্য |
attachments[]. fileUrl | string | সংযুক্তিটির ইউআরএল লিঙ্ক। গুগল ড্রাইভ ফাইল অ্যাটাচমেন্ট যোগ করার জন্য, ড্রাইভ এপিআই-এর সংযুক্তি যোগ করার সময় এটি প্রয়োজন। | লেখার যোগ্য |
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 | অংশগ্রহণকারীর প্রতিক্রিয়ার অবস্থা। সম্ভাব্য মানগুলো হলো:
| লেখার যোগ্য |
attendeesOmitted | boolean | ইভেন্টের উপস্থাপনা থেকে অংশগ্রহণকারীদের বাদ দেওয়া হয়েছে কিনা। কোনো ইভেন্ট পুনরুদ্ধার করার সময়, maxAttendee কোয়েরি প্যারামিটার দ্বারা নির্দিষ্ট কোনো সীমাবদ্ধতার কারণে এটি হতে পারে। কোনো ইভেন্ট আপডেট করার সময়, এটি শুধুমাত্র অংশগ্রহণকারীর প্রতিক্রিয়া আপডেট করতে ব্যবহার করা যেতে পারে। ঐচ্ছিক। ডিফল্ট মান হলো False। | লেখার যোগ্য |
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 এন্ডপয়েন্টটি দেখুন)। এই প্রপার্টিটি ইনডেক্স-ভিত্তিক খালি স্ট্রিং সেট করলে, অথবা এই ফিল্ডটি একেবারেই সেট না করলে, ইভেন্ট থেকে বিদ্যমান লেবেলটি মুছে যাবে। | লেখার যোগ্য |
extendedProperties. private | object | এই ক্যালেন্ডারে প্রদর্শিত ইভেন্টের অনুলিপিটির জন্য স্বতন্ত্র বৈশিষ্ট্যসমূহ। | লেখার যোগ্য |
extendedProperties. shared | object | অন্যান্য অংশগ্রহণকারীদের ক্যালেন্ডারে থাকা ইভেন্টের কপিগুলোর মধ্যে যে বৈশিষ্ট্যগুলো অভিন্ন থাকে। | লেখার যোগ্য |
focusTimeProperties | nested object | ফোকাস টাইম ইভেন্টের ডেটা। যদি eventType focusTime হয়, তবে এটি ব্যবহৃত হয়। | লেখার যোগ্য |
gadget. display | string | গ্যাজেটটির ডিসপ্লে মোড। অপ্রচলিত। সম্ভাব্য মানগুলো হলো:
| লেখার যোগ্য |
gadget. height | integer | গ্যাজেটটির উচ্চতা পিক্সেলে। উচ্চতাটি অবশ্যই ০ অপেক্ষা বড় একটি পূর্ণসংখ্যা হতে হবে। ঐচ্ছিক। অপ্রচলিত। | লেখার যোগ্য |
gadget. iconLink | string | গ্যাজেটটির আইকন ইউআরএল। ইউআরএল স্কিমটি অবশ্যই HTTPS হতে হবে। এটি এখন আর ব্যবহৃত হয় না। | লেখার যোগ্য |
gadget. link | string | গ্যাজেটটির ইউআরএল। ইউআরএল স্কিমটি অবশ্যই HTTPS হতে হবে। অপ্রচলিত। | লেখার যোগ্য |
gadget. preferences | object | পছন্দসমূহ। | লেখার যোগ্য |
gadget. title | string | গ্যাজেটটির শিরোনাম। অপ্রচলিত। | লেখার যোগ্য |
gadget. type | string | গ্যাজেটটির ধরণ। অপ্রচলিত। | লেখার যোগ্য |
gadget. width | integer | গ্যাজেটটির প্রস্থ পিক্সেলে। প্রস্থটি অবশ্যই ০ অপেক্ষা বড় একটি পূর্ণসংখ্যা হতে হবে। ঐচ্ছিক। অপ্রচলিত। | লেখার যোগ্য |
guestsCanInviteOthers | boolean | আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা অনুষ্ঠানে অন্যদের আমন্ত্রণ জানাতে পারবেন কিনা। ঐচ্ছিক। ডিফল্ট মান হলো True। | লেখার যোগ্য |
guestsCanModify | boolean | আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা ইভেন্টটি পরিবর্তন করতে পারবে কিনা। এটি ঐচ্ছিক। ডিফল্ট মান হলো False। | লেখার যোগ্য |
guestsCanSeeOtherGuests | boolean | আয়োজক ব্যতীত অন্য অংশগ্রহণকারীরা ইভেন্টের অংশগ্রহণকারীদের দেখতে পারবেন কিনা। ঐচ্ছিক। ডিফল্ট মান হলো True। | লেখার যোগ্য |
location | string | অনুষ্ঠানটির ভৌগোলিক অবস্থান (মুক্ত পাঠ্য হিসেবে)। ঐচ্ছিক। | লেখার যোগ্য |
organizer | object | ইভেন্টের আয়োজক। যদি আয়োজক একজন অংশগ্রহণকারীও হন, তবে attendees তালিকায় একটি পৃথক এন্ট্রির মাধ্যমে তা নির্দেশ করা হয় এবং organizer ফিল্ডটি 'True' সেট করা থাকে। আয়োজক পরিবর্তন করতে, 'move' অপারেশনটি ব্যবহার করুন। ইভেন্ট ইম্পোর্ট করার সময় ছাড়া এটি শুধুমাত্র পঠনযোগ্য। | লেখার যোগ্য |
organizer. displayName | string | আয়োজকের নাম, যদি জানা থাকে। | লেখার যোগ্য |
organizer. email | string | আয়োজকের ইমেল ঠিকানা, যদি থাকে। RFC5322 অনুযায়ী এটি অবশ্যই একটি বৈধ ইমেল ঠিকানা হতে হবে। | লেখার যোগ্য |
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 | এই রিমাইন্ডারে ব্যবহৃত পদ্ধতি। সম্ভাব্য মানগুলো হলো:
রিমাইন্ডার যোগ করার সময় এটি আবশ্যক। | লেখার যোগ্য |
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 | ইভেন্টের অবস্থা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
| লেখার যোগ্য |
summary | string | অনুষ্ঠানের শিরোনাম। | লেখার যোগ্য |
transparency | string | ইভেন্টটি ক্যালেন্ডারে সময় ব্লক করবে কিনা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
| লেখার যোগ্য |
visibility | string | ইভেন্টের দৃশ্যমানতা। ঐচ্ছিক। সম্ভাব্য মানগুলো হলো:
পুনরাবৃত্তিমূলক ইভেন্ট সম্পর্কে দ্রষ্টব্য: একটি পুনরাবৃত্তিমূলক ইভেন্টের কোনো একটি ইনস্ট্যান্সের দৃশ্যমানতা পরিবর্তন করলে তা সিরিজের সমস্ত ইনস্ট্যান্সকে প্রভাবিত করতে পারে। যদি নতুন সেটিংটি আরও কঠোর হয় (যেমন পাবলিক থেকে প্রাইভেট), তবে এটি সমস্ত ইনস্ট্যান্সে প্রয়োগ করা হয়। যদি নতুন সেটিংটি কম কঠোর হয় (যেমন প্রাইভেট থেকে পাবলিক), তবে পরিবর্তনটি উপেক্ষা করা হয়। একটি পুনরাবৃত্তিমূলক ইভেন্টকে কম কঠোর করতে হলে, আপনাকে অবশ্যই প্যারেন্ট পুনরাবৃত্তিমূলক ইভেন্টটি আপডেট করতে হবে। | লেখার যোগ্য |
প্রতিক্রিয়া
সফল হলে, এই মেথডটি রেসপন্স বডিতে একটি ইভেন্টস রিসোর্স রিটার্ন করে।
চেষ্টা করে দেখুন!
লাইভ ডেটার উপর এই মেথডটি কল করতে এবং প্রতিক্রিয়া দেখতে নিচের এপিআই এক্সপ্লোরারটি ব্যবহার করুন।