Captions: insert

ক্যাপশন ট্র্যাক আপলোড করে।

এই পদ্ধতিতে মিডিয়া আপলোড করা যায়। আপলোড করা ফাইলকে এইসব সীমাবদ্ধতা মেনে চলতে হবে:

  • ফাইলের সর্বাধিক সাইজ: ১০০ এমবি
  • গ্রহণযোগ্য মিডিয়া MIME-এর ধরন: text/xml, application/octet-stream, */*

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

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

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/upload/youtube/v3/captions

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন। যাচাইকরণ ও অনুমোদন সম্পর্কে আরও জানতে, OAuth 2.0 অনুমোদন প্রয়োগ করা দেখুন।

সুযোগ
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part string
part প্যারামিটার caption রিসোর্সের সেইসব অংশ নির্দিষ্ট করে যা API উত্তরে অন্তর্ভুক্ত থাকবে। প্যারামিটারের মান snippet-এ সেট করুন।

নিম্নলিখিত তালিকায় part-এর নাম রয়েছে যা আপনি প্যারামিটারের মানে অন্তর্ভুক্ত করতে পারবেন:
  • id
  • snippet
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে।

onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেল ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে আসল CMS অ্যাকাউন্ট দিয়ে যাচাই করেন সেটি নির্দিষ্ট YouTube কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে।
sync boolean
এই প্যারামিটার বন্ধ করে দেওয়া হয়েছে। sync প্যারামিটার থেকে বোঝা যায় যে YouTube-কে ভিডিওর অডিও ট্র্যাকের সাথে ক্যাপশন ফাইল অটোমেটিক সিঙ্ক করতে হবে কিনা। আপনি যদি মান true-এ সেট করেন, তাহলে YouTube আপলোড করা ক্যাপশন ফাইলে থাকা যেকোনও টাইম কোড উপেক্ষা করবে এবং ক্যাপশনের জন্য নতুন টাইম কোড তৈরি করবে।

আপনি যদি কোনও ট্রান্সস্ক্রিপ্ট আপলোড করেন, যাতে কোনও টাইম কোড নেই অথবা আপনার ফাইলে টাইম কোড ভুল আছে বলে সন্দেহ করেন এবং YouTube-কে সেগুলি ঠিক করার চেষ্টা করতে চান, তাহলে আপনার sync প্যারামিটার true-এ সেট করা উচিত।

অনুরোধের বডি

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

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

  • snippet.videoId
  • snippet.language
  • snippet.name

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

  • snippet.videoId
  • snippet.language
  • snippet.name
  • snippet.isDraft

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) contentRequired অনুরোধে ক্যাপশন ট্র্যাকের কন্টেন্ট নেই।
conflict (409) captionExists উল্লেখ করা ভিডিওতে আগে থেকেই প্রদত্ত snippet.language এবং snippet.name সহ ক্যাপশন ট্র্যাক আছে। একই ভাষার জন্য একটি ভিডিওতে একাধিক ট্র্যাক থাকতে পারে, তবে প্রতিটি ট্র্যাকের নাম আলাদা হতে হবে।

এই সমস্যার সমাধান করার একাধিক উপায় আছে। আপনি আগে থেকে থাকা ট্র্যাক মুছে দিয়ে নতুন একটি যোগ করতে পারেন অথবা নতুন ট্র্যাক যোগ করার আগে সেটির নাম পরিবর্তন করতে পারেন।
forbidden (403) forbidden ক্যাপশন ট্র্যাক আপলোড করার জন্য অনুরোধের সাথে যুক্ত অনুমতি যথেষ্ট নয়। অনুরোধটি সঠিকভাবে অনুমোদিত নাও হতে পারে।
invalidValue (400) invalidMetadata অনুরোধে ভুল মেটাডেটা ভ্যালু রয়েছে, যার ফলে ট্র্যাক তৈরি করা যাচ্ছে না। অনুরোধে snippet.language, snippet.name ও snippet.videoId প্রপার্টির জন্য সঠিক মান উল্লেখ করা হয়েছে কিনা তা কনফার্ম করুন। snippet.isDraft প্রপার্টিও অন্তর্ভুক্ত করা যেতে পারে, তবে এটি আবশ্যক নয়।
notFound (404) videoNotFound videoId প্যারামিটার দ্বারা শনাক্ত করা ভিডিও খুঁজে পাওয়া যায়নি।
invalidValue (400) nameTooLong অনুরোধে উল্লেখ করা snippet.name অনেক বড়। সর্বাধিক ১৫০টি অক্ষর ব্যবহার করা যাবে।

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

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