Captions

মনে রাখবেন: ১৩ মার্চ, ২০২৪ তারিখে, YouTube ঘোষণা করেছে যে এটি captions.insert এবং captions.update API এন্ডপয়েন্টের জন্য sync প্যারামিটার বন্ধ করে দিচ্ছে। YouTube Creator Studio-তে ক্যাপশন অটো-সিঙ্ক করার সুবিধা এখনও উপলভ্য। আরও বিবরণের জন্য API রিভিশন ইতিহাস দেখুন।

caption রিসোর্স YouTube ক্যাপশন ট্র্যাককে বোঝায়। একটি ক্যাপশন ট্র্যাক ঠিক একটি YouTube ভিডিওর সাথে যুক্ত থাকে।

পদ্ধতি

API, captions রিসোর্সের জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:

তালিকা

নির্দিষ্ট ভিডিওর সাথে যুক্ত ক্যাপশন ট্র্যাকের তালিকা ফিরিয়ে আনুন। মনে রাখবেন যে API রেসপন্সে আসল ক্যাপশন থাকে না এবং captions.download পদ্ধতি ক্যাপশন ট্র্যাক ফিরিয়ে আনার সুবিধা প্রদান করে। এখনই ব্যবহার করে দেখুন।

ইনসার্ট করুন

ক্যাপশন ট্র্যাক আপলোড করুন। এখনই এটি ব্যবহার করে দেখুন।

আপডেট

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

ডাউনলোড করুন

ক্যাপশন ট্র্যাক ডাউনলোড করুন। অনুরোধে tfmt প্যারামিটারের কোনও ভ্যালু উল্লেখ করা না থাকলে ক্যাপশন ট্র্যাকটি তার আসল ফর্ম্যাটে এবং tlang প্যারামিটারের কোনও ভ্যালু উল্লেখ করা না থাকলে তার আসল ভাষায় ফিরিয়ে আনা হয়। এখনই ব্যবহার করে দেখুন।

মুছে ফেলুন

নির্দিষ্ট ক্যাপশন ট্র্যাক মুছে দিন। এখনই এটি ব্যবহার করে দেখুন।

রিসোর্স রিপ্রেজেন্টেশন

নিম্নলিখিত JSON স্ট্রাকচার captions রিসোর্সের ফর্ম্যাট দেখায়:

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": string
  }
}

প্রপার্টি

