PlaylistItems: update

একটি প্লেলিস্ট আইটেম সংশোধন করে। উদাহরণস্বরূপ, আপনি প্লেলিস্টে আইটেমের অবস্থান আপডেট করতে পারেন।

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

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

অনুরোধ

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 ক্রিয়েটর স্টুডিও সেটিংসে নির্দিষ্ট বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

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

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

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

    • id
    • snippet.playlistId
    • snippet.resourceId

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

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

    আপনি যদি একটি আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন একটি সম্পত্তির জন্য একটি মান উল্লেখ না করে যার ইতিমধ্যে একটি মান আছে, তাহলে সম্পত্তির বিদ্যমান মানটি মুছে ফেলা হবে৷

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

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা 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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।

,

একটি প্লেলিস্ট আইটেম সংশোধন করে। উদাহরণস্বরূপ, আপনি প্লেলিস্টে আইটেমের অবস্থান আপডেট করতে পারেন।

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

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

অনুরোধ

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 ক্রিয়েটর স্টুডিও সেটিংসে নির্দিষ্ট বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

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

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

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

    • id
    • snippet.playlistId
    • snippet.resourceId

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

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

    আপনি যদি একটি আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন একটি সম্পত্তির জন্য একটি মান উল্লেখ না করে যার ইতিমধ্যে একটি মান আছে, তাহলে সম্পত্তির বিদ্যমান মানটি মুছে ফেলা হবে৷

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

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা 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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।