Freebusy: query

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

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

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

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

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

{
  "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 এক্সপ্লোরার ব্যবহার করুন।