Events: list

নির্দিষ্ট ক্যালেন্ডারে ইভেন্টগুলি ফেরত পাঠায়। এখনই চেষ্টা করে দেখুন ।

অনুরোধ

HTTP অনুরোধ 

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

পরামিতি

প্যারামিটারের নাম মূল্য বিবরণ
পথের পরামিতি
calendarId string ক্যালেন্ডার শনাক্তকারী। ক্যালেন্ডার আইডি পুনরুদ্ধার করতে calendarList.list পদ্ধতিতে কল করুন। আপনি যদি বর্তমানে লগ ইন করা ব্যবহারকারীর প্রাথমিক ক্যালেন্ডার অ্যাক্সেস করতে চান, তাহলে " primary " কীওয়ার্ডটি ব্যবহার করুন।
ঐচ্ছিক ক্যোয়ারী প্যারামিটার
alwaysIncludeEmail boolean অবহেলিত এবং উপেক্ষিত।
eventTypes string ইভেন্টের ধরণ ফেরত দিতে হবে। ঐচ্ছিক। বিভিন্ন ধরণের ইভেন্ট ফেরত দিতে এই প্যারামিটারটি একাধিকবার পুনরাবৃত্তি করা যেতে পারে। যদি সেট না করা থাকে, তাহলে সমস্ত ইভেন্টের ধরণ ফেরত দেয়।

গ্রহণযোগ্য মানগুলি হল:
  • " birthday ": বার্ষিক পুনরাবৃত্তি সহ সারাদিনের বিশেষ অনুষ্ঠান।
  • " default ": নিয়মিত ইভেন্ট।
  • " focusTime ": ফোকাস টাইম ইভেন্ট।
  • " fromGmail ": Gmail থেকে ইভেন্ট।
  • " outOfOffice ": অফিসের বাইরের ইভেন্ট।
  • " workingLocation ": কর্মস্থলের ইভেন্ট।
iCalUID string প্রতিক্রিয়ায় প্রদান করার জন্য iCalendar ফর্ম্যাটে একটি ইভেন্ট আইডি নির্দিষ্ট করে। ঐচ্ছিক। যদি আপনি কোনও ইভেন্টের iCalendar আইডি দিয়ে অনুসন্ধান করতে চান তবে এটি ব্যবহার করুন।
maxAttendees integer উত্তরে সর্বোচ্চ কতজন অংশগ্রহণকারী অন্তর্ভুক্ত করতে হবে। যদি নির্দিষ্ট সংখ্যক অংশগ্রহণকারী থাকে, তাহলে শুধুমাত্র অংশগ্রহণকারীকেই ফেরত পাঠানো হবে। ঐচ্ছিক।
maxResults integer একটি ফলাফল পৃষ্ঠায় সর্বাধিক সংখ্যক ইভেন্ট ফেরত এসেছে। ফলাফল পৃষ্ঠায় ইভেন্টের সংখ্যা এই মানের চেয়ে কম হতে পারে, অথবা একেবারেই নাও হতে পারে, এমনকি যদি কোয়েরির সাথে মিলে যাওয়া আরও ইভেন্ট থাকে। অসম্পূর্ণ পৃষ্ঠাগুলি প্রতিক্রিয়াতে একটি খালি নয় এমন nextPageToken ক্ষেত্র দ্বারা সনাক্ত করা যেতে পারে। ডিফল্টরূপে মান 250 ইভেন্ট। পৃষ্ঠার আকার কখনই 2500 ইভেন্টের চেয়ে বড় হতে পারে না। ঐচ্ছিক।
orderBy string ফলাফলে ইভেন্টের ক্রম দেখানো হয়েছে। ঐচ্ছিক। ডিফল্ট হল একটি অনির্দিষ্ট, স্থিতিশীল ক্রম।

গ্রহণযোগ্য মানগুলি হল:
  • " startTime ": শুরুর তারিখ/সময় অনুসারে (আরোহী ক্রম অনুসারে) ক্রমানুসারে। এটি শুধুমাত্র একক ইভেন্ট অনুসন্ধানের সময় উপলব্ধ (অর্থাৎ singleEvents প্যারামিটারটি সত্য)।
  • " updated ": শেষ পরিবর্তনের সময় অনুসারে (আরোহী ক্রম অনুসারে) ক্রম করুন।
