Events: watch

ইভেন্ট সংস্থান পরিবর্তনের জন্য দেখুন.

অনুরোধ

HTTP অনুরোধ

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

পরামিতি

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

গ্রহণযোগ্য মান হল:
  • " birthday ": বার্ষিক পুনরাবৃত্তি সহ সারাদিনের বিশেষ ইভেন্ট।
  • " default ": নিয়মিত ঘটনা।
  • " focusTime ": ফোকাস টাইম ইভেন্ট।
  • " fromGmail ": Gmail থেকে ইভেন্ট।
  • " outOfOffice ": অফিসের বাইরে ইভেন্ট।
  • " workingLocation ": কাজের অবস্থানের ঘটনা।

অনুমোদন

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

ব্যাপ্তি
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

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

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

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

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
সম্পত্তির নাম মান বর্ণনা নোট
id string একটি UUID বা অনুরূপ অনন্য স্ট্রিং যা এই চ্যানেলটিকে সনাক্ত করে৷
token string এই চ্যানেলে বিতরিত প্রতিটি বিজ্ঞপ্তির সাথে লক্ষ্য ঠিকানায় একটি নির্বিচারে স্ট্রিং বিতরণ করা হয়। ঐচ্ছিক।
type string এই চ্যানেলের জন্য ব্যবহৃত ডেলিভারি মেকানিজমের ধরন। বৈধ মান হল " web_hook " (বা " webhook ")। উভয় মানই একটি চ্যানেলকে নির্দেশ করে যেখানে Http অনুরোধগুলি বার্তা সরবরাহ করতে ব্যবহৃত হয়।
address string ঠিকানা যেখানে এই চ্যানেলের জন্য বিজ্ঞপ্তি বিতরণ করা হয়৷
params object ডেলিভারি চ্যানেলের আচরণ নিয়ন্ত্রণকারী অতিরিক্ত পরামিতি। ঐচ্ছিক।
params. ttl string বিজ্ঞপ্তি চ্যানেলের জন্য সেকেন্ডে লাইভ সময়। ডিফল্ট 604800 সেকেন্ড।

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

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

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
সম্পত্তির নাম মান বর্ণনা নোট
kind string এটিকে একটি রিসোর্সের পরিবর্তন দেখার জন্য ব্যবহৃত একটি বিজ্ঞপ্তি চ্যানেল হিসাবে চিহ্নিত করে, যা হল " api#channel "৷
id string একটি UUID বা অনুরূপ অনন্য স্ট্রিং যা এই চ্যানেলটিকে সনাক্ত করে৷
resourceId string একটি অস্বচ্ছ আইডি যা এই চ্যানেলে যে সংস্থান দেখা হচ্ছে তা শনাক্ত করে৷ বিভিন্ন API সংস্করণ জুড়ে স্থিতিশীল।
resourceUri string দেখা সম্পদের জন্য একটি সংস্করণ-নির্দিষ্ট শনাক্তকারী।
token string এই চ্যানেলে বিতরিত প্রতিটি বিজ্ঞপ্তির সাথে লক্ষ্য ঠিকানায় একটি নির্বিচারে স্ট্রিং বিতরণ করা হয়। ঐচ্ছিক।
expiration long মিলিসেকেন্ডে ইউনিক্স টাইমস্ট্যাম্প হিসাবে প্রকাশ করা বিজ্ঞপ্তি চ্যানেলের মেয়াদ শেষ হওয়ার তারিখ এবং সময়। ঐচ্ছিক।