CalendarList: list

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

অনুরোধ

HTTP অনুরোধ 

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

পরামিতি

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

গ্রহণযোগ্য মান হল:
  • " freeBusyReader ": ব্যবহারকারী বিনামূল্যে/ব্যস্ত তথ্য পড়তে পারেন।
  • " owner ": ব্যবহারকারী ইভেন্টগুলি এবং অ্যাক্সেস নিয়ন্ত্রণ তালিকাগুলি পড়তে এবং সংশোধন করতে পারে৷
  • " reader ": ব্যবহারকারী এমন ঘটনা পড়তে পারে যা ব্যক্তিগত নয়।
  • " writer ": ব্যবহারকারী ইভেন্ট পড়তে এবং পরিবর্তন করতে পারে।
pageToken string কোন ফলাফল পৃষ্ঠায় ফিরতে হবে তা উল্লেখ করে টোকেন। ঐচ্ছিক।
showDeleted boolean মুছে ফেলা ক্যালেন্ডার তালিকার এন্ট্রি ফলাফলে অন্তর্ভুক্ত করা হবে কিনা। ঐচ্ছিক। ডিফল্ট হল False.
showHidden boolean লুকানো এন্ট্রি দেখাতে হবে কিনা। ঐচ্ছিক। ডিফল্ট হল False.
syncToken string nextSyncToken ক্ষেত্র থেকে প্রাপ্ত টোকেন পূর্ববর্তী তালিকা অনুরোধ থেকে ফলাফলের শেষ পৃষ্ঠায় ফিরে এসেছে। এটি এই তালিকার অনুরোধের ফলাফলে শুধুমাত্র এন্ট্রি ধারণ করে যেগুলি তখন থেকে পরিবর্তিত হয়েছে। যদি শুধুমাত্র পঠনযোগ্য ক্ষেত্র যেমন ক্যালেন্ডার বৈশিষ্ট্য বা ACL পরিবর্তিত হয়, তাহলে এন্ট্রি ফেরত দেওয়া হবে না। সমস্ত এন্ট্রি মুছে ফেলা হয়েছে এবং লুকানো হয়েছে যেহেতু পূর্ববর্তী তালিকার অনুরোধ সর্বদা ফলাফল সেটে থাকবে এবং এটি showDeleted বা showHidden থেকে ফলস সেট করার অনুমতি নেই।
ক্লায়েন্ট স্টেট কনসিসটেন্সি নিশ্চিত করতে 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 সংগ্রহের ETag.
nextPageToken string এই ফলাফলের পরবর্তী পৃষ্ঠায় প্রবেশ করতে ব্যবহৃত টোকেন। আর কোন ফলাফল পাওয়া না গেলে বাদ দেওয়া হবে, যে ক্ষেত্রে nextSyncToken প্রদান করা হয়।
items[] list ব্যবহারকারীর ক্যালেন্ডার তালিকায় উপস্থিত ক্যালেন্ডার।
nextSyncToken string এই ফলাফলটি ফেরত দেওয়ার পর থেকে পরিবর্তিত এন্ট্রিগুলি পুনরুদ্ধার করার জন্য পরবর্তী সময়ে ব্যবহৃত টোকেন। যদি আরও ফলাফল পাওয়া যায় তাহলে বাদ দেওয়া হবে, যে ক্ষেত্রে nextPageToken প্রদান করা হয়।

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

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

,

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

অনুরোধ

HTTP অনুরোধ 

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

পরামিতি

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

গ্রহণযোগ্য মান হল:
  • " freeBusyReader ": ব্যবহারকারী বিনামূল্যে/ব্যস্ত তথ্য পড়তে পারেন।
  • " owner ": ব্যবহারকারী ইভেন্টগুলি এবং অ্যাক্সেস নিয়ন্ত্রণ তালিকাগুলি পড়তে এবং সংশোধন করতে পারে৷
  • " reader ": ব্যবহারকারী এমন ঘটনা পড়তে পারে যা ব্যক্তিগত নয়।
  • " writer ": ব্যবহারকারী ইভেন্ট পড়তে এবং পরিবর্তন করতে পারে।
pageToken string কোন ফলাফল পৃষ্ঠায় ফিরতে হবে তা উল্লেখ করে টোকেন। ঐচ্ছিক।
showDeleted boolean মুছে ফেলা ক্যালেন্ডার তালিকার এন্ট্রি ফলাফলে অন্তর্ভুক্ত করা হবে কিনা। ঐচ্ছিক। ডিফল্ট হল False.
showHidden boolean লুকানো এন্ট্রি দেখাতে হবে কিনা। ঐচ্ছিক। ডিফল্ট হল False.
syncToken string nextSyncToken ক্ষেত্র থেকে প্রাপ্ত টোকেন পূর্ববর্তী তালিকা অনুরোধ থেকে ফলাফলের শেষ পৃষ্ঠায় ফিরে এসেছে। এটি এই তালিকার অনুরোধের ফলাফলে শুধুমাত্র এন্ট্রি ধারণ করে যেগুলি তখন থেকে পরিবর্তিত হয়েছে। যদি শুধুমাত্র পঠনযোগ্য ক্ষেত্র যেমন ক্যালেন্ডার বৈশিষ্ট্য বা ACL পরিবর্তিত হয়, তাহলে এন্ট্রি ফেরত দেওয়া হবে না। সমস্ত এন্ট্রি মুছে ফেলা হয়েছে এবং লুকানো হয়েছে যেহেতু পূর্ববর্তী তালিকার অনুরোধ সর্বদা ফলাফল সেটে থাকবে এবং এটি showDeleted বা showHidden থেকে ফলস সেট করার অনুমতি নেই।
ক্লায়েন্ট স্টেট কনসিসটেন্সি নিশ্চিত করতে 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 সংগ্রহের ETag.
nextPageToken string এই ফলাফলের পরবর্তী পৃষ্ঠায় প্রবেশ করতে ব্যবহৃত টোকেন। আর কোন ফলাফল পাওয়া না গেলে বাদ দেওয়া হবে, যে ক্ষেত্রে nextSyncToken প্রদান করা হয়।
items[] list ব্যবহারকারীর ক্যালেন্ডার তালিকায় উপস্থিত ক্যালেন্ডার।
nextSyncToken string এই ফলাফলটি ফেরত দেওয়ার পর থেকে পরিবর্তিত এন্ট্রিগুলি পুনরুদ্ধার করার জন্য পরবর্তী সময়ে ব্যবহৃত টোকেন। যদি আরও ফলাফল পাওয়া যায় তাহলে বাদ দেওয়া হবে, যে ক্ষেত্রে nextPageToken প্রদান করা হয়।

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

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