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 একটি ফলাফলের পৃষ্ঠায় সর্বাধিক সংখ্যক ইভেন্ট ফিরে এসেছে। ডিফল্টরূপে মান হল 250 ইভেন্ট। পৃষ্ঠার আকার কখনই 2500 ইভেন্টের চেয়ে বড় হতে পারে না। ঐচ্ছিক।
originalStart string ফলাফলে উদাহরণের মূল শুরুর সময়। ঐচ্ছিক।
pageToken string কোন ফলাফল পৃষ্ঠায় ফিরতে হবে তা উল্লেখ করে টোকেন। ঐচ্ছিক।
showDeleted boolean ফলাফলে মুছে ফেলা ইভেন্টগুলি ( status " cancelled " এর সমান) অন্তর্ভুক্ত করা হবে কিনা। singleEvents মিথ্যা হলে পুনরাবৃত্ত ইভেন্টগুলির বাতিল দৃষ্টান্তগুলি এখনও অন্তর্ভুক্ত করা হবে৷ ঐচ্ছিক। ডিফল্ট হল 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

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

শরীরের অনুরোধ

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

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

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

{
  "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 " - ব্যবহারকারীর ক্যালেন্ডারের মালিকানা আছে৷ এই ভূমিকাটিতে লেখকের ভূমিকার সমস্ত অনুমতি রয়েছে যার অতিরিক্ত ACL দেখতে এবং ম্যানিপুলেট করার ক্ষমতা রয়েছে৷
defaultReminders[] list প্রমাণীকৃত ব্যবহারকারীর জন্য ক্যালেন্ডারে ডিফল্ট অনুস্মারক। এই অনুস্মারকগুলি এই ক্যালেন্ডারের সমস্ত ইভেন্টের জন্য প্রযোজ্য যা স্পষ্টভাবে তাদের ওভাররাইড করে না (যেমন reminders.useDefault সত্যে সেট করা নেই)৷
defaultReminders[]. method string এই অনুস্মারক দ্বারা ব্যবহৃত পদ্ধতি. সম্ভাব্য মান হল:
  • " email " - অনুস্মারক ইমেলের মাধ্যমে পাঠানো হয়।
  • " popup " - অনুস্মারকগুলি একটি UI পপআপের মাধ্যমে পাঠানো হয়৷

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

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

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

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

উদাহরণ

দ্রষ্টব্য: এই পদ্ধতির জন্য উপলব্ধ কোড উদাহরণগুলি সমস্ত সমর্থিত প্রোগ্রামিং ভাষার প্রতিনিধিত্ব করে না (সমর্থিত ভাষার তালিকার জন্য ক্লায়েন্ট লাইব্রেরি পৃষ্ঠা দেখুন)।

জাভা

জাভা ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;
import com.google.api.services.calendar.model.Events;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Iterate over the instances of a specific recurring event
String pageToken = null;
do {
  Events events =
      service.events().instances('primary', 'eventId').setPageToken(pageToken).execute();
  List<Event> items = events.getItems();
  for (Event event : items) {
    System.out.println(event.getSummary());
  }
  pageToken = events.getNextPageToken();
} while (pageToken != null);

পাইথন

পাইথন ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

page_token = None
while True:
  events = service.events().instances(calendarId='primary', eventId='eventId',
                                      pageToken=page_token).execute()
  for event in events['items']:
    print event['summary']
  page_token = events.get('nextPageToken')
  if not page_token:
    break

পিএইচপি

পিএইচপি ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

$events = $service->events->instances('primary', "eventId");

while(true) {
  foreach ($events->getItems() as $event) {
    echo $event->getSummary();
  }
  $pageToken = $events->getNextPageToken();
  if ($pageToken) {
    $optParams = array('pageToken' => $pageToken);
    $events = $service->events->instances('primary', "eventId",
        $optParams);
  } else {
    break;
  }
}

রুবি

রুবি ক্লায়েন্ট লাইব্রেরি ব্যবহার করে।

page_token = nil
begin
  result = client.list_event_instances('primary', 'eventId')
  result.items.each do |e|
    print e.summary + "\n"
  end
  if result.next_page_token != page_token
    page_token = result.next_page_token
  else
    page_token = nil
  end
end while !page_token.nil?

এটা চেষ্টা করুন!

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