মন্তব্যগুলি একটি ফাইলে ব্যবহারকারী-প্রদত্ত প্রতিক্রিয়া, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথির পাঠক পরামর্শ দেয় যে কীভাবে একটি বাক্যকে পুনরায় শব্দবন্ধ করতে হয়। দুই ধরনের মন্তব্য আছে: অ্যাঙ্কর করা মন্তব্য এবং আন্যাঙ্করড মন্তব্য । একটি নোঙ্গর করা মন্তব্য একটি নির্দিষ্ট অবস্থানের সাথে যুক্ত, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথিতে একটি বাক্য, একটি নথির একটি নির্দিষ্ট সংস্করণের মধ্যে। বিপরীতভাবে, একটি আন্যাঙ্করড মন্তব্য শুধু নথির সাথে যুক্ত।
উত্তরগুলি মন্তব্যের সাথে সংযুক্ত থাকে এবং মন্তব্যে ব্যবহারকারীর প্রতিক্রিয়া উপস্থাপন করে। ড্রাইভ API আপনার ব্যবহারকারীদের আপনার অ্যাপ দ্বারা তৈরি নথিতে মন্তব্য এবং উত্তর যোগ করতে দেয়। সমষ্টিগতভাবে, উত্তর সহ একটি মন্তব্য আলোচনা হিসাবে পরিচিত।
comments রিসোর্সে তালিকাভুক্ত প্রতিটি পদ্ধতিতে কল করার সময় প্রতিক্রিয়ায় ফিরে আসার জন্য ক্ষেত্রগুলি তালিকাভুক্ত করার জন্য fields প্যারামিটার সেট করা প্রয়োজন। আপনি যদি প্যারামিটারটি বাদ দেন, তবে পদ্ধতিটি একটি ত্রুটি প্রদান করে। আপনার প্রয়োজনীয় সঠিক ক্ষেত্রগুলি ফেরত দিতে, নির্দিষ্ট ক্ষেত্রগুলি ফেরত দেখুন।
একটি unanchored মন্তব্য যোগ করুন
একটি নথিতে একটি আনঅ্যাঙ্করড মন্তব্য যোগ করতে, fileId প্যারামিটার এবং মন্তব্য ধারণকারী একটি comments সংস্থান সহ create() পদ্ধতিতে কল করুন।
মন্তব্যটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়েছে, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফর্ম্যাট করা বিষয়বস্তু সমন্বিত একটি htmlContent ক্ষেত্র প্রদান করে।
একটি মন্তব্য একটি উত্তর যোগ করুন
একটি মন্তব্যে একটি উত্তর যোগ করতে, fileId এবং commentId পরামিতি সহ replies সংস্থানে replies.create() পদ্ধতিটি ব্যবহার করুন৷ রিকোয়েস্ট বডি উত্তর যোগ করতে content ফিল্ড ব্যবহার করে।
উত্তরটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফরম্যাট করা বিষয়বস্তু ধারণকারী একটি htmlContent ক্ষেত্র প্রদান করে।
পদ্ধতিটি fields ক্ষেত্রে তালিকাভুক্ত ক্ষেত্রগুলিকে ফেরত দেয়।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId এবং commentId পাথ প্যারামিটার এবং একাধিক ক্ষেত্র প্রদান করি।
POST https://www.googleapis.com/drive/v3/files/FILE_ID/comments/COMMENT_ID/replies?fields=id,comment
শরীরের অনুরোধ
{
"content": "This is a reply to a comment."
}একটি মন্তব্য সমাধান
একটি মন্তব্য শুধুমাত্র একটি মন্তব্য একটি উত্তর পোস্ট দ্বারা সমাধান করা যেতে পারে.
একটি মন্তব্য সমাধান করতে, fileId এবং commentId পরামিতি সহ replies সংস্থানে replies.create() পদ্ধতিটি ব্যবহার করুন৷
অনুরোধের বডি মন্তব্যটি সমাধান করতে action ফিল্ড ব্যবহার করে। মন্তব্য বন্ধ করে এমন একটি উত্তর যোগ করতে আপনি content ক্ষেত্রও সেট করতে পারেন।
যখন একটি মন্তব্য সমাধান করা হয়, তখন ড্রাইভ মন্তব্য সংস্থানটিকে resolved: true ৷ মুছে ফেলা মন্তব্যের বিপরীতে, সমাধান করা মন্তব্যে htmlContent বা content ক্ষেত্র অন্তর্ভুক্ত থাকতে পারে।
যখন আপনার অ্যাপ একটি মন্তব্যের সমাধান করে, তখন আপনার UI নির্দেশ করবে যে মন্তব্যটি সম্বোধন করা হয়েছে। উদাহরণস্বরূপ, আপনার অ্যাপ হতে পারে:
- আরও উত্তরের অনুমতি না দিন এবং আগের সমস্ত উত্তর এবং মূল মন্তব্যটি ম্লান করুন।
- সমাধান করা মন্তব্য লুকান।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId এবং commentId পাথ প্যারামিটার এবং একাধিক ক্ষেত্র প্রদান করি।
POST https://www.googleapis.com/drive/v3/files/FILE_ID/comments/COMMENT_ID/replies?fields=id,comment
শরীরের অনুরোধ
{
"action": "resolve",
"content": "This comment has been resolved."
}একটি নথির সর্বশেষ সংশোধনে একটি অ্যাঙ্কর করা মন্তব্য যোগ করুন
আপনি যখন একটি মন্তব্য যোগ করেন, আপনি ফাইলের একটি অঞ্চলে এটি নোঙ্গর করতে চাইতে পারেন। একটি অ্যাঙ্কর একটি ফাইলের ফাইলের সংশোধন এবং অঞ্চলকে সংজ্ঞায়িত করে যেখানে একটি মন্তব্য উল্লেখ করে। comments সংস্থান একটি JSON স্ট্রিং হিসাবে anchor ক্ষেত্র সংজ্ঞায়িত করে।
একটি অ্যাঙ্কর করা মন্তব্য যোগ করতে:
(ঐচ্ছিক)। একটি নথির জন্য প্রতিটি
revisionIDতালিকাভুক্ত করতেrevisions.list()পদ্ধতিতে কল করুন। যদি আপনি সর্বশেষ সংশোধন ছাড়া অন্য কোনো সংশোধনে একটি মন্তব্য অ্যাঙ্কর করতে চান তবেই এই পদক্ষেপটি অনুসরণ করুন৷ আপনি যদি সর্বশেষ সংশোধন ব্যবহার করতে চান, তাহলেrevisionIDএর জন্যheadব্যবহার করুন।fileIDপ্যারামিটার সহ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 দিয়ে প্রতিস্থাপন করুন।
একটি মন্তব্য পান
একটি ফাইলে একটি মন্তব্য পেতে, fileId এবং commentId পরামিতি সহ comments সংস্থানে get() পদ্ধতিটি ব্যবহার করুন। আপনি যদি মন্তব্য আইডি না জানেন তবে আপনি list() পদ্ধতি ব্যবহার করে সমস্ত মন্তব্য তালিকাভুক্ত করতে পারেন।
পদ্ধতিটি একটি comments সম্পদের একটি উদাহরণ প্রদান করে।
ফলাফলে মুছে ফেলা মন্তব্যগুলি অন্তর্ভুক্ত করতে, includedDeleted ক্যোয়ারী প্যারামিটারটিকে true সেট করুন।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId এবং commentId পাথ প্যারামিটার এবং একাধিক ক্ষেত্র প্রদান করি।
GET https://www.googleapis.com/drive/v3/files/FILE_ID/comments/COMMENT_ID?fields=id,comment,modifiedTime,resolved
মন্তব্য তালিকা
একটি ফাইলে মন্তব্য তালিকাভুক্ত করতে, fileId প্যারামিটার সহ comments সংস্থানে list() পদ্ধতি ব্যবহার করুন। পদ্ধতিটি মন্তব্যের একটি তালিকা প্রদান করে।
মন্তব্যের পৃষ্ঠা সংখ্যা বা ফিল্টার কাস্টমাইজ করতে নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি পাস করুন:
includeDeleted: মুছে ফেলা মন্তব্য অন্তর্ভুক্ত করতেtrueসেট করুন। মুছে ফেলা মন্তব্যhtmlContentবাcontentক্ষেত্র অন্তর্ভুক্ত করে না।pageSize: প্রতি পৃষ্ঠায় ফেরত দেওয়া মন্তব্যের সর্বোচ্চ সংখ্যা।pageToken: একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী তালিকা কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।startModifiedTime: ফলাফলের মন্তব্যের জন্যmodifiedTimeসময় ক্ষেত্রের সর্বনিম্ন মান।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId পাথ প্যারামিটার, includeDeleted ক্যোয়ারী প্যারামিটার এবং একাধিক ক্ষেত্র প্রদান করি।
GET https://www.googleapis.com/drive/v3/files/FILE_ID/comments?includeDeleted=true&fields=(id,comment,kind,modifiedTime,resolved)
একটি মন্তব্য আপডেট করুন
একটি ফাইলে একটি মন্তব্য আপডেট করতে, fileId এবং commentId পরামিতি সহ comments সংস্থানে update() পদ্ধতিটি ব্যবহার করুন। অনুরোধের বডি মন্তব্যটি আপডেট করতে content ক্ষেত্র ব্যবহার করে।
পদ্ধতিটি fields ক্যোয়ারী প্যারামিটারে তালিকাভুক্ত ক্ষেত্রগুলি প্রদান করে।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId এবং commentId পাথ প্যারামিটার এবং একাধিক ক্ষেত্র প্রদান করি।
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID/comments/COMMENT_ID?fields=id,comment
শরীরের অনুরোধ
{
"content": "This comment is now updated."
}একটি মন্তব্য মুছুন
একটি ফাইলে একটি মন্তব্য মুছে ফেলার জন্য, fileId এবং commentId পরামিতি সহ comments সংস্থানে delete() পদ্ধতিটি ব্যবহার করুন।
যখন একটি মন্তব্য মুছে ফেলা হয়, ড্রাইভ মন্তব্য সংস্থানটিকে deleted: true । মুছে ফেলা মন্তব্য htmlContent বা content ক্ষেত্র অন্তর্ভুক্ত করে না।
একটি উদাহরণ দেখান
অনুরোধ
এই উদাহরণে, আমরা fileId এবং commentId পাথ প্যারামিটার প্রদান করি।
DELETE https://www.googleapis.com/drive/v3/files/FILE_ID/comments/COMMENT_ID