Events: instances

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

অনুরোধ

HTTP অনুরোধ 

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

পরামিতি

প্যারামিটারের নাম মূল্য বিবরণ
পথের পরামিতি
calendarId string ক্যালেন্ডার শনাক্তকারী। ক্যালেন্ডার আইডি পুনরুদ্ধার করতে calendarList.list পদ্ধতিতে কল করুন। আপনি যদি বর্তমানে লগ ইন করা ব্যবহারকারীর প্রাথমিক ক্যালেন্ডার অ্যাক্সেস করতে চান, তাহলে " primary " কীওয়ার্ডটি ব্যবহার করুন।
eventId string পুনরাবৃত্ত ইভেন্ট শনাক্তকারী।
ঐচ্ছিক ক্যোয়ারী প্যারামিটার
alwaysIncludeEmail boolean অবচিত এবং উপেক্ষা করা হয়েছে। আয়োজক, স্রষ্টা এবং অংশগ্রহণকারীদের জন্য email ক্ষেত্রে সর্বদা একটি মান ফেরত পাঠানো হবে, এমনকি যদি কোনও প্রকৃত ইমেল ঠিকানা উপলব্ধ না থাকে (অর্থাৎ একটি উত্পন্ন, অ-কার্যকর মান প্রদান করা হবে)।
maxAttendees integer উত্তরে সর্বোচ্চ কতজন অংশগ্রহণকারী অন্তর্ভুক্ত করতে হবে। যদি নির্দিষ্ট সংখ্যক অংশগ্রহণকারী থাকে, তাহলে শুধুমাত্র অংশগ্রহণকারীকেই ফেরত পাঠানো হবে। ঐচ্ছিক।
maxResults integer একটি ফলাফল পৃষ্ঠায় সর্বাধিক সংখ্যক ইভেন্ট ফেরত পাঠানো যাবে। ডিফল্টরূপে মান হল ২৫০টি ইভেন্ট। পৃষ্ঠার আকার কখনই ২৫০০টি ইভেন্টের চেয়ে বড় হতে পারে না। ঐচ্ছিক।
originalStart string ফলাফলে ইনস্ট্যান্সের মূল শুরুর সময়। ঐচ্ছিক।
pageToken string কোন ফলাফল পৃষ্ঠাটি ফেরত পাঠাতে হবে তা নির্দিষ্ট করে টোকেন। ঐচ্ছিক।
showDeleted boolean ফলাফলে মুছে ফেলা ইভেন্টগুলি (" cancelled " এর সমান status সহ) অন্তর্ভুক্ত করা হবে কিনা। singleEvents False হলে পুনরাবৃত্ত ইভেন্টগুলির বাতিল করা উদাহরণগুলি এখনও অন্তর্ভুক্ত করা হবে। ঐচ্ছিক। ডিফল্ট হল False।
timeMax datetime কোনও ইভেন্টের শুরুর সময়ের জন্য উপরের সীমা (এক্সক্লুসিভ) ফিল্টার করার জন্য। ঐচ্ছিক। ডিফল্টভাবে শুরুর সময় অনুসারে ফিল্টার করা হয় না। বাধ্যতামূলক টাইম জোন অফসেট সহ একটি RFC3339 টাইমস্ট্যাম্প হতে হবে।
timeMin datetime কোনও ইভেন্টের শেষ সময়ের জন্য নিম্ন সীমা (সমেত) ফিল্টার করার জন্য। ঐচ্ছিক। ডিফল্টভাবে শেষ সময় অনুসারে ফিল্টার করা হয় না। বাধ্যতামূলক টাইম জোন অফসেট সহ একটি RFC3339 টাইমস্ট্যাম্প হতে হবে।
timeZone string প্রতিক্রিয়ায় ব্যবহৃত সময় অঞ্চল। ঐচ্ছিক। ডিফল্ট হল ক্যালেন্ডারের সময় অঞ্চল।

অনুমোদন

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

ব্যাপ্তি
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 ব্যবহার করুন।