Videos: update

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

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

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

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

অনুরোধ করুন

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-এর নাম রয়েছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারবেন:
  • brandPartner
  • 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-এ সেট করতে হবে। ভিডিওর গোপনীয়তা স্ট্যাটাস private হলে এবং ভিডিওটি কখনও প্রকাশ করা না হলে তবেই এই প্রপার্টি সেট করা যাবে।
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) defaultLanguageNotSet API অনুরোধটি ভিডিওর বিবরণের ডিফল্ট ভাষা উল্লেখ না করেই ভিডিওর স্থানীয় বিবরণ যোগ করার চেষ্টা করছে।
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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।