Freebusy: query

দ্রষ্টব্য: অনুমোদন ঐচ্ছিক।

ক্যালেন্ডারের একটি সেটের জন্য বিনামূল্যে/ব্যস্ত তথ্য প্রদান করে। এখনই চেষ্টা করে দেখুন ।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/calendar/v3/freeBusy

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar

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

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

অনুরোধের অংশে, নিম্নলিখিত কাঠামোর সাথে ডেটা সরবরাহ করুন:

{
  "timeMin": datetime,
  "timeMax": datetime,
  "timeZone": string,
  "groupExpansionMax": integer,
  "calendarExpansionMax": integer,
  "items": [
    {
      "id": string
    }
  ]
}

সম্পত্তির নাম	মান	বর্ণনা	নোট
timeMin	datetime	RFC3339 অনুযায়ী ফরম্যাট করা প্রশ্নের জন্য বিরতির শুরু।
timeMax	datetime	RFC3339 অনুযায়ী ফরম্যাট করা প্রশ্নের জন্য ব্যবধানের শেষ।
timeZone	string	উত্তরে ব্যবহৃত সময় অঞ্চল। ঐচ্ছিক। ডিফল্ট হল UTC।
groupExpansionMax	integer	একটি একক গোষ্ঠীর জন্য সর্বাধিক সংখ্যক ক্যালেন্ডার সনাক্তকারী প্রদান করতে হবে৷ ঐচ্ছিক। এই মানের চেয়ে বেশি সদস্য সহ একটি গ্রুপের জন্য একটি ত্রুটি ফেরত দেওয়া হয়। সর্বোচ্চ মান 100।
calendarExpansionMax	integer	সর্বাধিক সংখ্যক ক্যালেন্ডার যার জন্য FreeBusy তথ্য প্রদান করতে হবে। ঐচ্ছিক। সর্বোচ্চ মান 50।
items[]	list	প্রশ্ন করার জন্য ক্যালেন্ডার এবং/অথবা গ্রুপের তালিকা।
items[]. id	string	একটি ক্যালেন্ডার বা একটি গোষ্ঠীর শনাক্তকারী৷

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

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

{
  "kind": "calendar#freeBusy",
  "timeMin": datetime,
  "timeMax": datetime,
  "groups": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "calendars": [
        string
      ]
    }
  },
  "calendars": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "busy": [
        {
          "start": datetime,
          "end": datetime
        }
      ]
    }
  }
}

সম্পত্তির নাম	মান	বর্ণনা	নোট
kind	string	রিসোর্সের ধরন ("ক্যালেন্ডার#ফ্রিবিজি")।
timeMin	datetime	বিরতির শুরু।
timeMax	datetime	ব্যবধান শেষ।
groups	object	গোষ্ঠীর সম্প্রসারণ।
groups. (key)	nested object	ক্যালেন্ডারের তালিকা যারা এই গ্রুপের সদস্য।
groups.(key). errors[]	list	ঐচ্ছিক ত্রুটি(গুলি) (যদি গ্রুপের জন্য গণনা ব্যর্থ হয়)।
groups.(key).errors[]. domain	string	ত্রুটির ডোমেন, বা বিস্তৃত বিভাগ।
groups.(key).errors[]. reason	string	ত্রুটির জন্য নির্দিষ্ট কারণ. সম্ভাব্য কিছু মান হল: " groupTooBig " - অনুরোধ করা ব্যবহারকারীদের গ্রুপটি একটি একক প্রশ্নের জন্য খুব বড়৷ " tooManyCalendarsRequested " - অনুরোধ করা ক্যালেন্ডারের সংখ্যা একটি একক প্রশ্নের জন্য খুব বেশি। " notFound " - অনুরোধ করা সম্পদ খুঁজে পাওয়া যায়নি. " internalError " - API পরিষেবা একটি অভ্যন্তরীণ ত্রুটির সম্মুখীন হয়েছে৷ ভবিষ্যতে অতিরিক্ত ত্রুটির ধরন যোগ করা হতে পারে, তাই ক্লায়েন্টদের এই তালিকায় অন্তর্ভুক্ত নয় এমন অতিরিক্ত ত্রুটির স্থিতিগুলি সুন্দরভাবে পরিচালনা করা উচিত।
groups.(key). calendars[]	list	একটি গ্রুপের মধ্যে ক্যালেন্ডারের শনাক্তকারীর তালিকা।
calendars	object	ক্যালেন্ডারের জন্য বিনামূল্যে/ব্যস্ত তথ্যের তালিকা।
calendars. (key)	nested object	একটি একক ক্যালেন্ডারের জন্য বিনামূল্যে/ব্যস্ত বিস্তার।
calendars.(key). errors[]	list	ঐচ্ছিক ত্রুটি(গুলি) (যদি ক্যালেন্ডারের জন্য গণনা ব্যর্থ হয়)।
calendars.(key).errors[]. domain	string	ত্রুটির ডোমেন, বা বিস্তৃত বিভাগ।
calendars.(key).errors[]. reason	string	ত্রুটির জন্য নির্দিষ্ট কারণ. সম্ভাব্য কিছু মান হল: " groupTooBig " - অনুরোধ করা ব্যবহারকারীদের গ্রুপটি একটি একক প্রশ্নের জন্য খুব বড়৷ " tooManyCalendarsRequested " - অনুরোধ করা ক্যালেন্ডারের সংখ্যা একটি একক প্রশ্নের জন্য খুব বেশি। " notFound " - অনুরোধ করা সম্পদ খুঁজে পাওয়া যায়নি. " internalError " - API পরিষেবা একটি অভ্যন্তরীণ ত্রুটির সম্মুখীন হয়েছে৷ ভবিষ্যতে অতিরিক্ত ত্রুটির ধরন যোগ করা হতে পারে, তাই ক্লায়েন্টদের এই তালিকায় অন্তর্ভুক্ত নয় এমন অতিরিক্ত ত্রুটির স্থিতিগুলি সুন্দরভাবে পরিচালনা করা উচিত।
calendars.(key). busy[]	list	এই ক্যালেন্ডারকে ব্যস্ত হিসাবে বিবেচনা করা উচিত এমন সময়ের সীমার তালিকা৷
calendars.(key).busy[]. start	datetime	সময়কালের (অন্তর্ভুক্ত) শুরু।
calendars.(key).busy[]. end	datetime	সময়কালের (একচেটিয়া) শেষ।

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

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