CalendarList: list

ব্যবহারকারীর ক্যালেন্ডার তালিকায় থাকা ক্যালেন্ডারগুলো ফেরত দেয়। এখনই চেষ্টা করে দেখুন ।

অনুরোধ

HTTP অনুরোধ 

GET https://www.googleapis.com/calendar/v3/users/me/calendarList

প্যারামিটার

প্যারামিটার নাম মূল্য বর্ণনা
ঐচ্ছিক কোয়েরি প্যারামিটার
maxResults integer একটি ফলাফল পৃষ্ঠায় প্রদর্শিত এন্ট্রির সর্বোচ্চ সংখ্যা। ডিফল্ট মান হলো ১০০টি এন্ট্রি। পৃষ্ঠার আকার কখনোই ২৫০টি এন্ট্রির বেশি হতে পারবে না। ঐচ্ছিক।
minAccessRole string ফেরত আসা এন্ট্রিগুলোতে ব্যবহারকারীর জন্য সর্বনিম্ন অ্যাক্সেস ভূমিকা। ঐচ্ছিক। ডিফল্ট হলো কোনো সীমাবদ্ধতা নেই।

গ্রহণযোগ্য মানগুলো হলো:
  • " freeBusyReader ": ব্যবহারকারী ফ্রি/বিজি তথ্য পড়তে পারেন।
  • " owner ": ব্যবহারকারী ইভেন্ট পড়তে ও পরিবর্তন করতে এবং নিয়ন্ত্রণ তালিকা অ্যাক্সেস করতে পারেন।
  • " reader ": ব্যবহারকারী ব্যক্তিগত নয় এমন ইভেন্টগুলো পড়তে পারেন।
  • " writer ": ব্যবহারকারী ইভেন্টগুলো পড়তে ও পরিবর্তন করতে পারেন।
  • " writerWithoutPrivateAccess ": ব্যবহারকারী ইভেন্ট পড়তে ও পরিবর্তন করতে পারে, কিন্তু ব্যক্তিগত ইভেন্ট অ্যাক্সেস করতে পারে না।
pageToken string কোন ফলাফল পৃষ্ঠাটি ফেরত দেওয়া হবে তা নির্ধারণকারী টোকেন। ঐচ্ছিক।
showDeleted boolean ফলাফলে মুছে ফেলা ক্যালেন্ডার তালিকার এন্ট্রিগুলো অন্তর্ভুক্ত করা হবে কিনা। ঐচ্ছিক। ডিফল্ট মান হলো False।
showHidden boolean লুকানো এন্ট্রিগুলি দেখানো হবে কিনা। ঐচ্ছিক। ডিফল্ট মান হলো False।
syncToken string পূর্ববর্তী তালিকা অনুরোধের ফলাফলের শেষ পৃষ্ঠায় ফেরত আসা nextSyncToken ফিল্ড থেকে প্রাপ্ত টোকেন। এটি নিশ্চিত করে যে এই তালিকা অনুরোধের ফলাফলে শুধুমাত্র সেই এন্ট্রিগুলোই থাকবে যেগুলো তখন থেকে পরিবর্তিত হয়েছে। যদি শুধুমাত্র ক্যালেন্ডার প্রোপার্টি বা ACL-এর মতো রিড-অনলি ফিল্ডগুলো পরিবর্তিত হয়, তবে এন্ট্রিটি ফেরত দেওয়া হবে না। পূর্ববর্তী তালিকা অনুরোধের পর থেকে মুছে ফেলা এবং লুকানো সমস্ত এন্ট্রি সর্বদা ফলাফল সেটে থাকবে এবং showDeleted বা showHidden `False` সেট করার অনুমতি নেই।
ক্লায়েন্ট স্টেটের সামঞ্জস্য নিশ্চিত করতে minAccessRole কোয়েরি প্যারামিটারটি nextSyncToken সাথে একত্রে নির্দিষ্ট করা যাবে না।
যদি syncToken এর মেয়াদ শেষ হয়ে যায়, তাহলে সার্ভার 410 GONE রেসপন্স কোড দিয়ে সাড়া দেবে এবং ক্লায়েন্টের উচিত তার স্টোরেজ খালি করে কোনো syncToken ছাড়াই সম্পূর্ণ সিঙ্ক্রোনাইজেশন করা।
ইনক্রিমেন্টাল সিনক্রোনাইজেশন সম্পর্কে আরও জানুন ।
ঐচ্ছিক। ডিফল্ট হিসেবে সমস্ত এন্ট্রি ফেরত দেওয়া হয়।

অনুমোদন

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

পরিধি
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.calendarlist
https://www.googleapis.com/auth/calendar.calendarlist.readonly

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

অনুরোধকারী শরীর

এই মেথডের সাথে কোনো রিকোয়েস্ট বডি সরবরাহ করবেন না।

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

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

{
  "kind": "calendar#calendarList",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    calendarList Resource
  ]
}
সম্পত্তির নাম মূল্য বর্ণনা নোট
kind string সংগ্রহের ধরণ (" calendar#calendarList ")।
etag etag সংগ্রহটির ই-ট্যাগ।
nextPageToken string এই ফলাফলের পরবর্তী পৃষ্ঠা অ্যাক্সেস করতে ব্যবহৃত টোকেন। যদি আর কোনো ফলাফল উপলব্ধ না থাকে তবে এটি বাদ দেওয়া হয়, সেক্ষেত্রে nextSyncToken প্রদান করা হয়।
items[] list যে ক্যালেন্ডারগুলো ব্যবহারকারীর ক্যালেন্ডার তালিকায় রয়েছে।
nextSyncToken string এই ফলাফলটি ফেরত আসার পর থেকে যে এন্ট্রিগুলো পরিবর্তিত হয়েছে, শুধু সেগুলো পুনরুদ্ধার করার জন্য পরবর্তী সময়ে ব্যবহৃত টোকেন। যদি আরও ফলাফল উপলব্ধ থাকে তবে এটি বাদ দেওয়া হয়, সেক্ষেত্রে nextPageToken প্রদান করা হয়।

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

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