Activities: insert

YouTube চ্যানেল বুলেটিন বৈশিষ্ট্য অবমূল্যায়ন করেছে, এবং এই পদ্ধতিটি আর সমর্থিত নয়৷

আরও বিশদ বিবরণের জন্য, অনুগ্রহ করে YouTube সহায়তা কেন্দ্র দেখুন৷

একটি নির্দিষ্ট চ্যানেলের জন্য একটি বুলেটিন পোস্ট করুন৷ (অনুরোধ জমা দেওয়া ব্যবহারকারীকে চ্যানেলের পক্ষে কাজ করার জন্য অনুমোদিত হতে হবে।)

দ্রষ্টব্য: যদিও একটি activity সংস্থানে ব্যবহারকারীর ভিডিও রেটিং করা বা একটি ভিডিওকে পছন্দসই হিসাবে চিহ্নিত করার মতো ক্রিয়া সম্পর্কে তথ্য থাকতে পারে, সেই activity সংস্থানগুলি তৈরি করতে আপনাকে অন্যান্য API পদ্ধতিগুলি ব্যবহার করতে হবে৷ উদাহরণস্বরূপ, আপনি একটি ভিডিওকে রেট দিতে API-এর videos.rate() পদ্ধতি এবং একটি ভিডিওকে পছন্দসই হিসাবে চিহ্নিত করতে playlistItems.insert() পদ্ধতি ব্যবহার করবেন৷

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/activities

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • contentDetails
  • id
  • snippet

শরীরের অনুরোধ

অনুরোধের অংশে একটি কার্যকলাপ সংস্থান প্রদান করুন। সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • snippet.description

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.description
    • contentDetails.bulletin.resourceId

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি কার্যকলাপের সংস্থান প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) bulletinTextRequired অনুরোধটি বুলেটিন পোস্টের জন্য পাঠ্য প্রদান করতে snippet অবজেক্টের description বৈশিষ্ট্য ব্যবহার করতে হবে।
badRequest (400) invalidMetadata প্রদত্ত আইডির প্রকারের সাথে kind সম্পত্তি মেলে না।
forbidden (403) forbidden অনুরোধ সঠিকভাবে অনুমোদিত নয়.
notFound (404) playlistNotFound আপনি বুলেটিন পোস্টের সাথে যুক্ত করার চেষ্টা করছেন এমন ভিডিওটি YouTube খুঁজে পাচ্ছে না৷ contentDetails.bulletinPosted.playlistId প্রপার্টির মান পরীক্ষা করুন।
notFound (404) videoNotFound আপনি বুলেটিন পোস্টের সাথে যুক্ত করার চেষ্টা করছেন এমন ভিডিওটি YouTube খুঁজে পাচ্ছে না৷ contentDetails.bulletinPosted.videoId প্রপার্টির মান পরীক্ষা করুন।
userRateLimitExceeded (403) rateLimitExceeded অনুরোধটি সম্পূর্ণ করা যাবে না কারণ আপনি আপনার কোটা অতিক্রম করেছেন৷
,
YouTube চ্যানেল বুলেটিন বৈশিষ্ট্য অবমূল্যায়ন করেছে, এবং এই পদ্ধতিটি আর সমর্থিত নয়৷

আরও বিশদ বিবরণের জন্য, অনুগ্রহ করে YouTube সহায়তা কেন্দ্র দেখুন৷

একটি নির্দিষ্ট চ্যানেলের জন্য একটি বুলেটিন পোস্ট করুন৷ (অনুরোধ জমা দেওয়া ব্যবহারকারীকে চ্যানেলের পক্ষে কাজ করার জন্য অনুমোদিত হতে হবে।)

দ্রষ্টব্য: যদিও একটি activity সংস্থানে ব্যবহারকারীর ভিডিও রেটিং করা বা একটি ভিডিওকে পছন্দসই হিসাবে চিহ্নিত করার মতো ক্রিয়া সম্পর্কে তথ্য থাকতে পারে, সেই activity সংস্থানগুলি তৈরি করতে আপনাকে অন্যান্য API পদ্ধতিগুলি ব্যবহার করতে হবে৷ উদাহরণস্বরূপ, আপনি একটি ভিডিওকে রেট দিতে API-এর videos.rate() পদ্ধতি এবং একটি ভিডিওকে পছন্দসই হিসাবে চিহ্নিত করতে playlistItems.insert() পদ্ধতি ব্যবহার করবেন৷

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/activities

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • contentDetails
  • id
  • snippet

শরীরের অনুরোধ

অনুরোধের অংশে একটি কার্যকলাপ সংস্থান প্রদান করুন। সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • snippet.description

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.description
    • contentDetails.bulletin.resourceId

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি কার্যকলাপের সংস্থান প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) bulletinTextRequired অনুরোধটি বুলেটিন পোস্টের জন্য পাঠ্য প্রদান করতে snippet অবজেক্টের description বৈশিষ্ট্য ব্যবহার করতে হবে।
badRequest (400) invalidMetadata প্রদত্ত আইডির প্রকারের সাথে kind সম্পত্তি মেলে না।
forbidden (403) forbidden অনুরোধ সঠিকভাবে অনুমোদিত নয়.
notFound (404) playlistNotFound আপনি বুলেটিন পোস্টের সাথে যুক্ত করার চেষ্টা করছেন এমন ভিডিওটি YouTube খুঁজে পাচ্ছে না৷ contentDetails.bulletinPosted.playlistId প্রপার্টির মান পরীক্ষা করুন।
notFound (404) videoNotFound আপনি বুলেটিন পোস্টের সাথে যুক্ত করার চেষ্টা করছেন এমন ভিডিওটি YouTube খুঁজে পাচ্ছে না৷ contentDetails.bulletinPosted.videoId প্রপার্টির মান পরীক্ষা করুন।
userRateLimitExceeded (403) rateLimitExceeded অনুরোধটি সম্পূর্ণ করা যাবে না কারণ আপনি আপনার কোটা অতিক্রম করেছেন৷