Videos: update

API এখন আপনার চ্যানেল বা ভিডিওগুলিকে "বাচ্চাদের জন্য তৈরি" হিসাবে চিহ্নিত করার ক্ষমতা সমর্থন করে৷ এছাড়াও, channel এবং video সংস্থানগুলিতে এখন এমন একটি সম্পত্তি রয়েছে যা সেই চ্যানেল বা ভিডিওর "বাচ্চাদের জন্য তৈরি" স্থিতি সনাক্ত করে। YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলী এবং বিকাশকারীর নীতিগুলিও 10 জানুয়ারী 2020-এ আপডেট করা হয়েছিল৷ আরও তথ্যের জন্য, YouTube ডেটা API পরিষেবা এবং YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলীর পুনর্বিবেচনার ইতিহাসগুলি দেখুন৷

একটি ভিডিওর মেটাডেটা আপডেট করে।

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

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

অনুরোধ

HTTP অনুরোধ 

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

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

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

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

উপরন্তু, সমস্ত অংশে এমন বৈশিষ্ট্য থাকে না যা একটি ভিডিও সন্নিবেশ বা আপডেট করার সময় সেট করা যায়। উদাহরণ স্বরূপ, statistics বস্তুটি পরিসংখ্যানকে এনক্যাপসুলেট করে যা YouTube একটি ভিডিওর জন্য গণনা করে এবং এতে এমন মান থাকে না যা আপনি সেট বা পরিবর্তন করতে পারেন। যদি পরামিতি মান এমন একটি part নির্দিষ্ট করে যা পরিবর্তনযোগ্য মান ধারণ করে না, সেই part এখনও API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

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

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

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

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

    • id
    • snippet.title – অনুরোধটি video রিসোর্সের snippet আপডেট করলেই এই সম্পত্তির প্রয়োজন হয়।
    • snippet.categoryId – অনুরোধটি video রিসোর্সের snippet আপডেট করলেই এই সম্পত্তির প্রয়োজন হয়।

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

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • status.publishAt - যদি আপনি এই সম্পত্তির জন্য একটি মান সেট করেন, তাহলে আপনাকে অবশ্যই status.privacyStatus সম্পত্তিকে private হিসাবে সেট করতে হবে।
    • status.selfDeclaredMadeForKids
    • recordingDetails.locationDescription ( অবলোপন করা হয়েছে )
    • recordingDetails.location.latitude ( অপ্রচলিত )
    • recordingDetails.location.longitude ( অবচয় )
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

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

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

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) defaultLanguageNotSet এপিআই অনুরোধটি ভিডিও বিবরণের ডিফল্ট ভাষা উল্লেখ না করে স্থানীয় ভিডিও বিবরণ যোগ করার চেষ্টা করছে।
badRequest (400) invalidCategoryId snippet.categoryId বৈশিষ্ট্য একটি অবৈধ বিভাগ আইডি নির্দিষ্ট করে৷ সমর্থিত বিভাগগুলি পুনরুদ্ধার করতে videoCategories.list পদ্ধতি ব্যবহার করুন৷
badRequest (400) invalidDefaultBroadcastPrivacySetting অনুরোধটি ডিফল্ট সম্প্রচারের জন্য একটি অবৈধ গোপনীয়তা সেটিং সেট করার চেষ্টা করে৷
badRequest (400) invalidDescription অনুরোধের মেটাডেটা একটি অবৈধ ভিডিও বিবরণ নির্দিষ্ট করে।
badRequest (400) invalidPublishAt অনুরোধের মেটাডেটা একটি অবৈধ নির্ধারিত প্রকাশনার সময় নির্দিষ্ট করে।
badRequest (400) invalidRecordingDetails অনুরোধের মেটাডেটাতে recordingDetails অবজেক্টটি অবৈধ রেকর্ডিং বিশদ উল্লেখ করে।
badRequest (400) invalidTags অনুরোধের মেটাডেটা অবৈধ ভিডিও কীওয়ার্ড নির্দিষ্ট করে।
badRequest (400) invalidTitle অনুরোধের মেটাডেটা একটি অবৈধ বা খালি ভিডিও শিরোনাম নির্দিষ্ট করে৷
badRequest (400) invalidVideoMetadata অনুরোধ মেটাডেটা অবৈধ.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting অনুরোধটি ভিডিওর জন্য একটি অবৈধ এম্বেড সেটিং সেট করার চেষ্টা করে৷ মনে রাখবেন কিছু চ্যানেলের লাইভ স্ট্রিমের জন্য এমবেড করা প্লেয়ার অফার করার অনুমতি নাও থাকতে পারে। আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।
forbidden (403) forbiddenLicenseSetting অনুরোধ ভিডিওটির জন্য একটি অবৈধ লাইসেন্স সেট করার চেষ্টা করে৷
forbidden (403) forbiddenPrivacySetting অনুরোধটি ভিডিওটির জন্য একটি অবৈধ গোপনীয়তা সেটিং সেট করার চেষ্টা করে৷
notFound (404) videoNotFound আপনি আপডেট করার চেষ্টা করছেন যে ভিডিও খুঁজে পাওয়া যাবে না. এটি সঠিক কিনা তা নিশ্চিত করতে অনুরোধের অংশে id ক্ষেত্রের মান পরীক্ষা করুন।

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

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