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

Captions

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

একটি caption সম্পদ একটি YouTube ক্যাপশন ট্র্যাক প্রতিনিধিত্ব করে৷ একটি ক্যাপশন ট্র্যাক ঠিক একটি YouTube ভিডিওর সাথে যুক্ত৷

পদ্ধতি

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

list: একটি নির্দিষ্ট ভিডিওর সাথে যুক্ত ক্যাপশন ট্র্যাকগুলির একটি তালিকা পুনরুদ্ধার করুন৷ মনে রাখবেন যে API প্রতিক্রিয়াতে প্রকৃত ক্যাপশন থাকে না এবং captions.download পদ্ধতি একটি ক্যাপশন ট্র্যাক পুনরুদ্ধার করার ক্ষমতা প্রদান করে। এটা এখন চেষ্টা কর .
insert: একটি ক্যাপশন ট্র্যাক আপলোড করুন৷
update: একটি ক্যাপশন ট্র্যাক আপডেট করুন৷ একটি ক্যাপশন ট্র্যাক আপডেট করার সময়, আপনি ট্র্যাকের খসড়া স্থিতি পরিবর্তন করতে পারেন, ট্র্যাকের জন্য একটি নতুন ক্যাপশন ফাইল আপলোড করতে পারেন, বা উভয়ই৷
delete: একটি নির্দিষ্ট ক্যাপশন ট্র্যাক মুছুন। এটা এখন চেষ্টা কর .
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 যে ID ব্যবহার করে।
`snippet. lastUpdated`	`datetime` তারিখ এবং সময় যখন ক্যাপশন ট্র্যাক শেষ আপডেট করা হয়েছিল৷ মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে।
`snippet. trackKind`	`string` ক্যাপশন ট্র্যাকের ধরন। এই সম্পত্তির জন্য বৈধ মান হল: `ASR` - স্বয়ংক্রিয় বক্তৃতা শনাক্তকরণ ব্যবহার করে তৈরি করা একটি ক্যাপশন ট্র্যাক৷ `forced` - একটি ক্যাপশন ট্র্যাক যা প্লেয়ারে অন্য কোনো ট্র্যাক নির্বাচন না করলে প্লে হয়৷ উদাহরণ স্বরূপ, একটি ভিডিও যা দেখায় যে ভিনগ্রহীরা একটি এলিয়েন ভাষায় কথা বলছে তাতে শুধুমাত্র এলিয়েন ভাষার জন্য সাবটাইটেল দেখানোর জন্য বাধ্যতামূলক ক্যাপশন ট্র্যাক থাকতে পারে। `standard` - একটি নিয়মিত ক্যাপশন ট্র্যাক। এটি ডিফল্ট মান।
`snippet. language`	`string` ক্যাপশন ট্র্যাকের ভাষা। সম্পত্তি মান একটি BCP-47 ভাষা ট্যাগ.
`snippet. name`	`string` ক্যাপশন ট্র্যাকের নাম। নামটি প্লেব্যাকের সময় একটি বিকল্প হিসাবে ব্যবহারকারীর কাছে দৃশ্যমান হওয়ার উদ্দেশ্যে করা হয়েছে৷ সর্বাধিক সমর্থিত নামের দৈর্ঘ্য 150 অক্ষর।
`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` পদ্ধতিতে কল করার সময়, আপনি YouTube-কে ভিডিওতে আপলোড করা ট্র্যাক সিঙ্ক করার নির্দেশ দেওয়ার জন্য `sync` প্যারামিটারটিকে `true` হিসাবে সেট করতে পারেন৷ মানটি `false` হলে, কখন ক্যাপশন প্রদর্শন করতে হবে তা নির্ধারণ করতে YouTube আপলোড করা ক্যাপশন ট্র্যাকের সময় কোড ব্যবহার করে।
`snippet. status`	`string` ক্যাপশন ট্র্যাকের স্থিতি। এই সম্পত্তির জন্য বৈধ মান হল: `failed` `serving` `syncing`
`snippet. failureReason`	`string` যে কারণে YouTube ক্যাপশন ট্র্যাক প্রক্রিয়া করতে ব্যর্থ হয়েছে৷ এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি `state` সম্পত্তির মান `failed` । এই সম্পত্তির জন্য বৈধ মান হল: `processingFailed` - YouTube আপলোড করা ক্যাপশন ট্র্যাক প্রক্রিয়া করতে ব্যর্থ হয়েছে৷ `unknownFormat` - ক্যাপশন ট্র্যাকের বিন্যাস স্বীকৃত হয়নি। `unsupportedFormat` - ক্যাপশন ট্র্যাকের বিন্যাস সমর্থিত নয়।