Playlists: update

একটি প্লেলিস্ট পরিবর্তন করে। উদাহরণস্বরূপ, আপনি একটি প্লেলিস্টের শিরোনাম, বিবরণ, বা গোপনীয়তার স্থিতি পরিবর্তন করতে পারেন৷

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

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

ব্যাপ্তি
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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

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

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

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

    • id
    • snippet.title

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

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

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

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

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

ত্রুটি

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

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

এটা চেষ্টা করুন!

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

,

একটি প্লেলিস্ট পরিবর্তন করে। উদাহরণস্বরূপ, আপনি একটি প্লেলিস্টের শিরোনাম, বিবরণ, বা গোপনীয়তার স্থিতি পরিবর্তন করতে পারেন৷

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

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

ব্যাপ্তি
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 বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।

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

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

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

    • id
    • snippet.title

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

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

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

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

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

ত্রুটি

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

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

এটা চেষ্টা করুন!

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