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 - ক্যাপশন ট্র্যাকের বিন্যাস সমর্থিত নয়।