প্রয়োগ: ক্যাপশন

ক্যাপশন সম্পর্কিত ফাংশন পারফর্ম করতে কীভাবে YouTube Data API (v3) ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

ভিডিওর জন্য ক্যাপশন ট্র্যাকের তালিকা পাওয়া

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

নিচের অনুরোধটি Google Stories YouTube চ্যানেলের একটি ভিডিওর ক্যাপশনের তালিকা ফিরিয়ে আনে:

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

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

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

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

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

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

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

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

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

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

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

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

API Explorer ব্যবহার করে এই কোয়েরি পরীক্ষা করা যাবে না কারণ API Explorer-এ ফাইল ডাউনলোড করার সুবিধা নেই।

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

v3 API-তে নিম্নলিখিত বিকল্প কাজ করে:

• ক্যাপশন ট্র্যাক নির্দিষ্ট ফর্ম্যাটে ফেরত পেতে, tfmt প্যারামিটারের মান সেট করে কাঙ্ক্ষিত ফর্ম্যাট শনাক্ত করুন। প্যারামিটারের সংজ্ঞায় কাজ করে এমন ভ্যালু তালিকাভুক্ত করা হয়।

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

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

ক্যাপশন ট্র্যাক আপডেট করা

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

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

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

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

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

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

ক্যাপশন ট্র্যাক মুছে দেওয়া

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

• ধাপ ১: ক্যাপশন ট্র্যাক আইডি ফিরিয়ে আনা

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

• ধাপ ২: ট্র্যাক মুছে দিন

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

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