বাস্তবায়ন: ক্যাপশন

নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে ক্যাপশন সম্পর্কিত ফাংশনগুলি সম্পাদন করতে YouTube ডেটা API (v3) ব্যবহার করতে হয়৷

একটি ভিডিওর জন্য ক্যাপশন ট্র্যাকগুলির একটি তালিকা পুনরুদ্ধার করুন৷

একটি নির্দিষ্ট ভিডিওর জন্য উপলব্ধ ক্যাপশন ট্র্যাকগুলির একটি তালিকা পুনরুদ্ধার করতে, captions.list পদ্ধতিতে কল করুন৷ videoId প্যারামিটার মানটিকে YouTube ভিডিও আইডিতে সেট করুন যা অনন্যভাবে সেই ভিডিওটিকে সনাক্ত করে যার জন্য আপনি ক্যাপশনগুলি পুনরুদ্ধার করছেন৷ আপনার অনুরোধ অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

নীচের অনুরোধটি Google গল্প YouTube চ্যানেলে একটি ভিডিওর জন্য ক্যাপশনের একটি তালিকা পুনরুদ্ধার করে:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list?
part=snippet
&videoId=PRU2ShMzQRg

কোড নমুনার জন্য captions.list পদ্ধতির ডকুমেন্টেশন দেখুন।

একটি ক্যাপশন ট্র্যাক তৈরি করুন৷

এই ক্যোয়ারীটি APIs এক্সপ্লোরার ব্যবহার করে পরীক্ষা করা যাবে না কারণ APIs এক্সপ্লোরার ফাইল আপলোড করার ক্ষমতা সমর্থন করে না, যা এই পদ্ধতির জন্য প্রয়োজনীয়।

আপনি একটি ভিডিওর জন্য একটি নতুন ক্যাপশন ট্র্যাক আপলোড করতে API-এর captions.insert পদ্ধতি ব্যবহার করতে পারেন৷ একটি ট্র্যাক আপলোড করার সময়, আপনাকে অবশ্যই নিম্নলিখিত caption সম্পদ বৈশিষ্ট্যগুলির জন্য একটি মান নির্দিষ্ট করতে হবে:

  • snippet.videoId - এটি সেই ভিডিওটিকে চিহ্নিত করে যেখানে ক্যাপশন ট্র্যাকটি যোগ করা হচ্ছে৷
  • snippet.language - ক্যাপশন ট্র্যাকের ভাষা।
  • snippet.name - ক্যাপশন ট্র্যাকের নাম।

একটি ক্যাপশন ট্র্যাক আপলোড করার সময় নিম্নলিখিত অতিরিক্ত বিকল্পগুলি উপলব্ধ:

  • আপনি যদি sync প্যারামিটারটিকে true সেট করেন, তাহলে YouTube আপলোড করা ক্যাপশন ফাইলে থাকা যেকোনো সময় কোডগুলিকে উপেক্ষা করবে এবং ক্যাপশনগুলির জন্য নতুন সময় কোড তৈরি করবে৷

    যদি আপনি একটি ট্রান্সক্রিপ্ট আপলোড করছেন, যার কোনো টাইম কোড নেই, অথবা যদি আপনি সন্দেহ করেন যে আপনার ফাইলের টাইম কোডগুলি ভুল এবং YouTube সেগুলি ঠিক করার চেষ্টা করতে চান তাহলে আপনার sync প্যারামিটারটিকে true হিসাবে সেট করা উচিত৷

  • আপনি যদি caption রিসোর্সের snippet.isDraft প্রপার্টি true তে সেট করেন, ট্র্যাকটি সর্বজনীনভাবে দৃশ্যমান হবে না।

কোড নমুনার জন্য captions.insert পদ্ধতির ডকুমেন্টেশন দেখুন।

একটি ক্যাপশন ট্র্যাক ডাউনলোড করুন

এই ক্যোয়ারীটি APIs এক্সপ্লোরার ব্যবহার করে পরীক্ষা করা যাবে না কারণ APIs এক্সপ্লোরার ফাইলগুলি ডাউনলোড করার ক্ষমতা সমর্থন করে না৷

একটি নির্দিষ্ট ক্যাপশন ট্র্যাক ডাউনলোড করতে, captions.download পদ্ধতিতে কল করুন। ইউটিউব ক্যাপশন ট্র্যাক আইডিতে id প্যারামিটার মান সেট করুন যা আপনি যে ক্যাপশন ট্র্যাকটি ডাউনলোড করছেন তা অনন্যভাবে সনাক্ত করে৷ আপনার অনুরোধ অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

