রেফারেন্স গাইড

এই ডকুমেন্ট Google Sites Data API-এর জন্য র প্রোটোকল (XML এবং HTTP) সংক্রান্ত বিস্তারিত রেফারেন্স ডকুমেন্টেশন প্রদান করে।

এই ডকুমেন্টে প্রোগ্রামিং-ল্যাঙ্গুয়েজ ক্লায়েন্ট লাইব্রেরি সম্পর্কে কোনও তথ্য নেই। ক্লায়েন্ট লাইব্রেরি সংক্রান্ত রেফারেন্স তথ্যের জন্য, ডেভেলপারের নির্দেশিকার প্রোগ্রামিং ভাষা-নির্দিষ্ট বিভাগ থেকে লিঙ্ক দেখুন।

দর্শক

এই ডকুমেন্টটি সেইসব প্রোগ্রামারদের জন্য লেখা হয়েছে যারা Google Sites-এর সাথে ইন্টার‍্যাক্ট করতে পারে এমন ক্লায়েন্ট অ্যাপ্লিকেশন লিখতে চান।

এটি একটি রেফারেন্স ডকুমেন্ট; এটি ধরে নেয় যে আপনি প্রোটোকল গাইড-এ উপস্থাপিত ধারণা এবং Google Data API প্রোটোকলের পেছনের সাধারণ ধারণাগুলি বুঝতে পেরেছেন।

Google Sites ফিডের ধরন

Google Sites Data API নিম্নলিখিত ধরনের ফিড প্রদান করে:

অ্যাক্টিভিটি ফিড

অ্যাক্টিভিটি ফিড হল এমন একটি ফিড যাতে কোনও সাইটের মধ্যে থাকা সমস্ত অ্যাক্টিভিটির বিবরণ থাকে।

নির্দিষ্ট ডোমেনের মধ্যে থাকা সাইটের জন্য এই ফিডের GET URI হল:

https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]

domainName হল "সাইট" অথবা G Suite ডোমেন।

সাইটের ল্যান্ডিং পৃষ্ঠার URL-এ যেভাবে দেখানো হয়েছে, siteName হল সাইটের নাম: http://sites.google.com/a/domainName/siteName/.

এই ফিডে করা সব অনুরোধকে অবশ্যই যাচাই করিয়ে নিতে হবে।

অনুরোধের যেসব ধরন কাজ করে: GET

কন্টেন্ট ফিড

কন্টেন্ট ফিড হল এমন একটি ফিড যাতে বর্তমান, এডিট করা যায় এমন সাইট কন্টেন্ট থাকে।

নির্দিষ্ট ডোমেনের মধ্যে থাকা সাইটের জন্য এই ফিডের GET URI হল:

https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]

domainName হল "সাইট" অথবা G Suite ডোমেন।

siteName হল সাইটের নাম যা সাইটের ল্যান্ডিং পৃষ্ঠার URL-এ দেখা যায়: http://sites.google.com/a/domainName/siteName.

সাইটের (প্রকাশিত) সেটিংসের উপর নির্ভর করে এই ফিডে অনুরোধের জন্য যাচাইকরণ প্রয়োজন হতেও পারে বা নাও হতে পারে।

অনুরোধের যে ধরন কাজ করে: GET, POST, PUT, DELETE

স্ট্যান্ডার্ড Data API কোয়েরি প্যারামিটার ছাড়াও, Sites Data API নিম্নলিখিত ঐচ্ছিক প্যারামিটার ব্যবহার করার অনুমতি দেয় 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 হল "সাইট" অথবা G Suite ডোমেন।

siteName হল সাইটের নাম যা সাইটের ল্যান্ডিং পৃষ্ঠার URL-এ দেখা যায়: http://sites.google.com/a/domainName/siteName.

এই ফিডে করা সব অনুরোধকে অবশ্যই যাচাই করিয়ে নিতে হবে।

অনুরোধের যেসব ধরন কাজ করে: GET

সাইট ফিড

সাইট ফিড ব্যবহার করে ব্যবহারকারীর মালিকানাধীন বা দেখার অনুমতি আছে এমন Google Sites-এর তালিকা তৈরি করা যেতে পারে। এছাড়াও, এটি নতুন সাইট তৈরি করতে, কোনও সাইট কপি করতে বা আগে থেকে থাকা সাইটের নাম পরিবর্তন করতে ব্যবহার করা যেতে পারে।

সাইটের তালিকার জন্য ফিড URI হল:

https://sites.google.com/feeds/site/domainName/[siteName]

domainName হল "সাইট" অথবা G Suite ডোমেন।

এই ফিডে করা সব অনুরোধকে অবশ্যই যাচাই করিয়ে নিতে হবে।

অনুরোধের যেসব ধরন কাজ করে: GET, POST, PUT

সাইট ফিড, সাইট তালিকাভুক্ত করার জন্য GET অনুরোধ করার সময় নিম্নলিখিত (ঐচ্ছিক) প্যারামিটার কাজ করে:

প্যারামিটার বিবরণ ধরন নোট
include-all-sites G Suite ডোমেনে ব্যবহারকারী অন্তত দেখতে পাবেন এমন সব সাইটের তালিকা তৈরি করুন। বুলিয়ান G Suite ডোমেনের জন্য সাইট তালিকাভুক্ত করার সময় এই প্যারামিটারটি প্রযোজ্য হয়। সম্ভাব্য ভ্যালু হল true বা false. ডিফল্ট হল false।
with-mappings সাইট এন্ট্রিতে ওয়েব অ্যাড্রেস ম্যাপিং অন্তর্ভুক্ত থাকে। বুলিয়ান সম্ভাব্য ভ্যালু হল true বা false. ডিফল্ট হল false।

ACL ফিড

Google সাইটের শেয়ারিং অনুমতি (ACL) তালিকাভুক্ত করতে এবং/অথবা পরিবর্তন করতে ACL ফিড ব্যবহার করা যেতে পারে।

সাইটের তালিকার জন্য ফিড URI হল:

https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]

domainName হল "সাইট" অথবা G Suite ডোমেন।

এই ফিডে করা সব অনুরোধকে অবশ্যই যাচাই করিয়ে নিতে হবে।

অনুরোধের যে ধরন কাজ করে: GET, POST, PUT, DELETE

Google Sites কোয়েরি প্যারামিটার রেফারেন্স

Google Data API প্রোটোকল থেকে কাজ করে এমন কোয়েরি প্যারামিটার:

  • max-results
  • published-max (শুধুমাত্র কন্টেন্ট ফিড)
  • published-min (শুধুমাত্র কন্টেন্ট ফিড)
  • start-index
  • updated-max
  • updated-min
  • q (সম্পূর্ণ টেক্সট-কোয়েরি)

সেই ফিডের জন্য নির্দিষ্ট প্যারামিটারের তালিকা পেতে উপরে প্রতিটি ফিড দেখুন।

স্ক্রিনের উপরে ফিরুন