pageToken string কোন ফলাফল পৃষ্ঠাটি ফেরত পাঠাতে হবে তা নির্দিষ্ট করে টোকেন। ঐচ্ছিক।
privateExtendedProperty string propertyName=value হিসেবে নির্দিষ্ট করা বর্ধিত বৈশিষ্ট্যের সীমাবদ্ধতা। শুধুমাত্র ব্যক্তিগত বৈশিষ্ট্যের সাথে মিলিত হয়। প্রদত্ত সমস্ত সীমাবদ্ধতার সাথে মেলে এমন ইভেন্টগুলি ফেরত দিতে এই প্যারামিটারটি একাধিকবার পুনরাবৃত্তি করা যেতে পারে।
q string নিম্নলিখিত ক্ষেত্রগুলিতে এই পদগুলির সাথে মেলে এমন ইভেন্টগুলি খুঁজে পেতে বিনামূল্যে পাঠ্য অনুসন্ধান পদ:
  • summary
  • description
  • location
  • অংশগ্রহণকারীর displayName
  • অংশগ্রহণকারীর email
  • সংগঠকের displayName
  • আয়োজকের email
  • workingLocationProperties.officeLocation.buildingId
  • workingLocationProperties.officeLocation.deskId
  • workingLocationProperties.officeLocation.label
  • workingLocationProperties.customLocation.label

এই অনুসন্ধান পদগুলি কর্মক্ষেত্রের অবস্থান, অফিসের বাইরের এবং ফোকাস-টাইম ইভেন্টের সমস্ত প্রদর্শন শিরোনাম অনুবাদের সাথে পূর্বনির্ধারিত কীওয়ার্ডগুলির সাথেও মেলে। উদাহরণস্বরূপ, "অফিস" বা "ব্যুরো" অনুসন্ধান করলে officeLocation ধরণের কর্মক্ষেত্রের অবস্থানের ইভেন্টগুলি ফেরত পাওয়া যায়, যেখানে "অফিসের বাইরের" বা "Abwesend" অনুসন্ধান করলে অফিসের বাইরের ইভেন্টগুলি ফেরত পাওয়া যায়। ঐচ্ছিক।

sharedExtendedProperty string propertyName=value হিসেবে নির্দিষ্ট করা বর্ধিত বৈশিষ্ট্যের সীমাবদ্ধতা। শুধুমাত্র ভাগ করা বৈশিষ্ট্যের সাথে মিলিত হয়। প্রদত্ত সমস্ত সীমাবদ্ধতার সাথে মেলে এমন ইভেন্টগুলি ফেরত দিতে এই প্যারামিটারটি একাধিকবার পুনরাবৃত্তি করা যেতে পারে।
showDeleted boolean ফলাফলে মুছে ফেলা ইভেন্টগুলি (" cancelled " এর সমান status সহ) অন্তর্ভুক্ত করা হবে কিনা। showDeleted এবং singleEvents উভয়ই মিথ্যা হলে পুনরাবৃত্ত ইভেন্টগুলির বাতিল করা উদাহরণগুলি (কিন্তু অন্তর্নিহিত পুনরাবৃত্ত ইভেন্ট নয়) এখনও অন্তর্ভুক্ত করা হবে। যদি showDeleted এবং singleEvents উভয়ই সত্য হয়, তবে মুছে ফেলা ইভেন্টগুলির কেবলমাত্র একক উদাহরণ (কিন্তু অন্তর্নিহিত পুনরাবৃত্ত ইভেন্ট নয়) ফেরত দেওয়া হবে। ঐচ্ছিক। ডিফল্ট হল মিথ্যা।
showHiddenInvitations boolean ফলাফলে লুকানো আমন্ত্রণগুলি অন্তর্ভুক্ত করা হবে কিনা। ঐচ্ছিক। ডিফল্ট হল মিথ্যা।
singleEvents boolean পুনরাবৃত্ত ইভেন্টগুলিকে ইনস্ট্যান্সে প্রসারিত করা হবে কিনা এবং শুধুমাত্র একক-একক ইভেন্ট এবং পুনরাবৃত্ত ইভেন্টের ইনস্ট্যান্সগুলি ফেরত পাঠানো হবে কিনা, কিন্তু অন্তর্নিহিত পুনরাবৃত্ত ইভেন্টগুলি নয়। ঐচ্ছিক। ডিফল্ট হল মিথ্যা।
syncToken string পূর্ববর্তী তালিকা অনুরোধের ফলাফলের শেষ পৃষ্ঠায় nextSyncToken ক্ষেত্র থেকে প্রাপ্ত টোকেনটি ফিরে আসে। এটি এই তালিকা অনুরোধের ফলাফলে কেবলমাত্র সেইসব এন্ট্রি ধারণ করে যা তখন থেকে পরিবর্তিত হয়েছে। পূর্ববর্তী তালিকা অনুরোধের পর থেকে মুছে ফেলা সমস্ত ইভেন্ট সর্বদা ফলাফল সেটে থাকবে এবং showDeleted কে মিথ্যাতে সেট করার অনুমতি নেই।
ক্লায়েন্ট অবস্থার ধারাবাহিকতা নিশ্চিত করার জন্য বেশ কিছু কোয়েরি প্যারামিটার আছে যা nextSyncToken এর সাথে একত্রে নির্দিষ্ট করা যাবে না।

