PlaylistItems: update

প্লেলিস্ট আইটেম পরিবর্তন করে। যেমন, আপনি প্লেলিস্টে আইটেমের অবস্থান আপডেট করতে পারেন।

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

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

অনুরোধ করুন

HTTP অনুরোধ

PUT https://www.googleapis.com/youtube/v3/playlistItems

অনুমোদন

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

সুযোগ
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 অংশটি অন্তর্ভুক্ত থাকে, তাহলে প্লেলিস্ট আইটেমের শুরু ও শেষের সময় অনুরোধের বডিতে উল্লেখ করা মান অনুযায়ী আপডেট করা হবে। অনুরোধের বডিতে ভ্যালু উল্লেখ করা না থাকলে, আগে থেকে থাকা শুরু ও শেষের সময় সরিয়ে দেওয়া হবে এবং ডিফল্ট সেটিংস দিয়ে তা পরিবর্তন করা হবে। নিচে উল্লেখ করা তালিকায় part নাম আছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারবেন: contentDetails id snippet status
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner	string মনে রাখবেন: onBehalfOfContentOwner প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য এবং এটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য ডিজাইন করা হয়েছে যারা বিভিন্ন YouTube চ্যানেল ম্যানেজ করেন। এটি কন্টেন্টের মালিকের সাথে যুক্ত ব্যবহারকারীদের একবার যাচাইকরণ করার পরে কন্টেন্টের মালিকের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস এবং ম্যানেজ করার অনুমতি দেয়, প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান করার প্রয়োজন হয় না। প্যারামিটারটি উপস্থিত থাকলে, এর মান কন্টেন্টের মালিককে শনাক্ত করে এবং অনুরোধের যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল একজন YouTube ব্যবহারকারীকে শনাক্ত করে যিনি সেই কন্টেন্টের মালিকের পক্ষে কাজ করার জন্য অনুমোদিত। ব্যবহারকারী যে অ্যাকাউন্ট দিয়ে যাচাই করবেন সেটি অবশ্যই YouTube Creator Studio সেটিংসের মধ্যে নির্দিষ্ট কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধের বডি

অনুরোধের বডিতে playlistItem রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য:

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

  • id
  • snippet.playlistId
  • snippet.resourceId

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

  • snippet.position
  • contentDetails.note
  • contentDetails.startAt
  • contentDetails.endAt

  আপনি যদি কোনও আপডেট অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন কোনও প্রপার্টির জন্য ভ্যালু নির্দিষ্ট না করা থাকে যার আগে থেকেই একটি ভ্যালু আছে, তাহলে প্রপার্টির আগে থেকে থাকা ভ্যালু মুছে ফেলা হবে।

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
forbidden (403)	playlistItemsNotAccessible	নির্দিষ্ট প্লেলিস্ট আইটেম আপডেট করার জন্য অনুরোধটি যথাযথভাবে অনুমোদিত নয়।
invalidValue (400)	invalidPlaylistItemPosition	অনুরোধটি প্লেলিস্ট আইটেমের অবস্থানকে একটি ভুল বা কাজ করে না এমন মান সেট করার চেষ্টা করে। রিসোর্সের snippet-এ position প্রপার্টির ভ্যালু চেক করুন।
invalidValue (400)	invalidResourceType	রিসোর্স আইডির জন্য নির্দিষ্ট করা type এই অপারেশনের জন্য কাজ করে না। রিসোর্স আইডি প্লেলিস্টে যোগ করা আইটেম শনাক্ত করে – যেমন youtube#video।
invalidValue (400)	invalidSnippet	অনুরোধে কোনও সঠিক snippet প্রপার্টির উল্লেখ করা হয়নি।
invalidValue (400)	manualSortRequired	অনুরোধটি প্লেলিস্ট আইটেমের পজিশন সেট করার চেষ্টা করছে, কিন্তু প্লেলিস্টে ম্যানুয়াল সর্টিং ব্যবহার করা হয় না। (যেমন, প্লেলিস্টের আইটেম তারিখ বা জনপ্রিয়তার ভিত্তিতে সাজানো হতে পারে।) অনুরোধের মাধ্যমে যে রিসোর্স যোগ করা হচ্ছে সেখান থেকে snippet.position এলিমেন্ট সরিয়ে দিয়ে আপনি সমস্যার সমাধান করতে পারবেন। আপনি যদি চান যে প্লেলিস্ট আইটেমটি তালিকায় একটি নির্দিষ্ট অবস্থানে থাকুক, তাহলে আপনাকে প্রথমে প্লেলিস্টের সেটিংসে প্লেলিস্টের অর্ডার করা বিকল্পটি ম্যানুয়াল-এ আপডেট করতে হবে। YouTube ভিডিও ম্যানেজার থেকে এই সেটিংস অ্যাডজাস্ট করা যাবে।
notFound (404)	playlistItemNotFound	অনুরোধের id প্রপার্টি দিয়ে শনাক্ত করা প্লেলিস্ট আইটেম খুঁজে পাওয়া যায়নি।
notFound (404)	playlistNotFound	অনুরোধের playlistId প্যারামিটার দিয়ে শনাক্ত করা প্লেলিস্ট খুঁজে পাওয়া যায়নি।
required (400)	channelIdRequired	অনুরোধে প্রয়োজনীয় channelId প্রপার্টির জন্য কোনও ভ্যালু উল্লেখ করা হয়নি।
required (400)	playlistIdRequired	অনুরোধে প্রয়োজনীয় playlistId প্রপার্টির কোনও ভ্যালু উল্লেখ করা হয়নি।
required (400)	playlistItemIdRequired	অনুরোধে নির্দিষ্ট করা প্লেলিস্ট আইটেম রিসোর্সকে অবশ্যই id প্রপার্টি ব্যবহার করে আপডেট করা প্লেলিস্ট আইটেম শনাক্ত করতে হবে।
invalidValue (400)	playlistOperationUnsupported	API-তে নির্দিষ্ট প্লেলিস্টে ভিডিও আপডেট করার সুবিধা নেই। যেমন, আপনার আপলোড করা ভিডিওর প্লেলিস্টে কোনও ভিডিও আপডেট করতে পারবেন না।

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

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