v3 API নিম্নলিখিত বিকল্পগুলিকে সমর্থন করে:

  • একটি ক্যাপশন ট্র্যাক একটি নির্দিষ্ট বিন্যাসে ফেরত দেওয়া উচিত তা নির্দিষ্ট করতে, পছন্দসই বিন্যাস সনাক্ত করতে tfmt প্যারামিটার মান সেট করুন। প্যারামিটার সংজ্ঞা সমর্থিত মান তালিকা করে।

  • একটি ক্যাপশন ট্র্যাকের একটি অনুবাদ পুনরুদ্ধার করতে, tlang প্যারামিটার মানটিকে ISO 639-1 দুই-অক্ষরের ভাষা কোডে সেট করুন যা পছন্দসই ক্যাপশন ভাষা সনাক্ত করে। অনুবাদটি মেশিন অনুবাদ ব্যবহার করে তৈরি করা হয়, যেমন Google অনুবাদ।

কোড নমুনার জন্য captions.download পদ্ধতির ডকুমেন্টেশন দেখুন।

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

API একটি ক্যাপশন ট্র্যাকের খসড়া স্থিতি পরিবর্তন করার ক্ষমতা সমর্থন করে, একটি ফাইলের জন্য একটি নতুন ক্যাপশন ট্র্যাক আপলোড করতে, বা উভয়ই৷

আপনি একটি ট্র্যাকের খসড়া স্থিতি পরিবর্তন করার ক্ষমতা পরীক্ষা করতে APIs এক্সপ্লোরার ব্যবহার করতে পারেন৷ যাইহোক, আপনি প্রকৃত ক্যাপশন ট্র্যাক আপডেট করতে APIs এক্সপ্লোরার ব্যবহার করতে পারবেন না কারণ টুল ফাইল আপলোড করার ক্ষমতা সমর্থন করে না।

নীচের অনুরোধটি Google গল্প YouTube চ্যানেলে একটি ভিডিওর জন্য ক্যাপশনের একটি তালিকা পুনরুদ্ধার করে:

অনুরোধটি একটি ক্যাপশন ট্র্যাকের খসড়া স্থিতি true আপডেট করে, যার অর্থ ট্র্যাকটি সর্বজনীনভাবে দৃশ্যমান হবে না৷ APIs এক্সপ্লোরারে অনুরোধটি সম্পূর্ণ করতে, আপনাকে একটি ক্যাপশন ট্র্যাক সনাক্ত করতে id সম্পত্তির মান সেট করতে হবে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update?
part=snippet

কোড নমুনার জন্য captions.update পদ্ধতির ডকুমেন্টেশন দেখুন।

একটি ক্যাপশন ট্র্যাক মুছুন

এই উদাহরণটি দেখায় কিভাবে একটি ক্যাপশন ট্র্যাক মুছে ফেলতে হয়। উদাহরণে নিম্নলিখিত ধাপ রয়েছে:

  • ধাপ 1: ক্যাপশন ট্র্যাক আইডি পুনরুদ্ধার করুন

    একটি ভিডিওর জন্য ক্যাপশন ট্র্যাকগুলির একটি তালিকা পুনরুদ্ধার করতে উপরের পদক্ষেপগুলি অনুসরণ করুন৷ তালিকাটি ক্যাপশন ট্র্যাকগুলির একটি তালিকা প্রদর্শন করতে ব্যবহার করা যেতে পারে, প্রতিটি ট্র্যাকের আইডি একটি কী হিসাবে ব্যবহার করে৷

  • ধাপ 2: ট্র্যাক মুছুন

    একটি নির্দিষ্ট ভিডিও মুছে ফেলার জন্য captions.delete পদ্ধতিতে কল করুন। অনুরোধে, id প্যারামিটারটি আপনি যে ট্র্যাকটি মুছে ফেলছেন তার ক্যাপশন ট্র্যাক আইডি নির্দিষ্ট করে৷ অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। আপনি যদি APIs এক্সপ্লোরারে এই ক্যোয়ারীটি পরীক্ষা করছেন, তাহলে আপনাকে id প্যারামিটার মানের জন্য একটি বৈধ ক্যাপশন ট্র্যাক আইডি প্রতিস্থাপন করতে হবে।

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete?
id=CAPTION_TRACK_ID