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 ফলাফলে মুছে ফেলা ইভেন্টগুলো (যেগুলোর status " cancelled ") অন্তর্ভুক্ত করা হবে কিনা। 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 সংগ্রহটির ই-ট্যাগ।
summary string ক্যালেন্ডারের শিরোনাম। শুধুমাত্র পঠনযোগ্য।
description string ক্যালেন্ডারের বিবরণ। শুধুমাত্র পঠনযোগ্য।
updated datetime ক্যালেন্ডারের সর্বশেষ পরিবর্তনের সময় ( RFC3339 টাইমস্ট্যাম্প হিসেবে)। শুধুমাত্র পাঠযোগ্য।
timeZone string ক্যালেন্ডারের সময় অঞ্চল। শুধুমাত্র পঠনযোগ্য।
accessRole string এই ক্যালেন্ডারের জন্য ব্যবহারকারীর অ্যাক্সেস রোল। শুধুমাত্র পঠনযোগ্য। সম্ভাব্য মানগুলো হলো:
  • " none " - ব্যবহারকারীর কোনো অ্যাক্সেস নেই।
  • " freeBusyReader " - ব্যবহারকারীর ফ্রি/বিজি তথ্যে পড়ার অ্যাক্সেস আছে।
  • " reader " - ব্যবহারকারীর ক্যালেন্ডারটি পড়ার অ্যাক্সেস আছে। ব্যক্তিগত ইভেন্টগুলো রিডার অ্যাক্সেস থাকা ব্যবহারকারীরা দেখতে পাবেন, কিন্তু ইভেন্টের বিস্তারিত তথ্য গোপন থাকবে।
  • " writerWithoutPrivateAccess " - এই ব্যবহারকারীর ক্যালেন্ডারে পড়া এবং লেখার অ্যাক্সেস আছে। ব্যক্তিগত ইভেন্টগুলো writerWithoutPrivateAccess অ্যাক্সেস থাকা ব্যবহারকারীদের কাছে দেখা যাবে, কিন্তু ইভেন্টের বিস্তারিত তথ্য গোপন থাকবে।
  • " writer " - এই ব্যবহারকারীর ক্যালেন্ডারে পড়া এবং লেখার অ্যাক্সেস রয়েছে। ব্যক্তিগত ইভেন্টগুলো রাইটার অ্যাক্সেস থাকা ব্যবহারকারীদের কাছে প্রদর্শিত হবে এবং ইভেন্টের বিস্তারিত বিবরণ দেখা যাবে।
  • " owner " - এই ব্যবহারকারীর ক্যালেন্ডারে ব্যবস্থাপক অ্যাক্সেস রয়েছে। এই রোলের লেখক রোলের সমস্ত অনুমতির পাশাপাশি অন্যান্য ব্যবহারকারীদের অ্যাক্সেস স্তর দেখা এবং পরিবর্তন করার অতিরিক্ত ক্ষমতাও রয়েছে।

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

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

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

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

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

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

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