মন্তব্যগুলি একটি ফাইলে ব্যবহারকারী-প্রদত্ত প্রতিক্রিয়া, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথির পাঠক পরামর্শ দেয় যে কীভাবে একটি বাক্যকে পুনরায় শব্দবন্ধ করতে হয়। দুই ধরনের মন্তব্য আছে: অ্যাঙ্কর করা মন্তব্য এবং আন্যাঙ্করড মন্তব্য । একটি নোঙ্গর করা মন্তব্য একটি নির্দিষ্ট অবস্থানের সাথে যুক্ত, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথিতে একটি বাক্য, একটি নথির একটি নির্দিষ্ট সংস্করণের মধ্যে। বিপরীতভাবে, একটি আন্যাঙ্করড মন্তব্য শুধু নথির সাথে যুক্ত।
উত্তরগুলি মন্তব্যের সাথে সংযুক্ত থাকে এবং মন্তব্যে ব্যবহারকারীর প্রতিক্রিয়া উপস্থাপন করে। ড্রাইভ API আপনার ব্যবহারকারীদের আপনার অ্যাপ দ্বারা তৈরি নথিতে মন্তব্য এবং উত্তর যোগ করতে দেয়। সমষ্টিগতভাবে, উত্তর সহ একটি মন্তব্য আলোচনা হিসাবে পরিচিত।
একটি unanchored মন্তব্য যোগ করুন
একটি নথিতে একটি আনঅ্যাঙ্করড মন্তব্য যোগ করতে, fileId প্যারামিটার এবং মন্তব্য সম্বলিত একটি comments সংস্থান সহ comments.create পদ্ধতিতে কল করুন।
মন্তব্যটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়েছে, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফর্ম্যাট করা বিষয়বস্তু সমন্বিত একটি htmlContent ক্ষেত্র প্রদান করে।
একটি মন্তব্য একটি উত্তর যোগ করুন
একটি মন্তব্যে একটি উত্তর যোগ করতে, মন্তব্য, fileId প্যারামিটার এবং উত্তর সম্বলিত একটি replies সম্পদ সহ replies.create পদ্ধতিতে কল করুন।
উত্তরটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফরম্যাট করা বিষয়বস্তু ধারণকারী একটি htmlContent ক্ষেত্র প্রদান করে।
একটি নথির সর্বশেষ সংশোধনে একটি অ্যাঙ্কর করা মন্তব্য যোগ করুন
আপনি যখন একটি মন্তব্য যোগ করেন, আপনি ফাইলের একটি অঞ্চলে এটি নোঙ্গর করতে চাইতে পারেন। একটি অ্যাঙ্কর একটি ফাইলের ফাইলের সংশোধন এবং অঞ্চলকে সংজ্ঞায়িত করে যেখানে একটি মন্তব্য উল্লেখ করে। comments সংস্থান একটি JSON স্ট্রিং হিসাবে anchor ক্ষেত্র সংজ্ঞায়িত করে।
একটি অ্যাঙ্কর করা মন্তব্য যোগ করতে:
(ঐচ্ছিক)। একটি নথির জন্য প্রতিটি
revisionIDতালিকাভুক্ত করতেrevisions.listপদ্ধতিতে কল করুন। যদি আপনি সর্বশেষ সংশোধন ছাড়া অন্য কোনো সংশোধনে একটি মন্তব্য অ্যাঙ্কর করতে চান তবেই এই পদক্ষেপটি অনুসরণ করুন৷ আপনি যদি সর্বশেষ সংশোধন ব্যবহার করতে চান, তাহলেrevisionIDএর জন্যheadব্যবহার করুন।fileIDপ্যারামিটার সহcomments.createপদ্ধতিতে কল করুন, মন্তব্য সম্বলিত একটিcommentsসংস্থান এবং একটি JSON অ্যাঙ্কর স্ট্রিং যাতেrevisionID(r) এবং অঞ্চল (a) রয়েছে।
আপনি কীভাবে একটি অঞ্চলকে সংজ্ঞায়িত করবেন তা নির্ভর করে আপনি যে ধরনের নথির বিষয়বস্তুর সাথে কাজ করছেন তার উপর। আরও তথ্যের জন্য, একটি অঞ্চল সংজ্ঞায়িত করুন দেখুন।
একটি অঞ্চল সংজ্ঞায়িত করুন
পূর্বে উল্লিখিত হিসাবে, JSON অ্যাঙ্কর স্ট্রিংটিতে একটি revisionID ( r ) এবং অঞ্চল ( a ) রয়েছে। অঞ্চল ( a ) হল একটি JSON অ্যারে যেখানে একটি মন্তব্য নোঙর করা হয়েছে এমন বিন্যাস এবং অবস্থান নির্দিষ্ট করে অঞ্চল শ্রেণিবদ্ধকারী রয়েছে৷ একটি শ্রেণীবদ্ধকারী একটি চিত্রের জন্য একটি দ্বি-মাত্রিক আয়তক্ষেত্র, একটি নথিতে পাঠ্যের একটি লাইন, বা একটি ভিডিওতে একটি সময়কাল হতে পারে৷ একটি অঞ্চলকে সংজ্ঞায়িত করতে, আপনি যে ধরনের সামগ্রীতে অ্যাঙ্কর করার চেষ্টা করছেন তার সাথে মেলে এমন অঞ্চল শ্রেণীবিভাগ নির্বাচন করুন৷ উদাহরণস্বরূপ, যদি আপনার বিষয়বস্তু পাঠ্য হয়, আপনি সম্ভবত txt বা line অঞ্চল শ্রেণিবদ্ধকারী ব্যবহার করতে যাচ্ছেন।
ড্রাইভ এপিআই-এ অঞ্চল শ্রেণীবদ্ধকারীদের একটি তালিকার জন্য, অঞ্চল শ্রেণীবদ্ধকারী দেখুন।
নিম্নলিখিত উদাহরণটি একটি JSON অ্যাঙ্কর স্ট্রিং দেখায় যা একটি নথির দুটি পৃথক এলাকায় লাইনগুলিতে মন্তব্যগুলি অ্যাঙ্কর করে:
- প্রথম এলাকাটি লাইন 12 (
'n':12) থেকে শুরু হয় এবং তিনটি লাইন ('l':3) পর্যন্ত প্রসারিত হয়। - দ্বিতীয় এলাকা শুধুমাত্র লাইন 18 (
'n':18, 'l':1`) কভার করে।
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
REVISION_ID head বা একটি নির্দিষ্ট রিভিশনের ID দিয়ে প্রতিস্থাপন করুন।
একটি মন্তব্য সমাধান
একটি মন্তব্য সম্বোধন করা হলে comments সম্পদে resolved সম্পত্তিকে true হিসাবে সেট করতে comment.update পদ্ধতি ব্যবহার করুন।
যখন আপনার অ্যাপ resolved সম্পত্তি true সেট করে, তখন আপনার UI নির্দেশ করবে যে মন্তব্যটি সম্বোধন করা হয়েছে। উদাহরণস্বরূপ, আপনার অ্যাপ হতে পারে:
- আরও উত্তরের অনুমতি না দিন এবং আগের সমস্ত উত্তর এবং মূল মন্তব্যটি ম্লান করুন।
- সমাধান করা মন্তব্য লুকান।
একটি মন্তব্য মুছুন
মন্তব্য মুছে ফেলতে comments.delete পদ্ধতি ব্যবহার করুন। যখন একটি মন্তব্য মুছে ফেলা হয়, ড্রাইভ মন্তব্য সংস্থানটিকে "deleted": "true" হিসাবে চিহ্নিত করে।
মন্তব্য তালিকা
মন্তব্য তালিকাভুক্ত করতে comments.list পদ্ধতি ব্যবহার করুন। আপনি যদি ফলাফলে মুছে ফেলা মন্তব্যগুলি অন্তর্ভুক্ত করতে চান তবে includedDeleted ক্ষেত্রটিকে true হিসাবে সেট করুন।