Comments

comment রিসোর্সে একটি YouTube কমেন্ট সম্পর্কে তথ্য থাকে। comment রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে কমেন্ট দেখাতে পারে। এছাড়াও, কমেন্টটি টপ-লেভেল কমেন্ট বা টপ-লেভেল কমেন্টের উত্তর হতে পারে।

পদ্ধতি

API-তে comments রিসোর্সের জন্য নিম্নলিখিত পদ্ধতি কাজ করে:

তালিকা

API অনুরোধের প্যারামিটারের সাথে মিলে যাওয়া কমেন্টের তালিকা রিটার্ন করে। এখনই এটি ব্যবহার করে দেখুন।

ইনসার্ট করুন

আগে থেকে থাকা কমেন্টের উত্তর তৈরি করে। মনে রাখবেন: টপ-লেভেল কমেন্ট তৈরি করতে, commentThreads.insert পদ্ধতি ব্যবহার করুন। এখনই এটি ব্যবহার করে দেখুন।

আপডেট

কমেন্ট পরিবর্তন করে। এখনই এটি ব্যবহার করে দেখুন।

মুছে দিন

কমেন্ট মুছে দেয়। এখনই এটি ব্যবহার করে দেখুন।

setModerationStatus

এক বা একাধিক কমেন্টের মডারেশন স্ট্যাটাস সেট করে। কমেন্টের সাথে যুক্ত চ্যানেল বা ভিডিওর মালিককে API অনুরোধ অনুমোদন করতে হবে। এখনই এটি ব্যবহার করে দেখুন।

রিসোর্স রিপ্রেজেন্টেশন

নিম্নলিখিত JSON স্ট্রাকচার comments রিসোর্সের ফর্ম্যাট দেখায়:

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime,
    "imageUrl": string
  }
}

প্রপার্টি

এই রিসোর্সে যেসব প্রপার্টি দেখা যায়, নিম্নলিখিত সারণীতে সেগুলি সম্পর্কে বলা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#comment।
etag	etag এই রিসোর্সের Etag.
id	string YouTube যে আইডির মাধ্যমে অনন্যভাবে কমেন্ট শনাক্ত করে।
snippet	object snippet অবজেক্টে কমেন্ট সম্পর্কে প্রাথমিক বিবরণ থাকে।
snippet.authorDisplayName	string যে ব্যবহারকারী কমেন্ট পোস্ট করেছেন তার ডিসপ্লে নাম।
snippet.authorProfileImageUrl	string যে ব্যবহারকারী কমেন্ট পোস্ট করেছেন তার অবতারের URL।
snippet.authorChannelUrl	string কমেন্ট লেখকের YouTube চ্যানেলের URL, উপলভ্য থাকলে।
snippet.authorChannelId	object এই অবজেক্টে কমেন্ট লেখকের YouTube চ্যানেল সম্পর্কিত তথ্য থাকে, যদি উপলভ্য থাকে।
snippet.authorChannelId.value	string উপলভ্য থাকলে, কমেন্ট লেখকের YouTube চ্যানেলের আইডি।
snippet.channelId	string কমেন্টের সাথে যুক্ত YouTube চ্যানেলের আইডি।
snippet.textDisplay	string কমেন্টের টেক্সট। টেক্সটটি প্লেন টেক্সট বা HTML ফর্ম্যাটে পাওয়া যেতে পারে। (comments.list এবং commentThreads.list দুটি পদ্ধতিতেই textFormat প্যারামিটার কাজ করে, যা বেছে নেওয়া টেক্সট ফর্ম্যাট নির্দিষ্ট করে।) এমনকি প্লেন টেক্সটও মূল কমেন্ট টেক্সটের থেকে আলাদা হতে পারে। যেমন, এটি ভিডিওর নামের সাথে ভিডিও লিঙ্ক পরিবর্তন করতে পারে।
snippet.textOriginal	string কমেন্টের আসল, র-টেক্সট, যেমনটি প্রথমে পোস্ট করা হয়েছিল বা শেষবার আপডেট করা হয়েছিল। আসল টেক্সট শুধুমাত্র যাচাই করা ব্যবহারকারীকে ফেরত দেওয়া হয়, যদি তিনি কমেন্টের লেখক হন।
snippet.parentId	string মূল কমেন্টের অনন্য আইডি। কমেন্টটি অন্য কমেন্টের উত্তর হিসেবে জমা দেওয়া হলে তবেই এই প্রপার্টি সেট করা হয়।
snippet.canRate	boolean এই সেটিং থেকে বোঝা যায় যে বর্তমান দর্শক কমেন্ট রেট করতে পারবেন কিনা।
snippet.viewerRating	string এই কমেন্টে দর্শকের দেওয়া রেটিং। এই প্রপার্টি dislike রেটিং শনাক্ত করে না, তবে এই আচরণ পরিবর্তন সাপেক্ষ। ইতিমধ্যে, দর্শক কমেন্টকে ইতিবাচকভাবে রেটিং দিলে, প্রপার্টির ভ্যালু like হয়। অন্যান্য সব ক্ষেত্রে এই ভ্যালু হল none, যার মধ্যে ব্যবহারকারী কমেন্টকে নেগেটিভ রেটিং দিয়েছেন বা কমেন্টকে রেটিং দেননি এমন ক্ষেত্রও অন্তর্ভুক্ত। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: like none
snippet.likeCount	unsigned integer কমেন্টটি মোট যতগুলি লাইক (ইতিবাচক রেটিং) পেয়েছে।
snippet.moderationStatus	string কমেন্টের মডারেশন স্ট্যাটাস। এই প্রপার্টি শুধুমাত্র তখনই রিটার্ন করা হয় যখন চ্যানেলের মালিক বা যে ভিডিওতে অনুরোধ করা কমেন্ট করা হয়েছে তার মালিক API অনুরোধ অনুমোদন করেন। এছাড়াও, API অনুরোধে id ফিল্টার প্যারামিটার ব্যবহার করা হলে, এই প্রপার্টি সেট করা হয় না। এই প্রপার্টির জন্য বৈধ মান হল: heldForReview likelySpam published rejected
snippet.publishedAt	datetime কমেন্টটি প্রথমবার যে তারিখে ও সময়ে প্রকাশ করা হয়েছিল। ISO 8601 ফর্ম্যাটে ভ্যালু নির্দিষ্ট করা আছে।
snippet.updatedAt	datetime কমেন্ট শেষবার আপডেট করার তারিখ ও সময়। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।
snippet.imageUrl	string কমেন্টে অ্যাটাচ করা ছবি বা অ্যানিমেটেড GIF-এর URL, যদি থাকে। কোনও কমেন্টে ছবি বা GIF থাকলে তবেই এই প্রপার্টি থাকে। URL-টি ছয় ঘণ্টার টাইম টু লাইভ (TTL) সহ একটি স্বাক্ষরিত লিঙ্ক হিসেবে পরিবেশন করা হয় এবং এটি পাওয়ার ছয় ঘণ্টা পরে মেয়াদ শেষ হয়ে যায়।