Comments

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

পদ্ধতি

এপিআইটি comments রিসোর্সের জন্য নিম্নলিখিত মেথডগুলো সমর্থন করে:

list
এপিআই অনুরোধের প্যারামিটারগুলোর সাথে মেলে এমন মন্তব্যগুলোর একটি তালিকা ফেরত দেয়। এখনই চেষ্টা করে দেখুন ।
insert
বিদ্যমান কোনো মন্তব্যের প্রত্যুত্তর তৈরি করে। দ্রষ্টব্য: শীর্ষ-স্তরের মন্তব্য তৈরি করতে, commentThreads.insert পদ্ধতিটি ব্যবহার করুন। এখনই চেষ্টা করে দেখুন ।
update
একটি মন্তব্য পরিবর্তন করে। এখনই চেষ্টা করে দেখুন ।
delete
একটি মন্তব্য মুছে দেয়। এখনই চেষ্টা করে দেখুন ।
setModerationStatus
এক বা একাধিক মন্তব্যের মডারেশন স্ট্যাটাস নির্ধারণ করে। এপিআই অনুরোধটি অবশ্যই মন্তব্যগুলোর সাথে যুক্ত চ্যানেল বা ভিডিওর মালিকের দ্বারা অনুমোদিত হতে হবে। এখনই চেষ্টা করুন ।

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত 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
এপিআই রিসোর্সের ধরন শনাক্ত করে। এর মান হবে youtube#comment ।
etag etag
এই রিসোর্সের ই-ট্যাগ।
id string
যে আইডিটি ইউটিউব মন্তব্যটিকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহার করে।
snippet object
snippet অবজেক্টটিতে কমেন্ট সম্পর্কিত প্রাথমিক বিবরণ থাকে।
snippet. authorDisplayName string
মন্তব্যটি পোস্টকারী ব্যবহারকারীর প্রদর্শিত নাম।
snippet. authorProfileImageUrl string
মন্তব্যকারী ব্যবহারকারীর অ্যাভাটারের ইউআরএল।
snippet. authorChannelUrl string
মন্তব্যকারীর ইউটিউব চ্যানেলের ইউআরএল, যদি থাকে।
snippet. authorChannelId object
এই অবজেক্টটিতে মন্তব্য লেখকের ইউটিউব চ্যানেল সম্পর্কিত তথ্য অন্তর্ভুক্ত থাকে, যদি তা উপলব্ধ থাকে।
snippet.authorChannelId. value string
মন্তব্যকারীর ইউটিউব চ্যানেলের আইডি, যদি পাওয়া যায়।
snippet. channelId string
মন্তব্যটির সাথে যুক্ত ইউটিউব চ্যানেলের আইডি।
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
মন্তব্যের মডারেশন স্ট্যাটাস। এই প্রপার্টিটি শুধুমাত্র তখনই রিটার্ন করা হয়, যখন এপিআই অনুরোধটি সেই চ্যানেল বা ভিডিওর মালিক দ্বারা অনুমোদিত হয়, যেটিতে অনুরোধকৃত মন্তব্যগুলো করা হয়েছিল। এছাড়াও, যদি এপিআই অনুরোধে id ফিল্টার প্যারামিটার ব্যবহার করা হয়, তাহলে এই প্রপার্টিটি সেট করা হয় না।

এই প্রপার্টির জন্য বৈধ মানগুলি হলো:
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet. publishedAt datetime
মন্তব্যটি প্রথম প্রকাশিত হওয়ার তারিখ ও সময়। মানটি ISO 8601 ফরম্যাটে নির্দিষ্ট করা আছে।
snippet. updatedAt datetime
মন্তব্যটি সর্বশেষ হালনাগাদ করার তারিখ ও সময়। মানটি ISO 8601 ফরম্যাটে নির্দিষ্ট করা আছে।
snippet. imageUrl string
মন্তব্যের সাথে সংযুক্ত ছবি বা অ্যানিমেটেড জিআইএফ-এর ইউআরএল (যদি থাকে)। এই বৈশিষ্ট্যটি শুধুমাত্র তখনই উপস্থিত থাকে যখন কোনো মন্তব্যে একটি ছবি বা জিআইএফ থাকে। ইউআরএলটি ছয়-ঘণ্টার টাইম টু লিভ (TTL) সহ একটি স্বাক্ষরিত লিঙ্ক হিসাবে পরিবেশিত হয় এবং সংগ্রহের ছয় ঘণ্টা পর এর মেয়াদ শেষ হয়ে যায়।