Events: list

নির্দিষ্ট ক্যালেন্ডারে ইভেন্ট দেখায়। এখন এটি চেষ্টা করুন বা একটি উদাহরণ দেখুন

অনুরোধ

HTTP অনুরোধ

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

পরামিতি

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

গ্রহণযোগ্য মান হল:
  • " default ": নিয়মিত ঘটনা।
  • " focusTime ": ফোকাস টাইম ইভেন্ট।
  • " outOfOffice ": অফিসের বাইরে ইভেন্ট।
  • " workingLocation ": কাজের অবস্থানের ঘটনা।
iCalUID string iCalendar বিন্যাসে একটি ইভেন্ট আইডি নির্দিষ্ট করে যা প্রতিক্রিয়াতে প্রদান করা হবে। ঐচ্ছিক। আপনি যদি কোনো ইভেন্টের iCalendar ID দ্বারা অনুসন্ধান করতে চান তাহলে এটি ব্যবহার করুন।
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 অবস্থানের ইভেন্টগুলি প্রদান করে, যেখানে "অফিসের বাইরে" বা "অ্যাবসেন্ড" অনুসন্ধান করা অফিসের বাইরের ইভেন্টগুলি প্রদান করে৷ ঐচ্ছিক।

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

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

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

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

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

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

{
  "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 events in the specified calendar
String pageToken = null;
do {
  Events events = service.events().list('primary').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().list(calendarId='primary', 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->listEvents('primary');

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

রুবি

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

page_token = nil
begin
  result = client.list_events('primary', page_token: page_token)
  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 এক্সপ্লোরার ব্যবহার করুন।