এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Captions: insert

একটি ক্যাপশন ট্র্যাক আপলোড করে৷

এই পদ্ধতি মিডিয়া আপলোড সমর্থন করে. আপলোড করা ফাইলগুলিকে অবশ্যই এই সীমাবদ্ধতাগুলি মেনে চলতে হবে:

সর্বাধিক ফাইলের আকার: 100MB
গৃহীত মিডিয়া MIME প্রকার: text/xml , application/octet-stream , */*

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

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

ব্যাপ্তি
`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` হিসাবে সেট করা উচিত৷

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

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

এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:
- snippet.videoId
- snippet.language
- snippet.name
আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:
- snippet.videoId
- snippet.language
- snippet.name
- snippet.isDraft

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

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা 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` টি অনেক বড়। সমর্থিত সর্বাধিক দৈর্ঘ্য 150 অক্ষর।

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

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