এগুলো হল:
  • iCalUID
  • orderBy
  • privateExtendedProperty
  • q
  • sharedExtendedProperty
  • timeMin
  • timeMax
  • updatedMin
অনির্ধারিত আচরণ এড়াতে অন্যান্য সমস্ত কোয়েরি প্যারামিটার প্রাথমিক সিঙ্ক্রোনাইজেশনের মতোই হওয়া উচিত। যদি syncToken মেয়াদ শেষ হয়ে যায়, তাহলে সার্ভারটি 410 GONE রেসপন্স কোড দিয়ে সাড়া দেবে এবং ক্লায়েন্টকে তার স্টোরেজ সাফ করতে হবে এবং কোনও syncToken ছাড়াই সম্পূর্ণ সিঙ্ক্রোনাইজেশন করতে হবে।
ক্রমবর্ধমান সিঙ্ক্রোনাইজেশন সম্পর্কে আরও জানুন ।
ঐচ্ছিক। ডিফল্টভাবে সকল এন্ট্রি ফেরত দেওয়া হয়।
timeMax datetime কোনও ইভেন্টের শুরুর সময় ফিল্টার করার জন্য উপরের সীমা (এক্সক্লুসিভ)। ঐচ্ছিক। ডিফল্টভাবে শুরুর সময় অনুসারে ফিল্টার করা হয় না। বাধ্যতামূলক টাইম জোন অফসেট সহ একটি RFC3339 টাইমস্ট্যাম্প হতে হবে, উদাহরণস্বরূপ, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z। মিলিসেকেন্ড প্রদান করা যেতে পারে কিন্তু উপেক্ষা করা হয়। যদি timeMin সেট করা থাকে, তাহলে timeMax অবশ্যই timeMin এর চেয়ে বড় হতে হবে।
timeMin datetime কোনও ইভেন্টের শেষ সময়ের জন্য নিম্ন সীমা (এক্সক্লুসিভ) ফিল্টার করার জন্য। ঐচ্ছিক। ডিফল্টভাবে শেষ সময় অনুসারে ফিল্টার করা হয় না। বাধ্যতামূলক টাইম জোন অফসেট সহ একটি RFC3339 টাইমস্ট্যাম্প হতে হবে, উদাহরণস্বরূপ, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z। মিলিসেকেন্ড প্রদান করা যেতে পারে কিন্তু উপেক্ষা করা হয়। যদি timeMax সেট করা থাকে, তাহলে timeMin অবশ্যই timeMax এর চেয়ে ছোট হতে হবে।
timeZone string প্রতিক্রিয়ায় ব্যবহৃত সময় অঞ্চল। ঐচ্ছিক। ডিফল্ট হল ক্যালেন্ডারের সময় অঞ্চল।
updatedMin datetime কোনও ইভেন্টের শেষ পরিবর্তনের সময় ( RFC3339 টাইমস্ট্যাম্প হিসেবে) ফিল্টার করার জন্য নিম্ন সীমা। নির্দিষ্ট করা হলে, showDeleted নির্বিশেষে এই সময়ের থেকে মুছে ফেলা এন্ট্রিগুলি সর্বদা অন্তর্ভুক্ত করা হবে। ঐচ্ছিক। ডিফল্ট হল শেষ পরিবর্তনের সময় অনুসারে ফিল্টার করা নয়।

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

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

অনুরোধের মূল অংশ

এই পদ্ধতিতে কোনও অনুরোধের বডি সরবরাহ করবেন না।

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

যদি সফল হয়, তাহলে এই পদ্ধতিটি নিম্নলিখিত কাঠামো সহ একটি প্রতিক্রিয়া বডি প্রদান করে: 

