এই ডকুমেন্টটি Google Sites Data API-এর জন্য raw প্রোটোকল (XML এবং HTTP) এর জন্য বিস্তারিত রেফারেন্স ডকুমেন্টেশন প্রদান করে।
এই নথিতে প্রোগ্রামিং-ভাষা ক্লায়েন্ট লাইব্রেরি সম্পর্কে তথ্য নেই। ক্লায়েন্ট-লাইব্রেরি রেফারেন্স তথ্যের জন্য, ডেভেলপারের নির্দেশিকার প্রোগ্রামিং-ভাষা-নির্দিষ্ট বিভাগগুলির লিঙ্কগুলি দেখুন।
পাঠকবর্গ
এই ডকুমেন্টটি এমন প্রোগ্রামারদের জন্য তৈরি যারা Google Sites-এর সাথে ইন্টারঅ্যাক্ট করতে পারে এমন ক্লায়েন্ট অ্যাপ্লিকেশন লিখতে চান।
এটি একটি রেফারেন্স ডকুমেন্ট; এটি ধরে নেয় যে আপনি প্রোটোকল গাইডে উপস্থাপিত ধারণাগুলি এবং Google ডেটা API প্রোটোকলের পিছনের সাধারণ ধারণাগুলি বুঝতে পেরেছেন।
গুগল সাইট ফিডের ধরণ
গুগল সাইটস ডেটা এপিআই নিম্নলিখিত ধরণের ফিড সরবরাহ করে:
অ্যাক্টিভিটি ফিড
অ্যাক্টিভিটি ফিড হল এমন একটি ফিড যেখানে একটি সাইটের মধ্যে সমস্ত কার্যকলাপের বিবরণ থাকে।
একটি নির্দিষ্ট ডোমেনের মধ্যে একটি সাইটের জন্য এই ফিডের GET URI হল:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName হল "সাইট", অথবা একটি জি স্যুট ডোমেন।
siteName হল সাইটের ল্যান্ডিং পেজ URL-এ যেমনটি দেখা যায়: http://sites.google.com/a/ domainName / siteName /।
এই ফিডে করা সমস্ত অনুরোধ অবশ্যই প্রমাণীকরণ করতে হবে।
সমর্থিত অনুরোধের ধরণ: GET
কন্টেন্ট ফিড
কন্টেন্ট ফিড হল এমন একটি ফিড যাতে বর্তমান, সম্পাদনাযোগ্য সাইটের কন্টেন্ট থাকে।
একটি নির্দিষ্ট ডোমেনের মধ্যে একটি সাইটের জন্য এই ফিডের GET URI হল:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName হল "সাইট", অথবা একটি জি স্যুট ডোমেন।
siteName হল সাইটের ল্যান্ডিং পেজ URL-এ যেমনটি দেখা যায়: http://sites.google.com/a/ domainName / siteName ।
এই ফিডে অনুরোধের জন্য প্রমাণীকরণের প্রয়োজন হতে পারে বা নাও হতে পারে, এটি সাইটের (প্রকাশিত) সেটিংসের উপর নির্ভর করে।
সমর্থিত অনুরোধের ধরণ: GET , POST , PUT , DELETE
স্ট্যান্ডার্ড ডেটা এপিআই কোয়েরি প্যারামিটার ছাড়াও, সাইটস ডেটা এপিআই কন্টেন্ট ফিড ব্যবহার করে GET অনুরোধ জারি করার জন্য নিম্নলিখিত ঐচ্ছিক প্যারামিটারগুলিকে অনুমতি দেয়:
| প্যারামিটার | বিবরণ | আদর্শ | মন্তব্য |
|---|---|---|---|
ancestor | শুধুমাত্র সেইসব এন্ট্রির অনুরোধ করে যেগুলোতে নির্দিষ্ট পূর্বপুরুষ আছে। | স্ট্রিং | পছন্দসই পূর্বপুরুষ এন্ট্রির আইডি প্রদান করুন। উদাহরণস্বরূপ: 0123456789 । পিতামাতা, পিতামাতার পিতামাতা ইত্যাদি হিসাবে নির্দিষ্ট পূর্বপুরুষের সাথে সম্পর্কিত সমস্ত এন্ট্রি ফেরত দেয়। |
include-deleted | মুছে ফেলা এন্ট্রি অন্তর্ভুক্ত করা হবে কিনা তা নির্দিষ্ট করে। | বুলিয়ান | সম্ভাব্য মানগুলি true বা false । ডিফল্ট হল false । |
include-draft | খসড়া এন্ট্রি অন্তর্ভুক্ত করা হবে কিনা তা নির্দিষ্ট করে। | বুলিয়ান | সম্ভাব্য মানগুলি true বা false । ডিফল্ট মানটি false । এটি দেখার জন্য আপনাকে খসড়াটির মালিক বা লেখক হতে হবে। |
kind | কোন ধরণের কন্টেন্ট এন্ট্রি ফেরত পাঠানো হবে তা নির্দিষ্ট করে। এগুলি Google Sites-এর মধ্যে পৃষ্ঠার ধরণ অনুসরণ করে। | কমা দ্বারা পৃথক করা স্ট্রিংগুলির তালিকা | সম্ভাব্য মানগুলি হল announcement , announcementspage , attachment , comment , filecabinet , listitem , listpage , webpage , webattachment , template । |
parent | শুধুমাত্র সেইসব এন্ট্রির অনুরোধ করে যার নির্দিষ্ট প্যারেন্ট আছে। | স্ট্রিং | মূল এন্ট্রির আইডি প্রদান করুন। উদাহরণস্বরূপ: 0123456789 । |
path | একটি নির্দিষ্ট পৃষ্ঠার অনুক্রমের অধীনে কন্টেন্টের অনুরোধ করে | স্ট্রিং | একটি সাইটের মধ্যে একটি উপ-পৃষ্ঠার পথ যেখানে কন্টেন্ট আনা হবে। উদাহরণস্বরূপ: path=/path/to/page । |
রিভিশন ফিড
রিভিশন ফিড হল এমন একটি ফিড যাতে সাইটের কন্টেন্টের ঐতিহাসিক সংশোধনগুলি থাকে।
একটি নির্দিষ্ট ডোমেনের মধ্যে একটি সাইটের জন্য এই ফিডের GET URI হল:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName হল "সাইট", অথবা একটি জি স্যুট ডোমেন।
siteName হল সাইটের ল্যান্ডিং পেজ URL-এ যেমনটি দেখা যায়: http://sites.google.com/a/ domainName / siteName ।
এই ফিডে করা সমস্ত অনুরোধ অবশ্যই প্রমাণীকরণ করতে হবে।
সমর্থিত অনুরোধের ধরণ: GET
সাইট ফিড
সাইট ফিডটি ব্যবহারকারীর মালিকানাধীন বা দেখার অনুমতিপ্রাপ্ত Google সাইটগুলির তালিকা তৈরি করতে ব্যবহার করা যেতে পারে। এটি নতুন সাইট তৈরি করতে, একটি সাইট অনুলিপি করতে বা বিদ্যমান সাইটের নাম পরিবর্তন করতেও ব্যবহার করা যেতে পারে।
সাইট তালিকার ফিড URI হল:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName হল "সাইট", অথবা একটি জি স্যুট ডোমেন।
এই ফিডে করা সমস্ত অনুরোধ অবশ্যই প্রমাণীকরণ করতে হবে।
সমর্থিত অনুরোধের ধরণ: GET , POST , PUT
সাইট তালিকাভুক্ত করার জন্য GET অনুরোধ জারি করার সময় সাইট ফিড নিম্নলিখিত (ঐচ্ছিক) পরামিতিগুলিকে সমর্থন করে:
| প্যারামিটার | বিবরণ | আদর্শ | মন্তব্য |
|---|---|---|---|
include-all-sites | G Suite ডোমেনে ব্যবহারকারীর দ্বারা অন্তত দেখা যেতে পারে এমন সমস্ত সাইটের তালিকা তৈরি করুন। | বুলিয়ান | এই প্যারামিটারটি শুধুমাত্র G Suite ডোমেনের জন্য সাইট তালিকাভুক্ত করার সময় প্রযোজ্য। সম্ভাব্য মানগুলি true বা false । ডিফল্ট হল false । |
with-mappings | একটি সাইট এন্ট্রিতে ওয়েব ঠিকানা ম্যাপিং অন্তর্ভুক্ত করে। | বুলিয়ান | সম্ভাব্য মানগুলি true বা false । ডিফল্ট হল false । |
ACL ফিড
ACL ফিডটি একটি Google সাইটের শেয়ারিং অনুমতি (ACL) তালিকাভুক্ত এবং/অথবা পরিবর্তন করতে ব্যবহার করা যেতে পারে।
সাইট তালিকার ফিড URI হল:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName হল "সাইট", অথবা একটি জি স্যুট ডোমেন।
এই ফিডে করা সমস্ত অনুরোধ অবশ্যই প্রমাণীকরণ করতে হবে।
সমর্থিত অনুরোধের ধরণ: GET , POST , PUT , DELETE
গুগল সাইটের কোয়েরি প্যারামিটার রেফারেন্স
গুগল ডেটা এপিআই প্রোটোকল থেকে সমর্থিত কোয়েরি প্যারামিটার:
-
max-results -
published-max(শুধুমাত্র কন্টেন্ট ফিড) -
published-min(শুধুমাত্র কন্টেন্ট ফিড) -
start-index -
updated-max -
updated-min -
q(পূর্ণ টেক্সট-কোয়েরি)
উপরের প্রতিটি ফিড দেখুন, সেই ফিডের জন্য নির্দিষ্ট প্যারামিটারের তালিকা দেখতে।