মন্তব্য এবং উত্তর পরিচালনা করুন

মন্তব্যগুলি একটি ফাইলে ব্যবহারকারী-প্রদত্ত প্রতিক্রিয়া, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথির পাঠক পরামর্শ দেয় যে কীভাবে একটি বাক্যকে পুনরায় শব্দবন্ধ করতে হয়। দুই ধরনের মন্তব্য আছে: অ্যাঙ্কর করা মন্তব্য এবং আন্যাঙ্করড মন্তব্য । একটি নোঙ্গর করা মন্তব্য একটি নির্দিষ্ট অবস্থানের সাথে যুক্ত, যেমন একটি শব্দ-প্রক্রিয়াকরণ নথিতে একটি বাক্য, একটি নথির একটি নির্দিষ্ট সংস্করণের মধ্যে। বিপরীতভাবে, একটি আন্যাঙ্করড মন্তব্য শুধু নথির সাথে যুক্ত।

দ্রষ্টব্য: ব্লব ফাইলগুলিতে, Google ড্রাইভ এপিআই শুধুমাত্র আন্যাঙ্করড মন্তব্য সমর্থন করে। ব্লব ফাইল বা Google ডক্স এডিটর ফাইলে অ্যাঙ্কর করা মন্তব্য সমর্থিত নয়।

উত্তরগুলি মন্তব্যের সাথে সংযুক্ত থাকে এবং মন্তব্যে ব্যবহারকারীর প্রতিক্রিয়া উপস্থাপন করে। ড্রাইভ API আপনার ব্যবহারকারীদের আপনার অ্যাপ দ্বারা তৈরি নথিতে মন্তব্য এবং উত্তর যোগ করতে দেয়। সমষ্টিগতভাবে, উত্তর সহ একটি মন্তব্য আলোচনা হিসাবে পরিচিত।

একটি unanchored মন্তব্য যোগ করুন

একটি নথিতে একটি আনঅ্যাঙ্করড মন্তব্য যোগ করতে, fileId প্যারামিটার এবং মন্তব্য সম্বলিত একটি comments সংস্থান সহ comments.create পদ্ধতিতে কল করুন।

মন্তব্যটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়েছে, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফর্ম্যাট করা বিষয়বস্তু সমন্বিত একটি htmlContent ক্ষেত্র প্রদান করে।

গুরুত্বপূর্ণ: আমরা আপনাকে পরামর্শ দিচ্ছি যে একজন ব্যবহারকারীর মন্তব্য যোগ করার সঠিক অনুমতি আছে কিনা তা পরীক্ষা করে দেখুন। উপরন্তু, শুধুমাত্র একটি মন্তব্য বা একটি উত্তরের নির্মাতা একটি মন্তব্য বা একটি উত্তর মুছে ফেলতে বা সম্পাদনা করতে পারেন৷ ত্রুটিগুলি ঘটে যখন একজন অ-সৃষ্টিকর্তার ভূমিকায় থাকা ব্যবহারকারী একটি মন্তব্য মুছে ফেলা বা সম্পাদনা করার চেষ্টা করে। এই ত্রুটিগুলি এড়াতে, মন্তব্য সংস্থানের author.me ক্ষেত্রটি পরীক্ষা করে নিশ্চিত করুন যে ব্যবহারকারী অনুরোধ করছেন তিনি মন্তব্যটির লেখক এবং তারপর মন্তব্যের সাথে সম্পর্কিত তাদের অনুমতিগুলি যাচাই করুন৷

একটি মন্তব্য একটি উত্তর যোগ করুন

একটি মন্তব্যে একটি উত্তর যোগ করতে, মন্তব্য, fileId প্যারামিটার এবং উত্তর সম্বলিত একটি replies সম্পদ সহ replies.create পদ্ধতিতে কল করুন।

উত্তরটি প্লেইন টেক্সট হিসাবে ঢোকানো হয়, কিন্তু প্রতিক্রিয়া বডি প্রদর্শনের জন্য ফরম্যাট করা বিষয়বস্তু ধারণকারী একটি htmlContent ক্ষেত্র প্রদান করে।

একটি নথির সর্বশেষ সংশোধনে একটি অ্যাঙ্কর করা মন্তব্য যোগ করুন

আপনি যখন একটি মন্তব্য যোগ করেন, আপনি ফাইলের একটি অঞ্চলে এটি নোঙ্গর করতে চাইতে পারেন। একটি অ্যাঙ্কর একটি ফাইলের ফাইলের সংশোধন এবং অঞ্চলকে সংজ্ঞায়িত করে যেখানে একটি মন্তব্য উল্লেখ করে। comments সংস্থান একটি JSON স্ট্রিং হিসাবে anchor ক্ষেত্র সংজ্ঞায়িত করে।

দ্রষ্টব্য: ব্লব ফাইলগুলিতে, ড্রাইভ এপিআই শুধুমাত্র আন্যাঙ্করড মন্তব্যগুলিকে সমর্থন করে৷ ব্লব ফাইল বা Google ডক্স এডিটর ফাইলে অ্যাঙ্কর করা মন্তব্য সমর্থিত নয়।

