একটি comment সংস্থান একটি একক YouTube মন্তব্য সম্পর্কে তথ্য ধারণ করে৷ একটি comment সংস্থান একটি ভিডিও বা একটি চ্যানেল সম্পর্কে একটি মন্তব্য উপস্থাপন করতে পারে। এছাড়াও, মন্তব্যটি একটি শীর্ষ-স্তরের মন্তব্য বা একটি শীর্ষ-স্তরের মন্তব্যের উত্তর হতে পারে।
পদ্ধতি
API comments সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:
- list
- API অনুরোধের পরামিতিগুলির সাথে মেলে এমন মন্তব্যগুলির একটি তালিকা প্রদান করে৷ এখনই চেষ্টা করে দেখুন ।
- insert
- একটি বিদ্যমান মন্তব্যের একটি উত্তর তৈরি করে৷ দ্রষ্টব্য: একটি শীর্ষ-স্তরের মন্তব্য তৈরি করতে,
commentThreads.insertপদ্ধতি ব্যবহার করুন। এখনই চেষ্টা করে দেখুন । - update
- একটি মন্তব্য পরিবর্তন. এখনই চেষ্টা করে দেখুন ।
- delete
- একটি মন্তব্য মুছে দেয়। এখনই চেষ্টা করে দেখুন ।
- 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
}
}বৈশিষ্ট্য
নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:
| বৈশিষ্ট্য | |
|---|---|
kind | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#comment । |
etag | etagএই সম্পদের Etag. |
id | stringইউটিউব যে আইডি ব্যবহার করে মন্তব্যটিকে অনন্যভাবে শনাক্ত করতে। |
snippet | objectsnippet অবজেক্টে মন্তব্য সম্পর্কে প্রাথমিক বিবরণ রয়েছে। |
snippet. authorDisplayName | stringযে ব্যবহারকারী মন্তব্য পোস্ট করেছেন তার প্রদর্শন নাম। |
snippet. authorProfileImageUrl | stringমন্তব্য পোস্ট করা ব্যবহারকারীর অবতারের URL। |
snippet. authorChannelUrl | stringমন্তব্য লেখকের YouTube চ্যানেলের URL, যদি উপলব্ধ থাকে। |
snippet. authorChannelId | objectএই বস্তুটি মন্তব্য লেখকের YouTube চ্যানেল সম্পর্কে তথ্য ধারণ করে, যদি উপলব্ধ থাকে। |
snippet.authorChannelId. value | stringমন্তব্য লেখকের YouTube চ্যানেলের আইডি, যদি উপলব্ধ থাকে। |
snippet. channelId | stringমন্তব্যের সাথে যুক্ত ইউটিউব চ্যানেলের আইডি। |
snippet. textDisplay | stringমন্তব্যের পাঠ্য। টেক্সট প্লেইন টেক্সট বা এইচটিএমএল হয় পুনরুদ্ধার করা যেতে পারে. ( comments.list এবং commentThreads.list পদ্ধতি উভয়ই একটি textFormat প্যারামিটার সমর্থন করে, যা নির্বাচিত পাঠ্য বিন্যাস নির্দিষ্ট করে।)এমনকি প্লেইন টেক্সট মূল কমেন্ট টেক্সট থেকে ভিন্ন হতে পারে। উদাহরণস্বরূপ, এটি ভিডিও শিরোনাম দিয়ে ভিডিও লিঙ্ক প্রতিস্থাপন করতে পারে। |
snippet. textOriginal | stringকমেন্টের আসল, কাঁচা টেক্সট যেহেতু এটি প্রাথমিকভাবে পোস্ট করা হয়েছে বা সর্বশেষ আপডেট করা হয়েছে। মূল পাঠ্যটি শুধুমাত্র প্রমাণীকৃত ব্যবহারকারীর কাছে ফেরত দেওয়া হয় যদি তারা মন্তব্যের লেখক হয়। |
snippet. parentId | stringঅভিভাবক মন্তব্যের অনন্য আইডি. এই সম্পত্তি শুধুমাত্র সেট করা হয় যদি মন্তব্যটি অন্য মন্তব্যের উত্তর হিসাবে জমা দেওয়া হয়। |
snippet. canRate | booleanএই সেটিংটি নির্দেশ করে যে বর্তমান দর্শক মন্তব্যটিকে রেট দিতে পারে কিনা। |
snippet. viewerRating | stringদর্শক এই মন্তব্যে যে রেটিং দিয়েছেন। এই সম্পত্তি dislike রেটিং সনাক্ত করে না, যদিও এই আচরণ পরিবর্তন সাপেক্ষে. এর মধ্যে, সম্পত্তির মান like দর্শক মন্তব্যটিকে ইতিবাচকভাবে রেট দেয়। ব্যবহারকারীর মন্তব্যটিকে নেতিবাচক রেটিং দেওয়া বা মন্তব্যটিকে রেট না দেওয়া সহ অন্য সব ক্ষেত্রে মানটি none ৷এই সম্পত্তির জন্য বৈধ মান হল:
|
snippet. likeCount | unsigned integerমন্তব্যটি প্রাপ্ত মোট লাইকের সংখ্যা (ইতিবাচক রেটিং)। |
snippet. moderationStatus | stringমন্তব্যের সংযম অবস্থা. এই সম্পত্তিটি কেবল তখনই ফেরত দেওয়া হয় যদি API অনুরোধটি চ্যানেলের মালিকের দ্বারা অনুমোদিত হয় বা যে ভিডিওতে অনুরোধ করা মন্তব্য করা হয়েছিল। এছাড়াও, যদি API অনুরোধটি id ফিল্টার প্যারামিটার ব্যবহার করে তবে এই বৈশিষ্ট্যটি সেট করা হয় না।এই সম্পত্তির জন্য বৈধ মান হল:
|
snippet. publishedAt | datetimeতারিখ এবং সময় যখন মন্তব্যটি প্রাথমিকভাবে প্রকাশিত হয়েছিল। মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে। |
snippet. updatedAt | datetimeমন্তব্যটি সর্বশেষ আপডেট করার তারিখ এবং সময়। মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে। |