Playlists: update

প্লেলিস্ট পরিবর্তন করে। যেমন, আপনি কোনও প্লেলিস্টের নাম, বিবরণ বা গোপনীয়তা স্ট্যাটাস পরিবর্তন করতে পারেন।

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

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

PUT 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 রেসপন্সে অন্তর্ভুক্ত থাকবে এমন প্রপার্টি শনাক্ত করে।

মনে রাখবেন যে এই পদ্ধতিটি অনুরোধের বডিতে নির্দিষ্ট করা যেকোনও অংশে থাকা পরিবর্তনযোগ্য প্রপার্টির জন্য আগে থেকে থাকা মান ওভাররাইড করবে। যেমন, প্লেলিস্টের বিবরণ snippet অংশে থাকে, যা অনুরোধের মূল অংশে অন্তর্ভুক্ত করতে হবে। অনুরোধে snippet.description প্রপার্টির জন্য কোনও ভ্যালু উল্লেখ করা না থাকলে, প্লেলিস্টের বর্তমান বিবরণ মুছে যাবে।

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

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

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

অনুরোধের বডি

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

সেই রিসোর্সের জন্য:

  • এইসব প্রপার্টির জন্য আপনাকে অবশ্যই একটি মান উল্লেখ করতে হবে:

    • id
    • snippet.title

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

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • 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 পদ্ধতি ব্যবহার করুন এবং প্লেলিস্ট রিসোর্স ডকুমেন্টেশনে দেওয়া নির্দেশিকা মেনে সেগুলি আপডেট করতে ভুলবেন না।
forbidden (403) playlistForbidden এই অপারেশন নিষিদ্ধ অথবা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
invalidValue (400) invalidPlaylistSnippet অনুরোধে ভুল প্লেলিস্ট স্নিপেট দেওয়া হয়েছে।
notFound (404) playlistNotFound অনুরোধের id প্যারামিটার দিয়ে শনাক্ত করা প্লেলিস্ট খুঁজে পাওয়া যায়নি।
required (400) playlistTitleRequired অনুরোধে অবশ্যই প্লেলিস্টের নাম উল্লেখ করতে হবে।
invalidValue (400) playlistOperationUnsupported API-তে নির্দিষ্ট প্লেলিস্ট আপডেট করার সুবিধা নেই। যেমন, আপনার আপলোড করা ভিডিওর প্লেলিস্টের প্রপার্টি আপডেট করতে পারবেন না।

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

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