Captions: update

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

এই পদ্ধতি মিডিয়া আপলোড সমর্থন করে. আপলোড করা ফাইলগুলিকে অবশ্যই এই সীমাবদ্ধতাগুলি মেনে চলতে হবে:

  • সর্বাধিক ফাইলের আকার: 100MB
  • গৃহীত মিডিয়া MIME প্রকার: text/xml , application/octet-stream , */*

কোটা প্রভাব: এই পদ্ধতিতে কল করার জন্য 450 ইউনিটের কোটা খরচ হয়।

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

HTTP অনুরোধ

PUT https://www.googleapis.com/upload/youtube/v3/captions

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে। আপনি যদি ট্র্যাকের খসড়া স্ট্যাটাস আপডেট করেন তাহলে snippet সম্পত্তির মান সেট করুন। অন্যথায়, সম্পত্তি মান id এ সেট করুন।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • id
  • snippet
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ প্রকৃত CMS অ্যাকাউন্ট যেটির সাথে ব্যবহারকারী প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা উচিত।
sync boolean
এই প্যারামিটারটি অবমূল্যায়ন করা হয়েছে৷ দ্রষ্টব্য: এপিআই সার্ভার শুধুমাত্র প্যারামিটার মান প্রক্রিয়া করে যদি অনুরোধে একটি আপডেট করা ক্যাপশন ফাইল থাকে।

sync প্যারামিটারটি নির্দেশ করে যে YouTube স্বয়ংক্রিয়ভাবে ভিডিওর অডিও ট্র্যাকের সাথে ক্যাপশন ফাইলটি সিঙ্ক্রোনাইজ করবে কিনা। আপনি মানটি true সেট করলে, YouTube স্বয়ংক্রিয়ভাবে ক্যাপশন ট্র্যাকটিকে অডিও ট্র্যাকের সাথে সিঙ্ক্রোনাইজ করবে৷

শরীরের অনুরোধ

অনুরোধের অংশে একটি ক্যাপশন সংস্থান প্রদান করুন৷ সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • id

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.isDraft

    আপনি যদি একটি আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন একটি সম্পত্তির জন্য একটি মান উল্লেখ না করে যার ইতিমধ্যে একটি মান আছে, তাহলে সম্পত্তির বিদ্যমান মানটি মুছে ফেলা হবে৷

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি ক্যাপশন রিসোর্স প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) contentRequired অনুরোধটি একটি আপডেট করা ক্যাপশন ফাইল আপলোড করেনি৷ sync পরামিতি true সেট করা হলে প্রকৃত ট্র্যাক বিষয়বস্তু প্রয়োজন।
forbidden (403) forbidden অনুরোধের সাথে যুক্ত অনুমতিগুলি ক্যাপশন ট্র্যাক আপডেট করার জন্য যথেষ্ট নয়৷ অনুরোধ সঠিকভাবে অনুমোদিত নাও হতে পারে.
notFound (404) captionNotFound নির্দিষ্ট ক্যাপশন ট্র্যাক খুঁজে পাওয়া যায়নি. এটি সঠিক কিনা তা নিশ্চিত করতে অনুরোধের id সম্পত্তির মান পরীক্ষা করুন।

এটা চেষ্টা করুন!

এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।

,

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

এই পদ্ধতি মিডিয়া আপলোড সমর্থন করে. আপলোড করা ফাইলগুলিকে অবশ্যই এই সীমাবদ্ধতাগুলি মেনে চলতে হবে:

  • সর্বাধিক ফাইলের আকার: 100MB
  • গৃহীত মিডিয়া MIME প্রকার: text/xml , application/octet-stream , */*

কোটা প্রভাব: এই পদ্ধতিতে কল করার জন্য 450 ইউনিটের কোটা খরচ হয়।

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

HTTP অনুরোধ

PUT https://www.googleapis.com/upload/youtube/v3/captions

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে। আপনি যদি ট্র্যাকের খসড়া স্ট্যাটাস আপডেট করেন তাহলে snippet সম্পত্তির মান সেট করুন। অন্যথায়, সম্পত্তি মান id এ সেট করুন।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • id
  • snippet
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner string
এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট৷

onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি সামগ্রীর মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণ শংসাপত্র প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটাতে অ্যাক্সেস পেতে দেয়৷ প্রকৃত CMS অ্যাকাউন্ট যেটির সাথে ব্যবহারকারী প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা উচিত।
sync boolean
এই প্যারামিটারটি অবমূল্যায়ন করা হয়েছে৷ দ্রষ্টব্য: এপিআই সার্ভার শুধুমাত্র প্যারামিটার মান প্রক্রিয়া করে যদি অনুরোধে একটি আপডেট করা ক্যাপশন ফাইল থাকে।

sync প্যারামিটারটি নির্দেশ করে যে YouTube স্বয়ংক্রিয়ভাবে ভিডিওর অডিও ট্র্যাকের সাথে ক্যাপশন ফাইলটি সিঙ্ক্রোনাইজ করবে কিনা। আপনি মানটি true সেট করলে, YouTube স্বয়ংক্রিয়ভাবে ক্যাপশন ট্র্যাকটিকে অডিও ট্র্যাকের সাথে সিঙ্ক্রোনাইজ করবে৷

শরীরের অনুরোধ

অনুরোধের অংশে একটি ক্যাপশন সংস্থান প্রদান করুন৷ সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • id

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.isDraft

    আপনি যদি একটি আপডেটের অনুরোধ জমা দেন এবং আপনার অনুরোধে এমন একটি সম্পত্তির জন্য একটি মান উল্লেখ না করে যার ইতিমধ্যে একটি মান আছে, তাহলে সম্পত্তির বিদ্যমান মানটি মুছে ফেলা হবে৷

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি ক্যাপশন রিসোর্স প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
badRequest (400) contentRequired অনুরোধটি একটি আপডেট করা ক্যাপশন ফাইল আপলোড করেনি৷ sync পরামিতি true সেট করা হলে প্রকৃত ট্র্যাক বিষয়বস্তু প্রয়োজন।
forbidden (403) forbidden অনুরোধের সাথে যুক্ত অনুমতিগুলি ক্যাপশন ট্র্যাক আপডেট করার জন্য যথেষ্ট নয়৷ অনুরোধ সঠিকভাবে অনুমোদিত নাও হতে পারে.
notFound (404) captionNotFound নির্দিষ্ট ক্যাপশন ট্র্যাক খুঁজে পাওয়া যায়নি. এটি সঠিক কিনা তা নিশ্চিত করতে অনুরোধের id সম্পত্তির মান পরীক্ষা করুন।

এটা চেষ্টা করুন!

এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।