{
  "kind": "calendar#events",
  "etag": etag,
  "summary": string,
  "description": string,
  "updated": datetime,
  "timeZone": string,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    events Resource
  ]
}
সম্পত্তির নাম মূল্য বিবরণ মন্তব্য
kind string সংগ্রহের ধরণ (" calendar#events ")।
etag etag সংগ্রহের ETag।
summary string ক্যালেন্ডারের শিরোনাম। কেবল পঠনযোগ্য।
description string ক্যালেন্ডারের বর্ণনা। কেবল পঠনযোগ্য।
updated datetime ক্যালেন্ডারের শেষ পরিবর্তনের সময় ( RFC3339 টাইমস্ট্যাম্প হিসেবে)। শুধুমাত্র পঠনযোগ্য।
timeZone string ক্যালেন্ডারের সময় অঞ্চল। কেবল পঠনযোগ্য।
accessRole string এই ক্যালেন্ডারের জন্য ব্যবহারকারীর অ্যাক্সেস ভূমিকা। কেবল পঠনযোগ্য। সম্ভাব্য মানগুলি হল:
  • " none " - ব্যবহারকারীর কোনও অ্যাক্সেস নেই।
  • " freeBusyReader " - ব্যবহারকারীর অবাধ/ব্যস্ত তথ্য পড়ার অ্যাক্সেস আছে।
  • " reader " - ব্যবহারকারীর ক্যালেন্ডারে পড়ার অ্যাক্সেস আছে। পাঠকের অ্যাক্সেস আছে এমন ব্যবহারকারীদের কাছে ব্যক্তিগত ইভেন্টগুলি প্রদর্শিত হবে, কিন্তু ইভেন্টের বিবরণ লুকানো থাকবে।
  • " writer " - ব্যবহারকারীর ক্যালেন্ডারে পড়ার এবং লেখার অ্যাক্সেস আছে। লেখকের অ্যাক্সেস থাকা ব্যবহারকারীদের কাছে ব্যক্তিগত ইভেন্টগুলি প্রদর্শিত হবে এবং ইভেন্টের বিবরণ দৃশ্যমান হবে।
  • " owner " - ব্যবহারকারীর ক্যালেন্ডারে ম্যানেজার অ্যাক্সেস আছে। এই ভূমিকায় লেখকের ভূমিকার সমস্ত অনুমতি রয়েছে এবং অন্যান্য ব্যবহারকারীদের অ্যাক্সেস স্তরগুলি দেখার এবং পরিবর্তন করার অতিরিক্ত ক্ষমতা রয়েছে।

defaultReminders[] list প্রমাণিত ব্যবহারকারীর জন্য ক্যালেন্ডারে ডিফল্ট অনুস্মারক। এই অনুস্মারকগুলি এই ক্যালেন্ডারের সমস্ত ইভেন্টের ক্ষেত্রে প্রযোজ্য যা স্পষ্টভাবে তাদের ওভাররাইড করে না (অর্থাৎ reminders.useDefault True তে সেট করা নেই)।
defaultReminders[]. method string এই অনুস্মারক দ্বারা ব্যবহৃত পদ্ধতি। সম্ভাব্য মানগুলি হল:
  • " email " - অনুস্মারক ইমেলের মাধ্যমে পাঠানো হয়।
  • " popup " - একটি UI পপআপের মাধ্যমে অনুস্মারক পাঠানো হয়।

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

 লেখার যোগ্য
defaultReminders[]. minutes integer ইভেন্ট শুরু হওয়ার আগে কত মিনিটের মধ্যে রিমাইন্ডারটি ট্রিগার করা উচিত। বৈধ মানগুলি 0 এবং 40320 (মিনিটের মধ্যে 4 সপ্তাহ) এর মধ্যে।

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

 লেখার যোগ্য
nextPageToken string এই ফলাফলের পরবর্তী পৃষ্ঠা অ্যাক্সেস করার জন্য টোকেন ব্যবহার করা হয়েছে। যদি আর কোনও ফলাফল উপলব্ধ না হয় তবে বাদ দেওয়া হয়, এই ক্ষেত্রে nextSyncToken প্রদান করা হয়।
items[] list ক্যালেন্ডারে ইভেন্টের তালিকা।
nextSyncToken string এই ফলাফলটি ফেরত দেওয়ার পর থেকে পরিবর্তিত এন্ট্রিগুলি পুনরুদ্ধার করার জন্য পরবর্তী সময়ে টোকেন ব্যবহার করা হয়েছিল। আরও ফলাফল পাওয়া গেলে বাদ দেওয়া হয়, এই ক্ষেত্রে nextPageToken প্রদান করা হয়।

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

লাইভ ডেটাতে এই পদ্ধতিটি কল করতে এবং প্রতিক্রিয়া দেখতে নীচের APIs Explorer ব্যবহার করুন।