Captions: update

ক্যাপশন ট্র্যাক আপডেট করে। ক্যাপশন ট্র্যাক আপডেট করার সময়, আপনি ট্র্যাকের ড্রাফ্ট স্ট্যাটাস পরিবর্তন করতে, ট্র্যাকের জন্য নতুন ক্যাপশন ফাইল আপলোড করতে অথবা এই দু'টিই করতে পারবেন।

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

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

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

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

অনুরোধ করুন

HTTP অনুরোধ

PUT 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 প্যারামিটার দুটি উদ্দেশ্যে কাজ করে। এটি সেইসব প্রপার্টি শনাক্ত করে যা রাইট অপারেশন সেট করবে এবং সেইসব প্রপার্টিও শনাক্ত করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। আপনি ট্র্যাকের ড্রাফ্ট স্ট্যাটাস আপডেট করলে, প্রপার্টির ভ্যালু snippet হিসেবে সেট করুন। অন্যথায়, প্রপার্টির ভ্যালু id হিসেবে সেট করুন।

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

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

sync প্যারামিটারটি দেখায় যে YouTube-এর ভিডিওর অডিও ট্র্যাকের সাথে ক্যাপশন ফাইল অটোমেটিক সিঙ্ক করা উচিত কিনা। আপনি মান true-এ সেট করলে, YouTube অটোমেটিক অডিও ট্র্যাকের সাথে ক্যাপশন ট্র্যাক সিঙ্ক করবে।

অনুরোধের বডি

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

  • এইসব প্রপার্টির জন্য আপনাকে অবশ্যই একটি মান উল্লেখ করতে হবে:

    • id

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

    • snippet.isDraft

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

রেসপন্স

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

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
badRequest (400) contentRequired অনুরোধে আপডেট করা ক্যাপশন ফাইল আপলোড করা হয়নি। sync প্যারামিটার true হিসেবে সেট করা থাকলে, আসল ট্র্যাক কন্টেন্ট প্রয়োজন।
forbidden (403) forbidden ক্যাপশন ট্র্যাক আপডেট করার জন্য অনুরোধের সাথে যুক্ত অনুমতি যথেষ্ট নয়। অনুরোধটি সঠিকভাবে অনুমোদিত নাও হতে পারে।
notFound (404) captionNotFound নির্দিষ্ট করা ক্যাপশন ট্র্যাক খুঁজে পাওয়া যায়নি। অনুরোধের id প্রপার্টির ভ্যালু সঠিক কিনা তা নিশ্চিত করতে চেক করুন।

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

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