এই রিসোর্সে যেসব প্রপার্টি দেখা যায়, নিম্নলিখিত সারণীতে সেগুলি সম্পর্কে বলা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#caption।
etag	etag এই রিসোর্সের Etag.
id	string ক্যাপশন ট্র্যাক অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet	object snippet অবজেক্টে ক্যাপশন সম্পর্কে প্রাথমিক বিবরণ থাকে।
snippet.videoId	string ক্যাপশন ট্র্যাকের সাথে যুক্ত ভিডিওকে অনন্যভাবে শনাক্ত করতে YouTube যে আইডি ব্যবহার করে।
snippet.lastUpdated	datetime ক্যাপশন ট্র্যাক শেষবার আপডেট করার তারিখ ও সময়। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।
snippet.trackKind	string ক্যাপশন ট্র্যাকের ধরন। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: ASR – অটোমেটিক স্পিচ রিকগনিশন ব্যবহার করে তৈরি করা ক্যাপশন ট্র্যাক। forced – প্লেয়ারে অন্য কোনও ট্র্যাক বেছে না নিলে এই ক্যাপশন ট্র্যাকটি চালানো হয়। যেমন, কোনও ভিডিওতে এলিয়েনরা এলিয়েন ভাষায় কথা বললে, সেই ভিডিওতে এলিয়েন ভাষার সাবটাইটেল দেখানোর জন্য ফোর্সড ক্যাপশন ট্র্যাক থাকতে পারে। standard – একটি সাধারণ ক্যাপশন ট্র্যাক। এটি হল ডিফল্ট ভ্যালু।
snippet.language	string ক্যাপশন ট্র্যাকের ভাষা। প্রপার্টির ভ্যালু হল একটি BCP-47 ভাষা ট্যাগ।
snippet.name	string ক্যাপশন ট্র্যাকের নাম। প্লেব্যাকের সময় ব্যবহারকারীকে একটি বিকল্প হিসেবে নাম দেখানোর উদ্দেশ্যেই এটি করা হয়। নামের সর্বাধিক দৈর্ঘ্য ১৫০ অক্ষর হতে পারে।
snippet.audioTrackType	string ক্যাপশন ট্র্যাকের সাথে যুক্ত অডিও ট্র্যাকের ধরন। এই প্রপার্টির সঠিক ভ্যালু হল: commentary – ক্যাপশন ট্র্যাকটি এমন একটি বিকল্প অডিও ট্র্যাকের সাথে সম্পর্কিত যাতে ধারাভাষ্য অন্তর্ভুক্ত থাকে, যেমন ডিরেক্টরি ধারাভাষ্য। descriptive – ক্যাপশন ট্র্যাকটি একটি বিকল্প অডিও ট্র্যাকের সাথে সম্পর্কিত যাতে অতিরিক্ত বর্ণনামূলক অডিও অন্তর্ভুক্ত থাকে। primary – ক্যাপশন ট্র্যাক ভিডিওর প্রাথমিক অডিও ট্র্যাকের সাথে সম্পর্কিত, যা সাধারণত ভিডিওর সাথে যুক্ত অডিও ট্র্যাক। unknown – এটি ডিফল্ট ভ্যালু।
snippet.isCC	boolean ট্র্যাকে বধির ও আংশিক বধির ব্যক্তিদের জন্য ক্লোজড ক্যাপশন আছে কিনা তা বোঝায়। ডিফল্ট ভ্যালু হল false।
snippet.isLarge	boolean ক্যাপশন ট্র্যাকে দৃষ্টিশক্তিহীন ব্যক্তিদের জন্য বড় টেক্সট ব্যবহার করা হয়েছে কিনা তা দেখায়। ডিফল্ট ভ্যালু হল false।
snippet.isEasyReader	boolean ক্যাপশন ট্র্যাক "সহজ পাঠক"-এর জন্য ফর্ম্যাট করা হয়েছে কিনা তা বোঝায়, অর্থাৎ ভাষা শিক্ষার ক্ষেত্রে এটি থার্ড-গ্রেড লেভেলে আছে। ডিফল্ট ভ্যালু হল false।
snippet.isDraft	boolean ক্যাপশন ট্র্যাকটি ড্রাফ্ট কিনা তা নির্দেশ করে। ভ্যালু true হলে, ট্র্যাকটি সর্বজনীনভাবে দৃশ্যমান নয়। ডিফল্ট ভ্যালু হল false।
snippet.isAutoSynced	boolean YouTube ভিডিওর অডিও ট্র্যাকের সাথে ক্যাপশন ট্র্যাক সিঙ্ক করেছে কিনা তা দেখায়। ক্যাপশন ট্র্যাক আপলোড করার সময় সিঙ্ক করার জন্য স্পষ্টভাবে অনুরোধ করা হলে, ভ্যালু true হবে। যেমন, captions.insert বা captions.update মেথড কল করার সময়, আপনি sync প্যারামিটারকে true-এ সেট করতে পারেন যাতে YouTube-কে আপলোড করা ট্র্যাক ভিডিওর সাথে সিঙ্ক করার নির্দেশ দেওয়া যায়। ভ্যালু false হলে, কখন ক্যাপশন দেখাতে হবে তা নির্ধারণ করতে YouTube আপলোড করা ক্যাপশন ট্র্যাকে টাইম কোড ব্যবহার করে।
snippet.status	string ক্যাপশন ট্র্যাকের স্ট্যাটাস। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: failed serving syncing
snippet.failureReason	string YouTube ক্যাপশন ট্র্যাক প্রসেস করতে না পারার কারণ। state প্রপার্টির ভ্যালু failed হলে তবেই এই প্রপার্টি থাকে। এই প্রপার্টির সঠিক ভ্যালু হল: processingFailed – আপলোড করা ক্যাপশন ট্র্যাক YouTube প্রসেস করতে পারেনি। unknownFormat – ক্যাপশন ট্র্যাকের ফর্ম্যাট শনাক্ত করা যায়নি। unsupportedFormat – ক্যাপশন ট্র্যাকের ফর্ম্যাট কাজ করে না।