গুরুত্বপূর্ণ: অ্যাঙ্করগুলি অপরিবর্তনীয়, এবং একটি নথির বিষয়বস্তুর সাথে সম্পর্কিত তাদের অবস্থান সংশোধনের মধ্যে নিশ্চিত করা যায় না। আমরা আপনাকে এমন নথিতে অ্যাঙ্কর ব্যবহার করার পরামর্শ দিই যেখানে অবস্থান পরিবর্তন হয় না, যেমন চিত্র ফাইল বা শুধুমাত্র পঠনযোগ্য নথি।

একটি অ্যাঙ্কর করা মন্তব্য যোগ করতে:

1. (ঐচ্ছিক)। একটি নথির জন্য প্রতিটি revisionID তালিকাভুক্ত করতে revisions.list পদ্ধতিতে কল করুন। যদি আপনি সর্বশেষ সংশোধন ছাড়া অন্য কোনো সংশোধনে একটি মন্তব্য অ্যাঙ্কর করতে চান তবেই এই পদক্ষেপটি অনুসরণ করুন৷ আপনি যদি সর্বশেষ সংশোধন ব্যবহার করতে চান, তাহলে revisionID এর জন্য head ব্যবহার করুন।

2. fileID প্যারামিটার সহ comments.create পদ্ধতিতে কল করুন, মন্তব্য সম্বলিত একটি comments সংস্থান এবং একটি JSON অ্যাঙ্কর স্ট্রিং যাতে revisionID ( r ) এবং অঞ্চল ( a ) রয়েছে।

আপনি কীভাবে একটি অঞ্চলকে সংজ্ঞায়িত করবেন তা নির্ভর করে আপনি যে ধরনের নথির বিষয়বস্তুর সাথে কাজ করছেন তার উপর। আরও তথ্যের জন্য, একটি অঞ্চল সংজ্ঞায়িত করুন দেখুন।

দ্রষ্টব্য: আমরা আপনাকে সুপারিশ করি যে একজন ব্যবহারকারীর মন্তব্য যোগ করার জন্য সঠিক অনুমতি আছে কিনা তা পরীক্ষা করে দেখুন। উপরন্তু, শুধুমাত্র একটি মন্তব্য বা একটি উত্তরের নির্মাতা একটি মন্তব্য বা একটি উত্তর মুছে ফেলতে বা সম্পাদনা করতে পারেন৷ ত্রুটি ঘটে যখন একজন অ-সৃষ্টিকর্তার ভূমিকায় থাকা ব্যক্তি একটি মন্তব্য মুছে ফেলা বা সম্পাদনা করার চেষ্টা করে। এই ত্রুটিগুলি এড়াতে, মন্তব্য সংস্থানের author.me ক্ষেত্রটি পরীক্ষা করুন৷

একটি অঞ্চল সংজ্ঞায়িত করুন

পূর্বে উল্লিখিত হিসাবে, 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 দিয়ে প্রতিস্থাপন করুন।

গুরুত্বপূর্ণ: যদি আপনার অ্যাপ ব্যবহারকারীদের একটি দস্তাবেজের একাধিক সংশোধন আপডেট এবং ভাগ করতে দেয়, তাহলে পুরানো সংশোধনগুলির মন্তব্যগুলি আর অ্যাঙ্কর করা অবস্থানে প্রযোজ্য নাও হতে পারে৷ অতএব, আপনাকে অবশ্যই নির্দেশ করতে হবে যে প্রতিটি মন্তব্য আপনার UI-তে স্পষ্টভাবে কোন সংশোধনীর অন্তর্গত।

একটি মন্তব্য সমাধান

একটি মন্তব্য সম্বোধন করা হলে comments সম্পদে resolved সম্পত্তিকে true হিসাবে সেট করতে comment.update পদ্ধতি ব্যবহার করুন।

যখন আপনার অ্যাপ resolved সম্পত্তি true সেট করে, তখন আপনার UI নির্দেশ করবে যে মন্তব্যটি সম্বোধন করা হয়েছে। উদাহরণস্বরূপ, আপনার অ্যাপ হতে পারে:

• আরও উত্তরের অনুমতি না দিন এবং আগের সমস্ত উত্তর এবং মূল মন্তব্যটি ম্লান করুন।
• সমাধান করা মন্তব্য লুকান।

একটি মন্তব্য মুছুন

মন্তব্য মুছে ফেলতে comments.delete পদ্ধতি ব্যবহার করুন। যখন একটি মন্তব্য মুছে ফেলা হয়, ড্রাইভ মন্তব্য সংস্থানটিকে "deleted": "true" হিসাবে চিহ্নিত করে।

মন্তব্য তালিকা

মন্তব্য তালিকাভুক্ত করতে comments.list পদ্ধতি ব্যবহার করুন। আপনি যদি ফলাফলে মুছে ফেলা মন্তব্যগুলি অন্তর্ভুক্ত করতে চান তবে includedDeleted ক্ষেত্রটিকে true হিসাবে সেট করুন।