Playlists: insert

প্লেলিস্ট তৈরি করে।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করলে ৫০ ইউনিট কোটা খরচ হয়।

সাধারণ ব্যবহারিক ক্ষেত্র

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন। যাচাইকরণ ও অনুমোদনের ব্যাপারে আরও জানতে, OAuth 2.0 অনুমোদন প্রয়োগ করা দেখুন।

সুযোগ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

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

প্যারামিটারের মানে আপনি অন্তর্ভুক্ত করতে পারবেন এমন part-এর নাম নিম্নলিখিত তালিকায় রয়েছে:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে।


onBehalfOfContentOwner প্যারামিটার থেকে বোঝা যায় যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল এমন একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্ট মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।
onBehalfOfContentOwnerChannel string
এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য।


onBehalfOfContentOwnerChannel প্যারামিটারটি সেই চ্যানেলের YouTube চ্যানেল আইডি নির্দিষ্ট করে যেখানে ভিডিও যোগ করা হচ্ছে। কোনও অনুরোধে onBehalfOfContentOwner প্যারামিটারের জন্য কোনও মান নির্দিষ্ট করা হলে এই প্যারামিটারটি প্রয়োজন হয় এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে একসাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটারের মান যে চ্যানেলকে নির্দিষ্ট করে, সেটি onBehalfOfContentOwner প্যারামিটারের নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।

এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং সেগুলি ম্যানেজ করেন। এটি কন্টেন্টের মালিককে একবার যাচাইকরণ করার এবং প্রতিটি আলাদা চ্যানেলের জন্য যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটারের মানে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন নেওয়ার অনুমতি দেয়।

অনুরোধের বডি

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

  • আপনাকে এইসব প্রপার্টির জন্য একটি ভ্যালু নির্দিষ্ট করতে হবে:

    • snippet.title

  • আপনি এইসব প্রপার্টির জন্য ভ্যালু সেট করতে পারবেন:

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

রেসপন্স

সফল হলে, এই পদ্ধতিটি রেসপন্স বডিতে একটি playlist রিসোর্স রিটার্ন করে।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও জানতে, YouTube Data API - সমস্যা দেখুন।

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) defaultLanguageNotSetError defaultLanguage-কে localizations আপডেট করার জন্য সেট করতে হবে।
badRequest (400) localizationValidationError লোকালাইজেশন অবজেক্টের একটি ভ্যালু যাচাইকরণে ব্যর্থ হয়েছে। সঠিক ভ্যালু ফিরিয়ে আনতে playlists.list পদ্ধতি ব্যবহার করুন এবং প্লেলিস্ট রিসোর্স ডকুমেন্টেশনে দেওয়া নির্দেশিকা অনুযায়ী সেগুলি আপডেট করতে ভুলবেন না।
badRequest (400) maxPlaylistExceeded প্লেলিস্ট তৈরি করা যাবে না কারণ চ্যানেলে আগে থেকেই সর্বাধিক সংখ্যক প্লেলিস্ট রয়েছে।
forbidden (403) playlistForbidden এই অপারেশন নিষিদ্ধ অথবা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
invalidValue (400) invalidPlaylistSnippet অনুরোধে ভুল প্লেলিস্ট স্নিপেট দেওয়া হয়েছে।
required (400) playlistTitleRequired অনুরোধে অবশ্যই প্লেলিস্টের নাম উল্লেখ করতে হবে।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।