পুনর্বিবেচনার ইতিহাস

এই পৃষ্ঠায় YouTube Data API (v3) সংক্রান্ত পরিবর্তন ও ডকুমেন্টেশন আপডেট তালিকাভুক্ত করা আছে।

সেপ্টেম্বর 30, 2026

comments রিসোর্স ডেফিনেশন আপডেট করা হয়েছে যাতে নতুন snippet.imageUrl প্রপার্টি অন্তর্ভুক্ত করা যায়, যা কমেন্টের সাথে অ্যাটাচ করা ছবি বা অ্যানিমেটেড GIF-এর URL প্রদান করে।

২০২৬ সালের নভেম্বরে এই ফিচার সব ব্যবহারকারীর জন্য উপলভ্য হবে।

সেপ্টেম্বর 14, 2026

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • thumbnails.set পদ্ধতির বিবরণে এই তথ্য যোগ করা হয়েছে যে আপলোড করা থাম্বনেলের সর্বাধিক ফাইলের সাইজ ২ এমবি থেকে বাড়িয়ে ৫০ এমবি করা হয়েছে।
  • playlistImages.insert পদ্ধতির বিবরণে আপডেট করে উল্লেখ করা হয়েছে যে আপলোড করা ছবির সর্বাধিক ফাইল সাইজ ২ এমবি থেকে বাড়িয়ে ৫০ এমবি করা হয়েছে।

১১ সেপ্টেম্বর, ২০২৬

snippet.thumbnails.(key) প্রপার্টির সংজ্ঞা activities, liveBroadcasts, playlistItems, playlists, search এবং videos রিসোর্সের রেফারেন্স ডকুমেন্টেশনে আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে কিছু ভিডিওর জন্য এখন আরও বেশি রেজোলিউশনের থাম্বনেল সাইজ উপলভ্য: fhd (1080p), qhd (1440p) এবং uhd (4K)।

সেপ্টেম্বর 1, 2026

videos.getRating পদ্ধতি এখন https://www.googleapis.com/auth/youtube.readonly অনুমোদনের স্কোপ গ্রহণ করে।

২৭ আগস্ট, ২০২৬

YouTube সব ভিডিও ফর্ম্যাটের জন্য পাবলিক ভিউ গণনা করার পদ্ধতি একই রকম করবে: বড় দৈর্ঘ্যের ভিডিও, লাইভ ও Shorts। ভিডিও চালানো শুরু করার মুহূর্ত থেকেই YouTube পাবলিক ভিউ গণনা করবে।

মনিটাইজেশনের যোগ্যতা এবং বেশিরভাগ মূল পারফর্ম্যান্স মেট্রিক প্রভাবিত হয় না কারণ সেগুলি এনগেজড মেট্রিকের উপর নির্ভর করে। ক্রিয়েটরের উপার্জন "এনগেজড Shorts ভিউ" এবং "এনগেজড দেখার মোট সময়" অনুযায়ী গণনা করা হবে, যা আপনি YouTube Analytics > উন্নত মোড থেকে দেখতে পাবেন।

YouTube পার্টনার প্রোগ্রামের যোগ্যতার শর্তে কোনও পরিবর্তন করা হয়নি। YouTube পার্টনার প্রোগ্রামে যোগ দেওয়ার প্রয়োজনীয়তা এখন "উপযুক্ত Shorts ভিউ" এবং "উপযুক্ত ওয়াচ টাইম" (আগে "উপযুক্ত সর্বজনীন Shorts ভিউ" এবং "উপযুক্ত সর্বজনীন ওয়াচ টাইম") হিসেবে উল্লেখ করা হবে।

আরও জানতে, আপনার YouTube কন্টেন্টের পারফর্ম্যান্স বুঝুন নিবন্ধটি দেখুন।

মেট্রিক স্ট্যাটাস Trigger এর জন্য ব্যবহার করা হয়েছে
ভিউ আপডেট করা হয়েছে ভিডিও প্রথম ফ্রেম থেকে চালানো হয় (এর মধ্যে অটোপ্লে, পয়েন্টার ধরে রাখা এবং চালানোর জন্য ক্লিক/ট্যাপ করা অন্তর্ভুক্ত)। সর্বজনীন ভিউয়ের সাধারণ সংখ্যা।
এনগেজড ভিউ অপরিবর্তিত রয়েছে প্রথম ফ্রেমের পরেও প্লেব্যাক চলতে থাকে অথবা ব্যবহারকারী চালানোর জন্য ক্লিক/ট্যাপ করেন। YouTube পার্টনার প্রোগ্রামের মাধ্যমে মনিটাইজেশন, বেশিরভাগ মূল অ্যানালিটিক্স (ক্লিক-থ্রু রেট, গড় ভিউয়ের সময়সীমা) এবং এনগেজমেন্ট সংক্রান্ত রিপোর্টিং।
থাম্বনেল ইম্প্রেশন পরিবর্তিত হয়নি ইন্টার‍্যাকশন বা অটোপ্লে ছাড়াই থাম্বনেল দেখানো হয়। ফিড-লেভেল এক্সপোজার ও প্যাকেজিং পরিমাপ করে।

API ডকুমেন্টেশন আপডেট: চ্যানেল এবং ভিডিও রেফারেন্স ডকুমেন্টেশনে viewCount ফিল্ডের বিবরণ আপডেট করা হয়েছে।

৬ আগস্ট, ২০২৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • activities.contentDetails-এর অধীনে contentDetails.like এবং contentDetails.favorite ফিল্ডের সব রেফারেন্স পাবলিক ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে কারণ API এইসব ফিল্ড ফিরিয়ে দেয় না।

৭ জুলাই, ২০২৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

API এখন videos রিসোর্সে brandPartner অংশটি সাপোর্ট করে। এই অংশে ক্রিয়েটরের শুরু করা ব্র্যান্ড পার্টনার অ্যাক্সেসের জন্য ভিডিওর সাথে লিঙ্ক করা ব্র্যান্ড পার্টনারের বিবরণ থাকে।

নিম্নলিখিত পদ্ধতিগুলি কল করার সময় brandPartner অংশটি নির্দিষ্ট করা যেতে পারে:

brandPartner অবজেক্টে নিম্নলিখিত ফিল্ডগুলি থাকে:

  • channelId: ব্র্যান্ড পার্টনারের এক্সটার্নাল চ্যানেল আইডি।
  • channelHandle: ব্র্যান্ড পার্টনারের চ্যানেল হ্যান্ডেল।
লিঙ্ক তৈরি করার সময় channelId অথবা channelHandle সেট করতে হবে, তবে উত্তরে শুধু channelId দেখানো হয়।

২৩ জুন, ২০২৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • liveChatMessages-এর অধীনে messageDeletedEvent এবং messageRetractedEvent রিসোর্স টাইপের (এবং তাদের সংশ্লিষ্ট messageDeletedDetails এবং messageRetractedDetails অবজেক্ট) সব রেফারেন্স সরিয়ে দেওয়া হয়েছে কারণ এইসব ইভেন্ট API-এর মাধ্যমে ফেরত দেওয়া হচ্ছে না।

৩ জুন, ২০২৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

API এখন একটি নতুন পদ্ধতি, videos.batchGetStats, সমর্থন করে, যা API অনুরোধ প্যারামিটারের সাথে মেলে এমন ভিডিও পরিসংখ্যানের একটি তালিকা পুনরুদ্ধার করে।

এই পদ্ধতিতে কল করলে, এর নিজস্ব গ্র্যানুলার কোটা বাকেটে ১ ইউনিট কোটা খরচ হয়। মেথডের ডিফল্ট কোটা হল প্রতিদিন ১০,০০০ ইউনিট।

১ জুন, ২০২৬

YouTube Data API, videos.insert ও search.list দিয়ে শুরু করে, পদ্ধতির ছোট ছোট সেট কভার করে এমন গ্র্যানুলার কোটা সিস্টেমে ট্রানজিট করছে।

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

videos.insert এবং search.list পদ্ধতিতে API কল করার জন্য তাদের নিজস্ব কোটা বাকেট থেকে চার্জ করা হবে। অন্যান্য সব পদ্ধতিতে API কল করার জন্য আগে থেকে থাকা কোটা বাকেট থেকে চার্জ করা হবে। ডেভেলপাররা Google Cloud Console-এ কোটার সীমা দেখতে পারেন এবং তারা কোটা এক্সটেনশন ফর্ম-এর মাধ্যমে অতিরিক্ত কোটার জন্য অনুরোধ করতে পারেন।

৪ ডিসেম্বর, ২০২৫

YouTube Data API ডকুমেন্টেশন এবং কোটা ক্যালকুলেটর আপডেট করা হয়েছে যাতে ভিডিও আপলোডের কোটা খরচে পরিবর্তন প্রতিফলিত হয়, যা প্রায় ১৬০০ ইউনিট থেকে প্রায় ১০০ ইউনিটে নেমে এসেছে।

১০ জুলাই, ২০২৫

২১ জুলাই, ২০২৫ থেকে, YouTube video.list পদ্ধতির mostPopular চার্ট থেকে পাওয়া কন্টেন্ট অ্যাডজাস্ট করবে। অতীতে, mostPopular চার্টে 'এখন ট্রেন্ডিং' তালিকায় ফিচার করা ভিডিও দেখানো হত। এখন, mostPopular চার্টে জনপ্রিয় মিউজিক, সিনেমা ও গেমিং চার্ট থেকে ভিডিও দেখানো হবে। এই API পরিবর্তন YouTube-এর জনপ্রিয় পৃষ্ঠা বন্ধ করে দেওয়ার সাথে সামঞ্জস্যপূর্ণ।

২৬ মার্চ, ২০২৫

৩১ মার্চ, ২০২৫ থেকে, YouTube-এ Shorts-এর ভিউ গণনার পদ্ধতি পরিবর্তন করা হবে। অতীতে, Shorts-এর ক্ষেত্রে, কোনও Short নির্দিষ্ট সংখ্যক সেকেন্ড ধরে চালানো হলে, একটি ভিউ গণনা করা হত। এখন, আপনার Short কতবার চালানো বা রিপ্লে করা হয়েছে তার উপর ভিত্তি করে ভিউ গণনা করা হবে, এক্ষেত্রে ন্যূনতম দেখার সময় আর জরুরি নয়। আরও জানুন

৩১ মার্চ ২০২৫ থেকে, Data API-এর নিম্নলিখিত ফিল্ডগুলি এই পরিবর্তন অনুসারে Shorts-এর ভিউ কাউন্ট দেখাবে:

  • channels.statistics.viewCount
  • videos.statistics.viewCount

৩০ অক্টোবর, ২০২৪

API এখন বাস্তবসম্মত পরিবর্তিত বা সিন্থেটিক (A/S) কন্টেন্ট সহ ভিডিও শনাক্ত করার ক্ষমতাকে সমর্থন করে। A/S কন্টেন্ট সম্পর্কিত YouTube নীতি সম্পর্কে আরও জানুন।

A/S কন্টেন্টের উদাহরণের মধ্যে এমন ভিডিও অন্তর্ভুক্ত যা:

  • কন্টেন্টে দেখানো হচ্ছে যে একজন প্রকৃত ব্যক্তি সত্যিই কিছু বলছেন বা করছেন, যা তিনি বাস্তবে আদৌ বলেননি বা করেননি
  • বাস্তবের কোনও ঘটনা বা জায়গার ফুটেজ পরিবর্তন করে দেখানো
  • বাস্তব ঘটনার মতো এমন কোনও দৃশ্য দেখানো হয়েছে যা বাস্তবে ঘটেনি

কোনও ভিডিওতে A/S কন্টেন্ট আছে কিনা তা উল্লেখ করতে, status.containsSyntheticMedia প্রপার্টি সেট করুন। videos.insert বা videos.update মেথড কল করার সময় এই প্রপার্টি সেট করা যেতে পারে। সেট করা থাকলে, video রিসোর্সে প্রপার্টি ফেরত দেওয়া হয়।

৩০ এপ্রিল, ২০২৪

মনে রাখবেন: এটি বন্ধ করা সংক্রান্ত ঘোষণা।

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

API আর চ্যানেল আলোচনা ইনসার্ট বা রিট্রিভ করার সুবিধা দেয় না। এই পরিবর্তন YouTube ওয়েবসাইটের সাথে সামঞ্জস্যপূর্ণ, যেখানে চ্যানেলে কমেন্ট পোস্ট করার সুবিধা নেই।

১৩ মার্চ, ২০২৪

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

captions.insert এবং captions.update পদ্ধতির জন্য sync প্যারামিটার বন্ধ করা হয়েছে। ১২ এপ্রিল, ২০২৪ থেকে YouTube-এ প্যারামিটার আর কাজ করবে না।

এই পরিবর্তনের ফলে, ক্যাপশন ট্র্যাক যোগ বা আপডেট করার সময় ডেভেলপারদের অবশ্যই টাইমিং সংক্রান্ত তথ্য যোগ করতে হবে, অন্যথায় আপলোড করা যাবে না।

১২ মার্চ, ২০২৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

captions রিসোর্সের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে snippet.name ফিল্ডের জন্য অনুমোদিত সর্বাধিক দৈর্ঘ্য হল ১৫০টি অক্ষর। ট্র্যাকের নাম এর থেকে বড় হলে API একটি nameTooLong সমস্যা দেখায়।

৭ মার্চ, ২০২৪

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

channel রিসোর্স প্রপার্টি brandingSettings.channel.moderateComments বন্ধ করা হয়েছে। ৭ মার্চ, ২০২৪ থেকে YouTube এই প্যারামিটার আর সাপোর্ট করবে না।

৩১ জানুয়ারি, ২০২৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

channels.list পদ্ধতির নতুন forHandle প্যারামিটার আপনাকে YouTube হ্যান্ডেল উল্লেখ করে কোনও চ্যানেল সম্পর্কে তথ্য পেতে সাহায্য করে।

৯ নভেম্বর, ২০২৩

Comments-এর অধীনে videoId রিসোর্সের সব রেফারেন্স সরিয়ে দেওয়া হয়েছে কারণ API কলের মাধ্যমে videoId রিসোর্স ফেরত দেওয়া হচ্ছে না।

১২ সেপ্টেম্বর, ২০২৩

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

comments.markAsSpam পদ্ধতি বহু বছর ধরে অবচিত করা হয়েছে। এই পদ্ধতিটি YouTube-এ আগে থেকেই কাজ করে না এবং API-এর মাধ্যমেও আর কাজ করে না।

comments.markAsSpam পদ্ধতি উল্লেখ করা সব ডকুমেন্টে একটি করে ডেপ্রিকেশন বিজ্ঞপ্তি যোগ করা হয়েছে।

২২ আগস্ট, ২০২৩

search.list পদ্ধতিতে এখন videoPaidProductPlacement প্যারামিটার কাজ করে। এই প্যারামিটার আপনাকে সার্চ ফলাফল ফিল্টার করে শুধু সেইসব ভিডিও অন্তর্ভুক্ত করতে দেয় যেগুলিতে ক্রিয়েটর পেড প্রচার আছে বলে উল্লেখ করেছেন।

১৮ আগস্ট, ২০২৩

video রিসোর্সের liveStreamingDetails.concurrentViewers সংজ্ঞা আপডেট করা হয়েছে যাতে এটি মনে রাখা যায় যে YouTube Data API-এর দেওয়া একই সাথে থাকা দর্শকের সংখ্যা YouTube Analytics-এর মাধ্যমে উপলভ্য প্রসেস করা, স্প্যাম সরানো একই সাথে থাকা দর্শকের সংখ্যা থেকে আলাদা হতে পারে। YouTube সহায়তা কেন্দ্র থেকে লাইভ স্ট্রিমিং মেট্রিক সম্পর্কে আরও তথ্য পাওয়া যাবে।

৭ আগস্ট, ২০২৩

১২ জুন, ২০২৩-এ ঘোষণা করা অনুযায়ী, search.list পদ্ধতির relatedToVideoId প্যারামিটার বন্ধ করে দেওয়া হয়েছে। এই প্যারামিটার আর কাজ করে না এবং API ডকুমেন্টেশন থেকে এই প্যারামিটারের রেফারেন্স সরিয়ে দেওয়া হয়েছে।

২৮ জুন, ২০২৩

thumbnails.set পদ্ধতিতে এখন uploadRateLimitExceeded সমস্যা কাজ করে, এটি থেকে বোঝা যায় যে চ্যানেলটি গত ২৪ ঘণ্টায় অনেক বেশি থাম্বনেল আপলোড করেছে এবং পরে আবার চেষ্টা করা উচিত।

১২ জুন, ২০২৩

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

search.list পদ্ধতির relatedToVideoId প্যারামিটার অবচিত করা হয়েছে। ৭ আগস্ট, ২০২৩ থেকে YouTube-এ প্যারামিটার আর কাজ করবে না।

এই সময়, search.list পদ্ধতির ডকুমেন্টেশনে একটি অবচিতি বিজ্ঞপ্তি যোগ করা হয়েছে। ৭ আগস্ট, ২০২৩ তারিখে বা তার পরে search.list ডকুমেন্টেশন থেকে এই প্যারামিটার সম্পূর্ণভাবে সরিয়ে দেওয়া হবে।

এছাড়াও, সম্পর্কিত ভিডিও কীভাবে ফিরিয়ে আনা যায় তা দেখানোর জন্য একটি উদাহরণ API প্রয়োগ করার নির্দেশিকা থেকে সরিয়ে দেওয়া হয়েছে।

২২ আগস্ট, ২০২২

video.statistics ফিল্ডের জন্য সংশোধিত টাইপ অ্যানোটেশন, আনসাইনড লং থেকে স্ট্রিং।

৫ আগস্ট, ২০২২

YouTube ক্যাপশন আইডি তৈরি করার পদ্ধতি পরিবর্তন করেছে এবং সেই পরিবর্তনের অংশ হিসেবে, সব ক্যাপশন ট্র্যাকে নতুন ক্যাপশন আইডি অ্যাসাইন করছে। এই পরিবর্তনটি এমন অ্যাপ্লিকেশনের জন্য ব্যাকওয়ার্ড-ইনকমপ্যাটিবল পরিবর্তন হতে পারে যা caption_id ভ্যালু স্টোর করে, যদিও এটি এমন অ্যাপ্লিকেশনকে প্রভাবিত করবে না যা caption_id ভ্যালু স্টোর করে না।

এখন থেকে ১ ডিসেম্বর, ২০২২ পর্যন্ত, captions.list, captions.update, captions.download, এবং captions.delete পদ্ধতি পুরনো ও নতুন ক্যাপশন ট্র্যাক আইডি, উভয়কেই সাপোর্ট করবে। তবে, ১ ডিসেম্বর, ২০২২ থেকে বা তার পরে, YouTube পুরনো ক্যাপশন ট্র্যাক আইডি আর সাপোর্ট করবে না। সেই সময়, পুরনো ক্যাপশন ট্র্যাক আইডি দিয়ে সেইসব API পদ্ধতির যেকোনও একটি কল করলে captionNotFound সমস্যা হবে।

এই পরিবর্তনের জন্য প্রস্তুত হতে, আপনাকে এখন থেকে ১ ডিসেম্বর, ২০২২-এর মধ্যে সমস্ত সেভ করা ক্যাপশন ট্র্যাক ডেটা সম্পূর্ণভাবে সরিয়ে দেওয়ার পরিকল্পনা করতে হবে। এর অর্থ হল, আপনি যে ভিডিওর জন্য ক্যাপশন ট্র্যাক ডেটা স্টোর করেন, আপনাকে বর্তমানে স্টোর করা ডেটা মুছে দিতে হবে, তারপর ভিডিওর জন্য ক্যাপশন ট্র্যাকের বর্তমান সেট ফিরিয়ে আনতে captions.list মেথড কল করতে হবে এবং আপনি সাধারণত যেভাবে করেন সেভাবে API রেসপন্সে ডেটা স্টোর করতে হবে।

১২ জুলাই, ২০২২

YouTube API পরিষেবার শর্তাবলী আপডেট করা হয়েছে। আরও তথ্যের জন্য YouTube API পরিষেবা সংক্রান্ত পরিষেবার শর্তাবলী - রিভিশন ইতিহাস দেখুন।

২৭ এপ্রিল, ২০২২

videos.insert পদ্ধতির বিবরণে আপডেট করে উল্লেখ করা হয়েছে যে আপলোড করা ভিডিওর সর্বাধিক ফাইল সাইজ ১২৮ জিবি থেকে বাড়িয়ে ২৫৬ জিবি করা হয়েছে।

৮ এপ্রিল, ২০২২

subscriptions.list পদ্ধতির myRecentSubscribers এবং mySubscribers প্যারামিটার সংজ্ঞা দুটিই আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে API দ্বারা ফেরত দেওয়া সাবস্ক্রাইবারের সর্বাধিক সংখ্যা সীমিত হতে পারে। এই পরিবর্তনটি ডকুমেন্টেশন সংশোধনকে উপস্থাপন করে এবং API আচরণে কোনও পরিবর্তন নয়।

১৫ ডিসেম্বর, ২০২১

১৮ নভেম্বর, ২০২১-এ ঘোষণা করা হয়েছে যে, ভিডিওতে ডিসলাইকের সংখ্যা পুরো YouTube প্ল্যাটফর্ম জুড়ে ব্যক্তিগত করার পরিবর্তন, video রিসোর্সের statistics.dislikeCount প্রপার্টি এখন ব্যক্তিগত।

আপনি YouTube-এর অফিসিয়াল ব্লগ থেকে এই পরিবর্তন সম্পর্কে আরও জানতে পারবেন।

১৮ নভেম্বর, ২০২১

পরিবর্তনের সাথে সাথে সম্পূর্ণ YouTube প্ল্যাটফর্ম জুড়ে ভিডিওতে ডিসলাইকের সংখ্যা ব্যক্তিগত করা হবে, video রিসোর্সের statistics.dislikeCount প্রপার্টি ১৩ ডিসেম্বর, ২০২১ থেকে ব্যক্তিগত করা হবে। এর অর্থ হল, ভিডিও মালিকের দ্বারা API অনুরোধ প্রমাণিত হলে, প্রপার্টিটি শুধুমাত্র videos.list এন্ডপয়েন্ট থেকে পাওয়া API রেসপন্সে অন্তর্ভুক্ত করা হবে।

এই পরিবর্তনের ফলে videos.rate এন্ডপয়েন্ট প্রভাবিত হবে না।

যেসব ডেভেলপার সর্বজনীনভাবে ডিসলাইক সংখ্যা দেখান না এবং এখনও তাদের API ক্লায়েন্টের জন্য ডিসলাইক সংখ্যা প্রয়োজন, তারা ছাড় পাওয়ার জন্য অনুমোদিত তালিকায় অন্তর্ভুক্ত হওয়ার আবেদন করতে পারেন। ছাড়ের জন্য আবেদন করতে, আপনাকে এই আবেদন ফর্ম পূরণ করতে হবে।

YouTube-এর অফিসিয়াল ব্লগ থেকে এই পরিবর্তন সম্পর্কে আরও জানতে পারবেন।

২ জুলাই, ২০২১

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

commentThreads.update এন্ডপয়েন্ট বন্ধ করা হয়েছে এবং এটি আর কাজ করে না। এই এন্ডপয়েন্টটি অন্যান্য API এন্ডপয়েন্টের মাধ্যমে উপলভ্য ডুপ্লিকেট ফাংশনালিটি। পরিবর্তে, আপনি comments.update-এ কল করতে পারেন

পদ্ধতি এবং আপনার কোডের commentThreads রিসোর্স প্রয়োজন হলে, commentThreads.list পদ্ধতিতে সেকেন্ডারি কল করুন।

১ জুলাই, ২০২১

YouTube-এর API পরিষেবা ব্যবহারকারী সব ডেভেলপারকে ডিফল্ট কোটা হিসেবে বরাদ্দ করা ১০,০০০ ইউনিটের বেশি ইউনিট পেতে API মেনে চলা সংক্রান্ত অডিট সম্পূর্ণ করতে হবে। আজ পর্যন্ত, ডেভেলপাররা YouTube API পরিষেবা - অডিট এবং কোটা এক্সটেনশন ফর্ম পূরণ করে জমা দেওয়ার মাধ্যমে সম্মতি অডিট প্রক্রিয়া এবং অতিরিক্ত কোটা ইউনিট বরাদ্দের অনুরোধ উভয়ই পরিচালনা করেছেন।

এইসব প্রসেস আরও স্পষ্ট করতে এবং আমাদের API পরিষেবা ব্যবহারকারী ডেভেলপারদের প্রয়োজনীয়তা আরও ভালোভাবে পূরণ করতে, আমরা তিনটি নতুন ফর্ম এবং সেগুলি পূরণ করার জন্য একটি নির্দেশিকা যোগ করছি:

  • অডিট ও কোটা এক্সটেনশন ফর্ম: যেসব ডেভেলপার আগে থেকেই API-এর সাথে মানানসই অডিট পাস করেছেন তারা এই ফর্মটি পূরণ করে জমা দিতে পারেন (প্রথম প্রশ্নে "বর্তমান কোটা বজায় রাখতে একটি সম্মতি অডিট সম্পূর্ণ করুন (পুনরায় অডিট সম্পূর্ণ করার জন্য অনুরোধ করা হয়েছে)" বেছে নিয়ে) যাতে বরাদ্দ করা কোটা এক্সটেনশনের জন্য অনুরোধ করা যায়।
  • আপিল ফর্ম: যেসব ডেভেলপারদের API প্রোজেক্ট কমপ্লায়েন্স অডিটে ব্যর্থ হয়েছে (বা কোটা ইউনিট বাড়ানোর অনুরোধ বাতিল করা হয়েছে) তারা এই ফর্ম পূরণ করে জমা দিতে পারবেন।
  • মালিকানা পরিবর্তন সংক্রান্ত ফর্ম: কোনও API প্রোজেক্টের সাথে যুক্ত কোনও ডেভেলপার বা তার হয়ে API ক্লায়েন্ট অপারেট করা কোনও পার্টি, মালিকানা পরিবর্তন (যেমন, স্টক কেনা বা বিক্রি করা, মার্জার অথবা অন্য ধরনের কর্পোরেট ট্রানজ্যাকশন) হলে, তাকে এই ফর্ম পূরণ করে জমা দিতে হবে। এটি YouTube-এর API টিমকে আমাদের রেকর্ড আপডেট করতে, নতুন API প্রোজেক্টের ব্যবহারের ক্ষেত্রে সম্মতি অডিট করতে এবং ডেভেলপারের বর্তমান কোটা বরাদ্দ যাচাই করতে সাহায্য করে।

প্রতিটি নতুন ফর্ম থেকে আমরা জানতে পারব যে আপনি YouTube-এর API কীভাবে ব্যবহার করতে চান এবং আপনাকে আরও ভালোভাবে সাহায্য করতে পারব।

আমাদের নতুন API কমপ্লায়েন্স অডিট গাইড থেকে আরও বিবরণ পাওয়া যাবে।

১২ মে, ২০২১

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

এই আপডেটে API-তে নিম্নলিখিত পরিবর্তন করা হয়েছে:

  • channel রিসোর্সের contentDetails.relatedPlaylists.favorites প্রপার্টি বন্ধ করা হয়েছে। ২৮ এপ্রিল, ২০১৬-এর, রিভিশন ইতিহাস এন্ট্রি থেকে জানা যায় যে, প্রিয় ভিডিও ফিচারটি বেশ কয়েক বছর আগেই বন্ধ করে দেওয়া হয়েছে।

    এই আপডেটের আগে, কোনও API ক্লায়েন্ট যদি বিদ্যমান নেই এমন পছন্দের প্লেলিস্টে ভিডিও যোগ করার চেষ্টা করত, তাহলে API এখনও একটি নতুন প্লেলিস্ট তৈরি করত। ভবিষ্যতে, এই ধরনের ক্ষেত্রে প্লেলিস্ট তৈরি করা হবে না এবং API একটি সমস্যা দেখাবে। এছাড়াও, আইটেম যোগ করা, পরিবর্তন করা বা মুছে ফেলার মাধ্যমে পছন্দের প্লেলিস্ট পরিবর্তন করার চেষ্টা করা আগেকার ঘোষণা অনুযায়ী বন্ধ করা হয়েছে এবং যেকোনও সময় এর ফলে সমস্যা হতে পারে।

  • নিম্নলিখিত channel রিসোর্স প্রপার্টি বন্ধ করা হয়েছে। এইসব প্রপার্টি আগে থেকেই YouTube Studio UI এবং YouTube-এ কাজ করে না। এর ফলে, API-এর মাধ্যমেও সেগুলি আর কাজ করবে না।

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    channel রিসোর্স রিপ্রেজেন্টেশন থেকে সব প্রপার্টি সরিয়ে দেওয়া হয়েছে এবং রিসোর্সের প্রপার্টি তালিকা থেকে সেগুলির সংজ্ঞা সরিয়ে দেওয়া হয়েছে। এছাড়াও, এই প্রপার্টিগুলির সাথে যুক্ত সমস্যাগুলি পদ্ধতি-নির্দিষ্ট ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে।

  • নিম্নলিখিত channelSection রিসোর্স প্রপার্টি বন্ধ করা হয়েছে। এইসব প্রপার্টি আগে থেকেই YouTube Studio UI এবং YouTube-এ কাজ করে না। এর ফলে, API-এর মাধ্যমেও সেগুলি আর কাজ করবে না।

    • snippet.style
    • snippet.defaultLanguage
    • snippet.localized.title
    • localizations
    • localizations.(key)
    • localizations.(key).title
    • targeting
    • targeting.languages[]
    • targeting.regions[]
    • targeting.countries[]

    এই পরিবর্তনের সাথে সাথে, channelSection.list পদ্ধতির hl প্যারামিটারও বন্ধ করে দেওয়া হয়েছে কারণ এটি যে ফিচারকে সাপোর্ট করে সেটি আর কাজ করে না।

    channelSection রিসোর্স রিপ্রেজেন্টেশন থেকে সব প্রপার্টি সরিয়ে দেওয়া হয়েছে এবং রিসোর্সের প্রপার্টি তালিকা থেকে সেগুলির সংজ্ঞা সরিয়ে দেওয়া হয়েছে। এছাড়াও, এইসব প্রপার্টির সাথে সম্পর্কিত সমস্যা পদ্ধতি-নির্দিষ্ট ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে।

  • channelSection রিসোর্সের snippet.type প্রপার্টির জন্য, নিম্নলিখিত ভ্যালু বন্ধ করা হয়েছে। এইসব ভ্যালু YouTube চ্যানেল পৃষ্ঠায় আগে থেকেই কাজ করে না এবং এর ফলে API-এর মাধ্যমেও আর কাজ করে না।

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts

  • playlist রিসোর্সের snippet.tags[] প্রপার্টি বন্ধ করা হয়েছে। এই প্রপার্টি আগে থেকেই YouTube-এ কাজ করে না এবং এর ফলে, API-এর মাধ্যমেও এটি আর কাজ করে না।

৯ ফেব্রুয়ারি, ২০২১

playlistItem রিসোর্সে দুটি নতুন প্রপার্টি কাজ করে:

  • snippet.videoOwnerChannelId প্রপার্টি, প্লেলিস্ট ভিডিও আপলোড করা চ্যানেলের আইডি শনাক্ত করে।
  • snippet.videoOwnerChannelTitle প্রপার্টি সেই চ্যানেলের নাম শনাক্ত করে যেটি প্লেলিস্ট ভিডিও আপলোড করেছে।

২৮ জানুয়ারি, ২০২১

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list এবং playlists.update পদ্ধতিগুলি একটি নতুন playlistOperationUnsupported সমস্যাকে সমর্থন করে। কোনও অনুরোধ যখন এমন অপারেশন পারফর্ম করার চেষ্টা করে যা নির্দিষ্ট প্লেলিস্টের জন্য অনুমোদিত নয়, তখন এই সমস্যাটি ঘটে। যেমন, কোনও ব্যবহারকারী তার আপলোড করা ভিডিওর প্লেলিস্ট থেকে কোনও ভিডিও মুছতে পারবেন না বা প্লেলিস্টটিই মুছতে পারবেন না।

    সব ক্ষেত্রেই, এই সমস্যার ফলে 400 HTTP রেসপন্স কোড (অনুরোধ ঠিক নয়) ফেরত আসে।

  • playlistItems.list পদ্ধতির watchHistoryNotAccessible এবং watchLaterNotAccessible সংক্রান্ত সমস্যা ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। ব্যবহারকারীর দেখার ইতিহাস এবং 'পরে দেখুন' তালিকা, API-এর মাধ্যমে অ্যাক্সেস করা যায় না, তবে এই নির্দিষ্ট সমস্যাগুলি API-এর মাধ্যমে ফেরত পাঠানো হয় না।

১৫ অক্টোবর, ২০২০

ডেভেলপার নীতিতে দুটি নতুন বিভাগ যোগ করা হয়েছে:

  • নতুন বিভাগ III.E.4.i YouTube এম্বেড করা প্লেয়ারের মাধ্যমে সংগ্রহ ও পাঠানো ডেটা সম্পর্কে অতিরিক্ত তথ্য প্রদান করে। ব্যবহারকারী প্লেব্যাক করার ইচ্ছা প্রকাশ করে প্লেয়ারের সাথে ইন্টার‍্যাক্ট করার আগে, কোনও YouTube এম্বেড করা প্লেয়ারের মাধ্যমে আমাদের পাঠানো ব্যবহারকারীর ডেটার জন্য আপনিই দায়ী থাকবেন। কোনও ব্যবহারকারী প্লেয়ারের সাথে ইন্টার‍্যাক্ট করার আগে, আপনি 'অটোপ্লে' বিকল্পটি false হিসেবে সেট করে YouTube-এর সাথে শেয়ার করা ডেটা সীমিত করতে পারবেন।
  • নতুন অনুচ্ছেদ III.E.4.j আপনার সাইট ও অ্যাপে কন্টেন্ট এম্বেড করার আগে সেটি 'বাচ্চাদের জন্য তৈরি' (MFK) কিনা তা চেক করার সাথে সম্পর্কিত। আপনার API ক্লায়েন্টে এম্বেড করা ভিডিও বাচ্চাদের জন্য তৈরি কিনা তা জানার দায়িত্ব আপনার এবং এম্বেড করা প্লেয়ার থেকে সংগ্রহ করা ডেটা সেই অনুযায়ী ব্যবহার করতে হবে। তাই, কোনও YouTube এম্বেড করা প্লেয়ারের মাধ্যমে আপনার API ক্লায়েন্টে কন্টেন্ট এম্বেড করার আগে, YouTube Data API পরিষেবা ব্যবহার করে আপনাকে অবশ্যই কন্টেন্টের স্ট্যাটাস চেক করতে হবে।

নতুন ভিডিওর MadeForKids স্ট্যাটাস খোঁজা গাইড থেকে জানা যায় যে কীভাবে YouTube Data API পরিষেবা ব্যবহার করে কোনও ভিডিওর MFK স্ট্যাটাস খুঁজতে হয়।

এইসব পরিবর্তনের সাথে সাথে, এম্বেড করা প্লেয়ার প্যারামিটার ডকুমেন্টেশনে একটি রিমাইন্ডার যোগ করা হয়েছে যাতে এটি ব্যাখ্যা করা যায় যে আপনি অটোমেটিক চালানোর সুবিধা চালু করলে, প্লেয়ারের সাথে কোনও ব্যবহারকারীর ইন্টার‍্যাকশন ছাড়াই প্লেব্যাক হবে; প্লেব্যাক ডেটা সংগ্রহ এবং শেয়ার করা তাই পৃষ্ঠা লোড করার পরে ঘটবে।

৮ অক্টোবর, ২০২০

এই আপডেটে channel রিসোর্স সম্পর্কিত তিনটি ছোট পরিবর্তন করা হয়েছে:

  • snippet.thumbnails অবজেক্ট, যা চ্যানেলের থাম্বনেল ছবি শনাক্ত করে, নতুন তৈরি করা চ্যানেলের জন্য খালি থাকতে পারে এবং এটি পূরণ হতে এক দিন পর্যন্ত সময় লাগতে পারে।
  • statistics.videoCount প্রপার্টিতে শুধুমাত্র চ্যানেলের সর্বজনীন ভিডিওর সংখ্যা দেখানো হয়, এমনকি মালিককেও। এই আচরণ YouTube ওয়েবসাইটে দেখানো সংখ্যার সাথে সামঞ্জস্যপূর্ণ।
  • চ্যানেল কীওয়ার্ড, যা brandingSettings.channel.keywords প্রপার্টিতে শনাক্ত করা হয়, সেগুলি ৫০০ অক্ষরের সর্বাধিক অনুমোদিত দৈর্ঘ্য অতিক্রম করলে বা সেগুলিতে এস্কেপ না করা কোটেশন চিহ্ন (") থাকলে, ট্রানকেট করা হতে পারে। মনে রাখবেন যে ৫০০ অক্ষরের সীমা প্রতি কীওয়ার্ডের সীমা নয়, বরং এটি হল সব কীওয়ার্ডের মোট দৈর্ঘ্যের সীমা। এই আচরণ YouTube ওয়েবসাইটে হওয়া আচরণের মতোই।

৯ সেপ্টেম্বর, ২০২০

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

এই আপডেটে নিম্নলিখিত API পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে। এই ঘোষণার তারিখ অর্থাৎ ৯ সেপ্টেম্বর ২০২০ বা তার পরে সব পরিবর্তন কার্যকর হবে। এটি মাথায় রেখে, ডেভেলপারদের আর নিচে তালিকাভুক্ত API ফিচারের উপর নির্ভর করা উচিত নয়।

  • নিম্নলিখিত API রিসোর্স, পদ্ধতি, প্যারামিটার এবং রিসোর্স প্রপার্টি অবিলম্বে বন্ধ করা হয়েছে এবং এই ঘোষণার তারিখ থেকে বা তার পরে কাজ করা বন্ধ করে দেবে:
    • নিম্নলিখিত channel রিসোর্স প্রপার্টি:
      • statistics.commentCount প্রপার্টি
      • brandingSettings.image অবজেক্ট ও এর সব চাইল্ড প্রপার্টি
      • brandingSettings.hintsতালিকা ও এর সব চাইল্ড প্রপার্টি
    • channels.list পদ্ধতির categoryId ফিল্টার প্যারামিটার
    • guideCategories রিসোর্স এবং guideCategories.list পদ্ধতি
  • API অনুরোধে managedByMe প্যারামিটার true হিসেবে সেট করা হলে, API উত্তর channels.list পদ্ধতিতে prevPageToken প্রপার্টি আর থাকে না। এই পরিবর্তন অন্যান্য channels.list অনুরোধের জন্য prevPageToken প্রপার্টিকে প্রভাবিত করে না এবং এটি কোনও অনুরোধের জন্য nextPageToken প্রপার্টিকে প্রভাবিত করে না।
  • channel রিসোর্সের contentDetails.relatedPlaylists.watchLater এবং contentDetails.relatedPlaylists.watchHistory প্রপার্টি দুটিই ১১ আগস্ট ২০১৬-এ বন্ধ করা হয়েছে বলে ঘোষণা করা হয়েছে। এইসব প্লেলিস্টের জন্য playlistItems.insert পদ্ধতি এবং playlistItems.delete পদ্ধতির সহায়তা এখন সম্পূর্ণভাবে বন্ধ করে দেওয়া হয়েছে এবং ডকুমেন্টেশন থেকে দুটি প্রপার্টি সরিয়ে দেওয়া হয়েছে।
  • channels.list পদ্ধতির mySubscribers প্যারামিটার, যা ৩০ জুলাই ২০১৩-এ বন্ধ করা হয়েছে বলে ঘোষণা করা হয়েছিল, সেটি ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। যাচাই করা ব্যবহারকারীর চ্যানেলের সাবস্ক্রাইবারদের তালিকা পেতে subscriptions.list পদ্ধতি এবং তার mySubscribers প্যারামিটার ব্যবহার করুন।
  • channel রিসোর্সের invideoPromotion অবজেক্ট এবং এর সব চাইল্ড প্রপার্টি, যেগুলি ২৭ নভেম্বর ২০১৭-এ বন্ধ হয়ে গেছে বলে ঘোষণা করা হয়েছিল, সেগুলি ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে।

২৯ জুলাই, ২০২০

part প্যারামিটারের সাথে যুক্ত অতিরিক্ত খরচ সরিয়ে দিয়ে আমরা API অনুরোধের জন্য কোটা চার্জ করার প্রসেসকে সহজ করেছি। অবিলম্বে কার্যকর হবে, আমরা শুধুমাত্র কল করা পদ্ধতির জন্য বেস খরচ চার্জ করব। আপনি এখানে কোটা সম্পর্কে আরও তথ্য পেতে পারেন।

এই পরিবর্তনের ফলে বেশিরভাগ API কলের কোটা খরচ সামান্য কম হবে, তবে কিছু API কলের খরচ একই থাকবে। এই পরিবর্তনের ফলে কোনও API কলের খরচ বৃদ্ধি পায় না। মোটকথা, এর ফলে আপনার বরাদ্দ কোটা, যা Google Cloud Console-এ দেখা যায়, তা আরও বেশি ব্যবহার করা যাবে।

আমরা সব ডেভেলপারকে তাদের প্রোজেক্টের জন্য কমপ্লায়েন্স অডিট সম্পূর্ণ করার জন্য বিশেষভাবে সাজেস্ট করি, যাতে YouTube API পরিষেবাতে অ্যাক্সেস বজায় থাকে।

এই রিভিশন ইতিহাসের এন্ট্রিটি মূলত ২০ জুলাই, ২০২০ তারিখে প্রকাশ করা হয়েছিল।

২৮ জুলাই, ২০২০

২৮ জুলাই, ২০২০-এর পরে তৈরি করা যাচাই না করা API প্রজেক্ট থেকে videos.insert এন্ডপয়েন্টের মাধ্যমে আপলোড করা সব ভিডিও ব্যক্তিগত দেখার মোডে সীমাবদ্ধ থাকবে। এই বিধিনিষেধ তুলে নিতে, প্রতিটি প্রোজেক্টকে অডিট করতে হবে যাতে পরিষেবার শর্তাবলী মেনে চলা হচ্ছে কিনা তা যাচাই করা যায়।

ভিডিও আপলোড করার জন্য যাচাই না করা API ক্লায়েন্ট ব্যবহারকারী ক্রিয়েটররা একটি ইমেল পাবেন, যেখানে বলা থাকবে যে তাদের ভিডিও ব্যক্তিগত হিসেবে লক করা হয়েছে এবং তারা অফিসিয়াল বা অডিট করা ক্লায়েন্ট ব্যবহার করে এই বিধিনিষেধ এড়াতে পারবেন।

২৮ জুলাই, ২০২০-এর আগে তৈরি করা API প্রোজেক্টগুলি বর্তমানে এই পরিবর্তনের দ্বারা প্রভাবিত হয় না। তবে, আমরা সব ডেভেলপারকে সাজেস্ট করি যে তারা যেন কমপ্লায়েন্স অডিট সম্পূর্ণ করেন যাতে তাদের প্রোজেক্ট YouTube API পরিষেবাতে অ্যাক্সেস চালিয়ে যেতে পারে।

২১ জুলাই, ২০২০

[২৮ জুলাই, ২০২০-তে আপডেট করা হয়েছে।] এই রিভিশন ইতিহাস এন্ট্রিতে উল্লেখ করা ডকুমেন্টেশন আপডেট ২৮ জুলাই, ২০২০ তারিখে আবার প্রকাশ করা হয়েছে।

কোটা চার্জ করার প্রসেস সম্পর্কিত ডকুমেন্টেশন আপডেট আমরা গতকাল প্রকাশ করেছি। তবে, অপ্রত্যাশিত পরিস্থিতির কারণে, কোটা পরিবর্তন এখনও কার্যকর হয়নি। এর ফলে, নির্ভুলতার স্বার্থে ডকুমেন্টেশন আগের অবস্থায় ফিরিয়ে আনা হয়েছে। বিভ্রান্তি এড়াতে, পরিবর্তনের ব্যাখ্যা সহ রিভিশন ইতিহাসের এন্ট্রি সরিয়ে দেওয়া হয়েছে এবং অদূর ভবিষ্যতে আবার প্রকাশ করা হবে।

৭ জুলাই, ২০২০

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

videos.insert পদ্ধতির autoLevels এবং stabilize প্যারামিটার এখন অবচিত করা হয়েছে এবং দুটি প্যারামিটারই ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। সেগুলির ভ্যালু উপেক্ষা করা হয় এবং নতুন আপলোড করা ভিডিও যেভাবে প্রসেস করা হয় তার উপর কোনও প্রভাব ফেলে না।

১৫ জুন, ২০২০

নতুন YouTube ডেভেলপার নীতি মেনে চলা গাইড আপনাকে নিশ্চিত করতে সাহায্য করার জন্য নির্দেশিকা ও উদাহরণ প্রদান করে যে আপনার API ক্লায়েন্ট YouTube API পরিষেবার নির্দিষ্ট অংশ শর্তাবলী ও নীতি (API TOS) মেনে চলে।

এই নির্দেশিকা থেকে বোঝা যায় যে YouTube কীভাবে API পরিষেবার শর্তাবলীর নির্দিষ্ট কিছু দিক এনফোর্স করে, তবে এটি আগে থেকে থাকা কোনও ডকুমেন্টকে প্রতিস্থাপন করে না। API মেনে চলা সংক্রান্ত অডিট চলাকালীন ডেভেলপাররা যেসব সাধারণ প্রশ্ন করেন, এই নির্দেশিকায় সেগুলির উত্তর দেওয়া হয়েছে। আমরা আশা করি যে এটি আপনার ফিচার ডেভেলপমেন্ট প্রসেসকে সহজ করে তুলবে কারণ আপনি বুঝতে পারবেন যে আমরা কীভাবে আমাদের নীতিগুলি ব্যাখ্যা করি এবং প্রয়োগ করি।

৪ জুন, ২০২০

মনে রাখবেন: এটি আগে বন্ধ করে দেওয়া সংক্রান্ত ঘোষণার আপডেট।

চ্যানেল বুলেটিন ফিচার এখন সম্পূর্ণভাবে বন্ধ করে দেওয়া হয়েছে। এই পরিবর্তনটি প্রাথমিকভাবে ১৭ এপ্রিল ২০২০-তে ঘোষণা করা হয়েছিল এবং এখন তা কার্যকর করা হয়েছে। এর ফলে, activities.insert পদ্ধতি আর কাজ করে না এবং activities.list পদ্ধতি আর চ্যানেল বুলেটিন ফিরিয়ে আনে না। আরও তথ্যের জন্য, YouTube সহায়তা কেন্দ্র দেখুন।

১৭ এপ্রিল, ২০২০

মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

YouTube চ্যানেল বুলেটিন ফিচার বন্ধ করে দিচ্ছে। এর ফলে, activities.insert পদ্ধতি বন্ধ করা হবে এবং activities.list পদ্ধতি চ্যানেল বুলেটিন ফিরিয়ে আনা বন্ধ করবে। এইসব পরিবর্তন ১৮ মে, ২০২০ তারিখে বা তার পরে API-তে প্রযোজ্য হবে। আরও বিবরণের জন্য, YouTube সহায়তা কেন্দ্র দেখুন।

৩১ মার্চ, ২০২০

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • নতুন রিসোর্স ও পদ্ধতি

    • নতুন member রিসোর্স YouTube চ্যানেলের চ্যানেল মেম্বারকে উপস্থাপন করে। একজন মেম্বার কোনও ক্রিয়েটরকে নিয়মিত আর্থিক সহায়তা প্রদান করেন এবং বিশেষ সুবিধা পান। যেমন, ক্রিয়েটর কোনও চ্যাটের জন্য শুধুমাত্র মেম্বারদের জন্য মোড চালু করলে, মেম্বাররা চ্যাট করতে পারবেন।

      এই রিসোর্সটি sponsor রিসোর্সকে প্রতিস্থাপন করে, যা YouTube লাইভ স্ট্রিমিং API-এর অংশ হিসেবে ডকুমেন্ট করা হয়েছে। sponsor রিসোর্স এখন বন্ধ করা হয়েছে এবং API ক্লায়েন্টদের sponsors.list পদ্ধতির পরিবর্তে members.list পদ্ধতি ব্যবহার করার জন্য কল আপডেট করতে হবে।

    • নতুন membershipsLevel রিসোর্স, API অনুরোধ অনুমোদন করা ক্রিয়েটরের ম্যানেজ করা মূল্যের লেভেল শনাক্ত করে। membershipsLevels.list পদ্ধতি ক্রিয়েটরের সব মেম্বারশিপ লেভেলের তালিকা ফিরিয়ে আনে।

১০ জানুয়ারি, ২০২০

API এখন বাচ্চাদের জন্য তৈরি কন্টেন্ট শনাক্ত করতে পারে, যেটিকে YouTube "বাচ্চাদের জন্য তৈরি" বলে। YouTube সহায়তা কেন্দ্র থেকে "বাচ্চাদের জন্য তৈরি করা" কন্টেন্ট সম্পর্কে আরও জানুন।

channel এবং video রিসোর্স দুটি নতুন প্রপার্টিকে সাপোর্ট করে যাতে কন্টেন্ট ক্রিয়েটর এবং দর্শকরা বাচ্চাদের জন্য তৈরি কন্টেন্ট শনাক্ত করতে পারেন:

  • selfDeclaredMadeForKids প্রপার্টি কন্টেন্ট ক্রিয়েটরদের এটি নির্দিষ্ট করতে সাহায্য করে যে কোনও চ্যানেল বা ভিডিও বাচ্চাদের জন্য তৈরি করা হয়েছে কিনা।

    চ্যানেলের জন্য, এই প্রপার্টি channels.update মেথড কল করার সময় সেট করা যেতে পারে। ভিডিওর জন্য, videos.insert অথবা videos.update মেথড কল করার সময় এই প্রপার্টি সেট করা যেতে পারে।

    মনে রাখবেন, চ্যানেল মালিক API অনুরোধ অনুমোদন করলে, এই প্রপার্টি শুধুমাত্র সেইসব API উত্তরে অন্তর্ভুক্ত করা হয় যেগুলিতে channel বা video রিসোর্স থাকে।
  • madeForKids প্রপার্টি যেকোনও ব্যবহারকারীকে কোনও চ্যানেল বা ভিডিওর "বাচ্চাদের জন্য তৈরি" স্ট্যাটাস পুনরুদ্ধার করতে দেয়। যেমন, selfDeclaredMadeForKids প্রপার্টির ভ্যালুর উপর ভিত্তি করে স্ট্যাটাস নির্ধারণ করা হতে পারে। আপনার চ্যানেল, ভিডিও বা ব্রডকাস্টের জন্য দর্শক সেট করার ব্যাপারে আরও তথ্য পেতে YouTube সহায়তা কেন্দ্র দেখুন।

এছাড়াও, আমরা YouTube API পরিষেবার শর্তাবলী এবং ডেভেলপার নীতি আপডেট করেছি। আরও তথ্যের জন্য YouTube API পরিষেবার শর্তাবলী - রিভিশন ইতিহাস দেখুন। YouTube API পরিষেবার শর্তাবলী এবং ডেভেলপার নীতিতে করা পরিবর্তন ১০ জানুয়ারি, ২০২০ প্যাসিফিক সময় থেকে কার্যকর হবে।

১০ সেপ্টেম্বর, ২০১৯

YouTube-এ সাবস্ক্রাইবার সংখ্যা এবং এর ফলে API রেসপন্সে যে পরিবর্তন হয়েছে তা দেখানোর জন্য API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে। এই পরিবর্তনের ফলে, YouTube Data API পরিষেবার মাধ্যমে প্রাপ্ত সাবস্ক্রাইবারের সংখ্যাকে তিনটে গুরুত্বপূর্ণ সংখ্যায় রাউন্ড ডাউন করা হয়, যদি সাবস্ক্রাইবারের সংখ্যা ১০০০-এর বেশি হয়। এই পরিবর্তন channel রিসোর্সের statistics.subscriberCount প্রপার্টিকে প্রভাবিত করে।

মনে রাখবেন: এই পরিবর্তনটি এই প্রপার্টির ভ্যালুকে প্রভাবিত করে, এমনকি এমন ক্ষেত্রেও যেখানে কোনও ব্যবহারকারী তার নিজের চ্যানেল সম্পর্কে ডেটার জন্য একটি অনুমোদিত অনুরোধ পাঠান। চ্যানেলের মালিকরা এখনও YouTube Studio-তে সাবস্ক্রাইবারের সঠিক সংখ্যা দেখতে পাবেন।

যেমন, কোনও চ্যানেলের ১২৩,৪৫৬ জন সাবস্ক্রাইবার থাকলে, statistics.subscriberCount প্রপার্টিতে 123000 ভ্যালু থাকবে। API রেসপন্সে সাবস্ক্রাইবার সংখ্যা কীভাবে রাউন্ড অফ করা হয় এবং অন্যান্য সর্বজনীনভাবে দৃশ্যমান YouTube ইউজার ইন্টারফেসে সংক্ষিপ্ত করা হয় তার উদাহরণ নিচের সারণীতে দেখানো হয়েছে:

সাবস্ক্রাইবার সংখ্যার উদাহরণ YouTube Data API সর্বজনীনভাবে দৃশ্যমান YouTube UI
১,২৩৪ 1230 ১.২৩ হাজার
১২,৩৪৫ 12300 ১২.৩ হাজার
১২৩,৪৫৬ 123000 ১২৩ হাজার
1,234,567 1230000 ১.২৩ মিলিয়ন
১২,৩৪৫,৬৭৮ 12300000 ১২.৩ মিলিয়ন
১২৩,৪৫৬,৭৮৯ 123000000 ১২৩ মিলিয়ন

৪ এপ্রিল, ২০১৯

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে যাতে প্রতিটি পদ্ধতির সাধারণ ব্যবহারিক প্রয়োগ আরও ভালোভাবে ব্যাখ্যা করা যায় এবং APIs Explorer উইজেটের মাধ্যমে ডায়নামিক, খুব ভাল কোয়ালিটির কোড স্যাম্পেল প্রদান করা যায়। উদাহরণ দেখতে channels.list পদ্ধতির ডকুমেন্টেশন দেখুন। API পদ্ধতি বর্ণনা করে এমন পৃষ্ঠায় এখন দুটি নতুন এলিমেন্ট আছে:

    • API এক্সপ্লোরার উইজেট আপনাকে অনুমোদন স্কোপ বেছে নিতে, স্যাম্পেল প্যারামিটার ও প্রপার্টির ভ্যালু লিখতে এবং তারপরে আসল API অনুরোধ পাঠাতে ও আসল API উত্তর দেখতে দেয়। এছাড়াও, উইজেটটি ফুল-স্ক্রিন ভিউ অফার করে যা সম্পূর্ণ কোড স্যাম্পেল দেখায়, যা আপনার লেখা স্কোপ এবং ভ্যালু ব্যবহার করার জন্য ডাইনামিকভাবে আপডেট হয়।

    • সাধারণ ব্যবহারের উদাহরণ বিভাগে পৃষ্ঠায় ব্যাখ্যা করা পদ্ধতির এক বা একাধিক সাধারণ ব্যবহারের উদাহরণ বর্ণনা করা হয়েছে। যেমন, আপনি কোনও নির্দিষ্ট চ্যানেল বা বর্তমান ব্যবহারকারীর চ্যানেল সম্পর্কে ডেটা পেতে channels.list মেথড কল করতে পারেন।

      আপনার ব্যবহারের ক্ষেত্রে স্যাম্পেল ভ্যালু সহ APIs Explorer পপুলেট করতে বা আগে থেকে পপুলেট করা সেইসব ভ্যালু সহ ফুলস্ক্রিন APIs Explorer খুলতে আপনি সেই বিভাগের লিঙ্ক ব্যবহার করতে পারবেন। এইসব পরিবর্তনের উদ্দেশ্য হল, আপনার নিজের অ্যাপ্লিকেশনে যে ব্যবহারিক কেস প্রয়োগ করার চেষ্টা করছেন, তার সাথে সরাসরি প্রযোজ্য কোড স্যাম্পেলগুলি যাতে আপনি আরও সহজে দেখতে পান তা নিশ্চিত করা।

    বর্তমানে Java, JavaScript, PHP, Python ও curl-এর জন্য কোডের নমুনা উপলভ্য।

  • কোডের নমুনা টুলও নতুন UI-এর সাথে আপডেট করা হয়েছে যা উপরে বর্ণিত সব ফিচার অফার করে। এই টুল ব্যবহার করে, আপনি বিভিন্ন পদ্ধতির জন্য ব্যবহারের কেস এক্সপ্লোর করতে, APIs Explorer-এ ভ্যালু লোড করতে এবং Java, JavaScript, PHP ও Python-এ কোডের স্যাম্পেল পেতে ফুলস্ক্রিন APIs Explorer খুলতে পারবেন।

    এই পরিবর্তনের সাথে সাথে, যেসব পৃষ্ঠায় আগে Java, JavaScript, PHP ও Python-এর জন্য উপলভ্য কোড স্যাম্পেলের তালিকা দেওয়া ছিল, সেগুলি সরিয়ে দেওয়া হয়েছে।

  • Java, JavaScript, PHP ও Python-এর জন্য কুইকস্টার্ট গাইড আপডেট করা হয়েছে। API কী ব্যবহার করে একটি স্যাম্পেল এবং OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করে আরেকটি স্যাম্পেল কীভাবে রান করাতে হয় তা সংশোধিত নির্দেশিকায় ব্যাখ্যা করা হয়েছে। এর জন্য API এক্সপ্লোরার থেকে কোড স্যাম্পেল ব্যবহার করা হয়।

মনে রাখবেন, উপরে বর্ণিত পরিবর্তনগুলি ২০১৭ সালে API ডকুমেন্টেশনে যোগ করা একটি ইন্টার‍্যাক্টিভ টুলকে প্রতিস্থাপন করে।

৯ জুলাই, ২০১৮

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সের snippet.thumbnails প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে আপনার অ্যাপ্লিকেশনে থাম্বনেল দেখানোর সময়, আপনার কোডকে API রেসপন্সে যেভাবে ইমেজ URL দেখানো হয়েছে ঠিক সেইভাবেই ব্যবহার করতে হবে। যেমন, API রেসপন্সে ফেরত আসা URL-এ আপনার অ্যাপ্লিকেশনকে https ডোমেনের পরিবর্তে http ডোমেন ব্যবহার করা উচিত নয়।

    জুলাই ২০১৮ থেকে, চ্যানেলের থাম্বনেল URL শুধুমাত্র https ডোমেনে উপলভ্য হবে, যা API রেসপন্সে URL যেভাবে দেখানো হয় তার অনুরূপ। তার পরে, আপনার অ্যাপ্লিকেশন যদি http ডোমেন থেকে YouTube ছবি লোড করার চেষ্টা করে, তাহলে আপনি ভাঙা ছবি দেখতে পেতে পারেন।

  • মনে রাখবেন: এটি বন্ধ করা সংক্রান্ত ঘোষণা।

    video রিসোর্সের recordingDetails.location.altitude প্রপার্টি বন্ধ করা হয়েছে। ভিডিও এই প্রপার্টির জন্য ভ্যালু রিটার্ন করবে এমন কোনও গ্যারান্টি নেই। একইভাবে, API অনুরোধ সেই প্রপার্টির জন্য কোনও ভ্যালু সেট করার চেষ্টা করলেও, ইনকামিং ডেটা স্টোর নাও হতে পারে।

২২ জুন, ২০১৮

প্রয়োগ করার নির্দেশিকা, যা আগে প্রয়োগ ও মাইগ্রেশন নির্দেশিকা নামে পরিচিত ছিল, v2 API থেকে v3 API-তে মাইগ্রেট করার নির্দেশাবলী সরানোর জন্য আপডেট করা হয়েছে। এছাড়াও, v3 API-তে যেসব ফিচার আর ব্যবহার করা হয় না, যেমন, প্রিয় ভিডিও, সেগুলির নির্দেশাবলীও সরিয়ে দেওয়া হয়েছে।

২৭ নভেম্বর, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    YouTube ফিচার করা ভিডিও এবং ফিচার করা ওয়েবসাইট ফিচারগুলির জন্য সহায়তা সরিয়ে দিচ্ছে, যা API-তে channel রিসোর্সের invideoPromotion অবজেক্টের মাধ্যমে সমর্থিত। এর ফলে, সেই অবজেক্ট ও তার সব চাইল্ড প্রপার্টি বন্ধ করা হচ্ছে।

    আপনি এখনও ১৪ ডিসেম্বর, ২০১৭ পর্যন্ত invideoPromotion ডেটা পুনরুদ্ধার এবং সেট করতে পারবেন। ওই তারিখের পরে:

    • channels.list কল করার সময় invideoPromotion অংশটি ফিরিয়ে আনার চেষ্টা করলে, খালি invideoPromotion ফিরিয়ে আনা হবে অথবা কোনও invideoPromotion ডেটা ফিরিয়ে আনা হবে না।
    • channels.update কল করার সময় invideoPromotion ডেটা আপডেট করার চেষ্টা করলে, অন্তত ২৭ মে, ২০১৮ পর্যন্ত সফল উত্তর পাওয়া যাবে, তবে সেগুলি নো-অপস হিসেবে বিবেচিত হবে, অর্থাৎ সেগুলি আসলে কোনও আপডেট করবে না।

    ২৭ মে, ২০১৮-এর পরে, এইসব অনুরোধের ক্ষেত্রে সমস্যার মেসেজ দেখানো হতে পারে, যেমন, invalidPromotion একটি ভুল অংশ।

১৬ নভেম্বর, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • ইন্টার‍্যাক্টিভ কোড স্নিপেট টুল এখন Node.js কোড স্যাম্পেল সাপোর্ট করে। এছাড়াও, channels.list পদ্ধতির মতো প্রায় সব API পদ্ধতির জন্য ডকুমেন্টেশনে নমুনা দেখা যায়।

    কাস্টমাইজ করা যায় এমন স্যাম্পেলগুলি আপনাকে Node.js অ্যাপ্লিকেশনের জন্য একটি ব্যবহার-কেস-নির্দিষ্ট শুরুর পয়েন্ট দেওয়ার জন্য ডিজাইন করা হয়েছে। এই কার্যকারিতা Node.js কুইকস্টার্ট গাইডের কোডের মতোই। তবে, স্যাম্পেলে কিছু ইউটিলিটি ফাংশন থাকে যা কুইকস্টার্টে দেখা যায় না:

    • removeEmptyParameters ফাংশন API অনুরোধ প্যারামিটারের সাথে সম্পর্কিত কী-ভ্যালু পেয়ারের একটি তালিকা নেয় এবং ভ্যালু নেই এমন প্যারামিটার সরিয়ে দেয়।
    • createResource ফাংশন API রিসোর্সের প্রপার্টি অনুযায়ী কী-ভ্যালু পেয়ারের তালিকা নেয়। তারপরে এটি প্রপার্টিগুলিকে JSON অবজেক্টে কনভার্ট করে যা insert ও update অপারেশনে ব্যবহার করা যেতে পারে। নিচের উদাহরণে প্রপার্টির নাম ও ভ্যালুর সেট এবং JSON অবজেক্ট দেখানো হয়েছে যা কোড তাদের জন্য তৈরি করবে: 
      # Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

    এইসব স্যাম্পেল ডাউনলোড করে স্থানীয়ভাবে চালানোর জন্য ডিজাইন করা হয়েছে। আরও তথ্যের জন্য, কোড স্নিপেট টুলের নির্দেশাবলীতে স্থানীয়ভাবে সম্পূর্ণ কোড স্যাম্পেল রান করানোর পূর্বশর্ত দেখুন।

২৫ অক্টোবর, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • ইন্টার‍্যাক্টিভ কোড স্নিপেট টুলে Python কোড স্যাম্পেল আপডেট করা হয়েছে যাতে oauth2client লাইব্রেরির পরিবর্তে google-auth ও google-auth-oauthlib লাইব্রেরি ব্যবহার করা যায়, যা এখন বন্ধ করে দেওয়া হয়েছে।

    এই পরিবর্তনের পাশাপাশি, টুলটি এখন ইনস্টল করা Python অ্যাপ্লিকেশন এবং Python ওয়েব সার্ভার অ্যাপ্লিকেশনের জন্য সম্পূর্ণ কোড স্যাম্পেল প্রদান করে, যা কিছুটা ভিন্ন অথরাইজেশন ফ্লো ব্যবহার করে। সম্পূর্ণ নমুনা (এবং এই পরিবর্তন) দেখতে:

    1. ইন্টার‍্যাক্টিভ কোড স্নিপেট টুল অথবা channels.list পদ্ধতির মতো যেকোনও API পদ্ধতির ডকুমেন্টেশনে যান।
    2. কোড স্যাম্পেলের উপরে Python ট্যাবে ক্লিক করুন।
    3. স্নিপেট থেকে সম্পূর্ণ স্যাম্পেল দেখার জন্য ট্যাবের উপরে টগল বোতামে ক্লিক করুন।
    4. ট্যাবে এখন একটি সম্পূর্ণ কোড স্যাম্পেল দেখানো উচিত যা InstalledAppFlow অথরাইজেশন ফ্লো ব্যবহার করে। স্যাম্পেলের উপরে দেওয়া বিবরণ এটি ব্যাখ্যা করে এবং ওয়েব সার্ভার অ্যাপ্লিকেশনের জন্য স্যাম্পেলের লিঙ্কও দেয়।
    5. ওয়েব সার্ভারের উদাহরণে পরিবর্তন করতে লিঙ্কে ক্লিক করুন। ওই স্যাম্পেলটি Flask ওয়েব অ্যাপ্লিকেশন ফ্রেমওয়ার্ক এবং আলাদা অনুমোদনের ফ্লো ব্যবহার করে।

    এইসব স্যাম্পেল ডাউনলোড করে স্থানীয়ভাবে চালানোর জন্য ডিজাইন করা হয়েছে। আপনি স্যাম্পেল রান করাতে চাইলে, কোড স্নিপেট টুলের নির্দেশাবলীতে সম্পূর্ণ কোড স্যাম্পেল লোকালি রান করানোর নির্দেশাবলী দেখুন।

২৯ আগস্ট, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • search.list মেথডের forContentOwner প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে, প্যারামিটারটি true-এ সেট করা হলে, type প্যারামিটারটি অবশ্যই video-এ সেট করতে হবে।
  • search.list পদ্ধতির regionCode প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে যাতে এটি স্পষ্ট করা যায় যে প্যারামিটারটি সার্চ ফলাফলকে সেইসব ভিডিওর মধ্যে সীমাবদ্ধ করে যেগুলি নির্দিষ্ট অঞ্চলে দেখা যায়।
  • YouTube তার ব্র্যান্ডিং লোগো এবং আইকন আপডেট করেছে। "YouTube-এর সাথে ডেভেলপ করা হয়েছে" লেখা নতুন লোগো ব্র্যান্ডিং নির্দেশিকা পৃষ্ঠা থেকে ডাউনলোড করা যাবে। এছাড়াও, সেই পৃষ্ঠায় অন্যান্য নতুন YouTube লোগো ও আইকন দেখানো হয় এবং YouTube ব্র্যান্ড সাইট থেকে ডাউনলোড করা যায়।

২৪ জুলাই, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • iOS-এর জন্য নতুন YouTube Data API ক্যুইকস্টার্ট গাইড উপলভ্য। Objective-C বা Swift-এ লেখা সহজ iOS অ্যাপ্লিকেশনে কীভাবে YouTube Data API ব্যবহার করতে হয় তা এই নির্দেশিকায় ব্যাখ্যা করা হয়েছে।
  • YouTube Data API-এর জন্য ইন্টার‍্যাক্টিভ কোড স্নিপেট টুল-এ এখন ডকুমেন্টেশন অন্তর্ভুক্ত করা হয়েছে যা টুলের কিছু ফিচার ব্যাখ্যা করে:
    • API অনুরোধ কার্যকর করা হচ্ছে
    • কোড স্নিপেট ও সম্পূর্ণ কোড স্যাম্পেলের মধ্যে টগল করা
    • বয়লারপ্লেট ফাংশন ব্যবহার করা হচ্ছে
    • আগে থেকে থাকা রিসোর্স লোড করা হচ্ছে (আপডেট পদ্ধতির জন্য)

    মনে রাখবেন: API পদ্ধতির (উদাহরণ) জন্য API রেফারেন্স ডকুমেন্টেশনেও টুলটি এম্বেড করা আছে।

১ জুন, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • মনে রাখবেন: এটি বন্ধ করা সংক্রান্ত ঘোষণা।

    নিম্নলিখিত video রিসোর্স প্রপার্টি বন্ধ করা হচ্ছে। ১ ডিসেম্বর, ২০১৭ পর্যন্ত প্রপার্টি কাজ করলেও, সেই সময় পর্যন্ত ভিডিওগুলি সেইসব প্রপার্টির জন্য ভ্যালু প্রদান করা চালিয়ে যাবে কিনা তার কোনও গ্যারান্টি নেই। একইভাবে, videos.insert এবং videos.update অনুরোধ যা সেই প্রপার্টির ভ্যালু সেট করে, তা সেই তারিখের আগে কোনও সমস্যা তৈরি করবে না, তবে এটি সম্ভব যে ইনকামিং ডেটা স্টোর করা হবে না।

১৭ মে, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • কোড স্নিপেট আরও সর্বব্যাপী এবং ইন্টার‍্যাক্টিভ করে তুলতে API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে। যেসব পৃষ্ঠা API পদ্ধতি ব্যাখ্যা করে, যেমন channels.list বা videos.rate, সেগুলিতে এখন একটি ইন্টার‍্যাক্টিভ টুল রয়েছে যা আপনাকে Java, JavaScript, PHP, Python, Ruby, Apps Script এবং Go-তে কোড স্নিপেট দেখতে এবং কাস্টমাইজ করতে দেয়।

    প্রদত্ত যেকোনও পদ্ধতির জন্য, টুলটি এক বা একাধিক ব্যবহারের উদাহরণের জন্য কোড স্নিপেট দেখায় এবং প্রতিটি ব্যবহারের উদাহরণ সেই পদ্ধতিকে কল করার একটি সাধারণ উপায় বর্ণনা করে। যেমন, কোনও নির্দিষ্ট চ্যানেল বা বর্তমান ব্যবহারকারীর চ্যানেল সম্পর্কে ডেটা পেতে আপনি channels.list মেথড কল করতে পারেন।

    এছাড়াও, আপনি কোড স্যাম্পেলের সাথে ইন্টার‍্যাক্ট করতে পারবেন:

    • প্যারামিটার ও প্রপার্টির ভ্যালু পরিবর্তন করুন এবং আপনার দেওয়া ভ্যালু অনুযায়ী কোড স্নিপেট ডায়নামিক আপডেট হয়ে যাবে।

    • কোড স্নিপেট ও সম্পূর্ণ স্যাম্পেলের মধ্যে টগল করুন। কোড স্নিপেট, কোডের সেই অংশ দেখায় যা API পদ্ধতিকে কল করে। সম্পূর্ণ স্যাম্পেলে সেই স্নিপেট এবং অনুমোদন ও অনুরোধ পাঠানোর জন্য বয়লারপ্লেট কোড থাকে। সম্পূর্ণ স্যাম্পেল কপি করা এবং কমান্ড লাইন বা লোকাল ওয়েব সার্ভার থেকে রান করা যেতে পারে।

    • একটি বোতামে ক্লিক করে অনুরোধ কার্যকর করুন। (অনুরোধ কার্যকর করতে, আপনার হয়ে API কল করার জন্য আপনাকে টুলকে অনুমোদন দিতে হবে।)

    মনে রাখবেন, যেসব পৃষ্ঠায় এই টুল উপলভ্য সেখানে এটি APIs Explorer-এর জায়গা নিয়েছে। (প্রতিটি পৃষ্ঠায় একটি লিঙ্ক দেখানো হয় যাতে আপনি যে অনুরোধ নিয়ে কাজ করছেন সেটি APIs Explorer-এ লোড করার বিকল্পও আপনার কাছে থাকে।)

  • Data API কোড স্নিপেট টুলটিও নতুন UI সহ আপডেট করা হয়েছে যা উপরে বর্ণিত একই ধরনের সব ফিচার অফার করে। এই পৃষ্ঠায় উপলভ্য প্রধান নতুন ফিচারগুলি হল:

    • ডেটা লেখার জন্য API অনুরোধের ক্ষেত্রে সহায়তা।
    • Java স্যাম্পেলের জন্য সহায়তা।
    • ব্যবহারকারীদের অনুমোদন ও API অনুরোধ তৈরি করার জন্য আরও বেশি নমনীয় ও বিস্তারিত বয়লারপ্লেট কোড।

২৭ এপ্রিল, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন কুইকস্টার্ট গাইড থেকে আপনি জানতে পারবেন যে কীভাবে একটি সহজ অ্যাপ্লিকেশন সেট-আপ করতে হয় যা YouTube Data API সংক্রান্ত অনুরোধ করে। বর্তমানে Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python এবং Ruby-এর জন্য গাইড উপলভ্য।

৩০ মার্চ, ২০১৭

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সের নতুন topicDetails.topicCategories[] প্রপার্টিতে Wikipedia URL-এর একটি তালিকা রয়েছে যা চ্যানেলের কন্টেন্ট সম্পর্কে তথ্য দেয়। রিসোর্সের topicDetails.topicIds[] প্রপার্টিতে ফেরত আসা বিষয় আইডির সাথে URLগুলি সম্পর্কিত।
  • playlistItem রিসোর্সের নতুন contentDetails.videoPublishedAt প্রপার্টি, YouTube-এ ভিডিওটি কখন প্রকাশ করা হয়েছে তা শনাক্ত করে। রিসোর্সে আগে থেকেই snippet.publishedAt প্রপার্টি আছে, যা প্লেলিস্টে আইটেম যোগ করার সময় শনাক্ত করে।
  • channel রিসোর্সের মতো, video রিসোর্স এখন topicDetails.topicCategories[] প্রপার্টি ফিরিয়ে দেয়, যার মধ্যে Wikipedia URL-এর একটি তালিকা থাকে যা ভিডিওর কন্টেন্ট বর্ণনা করে। video রিসোর্সের ক্ষেত্রে, URL-গুলি রিসোর্সের topicDetails.relevantTopicIds[] প্রপার্টিতে ফিরে আসা বিষয় আইডিগুলির সাথে সম্পর্কিত।
  • video রিসোর্সের নতুন contentDetails.contentRating.mpaatRating প্রপার্টি সেই রেটিং শনাক্ত করে যা মোশন পিকচার অ্যাসোসিয়েশন অফ আমেরিকা কোনও সিনেমার ট্রেলার বা প্রিভিউকে দিয়েছে।

২৭ ফেব্রুয়ারি, ২০১৭

১১ আগস্ট, ২০১৬-এ যেমন ঘোষণা করা হয়েছিল, YouTube, টপিক আইডির কাজ করে এমন তালিকা থেকে কিউরেট করা তালিকায় পরিবর্তন করেছে। channel ও video রিসোর্সের topicDetails প্রপার্টি এবং search.list পদ্ধতির topicId প্যারামিটারে কাজ করে এমন টপিক আইডির সম্পূর্ণ তালিকা অন্তর্ভুক্ত করা আছে।

মনে রাখবেন, কিউরেট করা তালিকায় বেশ কিছু পরিবর্তন করা হয়েছে:

  • নিম্নলিখিত বিষয়গুলি Society-এর সাবটপিক হিসেবে যোগ করা হয়েছে:
    নামবিষয় আইডি
    ব্যবসা/m/09s1f
    স্বাস্থ্য/m/0kt51
    সামরিক/m/01h6rj
    রাজনীতি/m/05qt0
    ধর্ম/m/06bvp
  • Animated cartoon বিষয়, যা আগে Entertainment-এর চাইল্ড ছিল, সেটি সরিয়ে দেওয়া হয়েছে।
  • Children's music বিষয়, যা আগে Music-এর চাইল্ড ছিল, সেটি সরিয়ে দেওয়া হয়েছে।

এই পরিবর্তনের ফলে, ভিডিও সম্পর্কিত বিষয়গুলি এখন সবসময় video রিসোর্সের topicDetails.relevantTopicIds[] প্রপার্টি ভ্যালুতে ফেরত দেওয়া হয়।

২৯ নভেম্বর, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • ১০ ফেব্রুয়ারি, ২০১৭ থেকে যেসব বিষয় আইডি কাজ করবে সেগুলির তালিকায় তিনটি ছোট পরিবর্তন করা হয়েছে:

    • Professional wrestling বিভাগ, যা আগে Sports বিভাগের চাইল্ড ছিল, এখন Entertainment-এর চাইল্ড।
    • TV shows বিভাগটি, যা Entertainment-এর চাইল্ড, সেটি নতুন।
    • Health বিভাগটি, যা আগে Lifestyle-এর সাব-ক্যাটাগরি ছিল, সেটি সরিয়ে দেওয়া হয়েছে।

    এছাড়াও মনে রাখবেন যে কয়েকটি পেরেন্ট বিভাগ (Entertainment, Gaming, Lifestyle, Music ও Sports) আছে। Tennis-এর মতো চাইল্ড বিভাগের সাথে যুক্ত যেকোনও ভিডিও পেরেন্ট বিভাগের (Sports) সাথেও যুক্ত থাকবে।

১০ নভেম্বর, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • ১১ আগস্ট, ২০১৬-এ প্রথমবার ঘোষণা করা অনুযায়ী, Freebase এবং Freebase API বন্ধ করে দেওয়ার জন্য বিষয় আইডি সম্পর্কিত বেশ কিছু পরিবর্তন করতে হবে। বিষয় আইডি channel এবং video রিসোর্সের সাথে সম্পর্কিত বিষয় শনাক্ত করে এবং আপনি নির্দিষ্ট বিষয়ের সাথে সম্পর্কিত চ্যানেল বা ভিডিও খুঁজতে topicId সার্চ প্যারামিটার ব্যবহার করতে পারেন।

    ১০ ফেব্রুয়ারি, ২০১৭ থেকে YouTube, এত দিন ধরে রিটার্ন করা আইডিগুলির অনেক বেশি গ্র্যানুলার সেটের পরিবর্তে, আইডিগুলির একটি ছোট সেট রিটার্ন করা শুরু করবে। এছাড়াও, মনে রাখবেন যে চ্যানেল এবং ভিডিওগুলি কোনও বিষয়ের সাথে যুক্ত হওয়ার গ্যারান্টি দেওয়া হয় না, যা বর্তমান API আচরণের সাথে সামঞ্জস্যপূর্ণ।

    আপনি যাতে এইসব পরিবর্তনের জন্য আপনার API ক্লায়েন্ট প্রস্তুত করতে পারেন, সেই জন্য নিম্নলিখিত API প্যারামিটার ও প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে সেই সময়ের পরে কাজ করবে এমন বিষয় আইডির তালিকা দেখানো যায়। মনে রাখবেন, সব প্রপার্টির জন্য বিভাগের তালিকা একই।

  • মনে রাখবেন: এটি বন্ধ হয়ে যাওয়া সংক্রান্ত ঘোষণা।

    নিম্নলিখিত প্রপার্টি বন্ধ করা হচ্ছে:

    • channel রিসোর্সের topicDetails.topicIds[] প্রপার্টি। এই প্রপার্টি ১০ নভেম্বর, ২০১৭ পর্যন্ত কাজ করবে।
    • video রিসোর্সের topicDetails.relevantTopicIds[] প্রপার্টি। এই প্রপার্টি ১০ নভেম্বর, ২০১৭ পর্যন্ত কাজ করবে।
    • video রিসোর্সের topicDetails.topicIds[] প্রপার্টি। ১০ ফেব্রুয়ারি, ২০১৭-এর পরে এই প্রপার্টিতে কোনও ভ্যালু থাকবে না। (সেই তারিখের পরে, topicDetails.relevantTopicIds[] প্রপার্টির ভ্যালু কোনও ভিডিওর সাথে যুক্ত সব বিষয় শনাক্ত করবে।)

  • Freebase আগেই বন্ধ করে দেওয়া হয়েছে, তাই Freebase টপিক ব্যবহার করে সার্চ করা সংক্রান্ত গাইড ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে। সেই গাইডে কোডের স্যাম্পেল দেওয়া আছে যা থেকে বোঝা যাবে যে Freebase API-এর সাথে কোনও অ্যাপ্লিকেশন কীভাবে কাজ করবে।

    এছাড়াও, বিষয় আইডি সম্পর্কিত বেশ কিছু কোড স্যাম্পেল search.list পদ্ধতির ডকুমেন্টেশন থেকে সরিয়ে দেওয়া হয়েছে।

২ নভেম্বর, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • নতুন প্রপার্টি ও প্যারামিটার

    • video রিসোর্সে একাধিক নতুন প্রপার্টি রয়েছে:

      • player.embedHtml প্রপার্টিতে একটি <iframe> ট্যাগ থাকে যা আপনি ভিডিও চালানোর জন্য একটি প্লেয়ার এম্বেড করতে ব্যবহার করতে পারেন। নতুন player.embedHeight এবং player.embedWidth প্রপার্টি এম্বেড করা প্লেয়ারের ডাইমেনশন শনাক্ত করে। API অনুরোধে অন্তত একটি maxHeight বা maxWidth প্যারামিটারের মান উল্লেখ করা থাকলে তবেই এই প্রপার্টিগুলি রিটার্ন করা হয়। এই দুটি নতুন প্যারামিটার সম্পর্কে এই রিভিশন ইতিহাস এন্ট্রিতে পরে ব্যাখ্যা করা হয়েছে।

      • নতুন hasCustomThumbnail প্রপার্টি থেকে বোঝা যায় যে ভিডিও আপলোডার ভিডিওর জন্য কাস্টম থাম্বনেল ছবি দিয়েছেন কিনা। মনে রাখবেন, এই প্রপার্টি শুধু ভিডিও আপলোডার দেখতে পাবেন।

      • নতুন fpbRatingReasons[] ভিডিওটি FPB (দক্ষিণ আফ্রিকা) রেটিং পাওয়ার কারণ শনাক্ত করে।

      • নতুন mcstRating ভিয়েতনামে ভিডিওটি যে রেটিং পেয়েছে তা শনাক্ত করে।

    • videos.list পদ্ধতিতে দুটি নতুন প্যারামিটার কাজ করে, maxHeight এবং maxWidth। video রিসোর্সে player অংশটি রিট্রিভ করার সময় আপনি একটি বা দুটি প্যারামিটারই ব্যবহার করতে পারেন।

      ডিফল্ট হিসেবে, player.embedHtml প্রপার্টিতে ফেরত আসা <iframe>-এর উচ্চতা ৩৬০ পিক্সেল হয়। ভিডিওর অ্যাস্পেক্ট রেশিওর সাথে মানানসই হতে প্রস্থ অ্যাডজাস্ট করা হয়, এর ফলে এম্বেড করা প্লেয়ারে ভিডিওর চারপাশে কালো বার থাকে না। যেমন, কোনও ভিডিওর অ্যাস্পেক্ট রেশিও ১৬:৯ হলে, প্লেয়ারের প্রস্থ হবে ৬৪০ পিক্সেল।

      নতুন প্যারামিটারের সাহায্যে, আপনি নির্দিষ্ট করতে পারবেন যে ডিফল্ট ডাইমেনশনের পরিবর্তে, এম্বেড কোডটি আপনার অ্যাপ্লিকেশন লেআউটের জন্য উপযুক্ত উচ্চতা এবং/অথবা প্রস্থ ব্যবহার করবে। এম্বেড করা প্লেয়ারের চারপাশে কালো বার যাতে না থাকে তা নিশ্চিত করতে API সার্ভার প্লেয়ারের ডাইমেনশন প্রয়োজনমতো স্কেল করে। মনে রাখবেন, দুটি প্যারামিটারই এম্বেড করা প্লেয়ারের সর্বাধিক ডাইমেনশন নির্দিষ্ট করে। তাই, দুটি প্যারামিটারই নির্দিষ্ট করা থাকলে, একটি ডাইমেনশন এখনও সেই ডাইমেনশনের জন্য অনুমোদিত সর্বোচ্চ পরিমাণের চেয়ে ছোট হতে পারে।

      যেমন, ধরুন কোনও ভিডিওর অ্যাস্পেক্ট রেশিও ১৬:৯। তাই, maxHeight বা maxWidth প্যারামিটার সেট করা না থাকলে, player.embedHtml ট্যাগে ৬৪০x৩৬০ প্লেয়ার থাকবে।

      • maxHeight প্যারামিটার 720-এ সেট করা থাকলে এবং maxWidth প্যারামিটার সেট করা না থাকলে, API ১২৮০x৭২০ প্লেয়ার রিটার্ন করবে।
      • maxWidth প্যারামিটার 960-এ সেট করা থাকলে এবং maxHeight প্যারামিটার সেট করা না থাকলে, API একটি ৯৬০x৫৪০ প্লেয়ার রিটার্ন করবে।
      • maxWidth প্যারামিটার 960-এ সেট করা থাকলে এবং maxHeight প্যারামিটার 450-এ সেট করা থাকলে, API একটি ৮০০x৪৫০ প্লেয়ার রিটার্ন করবে।

      উপরে বর্ণনা করা নতুন player.embedHeight এবং player.embedWidth প্রপার্টি প্লেয়ারের ডাইমেনশন শনাক্ত করে।

  • আগে থেকে থাকা পদ্ধতি, প্রপার্টি ও প্যারামিটারে আপডেট

    • channelSection রিসোর্সের বিবরণ আপডেট করে জানানো হয়েছে যে টার্গেটিং ডেটা সেট না করে কোনও চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারবে এবং টার্গেটিং ডেটা সেট করে সর্বাধিক ১০০টি শেল্ফ তৈরি করতে পারবে।

      এছাড়াও, channelSection রিসোর্সের targeting প্রপার্টি আপডেট করা হয়েছে যাতে এটি দেখাতে পারে যে টার্গেটিং বিকল্প শুধুমাত্র API ব্যবহার করেই সেট করা যায়। YouTube ওয়েবসাইটের ইউজার ইন্টারফেস ব্যবহার করে চ্যানেল বিভাগ পরিবর্তন করা হলে টার্গেটিং বিকল্প মুছে যায়।

    • i18nLanguage রিসোর্সের snippet.name প্রপার্টির সংজ্ঞা সংশোধন করা হয়েছে যাতে বোঝা যায় যে ভ্যালুটি কোনও ভাষার নামকে এমনভাবে উপস্থাপন করে যেভাবে এটি i18nLanguage.list পদ্ধতির hl প্যারামিটার দ্বারা নির্দিষ্ট করা ভাষায় লেখা হয়।

    • playlistItem রিসোর্সের contentDetails.note প্রপার্টি আপডেট করা হয়েছে যাতে প্রপার্টি ভ্যালুর সর্বাধিক দৈর্ঘ্য ২৮০টি অক্ষর হয়।

    • playlistItem রিসোর্সের contentDetails.startAt এবং contentDetails.endAt প্রপার্টি বন্ধ করা হয়েছে। playlistItems.insert বা playlistItems.update অনুরোধে সেট করা থাকলে এইসব ফিল্ড উপেক্ষা করা হয়।

    • playlistItems.delete এবং playlistItems.update পদ্ধতিতে এখন onBehalfOfContentOwner প্যারামিটার কাজ করে, যা আগে থেকেই অন্যান্য পদ্ধতিতে কাজ করে। যেসব অনুরোধ এই পদ্ধতি ব্যবহার করে সেগুলিকে https://www.googleapis.com/auth/youtubepartner স্কোপে অ্যাক্সেস প্রদানকারী টোকেন দিয়েও অনুমোদন করতে হবে।

    • search.list পদ্ধতির publishedBefore ও publishedAfter প্যারামিটার দু'টিই আপডেট করা হয়েছে যাতে বোঝা যায় যে প্যারামিটার ভ্যালু অন্তর্ভুক্ত। যেমন, publishedBefore প্যারামিটার সেট করা থাকলে, API নির্দিষ্ট সময়ের আগে বা সেই সময়ে তৈরি করা রিসোর্স রিটার্ন করে।

    • video রিসোর্সের contentDetails.contentRating.grfilmRating প্রপার্টিতে তিনটি অতিরিক্ত ভ্যালু কাজ করে: grfilmK12, grfilmK15 ও grfilmK18.

    • videos.insert পদ্ধতির বিবরণে আপডেট করে উল্লেখ করা হয়েছে যে আপলোড করা ভিডিওর সর্বাধিক ফাইল সাইজ ৬৪ জিবি থেকে বেড়ে ১২৮ জিবি হয়েছে।

  • নতুন ও আপডেট করা সমস্যা

    • API-তে নিম্নলিখিত নতুন সমস্যাগুলি কাজ করে:

      সমস্যার ধরন সমস্যার বিবরণ বিবরণ
      forbidden (403) homeParameterDeprecated activities.list পদ্ধতি এই সমস্যা দেখায়, যার অর্থ হল এই API-এর মাধ্যমে ব্যবহারকারীর হোম পেজ অ্যাক্টিভিটি ডেটা উপলভ্য নয়। অননুমোদিত অনুরোধে আপনি home প্যারামিটার true-এ সেট করলে এই সমস্যা হতে পারে।
      invalidValue (400) invalidContentDetails অনুরোধে থাকা contentDetails অবজেক্টটি যে ভুল, তা বোঝাতে playlistItems.insert পদ্ধতি এই সমস্যাটি রিটার্ন করে। এই সমস্যা হওয়ার একটি কারণ হল, contentDetails.note ফিল্ডে ২৮০টির বেশি অক্ষর আছে।
      forbidden (403) watchHistoryNotAccessible playlistItems.list পদ্ধতি এই এররটি দেখায় কারণ অনুরোধটি "দেখার ইতিহাস" প্লেলিস্ট আইটেম রিট্রিভ করার চেষ্টা করেছে, কিন্তু API ব্যবহার করে সেগুলি রিট্রিভ করা যায় না।
      forbidden (403) watchLaterNotAccessible playlistItems.list পদ্ধতি এই ত্রুটি রিটার্ন করে দেখায় যে অনুরোধটি "পরে দেখুন" প্লেলিস্ট আইটেম ফিরিয়ে আনার চেষ্টা করেছে, কিন্তু API ব্যবহার করে সেগুলি ফিরিয়ে আনা যাবে না।
      badRequest (400) uploadLimitExceeded videos.insert পদ্ধতি এই সমস্যা দেখায়, যার অর্থ হল চ্যানেলটি যতগুলি ভিডিও আপলোড করতে পারে তার সীমা অতিক্রম করেছে।
      forbidden (403) forbiddenEmbedSetting videos.update পদ্ধতি এই ত্রুটি রিটার্ন করে এটি বোঝাতে যে API অনুরোধ ভিডিওর জন্য ভুল এম্বেড সেটিং সেট করার চেষ্টা করে। মনে রাখবেন, কিছু চ্যানেলের কাছে লাইভ স্ট্রিমের জন্য এম্বেড করা প্লেয়ার অফার করার অনুমতি নাও থাকতে পারে। আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।

    • আপনি কোনও প্লেলিস্টে ডুপ্লিকেট ভিডিও যোগ করলে, playlistItems.insert পদ্ধতিতে আর কোনও সমস্যা হয় না। আগে পছন্দের ভিডিওর মতো কিছু প্লেলিস্টের ক্ষেত্রে এই সমস্যা দেখা দিত, যেগুলিতে ডুপ্লিকেট ভিডিও যোগ করা যেত না, তবে এখন আর সেগুলি কাজ করে না। সাধারণত, প্লেলিস্টে ডুপ্লিকেট ভিডিও যোগ করা যায়।

  • অন্যান্য আপডেট

    • ১৫ সেপ্টেম্বর, ২০১৬-এর জন্য রিভিশন ইতিহাস এন্ট্রি আপডেট করা হয়েছে যাতে এটি স্পষ্ট করা যায় যে, যখনই কোনও উত্তরে channel রিসোর্সের contentDetails.relatedPlaylists.watchHistory এবং contentDetails.relatedPlaylists.watchLater প্রপার্টি অন্তর্ভুক্ত করা হয়, তখন সেগুলিতে সর্বদা যথাক্রমে HL এবং WL ভ্যালু থাকে। এছাড়াও, কোনও অনুমোদিত ব্যবহারকারী যদি নিজের চ্যানেলের ডেটা পান, তাহলেই শুধুমাত্র সেইসব প্রপার্টি অন্তর্ভুক্ত করা হয়।

১৫ সেপ্টেম্বর, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • ১১ আগস্ট, ২০১৬-এর রিভিশন ইতিহাসের আপডেটে বিষয় আইডি সম্পর্কিত বিভিন্ন পরিবর্তন নিয়ে আলোচনা করা হয়েছে, যার মধ্যে ১০ ফেব্রুয়ারি, ২০১৭ থেকে কাজ করবে এমন বিষয় আইডির সেট পরিবর্তন করার বিষয়টিও রয়েছে। যেসব বিষয়ের তালিকা কাজ করবে তা ১০ নভেম্বর, ২০১৬-এর মধ্যে প্রকাশ করা হবে।

  • নিম্নলিখিত পরিবর্তনগুলি এখন কার্যকর হয়েছে। এইসব পরিবর্তনের বিজ্ঞপ্তি ১১ আগস্ট, ২০১৬-এ রিভিশন ইতিহাস আপডেটে দেওয়া হয়েছে:

    • activities.list পদ্ধতিটি home প্যারামিটার true-এ সেট করে কল করা হলে, API রেসপন্সে এখন এমন আইটেম থাকে যা লগ-আউট করা YouTube ব্যবহারকারী হোম পেজে দেখতে পাবেন।

      এটি একটি সামান্য পরিবর্তন যা ১১ আগস্ট, ২০১৬-এ রিভিশন ইতিহাসের আপডেটে বর্ণিত আচরণের চেয়ে আরও ভালো ব্যবহারকারীর অভিজ্ঞতা প্রদান করার উদ্দেশ্যে করা হয়েছে। ওই আপডেটে বলা হয়েছিল যে home প্যারামিটার ব্যবহার করে করা অনুরোধের ক্ষেত্রে খালি তালিকা দেখানো হবে।

    • channel রিসোর্সের contentDetails.relatedPlaylists.watchHistory এবং contentDetails.relatedPlaylists.watchLater প্রপার্টিতে এখন সব চ্যানেলের জন্য যথাক্রমে HL এবং WL ভ্যালু রয়েছে।

      স্পষ্টভাবে বলতে গেলে, এই প্রপার্টি শুধুমাত্র সেইসব অনুমোদিত ব্যবহারকারী দেখতে পাবেন যারা ব্যবহারকারীর নিজের চ্যানেল সম্পর্কে ডেটা রিট্রিভ করছেন। প্রপার্টিতে সবসময় HL এবং WL ভ্যালু থাকে, এমনকি কোনও অনুমোদিত ব্যবহারকারী নিজের চ্যানেলের ডেটা ফিরিয়ে আনার সময়ও এটি থাকে। তাই, দেখার ইতিহাস এবং পরে দেখুন প্লেলিস্ট আইডি API-এর মাধ্যমে ফিরিয়ে আনা যাবে না।

      এছাড়াও, কোনও চ্যানেলের দেখার ইতিহাস বা পরে দেখার প্লেলিস্টের জন্য প্লেলিস্টের বিবরণ (playlists.list) বা প্লেলিস্ট আইটেম (playlistItems.list) ফিরিয়ে আনার অনুরোধ এখন খালি তালিকা দেখায়। এই আচরণ নতুন ভ্যালু, HL এবং WL-এর জন্য প্রযোজ্য, এর পাশাপাশি আপনার API ক্লায়েন্ট আগে থেকে স্টোর করে থাকতে পারে এমন যেকোনও দেখার ইতিহাস বা পরে দেখার প্লেলিস্ট আইডির জন্যও প্রযোজ্য।

  • video রিসোর্সের fileDetails.recordingLocation অবজেক্ট এবং এর চাইল্ড প্রপার্টি আর ফেরত দেওয়া হয় না। আগে, এই ডেটা (যেমন, পেরেন্ট fileDetails অবজেক্ট) শুধুমাত্র ভিডিওর মালিকই ফিরিয়ে আনতে পারতেন।

১১ আগস্ট, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন প্রকাশিত YouTube API পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), YouTube Engineering and Developers Blog-এ বিস্তারিতভাবে আলোচনা করা হয়েছে, যা বর্তমান পরিষেবার শর্তাবলীতে একগুচ্ছ আপডেট প্রদান করে। আপডেট করা শর্তাবলী ছাড়াও, যা ১০ ফেব্রুয়ারি, ২০১৭ থেকে কার্যকর হবে, এই আপডেটে বেশ কয়েকটি সহায়ক ডকুমেন্ট রয়েছে যা ডেভেলপারদের অবশ্যই অনুসরণ করতে হবে এমন নীতিগুলি ব্যাখ্যা করতে সাহায্য করবে।

    আপডেট করা শর্তাবলীর জন্য রিভিশন ইতিহাসে নতুন ডকুমেন্টের সম্পূর্ণ সেট বর্ণনা করা হয়েছে। এছাড়াও, আপডেট করা শর্তাবলী বা সেইসব সহায়ক ডকুমেন্টে ভবিষ্যতে কোনও পরিবর্তন করা হলে, সেইসব পরিবর্তনের বিবরণও রিভিশন ইতিহাসে দেওয়া থাকবে। আপনি সেই ডকুমেন্টের একটি লিঙ্ক থেকে সেই রিভিশন ইতিহাসে হওয়া পরিবর্তনের তালিকা RSS ফিডে সাবস্ক্রাইব করতে পারেন।

  • Freebase ও Freebase API বন্ধ করে দেওয়ার ফলে বিষয় আইডি সংক্রান্ত বিভিন্ন পরিবর্তন হচ্ছে। নিম্নলিখিত API রিসোর্স ও পদ্ধতিতে বিষয় আইডি ব্যবহার করা হয়:

    • channel রিসোর্সের topicDetails অংশ চ্যানেলের সাথে যুক্ত বিষয় শনাক্ত করে।
    • video রিসোর্সের topicDetails অংশ ভিডিওর সাথে যুক্ত বিষয় শনাক্ত করে।
    • search.list পদ্ধতির topicId প্যারামিটার আপনাকে কোনও নির্দিষ্ট বিষয় সম্পর্কিত ভিডিও বা চ্যানেল সার্চ করতে দেয়।

    এইসব ফিচারে করা পরিবর্তনগুলি হল:

    • ১০ ফেব্রুয়ারি, ২০১৭ থেকে, YouTube এখন পর্যন্ত পাওয়া অনেক বেশি গ্র্যানুলার সেট আইডির পরিবর্তে অল্প সংখ্যক টপিক আইডি ফেরত দেওয়া শুরু করবে। কাজ করে এমন বিষয়ের সেট খেলাধূলা বা বাস্কেটবল-এর মতো উচ্চ-স্তরের বিভাগ শনাক্ত করবে, তবে, উদাহরণস্বরূপ, তারা নির্দিষ্ট টিম বা খেলোয়াড়দের শনাক্ত করবে না। আমরা কাজ করে এমন বিষয়ের সেট ঘোষণা করব যাতে এই পরিবর্তনের জন্য আপনার অ্যাপ্লিকেশন প্রস্তুত করার সময় পান।

    • আপনি আগে থেকে যেসব Freebase টপিক আইডি পেয়েছেন, সেগুলি ১০ ফেব্রুয়ারি, ২০১৭ পর্যন্ত কন্টেন্ট সার্চ করার জন্য ব্যবহার করা যাবে। তবে, সেই সময়ের পরে, আপনি বিষয় অনুযায়ী সার্চ ফলাফল ফিরিয়ে আনতে আগের আইটেমে শনাক্ত করা বিষয়ের ছোট সেটটিই শুধু ব্যবহার করতে পারবেন।

    • ১০ ফেব্রুয়ারি, ২০১৭-এর পরে, আপনি যদি এমন কোনও বিষয় আইডি ব্যবহার করে ফলাফল সার্চ করার চেষ্টা করেন যা কাজ করে এমন ছোট বিষয় আইডি সেটে নেই, তাহলে API একটি খালি ফলাফল সেট রিটার্ন করবে।

  • ১২ সেপ্টেম্বর, ২০১৬ থেকে বেশ কিছু API ফিল্ড ও প্যারামিটার বন্ধ করে দেওয়া হচ্ছে:

    • activities.list মেথডের home প্যারামিটার একজন অনুমোদিত ব্যবহারকারীকে অ্যাক্টিভিটি ফিড ফিরিয়ে আনার অনুমতি দেয় যা সেই ব্যবহারকারীর জন্য YouTube হোম পেজে দেখানো হবে। ১২ সেপ্টেম্বর, ২০১৬-এর পরে এই প্যারামিটার ব্যবহার করে করা অনুরোধের ক্ষেত্রে খালি তালিকা দেখানো হবে।

    • channel রিসোর্সের contentDetails.relatedPlaylists.watchHistory ও contentDetails.relatedPlaylists.watchLater প্রপার্টি শুধুমাত্র সেইসব অনুমোদিত ব্যবহারকারী দেখতে পাবেন যারা নিজের চ্যানেল সম্পর্কে ডেটা রিট্রিভ করছেন। ১২ সেপ্টেম্বর, ২০১৬-এর পরে, contentDetails.relatedPlaylists.watchHistory সব চ্যানেলের জন্য HL ভ্যালু এবং contentDetails.relatedPlaylists.watchLater প্রপার্টি WL ভ্যালু রিটার্ন করবে।

      ১২ সেপ্টেম্বর, ২০১৬-এর পরে কোনও চ্যানেলের দেখার ইতিহাস বা পরে দেখার প্লেলিস্টের জন্য প্লেলিস্টের বিবরণ (playlists.list) ফিরিয়ে আনার অনুরোধ করলে একটি খালি তালিকা দেখানো হবে। এইসব প্লেলিস্টের যেকোনও একটিতে প্লেলিস্ট আইটেম (playlistItems.list) ফিরিয়ে আনার অনুরোধের ক্ষেত্রেও সেই সময়ের পরে একটি খালি তালিকা দেখানো হবে। এটি নতুন ভ্যালু, HL এবং WL-এর ক্ষেত্রে প্রযোজ্য, এর পাশাপাশি আপনার API ক্লায়েন্ট আগে থেকে সেভ করে রেখেছে এমন যেকোনও দেখার ইতিহাস বা পরে দেখুন প্লেলিস্ট আইডির ক্ষেত্রেও প্রযোজ্য।

    • ১২ সেপ্টেম্বর, ২০১৬-এর পরে video রিসোর্সের fileDetails.recordingLocation অবজেক্ট বা এর কোনও চাইল্ড প্রপার্টি আর ফেরত দেওয়া হবে না। এই ডেটা শুধুমাত্র ভিডিওর মালিকই পুনরুদ্ধার করতে পারেন, কারণ মূল fileDetails অবজেক্ট শুধুমাত্র ভিডিওর মালিকই পুনরুদ্ধার করতে পারেন।

১৩ জুন, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সের contentDetails.googlePlusUserId প্রপার্টি বন্ধ করা হয়েছে। আগে, চ্যানেলটি Google+ প্রোফাইলের সাথে যুক্ত থাকলে তবেই প্রপার্টিটি থাকত। বন্ধ হয়ে যাওয়ার পরে, প্রপার্টিটি আর কোনও channel রিসোর্সে অন্তর্ভুক্ত করা হবে না।

  • comment রিসোর্সের snippet.authorGoogleplusProfileUrl প্রপার্টি বন্ধ করা হয়েছে। আগে, চ্যানেলটি Google+ প্রোফাইলের সাথে যুক্ত থাকলে তবেই প্রপার্টিটি থাকত। বন্ধ হয়ে যাওয়ার পরে, প্রপার্টিটি আর কোনও comment রিসোর্সে অন্তর্ভুক্ত করা হবে না।

যেহেতু এই প্রপার্টিগুলির কোনওটিই বন্ধ করার পরে ফেরত দেওয়া হবে না, তাই সংশ্লিষ্ট রিসোর্স ডকুমেন্টেশন থেকে উভয় প্রপার্টিই সরিয়ে দেওয়া হয়েছে।

৩১ মে, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • subscriptions.list পদ্ধতিরmyRecentSubscribers নতুন প্যারামিটার, যাচাই করা ব্যবহারকারীর চ্যানেলের সাবস্ক্রাইবারদের একটি তালিকা সেই সময়ে সাবস্ক্রাইব করার বিপরীত কালানুক্রমিক ক্রমে পুনরুদ্ধার করে।

    মনে রাখবেন যে নতুন প্যারামিটারটি শুধুমাত্র যাচাইকৃত ব্যবহারকারীর চ্যানেলের সবচেয়ে সাম্প্রতিক ১০০০ সাবস্ক্রাইবারের তথ্য পুনরুদ্ধার করতে পারে। সাবস্ক্রাইবারদের সম্পূর্ণ তালিকা পেতে, mySubscribers প্যারামিটার ব্যবহার করুন। যে প্যারামিটার নির্দিষ্ট ক্রমে সাবস্ক্রাইবারদের রিটার্ন করে না, সেটি পুনরুদ্ধার করা যেতে পারে এমন সাবস্ক্রাইবারদের সংখ্যা সীমিত করে না।

  • অ্যাক্টিভিটি, playlistItem, প্লেলিস্ট, সার্চ ফলাফল, থাম্বনেল এবং ভিডিও রিসোর্সের জন্য snippet.thumbnails.(key) প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে কিছু ভিডিওর জন্য অতিরিক্ত থাম্বনেল ছবির সাইজ উপলভ্য আছে কিনা তা উল্লেখ করা যায়।

    • standard ছবিটি ৬৪০ পিক্সেল চওড়া এবং ৪৮০ পিক্সেল লম্বা।
    • maxres ছবিটি ১২৮০ পিক্সেল চওড়া ও ৭২০ পিক্সেল লম্বা।

  • channelSection.list পদ্ধতির part প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে targeting অংশটি 2 কোটা ইউনিট খরচ করে পাওয়া যেতে পারে।

  • videos.list পদ্ধতি এখন একটি নিষিদ্ধ (403) সমস্যা দেখায় যখন একটি ভুলভাবে অনুমোদিত অনুরোধ video রিসোর্সের fileDetails, processingDetails বা suggestions অংশগুলি ফিরিয়ে আনার চেষ্টা করে। ভিডিওর মালিকই শুধু সেই অংশগুলি দেখতে পাবেন।

১৭ মে, ২০১৬

নতুন Data API কোড স্নিপেট টুল, YouTube Data API-এর সাধারণ ব্যবহারের ক্ষেত্রে ছোট কোড স্নিপেট প্রদান করে। কোড স্নিপেট বর্তমানে Apps Script, Go, JavaScript, PHP, Python ও Ruby-তে সব রিড-ওনলি API পদ্ধতির জন্য উপলভ্য।

প্রতিটি পদ্ধতির জন্য, টুলটি এক বা একাধিক ব্যবহারের ক্ষেত্রের জন্য কোড স্যাম্পেল দেখায়। যেমন, এটি search.list পদ্ধতির জন্য পাঁচটি কোড স্নিপেট প্রদান করে:

  • কীওয়ার্ড অনুযায়ী ভিডিওর তালিকা তৈরি করুন
  • লোকেশন অনুযায়ী ভিডিও তালিকাভুক্ত করা
  • লাইভ ইভেন্টের তালিকা তৈরি করা হচ্ছে
  • যাচাই করা ব্যবহারকারীর ভিডিও সার্চ করা
  • এই ধরনের ভিডিওর তালিকা

প্রতিটি ব্যবহারের ক্ষেত্রে, টুলটি API অনুরোধে ব্যবহৃত প্যারামিটারগুলি প্রদর্শন করে। আপনি প্যারামিটার ভ্যালু পরিবর্তন করতে পারবেন, সেক্ষেত্রে আপনার দেওয়া প্যারামিটার ভ্যালু দেখানোর জন্য টুলটি কোড স্নিপেট আপডেট করে।

সবশেষে, টুলটি প্রতিটি অনুরোধের জন্য API রেসপন্স দেখায়। আপনি অনুরোধের প্যারামিটার পরিবর্তন করে থাকলে, আপনার দেওয়া প্যারামিটারের মানের উপর ভিত্তি করে API রেসপন্স দেখানো হয়। মনে রাখবেন, API থেকে পাওয়া উত্তর দেখানোর জন্য আপনার হয়ে অনুরোধ জমা দিতে, আপনাকে টুলটিকে অনুমোদন করতে হবে।

২৮ এপ্রিল, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • video রিসোর্সের নতুন contentDetails.projection প্রপার্টি ভিডিওর প্রোজেকশন ফর্ম্যাট নির্দিষ্ট করে। প্রপার্টির সঠিক ভ্যালু হল 360 ও rectangular।

  • দুটি প্রপার্টির মধ্যে পার্থক্য ব্যাখ্যা করার জন্য video রিসোর্সের recordingDetails.location এবং fileDetails.recordingLocation প্রপার্টি দুটিই আপডেট করা হয়েছে:

    • recordingDetails.location প্রপার্টি সেই লোকেশন শনাক্ত করে যা ভিডিওর মালিক ভিডিওর সাথে যুক্ত করতে চান। এই লোকেশন এডিট করা যাবে, সর্বজনীন ভিডিওতে সার্চ করা যাবে এবং সর্বজনীন ভিডিওর জন্য ব্যবহারকারীদের দেখানো হতে পারে।
    • fileDetails.recordingLocation প্রপার্টির মান অপরিবর্তনীয় এবং এটি আপলোড করা আসল ভিডিও ফাইলের সাথে সম্পর্কিত লোকেশনকে দেখায়। এই ভ্যালু শুধুমাত্র ভিডিওর মালিক দেখতে পাবেন।

  • channel রিসোর্সের contentDetails.relatedPlaylists.favorites প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা হয়েছে যে প্রপার্টির ভ্যালুতে এমন প্লেলিস্ট আইডি থাকতে পারে যা খালি প্লেলিস্টকে রেফার করে এবং যা ফেচ করা যায় না। কারণ, 'পছন্দের ভিডিও' ফাংশনটি আগেই বন্ধ করে দেওয়া হয়েছে। মনে রাখবেন, এই প্রপার্টি API বাতিলকরণ নীতি মেনে চলে না।

  • comments.insert, comments.update, commentThreads.insert বা commentThreads.update পদ্ধতির মাধ্যমে ফেরত পাঠানো যেতে পারে এমন ineligibleAccount সমস্যার সংজ্ঞা আপডেট করা হয়েছে। এর ফলে বোঝা যায় যে API অনুরোধ অনুমোদন করার জন্য ব্যবহৃত YouTube অ্যাকাউন্ট ব্যবহারকারীর Google অ্যাকাউন্টের সাথে মার্জ করা না হলে এই সমস্যা হয়।

২০ এপ্রিল, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channels.update মেথডের part প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে localizations-ও সেই প্যারামিটারের জন্য একটি সঠিক ভ্যালু।

  • শুরু করার নির্দেশিকার কোটা ব্যবহার বিভাগটি Google Developer's Console-এর সাথে লিঙ্ক করার জন্য আপডেট করা হয়েছে, যেখানে আপনি নিজের আসল কোটা এবং কোটা ব্যবহার দেখতে পাবেন।

১৬ মার্চ, ২০১৬

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • channelBanner রিসোর্স ডকুমেন্টেশনে উল্লেখ করা হয়েছে যে আপলোড করা চ্যানেল ব্যানার ছবির সাজেস্ট করা সাইজ হল ২৫৬০x১৪৪০ পিক্সেল। ন্যূনতম সাইজ (২০৪৮ পিক্সেল x ১১৫২ পিক্সেল) পরিবর্তন করা হয়নি।

    • channel রিসোর্সের নতুন snippet.customUrl প্রপার্টি চ্যানেলের সাথে যুক্ত কাস্টম URL শনাক্ত করে। (সব চ্যানেলের কাস্টম URL থাকে না।) YouTube সহায়তা কেন্দ্র থেকে কাস্টম URL পাওয়ার জন্য যোগ্যতার প্রয়োজনীয় শর্ত এবং কীভাবে URL সেট-আপ করতে হয় সেই ব্যাপারে জানতে পারবেন।

    • channel রিসোর্সের brandingSettings.watch অবজেক্ট এবং এর সব চাইল্ড প্রপার্টি বন্ধ করা হয়েছে।

    • search.list অনুরোধের API রেসপন্সে এখন regionCode প্রপার্টি আছে। সার্চ কোয়েরির জন্য ব্যবহার করা অঞ্চল কোড প্রপার্টি শনাক্ত করে। অঞ্চল কোড API-কে নির্দিষ্ট দেশের জন্য সার্চ ফলাফল দেখানোর নির্দেশ দেয়।

      প্রপার্টি ভ্যালু হল দুই অক্ষরের ISO কান্ট্রি কোড যা অঞ্চল শনাক্ত করে। i18nRegions.list পদ্ধতি কাজ করে এমন অঞ্চলের তালিকা দেখায়। ডিফল্ট মান হল US। কাজ করে না এমন কোনও অঞ্চল উল্লেখ করা হলে, কোয়েরি ম্যানেজ করার জন্য YouTube ডিফল্ট ভ্যালুর পরিবর্তে অন্য কোনও অঞ্চল বেছে নিতে পারে।

    • videoAbuseReportReason রিসোর্স snippet.label ও snippet.secondaryReasons[].label প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে এটি উল্লেখ করা যায় যে প্রপার্টিতে অপব্যবহারের অভিযোগের কারণের জন্য স্থানীয় লেবেলের টেক্সট থাকে।

      এছাড়াও, videoAbuseReportReasons.list পদ্ধতিতে এখন hl প্যারামিটার কাজ করে, যা API উত্তরের লেবেল টেক্সটের জন্য ব্যবহার করা উচিত এমন ভাষা নির্দিষ্ট করে। ডিফল্ট প্যারামিটার ভ্যালু হল en_US।

    • video রিসোর্সের নতুন contentDetails.contentRating.ecbmctRating প্রপার্টি, তুরস্কের সংস্কৃতি ও পর্যটন মন্ত্রকের মূল্যায়ন ও শ্রেণীবিভাগ বোর্ড থেকে পাওয়া ভিডিওর রেটিং শনাক্ত করে।

      এছাড়াও, অন্যান্য রেটিং সিস্টেমের জন্য API প্রপার্টি নিম্নলিখিত নতুন প্রপার্টি ভ্যালু সমর্থন করে:

      • contentDetails.contentRating.fpbRating (দক্ষিণ আফ্রিকা)
        রেটিং: ১০; প্রপার্টির ভ্যালু: fpb10
      • contentDetails.contentRating.moctwRating (তাইওয়ান)
        রেটিং: R-12; প্রপার্টির ভ্যালু: moctwR12
      • contentDetails.contentRating.moctwRating (তাইওয়ান)
        রেটিং: R-15; প্রপার্টির ভ্যালু: moctwR15

    • video রিসোর্সের liveStreamingDetails.activeLiveChatId প্রপার্টিতে ভিডিওর সাথে যুক্ত অ্যাক্টিভ লাইভ চ্যাটের আইডি থাকে। ভিডিওটি যদি লাইভ চ্যাট চালু থাকা বর্তমান লাইভ ব্রডকাস্ট হয়, তাহলেই প্রপার্টির ভ্যালু থাকবে। ব্রডকাস্ট শেষ হয়ে গেলে এবং লাইভ চ্যাট বন্ধ হয়ে গেলে, ভিডিওর জন্য আর প্রপার্টি ফেরত দেওয়া হয় না।

    • video রিসোর্সের status.rejectionReason প্রপার্টি নতুন প্রপার্টি ভ্যালু legal-এর সাথে কাজ করে।

  • API-তে নিম্নলিখিত নতুন সমস্যাগুলি কাজ করে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest (400) notEditable channelSections.insert, channelSections.update ও channelSections.delete পদ্ধতি এই এররটি রিটার্ন করে এটি বোঝাতে চায় যে নির্দিষ্ট চ্যানেল বিভাগটি তৈরি, আপডেট বা মুছে ফেলা যাবে না।
    badRequest (400) styleRequired channelSections.insert এবং channelSections.update পদ্ধতি এই সমস্যাটি দেখায়, যা থেকে বোঝা যায় যে API অনুরোধে জমা দেওয়া channelSection রিসোর্সে অবশ্যই snippet.style প্রপার্টির জন্য একটি ভ্যালু উল্লেখ করতে হবে।
    badRequest (400) typeRequired channelSections.insert এবং channelSections.update পদ্ধতি এই সমস্যাটি দেখায়, যা থেকে বোঝা যায় যে API অনুরোধে জমা দেওয়া channelSection রিসোর্সে অবশ্যই snippet.type প্রপার্টির জন্য একটি ভ্যালু উল্লেখ করতে হবে।
    badRequest (400) processingFailure commentThreads.list পদ্ধতি এই সমস্যাটি দেখায়, যার অর্থ হল API সার্ভার অনুরোধটি সফলভাবে প্রসেস করতে পারেনি। এটি সাময়িক সমস্যা হলেও, সাধারণত এর অর্থ হল অনুরোধের ইনপুট সঠিক নয়। অনুরোধের বডিতে commentThread রিসোর্সের স্ট্রাকচার চেক করে দেখুন যে সেটি সঠিক কিনা।
    forbidden (403) commentsDisabled commentThreads.list পদ্ধতি এই সমস্যাটি দেখায় যাতে বোঝা যায় যে videoId প্যারামিটার দ্বারা শনাক্ত করা ভিডিওতে কমেন্ট করার সুবিধা বন্ধ করা আছে।
    badRequest (400) commentTextTooLong commentThreads.insert পদ্ধতি এই ত্রুটি রিটার্ন করে এটি বোঝাতে যে, যে comment রিসোর্স যোগ করা হচ্ছে তার snippet.topLevelComment.snippet.textOriginal প্রপার্টিতে অনেক বেশি অক্ষর আছে।
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist playlistItems.insert পদ্ধতি এই সমস্যা দেখায়, যার অর্থ হল আপনি যে ভিডিওটি প্লেলিস্টে যোগ করার চেষ্টা করছেন সেটি আগে থেকেই অন্য একটি সিরিজ প্লেলিস্টে রয়েছে। সিরিজ প্লেলিস্ট সম্পর্কে আরও জানতে YouTube সহায়তা কেন্দ্র দেখুন।
    badRequest (400) subscriptionForbidden subscriptions.insert পদ্ধতিতে এই সমস্যার মেসেজ দেখানো হয়, এর অর্থ হল আপনি সর্বাধিক সংখ্যক সাবস্ক্রিপশন নিয়েছেন অথবা সম্প্রতি অনেক বেশি সাবস্ক্রিপশন তৈরি করেছেন। পরের ক্ষেত্রে, আপনি কয়েক ঘণ্টা পরে আবার অনুরোধ করতে পারবেন।
    badRequest (400) invalidCategoryId আপলোড করা video রিসোর্সের snippet.categoryId প্রপার্টিতে ভুল বিভাগ আইডি উল্লেখ করা হয়েছে তা বোঝাতে videos.update পদ্ধতি এই সমস্যাটি রিটার্ন করে। কাজ করে এমন বিভাগ ফিরিয়ে আনতে videoCategories.list পদ্ধতি ব্যবহার করুন।
    badRequest (400) invalidDescription videos.update পদ্ধতি এই সমস্যা দেখায়, যার অর্থ হল আপলোড করা video রিসোর্সের snippet.description প্রপার্টিতে ভুল ভ্যালু উল্লেখ করা হয়েছে।
    badRequest (400) invalidPublishAt আপলোড করা video রিসোর্সে নির্দিষ্ট করা status.publishAt প্রপার্টিতে ভুল শিডিউল করা প্রকাশনার সময় উল্লেখ করা হয়েছে তা বোঝাতে videos.update পদ্ধতি এই সমস্যাটি রিটার্ন করে।
    badRequest (400) invalidRecordingDetails videos.update পদ্ধতি এই ত্রুটি রিটার্ন করে এটি বোঝাতে যে আপলোড করা video রিসোর্সে recordingDetails অবজেক্ট ভুল রেকর্ডিং বিবরণ উল্লেখ করেছে।
    badRequest (400) invalidTags videos.update পদ্ধতি এই সমস্যা দেখায়, যার অর্থ হল আপলোড করা video রিসোর্সের snippet.tags প্রপার্টিতে ভুল ভ্যালু উল্লেখ করা হয়েছে।
    badRequest (400) invalidTitle videos.update পদ্ধতি এই সমস্যাটি রিটার্ন করে এটি বোঝাতে যে আপলোড করা video রিসোর্সের snippet.title প্রপার্টি একটি ভুল বা খালি ভিডিওর শীর্ষক নির্দিষ্ট করেছে।
    badRequest (400) invalidVideoMetadata অনুরোধের মেটাডেটা সঠিক না হলে, videos.update পদ্ধতি এই সমস্যাটি দেখায়। এই সমস্যাটি তখনই হয় যখন অনুরোধটি video রিসোর্সের snippet অংশটি আপডেট করে কিন্তু snippet.title ও snippet.categoryId প্রপার্টি দুটির কোনওটিরই ভ্যালু সেট করে না।

১৮ ডিসেম্বর, ২০১৫

ইউরোপীয় ইউনিয়নের (EU) আইন অনুসারে, ইউরোপীয় ইউনিয়নের ব্যবহারকারীদের নির্দিষ্ট কিছু ডিসক্লোজার দিতে হবে এবং তাদের থেকে সম্মতি নিতে হবে। তাই, ইউরোপীয় ইউনিয়নের ব্যবহারকারীদের ক্ষেত্রে আপনাকে ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে হবে। আমাদের YouTube API পরিষেবার শর্তাবলীতে এই প্রয়োজনীয়তা সংক্রান্ত বিজ্ঞপ্তি যোগ করা হয়েছে।

১৯ নভেম্বর, ২০১৫

API এখন playlist ও video রিসোর্সের snippet.title ও snippet.description প্রপার্টি, channelSection রিসোর্সের snippet.title প্রপার্টি এবং channel রিসোর্সের snippet.description প্রপার্টির জন্য স্থানীয় টেক্সট সেট ও রিট্রিভ করার সুবিধা দেয়।

  • স্থানীয় ভাষায় শীর্ষক ও বিবরণ সেট করা

    কোনও রিসোর্সের জন্য insert বা update পদ্ধতি কল করার সময় আপনি সেই রিসোর্সের জন্য লোকালাইজ করা ভ্যালু সেট করতে পারবেন। কোনও রিসোর্সের জন্য স্থানীয় মান সেট করতে, নিম্নলিখিত দুটি কাজই করুন:

    • রিসোর্সের snippet.defaultLanguage প্রপার্টির জন্য কোনও ভ্যালু সেট করা আছে কিনা তা নিশ্চিত করুন। এই প্রপার্টি রিসোর্সের snippet.title এবং snippet.description প্রপার্টির ভাষা শনাক্ত করে। এর ভ্যালু যেকোনও কাজ করে এমন অ্যাপ্লিকেশন ভাষা বা বেশিরভাগ অন্যান্য ISO 639-1:2002 ভাষা কোড হতে পারে। যেমন, আপনি যদি এমন কোনও ভিডিও আপলোড করেন যার নাম ও বিবরণ ইংরেজিতে লেখা, তাহলে আপনাকে snippet.defaultLanguage প্রপার্টি en হিসেবে সেট করতে হবে।

      channel রিসোর্স আপডেট করার জন্য নোট: channel রিসোর্সের জন্য snippet.defaultLanguage প্রপার্টি সেট করতে, আপনাকে আসলে brandingSettings.channel.defaultLanguage প্রপার্টি আপডেট করতে হবে।

    • আপনি যে রিসোর্স আপডেট করছেন তাতে localizations অবজেক্ট যোগ করুন। প্রতিটি অবজেক্ট কী হল একটি স্ট্রিং যা কোনও অ্যাপ্লিকেশন ভাষা বা ISO 639-1:2002 ভাষা কোড শনাক্ত করে এবং প্রতিটি কী এমন একটি অবজেক্টের সাথে ম্যাপ করে যাতে রিসোর্সের জন্য স্থানীয় ভাষায় লেখা শীর্ষক (ও বিবরণ) থাকে।

      নিচের স্যাম্পেল স্নিপেট রিসোর্সের ডিফল্ট ভাষা ইংরেজি হিসেবে সেট করে। এটি ভিডিওতে স্থানীয় জার্মান ও স্প্যানিশ শীর্ষক ও বিবরণ যোগ করে:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}

      • গুরুত্বপূর্ণ: মনে রাখবেন যে কোনও রিসোর্সের জন্য আপনি লোকালাইজ করা ডেটা আপডেট করলে, আপনার API অনুরোধে অবশ্যই ডেটার সবকটি বিদ্যমান লোকালাইজ করা ভার্সন অন্তর্ভুক্ত থাকতে হবে। যেমন, উপরের উদাহরণে ভিডিওতে পর্তুগিজ ডেটা যোগ করার জন্য আপনি পরবর্তী অনুরোধ পাঠালে, অনুরোধে জার্মান, স্প্যানিশ ও পর্তুগিজ ভাষার জন্য লোকালাইজ করা ডেটা অন্তর্ভুক্ত করতে হবে।

  • লোকালাইজ করা ভ্যালু ফিরিয়ে আনা হচ্ছে

    API-তে কোনও রিসোর্সের জন্য লোকালাইজ করা ভ্যালু পাওয়ার দুটি পদ্ধতি কাজ করে:

    • নির্দিষ্ট অ্যাপ্লিকেশন ভাষার জন্য লোকাল ডেটা পেতে, YouTube ওয়েবসাইট যে ভাষায় কাজ করে, আপনার channels.list, channelSections.list, playlists.list বা videos.list অনুরোধে hl প্যারামিটার যোগ করুন। সেই ভাষায় লোকালাইজ করা রিসোর্স বিবরণ উপলভ্য থাকলে, রিসোর্সের snippet.localized অবজেক্টে লোকালাইজ করা মান থাকবে। তবে, লোকালাইজ করা বিবরণ উপলভ্য না থাকলে, snippet.localized অবজেক্টে রিসোর্সের ডিফল্ট ভাষায় রিসোর্সের বিবরণ থাকবে।

      যেমন, ধরুন, videos.list অনুরোধের মাধ্যমে উপরে বর্ণিত ভিডিওর জন্য জার্মান ও স্প্যানিশ ভাষায় স্থানীয়করণ করা ডেটা পাওয়া গেছে। hl প্যারামিটার de হিসেবে সেট করা থাকলে, রিসোর্সে নিম্নলিখিত ডেটা থাকবে:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}

      তবে, hl প্যারামিটার fr হিসেবে সেট করা থাকলে, snippet.localized অবজেক্টে ইংরেজি শীর্ষক ও বিবরণ থাকবে কারণ রিসোর্সের ডিফল্ট ভাষা হল ইংরেজি এবং স্থানীয়করণ করা ফরাসি বিবরণ উপলভ্য নেই।

      গুরুত্বপূর্ণ: hl প্যারামিটারটি শুধুমাত্র সেইসব ভ্যালু সাপোর্ট করে যা YouTube ওয়েবসাইটে কাজ করে এমন অ্যাপ্লিকেশনের ভাষা শনাক্ত করে। অন্যান্য ভাষার জন্য স্থানীয়করণ করা টেক্সট উপলভ্য কিনা তা নির্ধারণ করতে, আপনাকে রিসোর্সের জন্য localizations অংশটি ফিরিয়ে আনতে হবে এবং স্থানীয়করণ করা টেক্সট আছে কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে।

      যেমন, অ্যাপালাচিয়ান ইংরেজিতে স্থানীয়করণ করা টেক্সট উপলভ্য কিনা তা নির্ধারণ করতে আপনাকে স্থানীয়করণের সম্পূর্ণ তালিকা ফিরিয়ে আনতে হবে।

    • কোনও রিসোর্স ফিরিয়ে আনার সময়, সেই রিসোর্সের সব লোকালাইজ করা বিবরণ ফিরিয়ে আনতে part প্যারামিটার ভ্যালুতে localizations অন্তর্ভুক্ত করুন। আপনি যদি এমন কোনও ভাষার জন্য লোকালাইজ করা ডেটা রিট্রিভ করেন যা বর্তমান YouTube অ্যাপ্লিকেশন ভাষা নয়, তাহলে আপনাকে সমস্ত লোকালাইজেশন রিট্রিভ করতে এই পদ্ধতি ব্যবহার করতে হবে এবং তারপরে কাঙ্ক্ষিত লোকালাইজ করা ডেটা আছে কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে।

  • লোকালাইজ করা টেক্সট ভ্যালু সম্পর্কিত সমস্যা

    এছাড়াও, API-তে লোকালাইজ করা টেক্সট ভ্যালুর জন্য নিম্নলিখিত নতুন সমস্যা কাজ করে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest (400) defaultLanguageNotSetError এই সমস্যা থেকে বোঝা যায় যে কোনও রিসোর্সের জন্য localizations অবজেক্ট যোগ বা আপডেট করার অনুরোধ ব্যর্থ হচ্ছে, কারণ সেই রিসোর্সের জন্য snippet.defaultLanguage প্রপার্টি সেট করা নেই। channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert এবং videos.update পদ্ধতি এই সমস্যার সমাধান করে।
    badRequest (400) localizationValidationError এই সমস্যার অর্থ হল, রিসোর্সের localizations অবজেক্টের কোনও একটি ভ্যালু যাচাই করা যায়নি। যেমন, অবজেক্টে ভুল ভাষা কোড থাকলে এই সমস্যা হতে পারে। channels.update, channelSections.insert, channelSections.update, playlists.insert ও playlists.update পদ্ধতি এই সমস্যার সমাধান করতে পারে।

৪ নভেম্বর, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • search.list মেথডের order প্যারামিটার আপডেট করা হয়েছে। এর মাধ্যমে এটি উল্লেখ করা হয়েছে যে আপনি যদি viewCount অনুযায়ী লাইভ ব্রডকাস্ট সাজান, তাহলে ব্রডকাস্ট চলাকালীন API ফলাফল ব্রডকাস্টের কনকারেন্ট দর্শকের সংখ্যা অনুযায়ী সাজানো হবে।

    • search.list পদ্ধতির relatedToVideoId প্যারামিটার আপডেট করা হয়েছে যাতে এটি উল্লেখ করা যায় যে প্যারামিটার সেট করা থাকলে, শুধুমাত্র অন্যান্য কাজ করে এমন প্যারামিটারগুলি হল part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (যেগুলি অবশ্যই video হিসেবে সেট করতে হবে) এবং fields। এই আপডেট API-এর আচরণে কোনও পরিবর্তন দেখায় না।

    • video রিসোর্সের snippet.publishedAt প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে উল্লেখ করা যায় যে প্রপার্টির ভ্যালু, যা ভিডিওটি প্রকাশ করার তারিখ ও সময় নির্দিষ্ট করে, সেটি ভিডিওটি আপলোড করার সময়ের থেকে আলাদা হতে পারে। যেমন, কোনও ভিডিও ব্যক্তিগত হিসেবে আপলোড করার পরে সেটি পরে সর্বজনীন করা হলে, প্রপার্টির ভ্যালু সেই সময়কে নির্দিষ্ট করে যখন ভিডিওটি সর্বজনীন করা হয়েছিল। আপডেট করা সংজ্ঞায় এটিও ব্যাখ্যা করা হয়েছে যে ব্যক্তিগত ও তালিকাভুক্ত নয় এমন ভিডিওর ক্ষেত্রে কীভাবে ভ্যালু পপুলেট করা হয়।

      এই পরিবর্তনের ফলে API-এর আচরণে কোনও পরিবর্তন হয় না।

    • video রিসোর্সের status.publishAt প্রপার্টির সংজ্ঞা আপডেট করে নিম্নলিখিত বিষয়গুলি যোগ করা হয়েছে:

      • videos.update পদ্ধতি কল করার সময় আপনি এই প্রপার্টির ভ্যালু সেট করলে, ভিডিওটি আগে থেকেই ব্যক্তিগত হিসেবে সেট করা থাকলেও আপনাকে অবশ্যই status.privacyStatus প্রপার্টির ভ্যালু private হিসেবে সেট করতে হবে।
      • অনুরোধে যদি কোনও ভিডিও অতীতে কোনও সময়ে প্রকাশ করার জন্য শিডিউল করা হয়, তাহলে সেটি এখনই প্রকাশ করা হবে। তাই, status.publishAt প্রপার্টিকে অতীতের কোনও তারিখ ও সময়ে সেট করার প্রভাব, ভিডিওর privacyStatus-কে private থেকে public-এ পরিবর্তন করার প্রভাবের মতোই।

    • video রিসোর্সের contentDetails.contentRating.cncRating প্রপার্টিতে ফ্রান্সের Commission de classification cinematographique-এর দেওয়া ভিডিওর রেটিং উল্লেখ করা হয়। এই প্রপার্টি contentDetails.contentRating.fmocRating প্রপার্টিকে প্রতিস্থাপন করে, যা এখন বন্ধ করা হয়েছে।

    • channel রিসোর্সের brandingSettings.channel.keywords-এর সংজ্ঞা আপডেট করা হয়েছে যাতে সঠিকভাবে বোঝা যায় যে প্রপার্টি ভ্যালুতে স্পেস দিয়ে আলাদা করা স্ট্রিংয়ের তালিকা রয়েছে, কমা দিয়ে আলাদা করা তালিকা নয়, যেমনটি আগে ডকুমেন্ট করা হয়েছিল। এই আপডেটের ফলে API-এর আচরণে কোনও পরিবর্তন হয় না।

    • thumbnails.set পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে যাতে সঠিকভাবে দেখানো যায় যে অনুরোধের বডিতে থাম্বনেল ছবি আছে যা আপনি আপলোড করছেন এবং ভিডিওর সাথে যুক্ত করছেন। অনুরোধের প্রধান অংশে thumbnail রিসোর্স নেই। আগে, ডকুমেন্টেশনে বলা হয়েছিল যে এই পদ্ধতি কল করার সময় আপনাকে অনুরোধের বডি প্রদান করতে হবে না। এই আপডেট API-এর আচরণে কোনও পরিবর্তন দেখায় না।

    • activity রিসোর্সের বিবরণ আপডেট করা হয়েছে যাতে এটি দেখানো যায় যে activities.list পদ্ধতিতে বর্তমানে নতুন ভিডিও কমেন্ট সংক্রান্ত রিসোর্স অন্তর্ভুক্ত নেই। রিসোর্সের snippet.type এবং contentDetails.comment-ও আপডেট করা হয়েছে।

  • নতুন ও আপডেট করা সমস্যা

    • API এখন নিম্নলিখিত সমস্যাগুলি সমাধান করতে পারে:

      সমস্যার বিবরণ
      activities.insert
      HTTP রেসপন্স কোডbadRequest (400)
      কারণinvalidMetadata
      বিবরণপ্রদান করা আইডির ধরনের সাথে kind প্রপার্টি মিলছে না।
      commentThreads.update
      comments.insert
      comments.update
      HTTP রেসপন্স কোডbadRequest (400)
      কারণcommentTextTooLong
      বিবরণযে comment রিসোর্স যোগ করা বা আপডেট করা হচ্ছে, তার snippet.topLevelComment.snippet.textOriginal প্রপার্টিতে অনেক বেশি অক্ষর রয়েছে।
      playlistItems.insert
      playlistItems.update
      HTTP রেসপন্স কোডforbidden (403)
      কারণplaylistItemsNotAccessible
      বিবরণনির্দিষ্ট প্লেলিস্ট আইটেম যোগ, আপডেট বা মুছে ফেলার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
      playlists.delete
      playlists.insert
      playlists.update
      HTTP রেসপন্স কোডbadRequest (400)
      কারণplaylistForbidden
      বিবরণএই অপারেশন নিষিদ্ধ অথবা অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
      search.list
      HTTP রেসপন্স কোডbadRequest (400)
      কারণinvalidLocation
      বিবরণlocation এবং/অথবা locationRadius প্যারামিটারের মান ভুলভাবে ফর্ম্যাট করা হয়েছে।
      search.list
      HTTP রেসপন্স কোডbadRequest (400)
      কারণinvalidRelevanceLanguage
      বিবরণrelevanceLanguage প্যারামিটারের ভ্যালু ভুলভাবে ফর্ম্যাট করা হয়েছে।
      subscriptions.insert
      HTTP রেসপন্স কোডbadRequest (400)
      কারণsubscriptionForbidden
      বিবরণ নিম্নলিখিত যেকোনও একটি শর্ত পূরণ হলে এই সমস্যা হয়:
      • আপনি যে সাবস্ক্রিপশন তৈরি করার চেষ্টা করছেন সেটি আগে থেকেই আছে
      • আপনি ইতিমধ্যেই সাবস্ক্রিপশনের সর্বাধিক সংখ্যায় পৌঁছে গেছেন
      • আপনি নিজের চ্যানেলে সাবস্ক্রাইব করার চেষ্টা করছেন, এটি কাজ করে না।
      • আপনি সম্প্রতি অনেক সাবস্ক্রিপশন তৈরি করেছেন এবং অনুরোধটি আবার করার আগে আপনাকে কয়েক ঘণ্টা অপেক্ষা করতে হবে।
      videos.update
      HTTP রেসপন্স কোডbadRequest (400)
      কারণinvalidDefaultBroadcastPrivacySetting
      বিবরণঅনুরোধটি ডিফল্ট ব্রডকাস্টের জন্য একটি ভুল গোপনীয়তা সেটিং সেট করার চেষ্টা করে।

২৮ আগস্ট, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • video রিসোর্সের statistics.favoriteCount প্রপার্টি বন্ধ করা হয়েছে।

      আমাদের ডেপ্রিকেশন নীতি অনুযায়ী, এই ঘোষণার পরে অন্তত এক বছর ধরে এই প্রপার্টি video রিসোর্সে অন্তর্ভুক্ত থাকবে। তবে, প্রপার্টির ভ্যালু এখন সবসময় 0-এ সেট করা থাকে।

৭ আগস্ট, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • API সার্ভার কীভাবে প্রপার্টির ভ্যালুর দৈর্ঘ্য গণনা করে সেই সম্পর্কে আরও তথ্য প্রদান করতে video রিসোর্সের snippet.tags[] প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে। মনে রাখবেন, এই আপডেটের ফলে API-এর আচরণে কোনও পরিবর্তন হয় না।

      বিশেষত, সংজ্ঞাটি এখন ব্যাখ্যা করে যে কোনও ট্যাগে স্পেস থাকলে, API সার্ভার ট্যাগ ভ্যালুকে এমনভাবে ম্যানেজ করে যেন সেটি কোটেশন চিহ্নের মধ্যে মোড়ানো আছে এবং কোটেশন চিহ্নগুলি অক্ষর সীমার মধ্যে গণনা করা হয়। তাই, অক্ষর সীমার ক্ষেত্রে, Foo-Baz ট্যাগে সাতটি অক্ষর আছে, কিন্তু Foo Baz ট্যাগে নয়টি অক্ষর আছে।

    • commentThreads.insert পদ্ধতিতে আর shareOnGooglePlus প্যারামিটার কাজ করে না, যা আগে কোনও কমেন্ট এবং সেই কমেন্টের উত্তর লেখকের Google+ প্রোফাইলেও পোস্ট করা উচিত কিনা তা নির্দেশ করত। কোনও অনুরোধ প্যারামিটার জমা দিলে, API সার্ভার প্যারামিটারটি উপেক্ষা করে কিন্তু অন্যথায় অনুরোধটি ম্যানেজ করে।

১৮ জুন, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • commentThreads.list পদ্ধতির নতুন order প্যারামিটার নির্দিষ্ট করে যে API উত্তরকে কোন ক্রমে কমেন্ট থ্রেড তালিকাভুক্ত করতে হবে। থ্রেড সময় বা প্রাসঙ্গিকতা অনুযায়ী সাজানো যেতে পারে। ডিফল্ট অ্যাকশন হল সময় অনুযায়ী সেগুলি সাজানো।

    • video রিসোর্সের নতুন snippet.defaultAudioLanguage প্রপার্টি ভিডিওর ডিফল্ট অডিও ট্র্যাকে বলা ভাষা নির্দিষ্ট করে।

    • video রিসোর্সের contentDetails.licensedContent প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে এটি স্পষ্ট হয় যে কন্টেন্টটি প্রথমে YouTube কন্টেন্ট পার্টনারের সাথে লিঙ্ক করা চ্যানেলে আপলোড করতে হবে এবং তারপর সেই পার্টনারকে দাবি করতে হবে। এর ফলে API-এর আচরণে কোনও পরিবর্তন হয় না।

    • captions.delete, captions.download, captions.insert, captions.list এবং captions.update পদ্ধতি এখন onBehalfOfContentOwner প্যারামিটারকে সাপোর্ট করে, যা আগে থেকেই অন্যান্য বেশ কিছু পদ্ধতির জন্য কাজ করে। যেসব অনুরোধ এই পদ্ধতি ব্যবহার করে সেগুলিকে https://www.googleapis.com/auth/youtubepartner স্কোপে অ্যাক্সেস প্রদানকারী টোকেন দিয়েও অনুমোদন করতে হবে।

  • নতুন ও আপডেট করা সমস্যা

    • API এখন নিম্নলিখিত সমস্যাগুলি সমাধান করতে পারে:

      সমস্যার বিবরণ
      videos.rate
      HTTP রেসপন্স কোডbadRequest (400)
      কারণemailNotVerified
      বিবরণভিডিও রেটিং দেওয়ার আগে ব্যবহারকারীকে তার ইমেল আইডি যাচাই করতে হবে।
      videos.rate
      HTTP রেসপন্স কোডbadRequest (400)
      কারণvideoPurchaseRequired
      বিবরণযেসব ব্যবহারকারী ভিডিও ভাড়া নিয়েছেন, শুধুমাত্র তারাই ভাড়া নেওয়া ভিডিওতে রেটিং দিতে পারবেন।

    • subscriptions.delete এবং subscriptions.insert পদ্ধতিতে accountClosed এবং accountSuspended সমস্যা আর কাজ করে না।

২৭ এপ্রিল, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন রিসোর্স ও পদ্ধতি

    • নতুন videoAbuseReportReason রিসোর্সে এমন একটি কারণ সম্পর্কে তথ্য রয়েছে যার জন্য আপত্তিজনক কন্টেন্ট থাকার কারণে একটি ভিডিও ফ্ল্যাগ করা হবে। videoAbuseReportReasons.list পদ্ধতির মাধ্যমে আপনি ভিডিও ফ্ল্যাগ করার সব কারণের তালিকা পেতে পারেন।

    • নতুন videos.reportAbuse পদ্ধতিটি এমন একটি উপায় প্রদান করে যা আসলে আপত্তিজনক কন্টেন্ট সহ একটি ভিডিও ফ্ল্যাগ করে। অনুরোধের বডিতে একটি JSON অবজেক্ট থাকে যা ফ্ল্যাগ করা ভিডিও এবং ভিডিওতে আপত্তিজনক কন্টেন্ট থাকার কারণ নির্দিষ্ট করে। videoAbuseReportReason.list উপরে বর্ণিত পদ্ধতি থেকে বৈধ কারণ পাওয়া যেতে পারে।

      এছাড়াও, মাইগ্রেশন গাইড-এ অপব্যবহারমূলক ভিডিওর ব্যাপারে অভিযোগ জানানোর উদাহরণ সহ আপডেট করা হয়েছে। এই পরিবর্তনের ফলে, v3 API এখন v2 API-এর সেইসব ফিচার সাপোর্ট করে যা এটি সাপোর্ট করার জন্য শিডিউল করা হয়েছে। এইসব ফিচার মাইগ্রেশন গাইডেও ব্যাখ্যা করা হয়েছে।

  • আগে থেকে থাকা রিসোর্স ও পদ্ধতিতে আপডেট

    • search.list পদ্ধতির নতুন forDeveloper ফিল্টার প্যারামিটার, সার্চকে শুধুমাত্র ডেভেলপারের অ্যাপ্লিকেশন বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিও ফিরিয়ে আনার জন্য সীমাবদ্ধ করে। forDeveloper প্যারামিটারটি q প্যারামিটারের মতো ঐচ্ছিক সার্চ প্যারামিটারের সাথে একসাথে ব্যবহার করা যেতে পারে।

      এই ফিচারের জন্য, আপলোড করা প্রতিটি ভিডিওতে অটোমেটিক প্রোজেক্ট নম্বর ট্যাগ করা হয় যা Google Developers Console-এ ডেভেলপারের অ্যাপ্লিকেশনের সাথে যুক্ত থাকে।

      পরবর্তীকালে, কোনও সার্চ অনুরোধ forDeveloper প্যারামিটারকে true হিসেবে সেট করলে, API সার্ভার ডেভেলপারকে শনাক্ত করার জন্য অনুরোধের অনুমোদন সংক্রান্ত ক্রেডেনশিয়াল ব্যবহার করে। তাই, কোনও ডেভেলপার তার নিজের অ্যাপ বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওর ফলাফল সীমাবদ্ধ করতে পারেন, তবে অন্য অ্যাপ বা সাইটের মাধ্যমে আপলোড করা ভিডিওর ফলাফল সীমাবদ্ধ করতে পারেন না।

      নতুন ফিচারটি v2 API-তে কাজ করা ডেভেলপার ট্যাগ কার্যকারিতার মতো একই রকম কার্যকারিতা অফার করে, যদিও এটি অভিন্ন নয়।

    • channel রিসোর্সের নতুন snippet.country প্রপার্টি চ্যানেল মালিকদের তাদের চ্যানেলকে একটি নির্দিষ্ট দেশের সাথে যুক্ত করতে দেয়।

      মনে রাখবেন: channel রিসোর্সের জন্য snippet.country প্রপার্টি সেট করতে, আপনাকে আসলে brandingSettings.channel.country প্রপার্টি আপডেট করতে হবে।

    • API এখন channelSection রিসোর্সের জন্য টার্গেটিং সাপোর্ট করে। চ্যানেল বিভাগ টার্গেট করার মাধ্যমে নির্দিষ্ট শর্ত পূরণকারী ব্যবহারকারীদের কাছে কন্টেন্ট বিভাগের দৃশ্যমানতা সীমিত করা যায়।

      API তিনটি টার্গেটিং বিকল্প দেখায়। চ্যানেল বিভাগ দৃশ্যমান হতে হলে ব্যবহারকারীকে টার্গেটিং সংক্রান্ত সব সেটিংস পূরণ করতে হবে।

      • targeting.languages[]: YouTube অ্যাপ্লিকেশনের ভাষার তালিকা। যেসব ব্যবহারকারী সেইসব ভাষার মধ্যে একটি বেছে নিয়েছেন, তারা সংশ্লিষ্ট চ্যানেল বিভাগ দেখতে পাবেন।

      • targeting.regions[]: YouTube-এর পছন্দসই কন্টেন্ট অঞ্চলের তালিকা। যেসব ব্যবহারকারী এই অঞ্চলগুলির মধ্যে কোনও একটি বেছে নিয়েছেন এবং যেসব ব্যবহারকারীর জন্য এই অঞ্চলগুলির মধ্যে কোনও একটি অটোমেটিক বেছে নেওয়া হয়েছে, তারা এই চ্যানেল বিভাগ দেখতে পাবেন।

      • targeting.countries[]: যেসব দেশে চ্যানেল বিভাগ দেখা যায়, সেগুলির তালিকা। তালিকার প্রতিটি ভ্যালু হল একটি ISO 3166-1 alpha-2 দেশের কোড।

    • video রিসোর্সের contentDetails.duration প্রপার্টির সংজ্ঞা সংশোধন করা হয়েছে যাতে বোঝা যায় যে ভ্যালু ঘণ্টা, দিন এবং আরও অনেক কিছু দেখাতে পারে।

    • channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete এবং videos.delete পদ্ধতির ডকুমেন্টেশন সংশোধন করা হয়েছে যাতে বোঝা যায় যে, সফল হলে, সেই সমস্ত পদ্ধতি একটি HTTP 204 রেসপন্স কোড (No Content) রিটার্ন করে।

  • নতুন ও আপডেট করা সমস্যা

    • API এখন নিম্নলিখিত সমস্যার ক্ষেত্রে কাজ করে:

      সমস্যার ধরন সমস্যার বিবরণ বিবরণ
      badRequest (400) targetInvalidCountry ইনসার্ট করা channelSection রিসোর্সে targeting.countries[] প্রপার্টির জন্য ভুল মান থাকলে, channelSections.insert ও channelSections.update পদ্ধতি এই সমস্যাটি দেখায়।
      badRequest (400) targetInvalidLanguage যোগ করা channelSection রিসোর্সে targeting.languages[] প্রপার্টির জন্য ভুল ভ্যালু থাকলে, channelSections.insert এবং channelSections.update পদ্ধতি এই সমস্যা দেখায়।
      badRequest (400) targetInvalidRegion যোগ করা channelSection রিসোর্সে targeting.regions[] প্রপার্টির জন্য ভুল ভ্যালু থাকলে, channelSections.insert এবং channelSections.update পদ্ধতি এই সমস্যা দেখায়।
      badRequest (400) operationNotSupported snippet.parentId প্রপার্টি দ্বারা শনাক্ত করা টপ-লেভেল কমেন্টের উত্তরে API ব্যবহারকারী কমেন্ট যোগ করতে না পারলে, comments.insert পদ্ধতি এই সমস্যার কথা জানায়। commentThread রিসোর্সে, snippet.canReply প্রপার্টি থেকে বোঝা যায় যে বর্তমান দর্শক থ্রেডে উত্তর দিতে পারবেন কিনা।
      badRequest (400) invalidChannelId অনুরোধের channelId প্যারামিটারে ভুল চ্যানেল আইডি উল্লেখ করা থাকলে, search.list পদ্ধতিতে এই সমস্যাটি দেখানো হয়।
      badRequest (400) subscriptionForbidden API ব্যবহারকারী নিজের চ্যানেলে সাবস্ক্রাইব করার চেষ্টা করলে subscriptions.insert পদ্ধতি এই সমস্যার মেসেজ দেখায়।

    • captions.update পদ্ধতিতে আর invalidMetadata এবং videoNotFound সমস্যা দেখা যায় না।

১৬ এপ্রিল, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • v2 API থেকে এখনও কমেন্ট কার্যকারিতা ব্যবহার করা অ্যাপ্লিকেশনগুলি কীভাবে মাইগ্রেট করা যায় তা ব্যাখ্যা করার জন্য মাইগ্রেশন গাইড আপডেট করা হয়েছে।

    এছাড়াও, এই নির্দেশিকায় বেশ কিছু কমেন্টিং ফিচারের কথা বলা হয়েছে যেগুলি v2 API-তে কাজ করত না, কিন্তু v3 API-তে কাজ করে। এর মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত:

    • কোনও চ্যানেল সম্পর্কে কমেন্ট রিট্রিভ করা
    • কোনও চ্যানেলের সাথে সম্পর্কিত সব কমেন্ট থ্রেড ফিরিয়ে আনা, যার অর্থ হল API রেসপন্সে চ্যানেল বা এর যেকোনও ভিডিও সম্পর্কে কমেন্ট থাকতে পারে।
    • কোনও কমেন্টের টেক্সট আপডেট করা
    • কোনও কমেন্টকে স্প্যাম হিসেবে চিহ্নিত করা
    • কমেন্টের মডারেশন স্ট্যাটাস সেট করা

  • পুশ বিজ্ঞপ্তি সাবস্ক্রাইব করা সংক্রান্ত নির্দেশিকা আপডেট করা হয়েছে। এর ফলে, বিজ্ঞপ্তি শুধুমাত্র Google PubSubHubBub হাবে পুশ করা হয় এবং আগে যেমন বলা হয়েছিল, Superfeedr হাবেও পুশ করা হয় না।

৯ এপ্রিল, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • API-এর নতুন commentThread এবং comment রিসোর্স আপনাকে কমেন্ট ফিরিয়ে আনতে, যোগ করতে, আপডেট করতে, মুছে ফেলতে এবং মডারেট করতে দেয়।

    • commentThread রিসোর্সে YouTube কমেন্ট থ্রেড সম্পর্কে তথ্য থাকে, যার মধ্যে টপ-লেভেল কমেন্ট এবং সেই কমেন্টের উত্তর (যদি থাকে) অন্তর্ভুক্ত থাকে। commentThread রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে কমেন্ট দেখাতে পারে।

      টপ-লেভেল কমেন্ট ও উত্তর আসলে comment রিসোর্স যা commentThread রিসোর্সের মধ্যে নেস্ট করা থাকে। এটি মনে রাখা গুরুত্বপূর্ণ যে commentThread রিসোর্সে কোনও কমেন্টের সব উত্তর নাও থাকতে পারে এবং আপনি যদি কোনও নির্দিষ্ট কমেন্টের সব উত্তর পেতে চান, তাহলে আপনাকে comments.list পদ্ধতি ব্যবহার করতে হবে। এছাড়াও, কিছু কমেন্টের কোনও উত্তর নেই।

      API-তে commentThread রিসোর্সের জন্য নিম্নলিখিত পদ্ধতি কাজ করে:

      • commentThreads.list – কমেন্ট থ্রেডের তালিকা ফিরিয়ে আনুন। কোনও নির্দিষ্ট ভিডিও বা চ্যানেলের সাথে যুক্ত কমেন্ট খুঁজে পেতে এই পদ্ধতি ব্যবহার করুন।
      • commentThreads.insert – নতুন টপ-লেভেল কমেন্ট তৈরি করুন। (আগে থেকে থাকা কমেন্টের উত্তর দিতে comments.insert পদ্ধতি ব্যবহার করুন।)
      • commentThreads.update – টপ-লেভেল কমেন্ট পরিবর্তন করুন।

    • comment রিসোর্সে একটি YouTube কমেন্ট সম্পর্কে তথ্য থাকে। comment রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে করা কমেন্টকে বোঝাতে পারে। এছাড়াও, কমেন্টটি টপ-লেভেল কমেন্ট হতে পারে অথবা টপ-লেভেল কমেন্টের উত্তর হতে পারে।

      API-তে comment রিসোর্সের জন্য নিম্নলিখিত পদ্ধতি কাজ করে:

      • comments.list – কমেন্টের তালিকা ফিরিয়ে আনুন। কোনও নির্দিষ্ট কমেন্টের সব উত্তর পেতে এই পদ্ধতি ব্যবহার করুন।
      • comments.insert – আগে থেকে থাকা কমেন্টের উত্তর তৈরি করুন।
      • comments.update – কমেন্ট পরিবর্তন করুন।
      • comments.markAsSpam – এক বা একাধিক কমেন্ট স্প্যাম হিসেবে ফ্ল্যাগ করুন।
      • comments.setModerationStatus – এক বা একাধিক কমেন্টের মডারেশন স্ট্যাটাস সেট করুন। যেমন, সর্বজনীনভাবে দেখানোর জন্য কোনও কমেন্ট অনুমোদন করা অথবা দেখানোর অনুপযুক্ত হিসেবে কোনও কমেন্ট বাতিল করা। কমেন্টের সাথে যুক্ত চ্যানেল বা ভিডিওর মালিকের থেকে API অনুরোধ অনুমোদিত হতে হবে।
      • comments.delete – কোনও কমেন্ট মুছে দিন।

    মনে রাখবেন, comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert ও commentThreads.update মেথডে কল করার জন্য API-এর নতুন https://www.googleapis.com/auth/youtube.force-ssl স্কোপ প্রয়োজন, যা ২ এপ্রিল, ২০১৫-এর রিভিশন ইতিহাসে বর্ণনা করা হয়েছে।

  • নতুন পুশ বিজ্ঞপ্তি সাবস্ক্রাইব করা গাইড, PubSubHubBub-এর মাধ্যমে পুশ বিজ্ঞপ্তির জন্য API-এর নতুন সহায়তা ব্যাখ্যা করে, এটি হল ওয়েব-অ্যাক্সেসযোগ্য রিসোর্সের জন্য সার্ভার-টু-সার্ভার প্রকাশ/সাবস্ক্রাইব প্রোটোকল। কোনও চ্যানেল নিম্নলিখিত অ্যাক্টিভিটির মধ্যে যেকোনও একটি করলে, আপনার PubSubHubBub কলব্যাক সার্ভার Atom ফিড বিজ্ঞপ্তি পেতে পারে:

    • ভিডিও আপলোড করে
    • ভিডিওর শীর্ষক আপডেট করে
    • ভিডিওর বিবরণ আপডেট করে

  • পুশ বিজ্ঞপ্তির জন্য নতুন সহায়তা নোট করতে মাইগ্রেশন গাইডও আপডেট করা হয়েছে। তবে, v2 API-তে আরও অনেক ধরনের পুশ বিজ্ঞপ্তি কাজ করে যা v3 API-তে কাজ করে না, তাই PubSubHubBub-এর উল্লেখ এখনও সেই গাইডের বন্ধ হয়ে গেছে বিভাগে তালিকাভুক্ত করা আছে।

  • API-এর নতুন https://www.googleapis.com/auth/youtube.force-ssl স্কোপ এখন যেকোনও API পদ্ধতির জন্য একটি বৈধ স্কোপ যা আগে https://www.googleapis.com/auth/youtube স্কোপকে সাপোর্ট করত।

  • API এখন নিম্নলিখিত সমস্যার ক্ষেত্রে কাজ করে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest (400) invalidRating অনুরোধে rating প্যারামিটারের জন্য অপ্রত্যাশিত ভ্যালু থাকলে, videos.rate পদ্ধতি এই সমস্যা দেখায়।

  • subscriptions.insert পদ্ধতিতে আর subscriptionLimitExceeded সমস্যাটি দেখানো হয় না, আগে এটি থেকে বোঝা যেত যে অনুরোধে চিহ্নিত সাবস্ক্রাইবার সাবস্ক্রিপশন রেট সীমা অতিক্রম করেছেন।

২ এপ্রিল, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • নতুন captions রিসোর্স YouTube ক্যাপশন ট্র্যাককে বোঝায়। ক্যাপশন ট্র্যাক ঠিক একটি YouTube ভিডিওর সাথে যুক্ত থাকে।

    API-তে ক্যাপশন ট্র্যাক তালিকাভুক্ত করা, যোগ করা, আপডেট করা, ডাউনলোড করা এবং মুছে ফেলার পদ্ধতি রয়েছে।

  • v2 API-তে এখনও ক্যাপশন ফাংশনালিটি ব্যবহার করা অ্যাপ্লিকেশন কীভাবে মাইগ্রেট করতে হবে তা ব্যাখ্যা করার জন্য মাইগ্রেশন গাইড আপডেট করা হয়েছে।

  • API-এর নতুন https://www.googleapis.com/auth/youtube.force-ssl স্কোপের জন্য SSL কানেকশনের মাধ্যমে API সার্ভারের সাথে যোগাযোগ করতে হবে।

    এই নতুন স্কোপ https://www.googleapis.com/auth/youtube স্কোপের মতো একই অ্যাক্সেস প্রদান করে। এবং, আসলে, সেই দুটি স্কোপ কার্যকারিতার দিক থেকে অভিন্ন কারণ YouTube API সার্ভার শুধুমাত্র একটি HTTPS এন্ডপয়েন্টের মাধ্যমে উপলভ্য। এর ফলে, https://www.googleapis.com/auth/youtube স্কোপে SSL কানেকশনের প্রয়োজন না থাকলেও, API অনুরোধ করার আর কোনও উপায় নেই।

    caption রিসোর্সের সব পদ্ধতিতে কল করার জন্য নতুন স্কোপ প্রয়োজন।

১১ মার্চ, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • YouTube Data API (v3) মাইগ্রেশন গাইডে একটি নতুন ট্যাব আছে, যার নাম v3 API-তে নতুন, এতে v3 API-তে কাজ করে এবং v2 API-তে কাজ করে না এমন ফিচারের তালিকা আছে। একই ফিচার আগে এবং এখনও গাইডের অন্যান্য ট্যাবে তালিকাভুক্ত করা আছে। যেমন, চ্যানেলের ইন-ভিডিও প্রোমোশনাল ক্যাম্পেন ডেটা কীভাবে আপডেট করতে হয় তা ব্যাখ্যা করা নতুন ফিচারটি চ্যানেল (প্রোফাইল) ট্যাবেও তালিকাভুক্ত করা আছে।

  • YouTube Data API (v3) মাইগ্রেশন গাইড আপডেট করা হয়েছে এবং এতে উল্লেখ করা হয়েছে যে v3 API নিম্নলিখিত v2 API ফিচারকে সাপোর্ট করবে:

  • YouTube Data API (v3) মাইগ্রেশন গাইড আপডেট করা হয়েছে এবং সেখানে উল্লেখ করা হয়েছে যে v3 API-তে নিম্নলিখিত v2 API ফিচার কাজ করবে না:

    • ভিডিও সাজেশন ফিরিয়ে আনা – v3 API এমন কোনও তালিকা ফিরিয়ে আনে না যাতে শুধু বর্তমান API ব্যবহারকারীর জন্য সাজেস্ট করা ভিডিও থাকে। তবে, আপনি activities.list পদ্ধতি কল করে এবং home প্যারামিটারের ভ্যালু true হিসেবে সেট করে সাজেস্ট করা ভিডিও খুঁজে পেতে v3 API ব্যবহার করতে পারেন।

      API রেসপন্সে, snippet.type প্রপার্টির ভ্যালু recommendation হলে, রিসোর্সটি সাজেস্ট করা ভিডিওর সাথে সম্পর্কিত। সেক্ষেত্রে, contentDetails.recommendation.reason এবং contentDetails.recommendation.seedResourceId প্রপার্টিতে ভিডিওটি কেন সাজেস্ট করা হয়েছে সেই সম্পর্কে তথ্য থাকবে। মনে রাখবেন, উত্তরে নির্দিষ্ট সংখ্যক সাজেস্ট করা ভিডিও থাকবে এমন কোনও গ্যারেন্টি নেই।

    • চ্যানেল সাজেশন ফিরিয়ে আনা

    • নতুন সাবস্ক্রিপশন ভিডিও ফিরিয়ে আনা – v3 API এমন কোনও তালিকা ফিরিয়ে আনে না যাতে শুধু API ব্যবহারকারীর সাবস্ক্রাইব করা চ্যানেলে সম্প্রতি আপলোড করা ভিডিও থাকে। তবে, আপনি v3 API ব্যবহার করে activities.list পদ্ধতি কল করে এবং home প্যারামিটারের মান true-এ সেট করে নতুন সাবস্ক্রিপশন ভিডিও খুঁজে পেতে পারেন।

      API-এর উত্তরে, কোনও রিসোর্স নতুন সাবস্ক্রিপশন ভিডিওর সাথে সম্পর্কিত হয়, যদি snippet.type প্রপার্টির ভ্যালু upload হয়। মনে রাখবেন, উত্তরে নির্দিষ্ট সংখ্যক নতুন সাবস্ক্রিপশন ভিডিও থাকবে এমন কোনও গ্যারেন্টি নেই।

    • RSS ফিড সংক্রান্ত সহায়তা

    • ফিড আপডেট সংক্রান্ত পুশ বিজ্ঞপ্তি – v2 API, YouTube ব্যবহারকারীদের জন্য ব্যবহারকারীর অ্যাক্টিভিটি ফিড মনিটর করতে, Simple Update Protocol (SUP) বা PubSubHubbub ব্যবহার করে পুশ বিজ্ঞপ্তি কাজ করে। নতুন চ্যানেল সাবস্ক্রিপশন এবং ভিডিও রেট, শেয়ার, ফেভারিট হিসেবে চিহ্নিত, কমেন্ট বা আপলোড করা হলে বিজ্ঞপ্তি পাঠানো হত।

      v3 API PubSubHubbub প্রোটোকল ব্যবহার করে পুশ বিজ্ঞপ্তি পাঠাতে পারবে, তবে বিজ্ঞপ্তিগুলি শুধুমাত্র ভিডিও আপলোড এবং ভিডিওর নাম বা ভিডিওর বিবরণের আপডেটের মধ্যেই সীমাবদ্ধ থাকবে।

    • চ্যানেলের লোকেশন – চ্যানেলের YouTube পাবলিক প্রোফাইলে ব্যবহারকারীর লোকেশন শনাক্ত করতে v2 API <yt:location> ট্যাগ ব্যবহার করে। কিছু ডেভেলপার এই ফিল্ডটি কোনও চ্যানেলকে নির্দিষ্ট দেশের সাথে যুক্ত করার জন্য ব্যবহার করলেও, ফিল্ডের ডেটা সেই উদ্দেশ্যে ধারাবাহিকভাবে ব্যবহার করা যায়নি।

    • ডেভেলপার ট্যাগ সেট বা ফিরিয়ে আনা – v2 API-তে ভিডিও আপলোড করার সময় সেটির সাথে কীওয়ার্ড বা ডেভেলপার ট্যাগ যোগ করার সুবিধা ছিল। ডেভেলপার ট্যাগ YouTube ব্যবহারকারীদের দেখানো হবে না, তবে ভিডিওর মালিকরা নির্দিষ্ট ডেভেলপার ট্যাগের সাথে মিলে যাওয়া ভিডিওগুলি খুঁজে পেতে পারেন।

      v3 API একই ধরনের ফিচার প্রদান করবে, তবে তা অভিন্ন নয়। বিশেষত, কোনও ডেভেলপার তার নিজের অ্যাপ্লিকেশনের মাধ্যমে আপলোড করা ভিডিও সার্চ করতে পারবেন। এই ফিচারের জন্য, আপলোড করা প্রতিটি ভিডিওতে অটোমেটিক প্রোজেক্ট নম্বর ট্যাগ করা হয় যা Google Developers Console-এ ডেভেলপারের অ্যাপ্লিকেশনের সাথে যুক্ত থাকে। তারপরে, ডেভেলপার ভিডিও সার্চ করার জন্য একই প্রোজেক্ট নম্বর ব্যবহার করেন।

    • প্রকাশের তারিখ, ভিউয়ের সংখ্যা বা রেটিং অনুযায়ী ভিডিওর তালিকা – v2 API-তে, orderby প্যারামিটার আপনাকে প্লেলিস্টে থাকা ভিডিওগুলি অবস্থান, সময়সীমা, প্রকাশের তারিখ, শীর্ষক এবং অন্যান্য বেশ কয়েকটি মান অনুযায়ী সাজাতে দেয়। v3 API-তে, প্লেলিস্ট আইটেম সাধারণত ছোট থেকে বড় ক্রম অনুসারে সাজানো হয় এবং সাজানোর অন্যান্য বিকল্প উপলভ্য থাকে না।

      তবে এর কিছু ব্যতিক্রম আছে। নিচের ধরনের প্লেলিস্টের জন্য নতুন আপলোড করা, পছন্দের, লাইক করা বা সম্প্রতি দেখা ভিডিও অটোমেটিক প্রথম আইটেম (snippet.position=0) হিসেবে যোগ করা হয়। তাই, এই তালিকাগুলির প্রতিটি আইটেম যোগ করার সময়ের ভিত্তিতে নতুন থেকে পুরনো আইটেম হিসেবে সাজানো হয়।

      • ব্যবহারকারীর আপলোড করা কন্টেন্ট
      • পছন্দসই ভিডিও
      • পছন্দ করা ভিডিওগুলি
      • ইতিহাস দেখুন

      তবে মনে রাখবেন, "পরে দেখুন" প্লেলিস্টে নতুন আইটেম যোগ করা হলে, সেটি তালিকার শেষে যোগ করা হয়, তাই সেই তালিকাটি কার্যকরভাবে সবচেয়ে পুরনো থেকে নতুন আইটেম হিসেবে সাজানো হয়।

    • ব্যাচ প্রসেসিং – v2 API-তে ব্যাচ প্রসেসিংয়ের যেসব সুবিধা ছিল, v3 API-তে তার মধ্যে একটি সুবিধা পাওয়া যায়। v3 API-এর channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list এবং videos.list পদ্ধতিগুলি সবই একটি id প্যারামিটারকে সমর্থন করে, যা আইডিগুলির (ভিডিও আইডি, চ্যানেল আইডি ইত্যাদি) কমা-সীমাবদ্ধ তালিকা নির্দিষ্ট করতে ব্যবহার করা যেতে পারে। এইসব পদ্ধতি ব্যবহার করে, আপনি একটি অনুরোধের মাধ্যমে একাধিক রিসোর্সের তালিকা পেতে পারেন।

    এইসব পরিবর্তনের মাধ্যমে, গাইড এখন পুরনো (v2) API-তে কাজ করে এমন সব কার্যকারিতা শনাক্ত করে যা বর্তমান API ভার্সনে (v3) বন্ধ হয়ে যাবে।

৪ মার্চ, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • channelSections.delete এবং channelSections.update পদ্ধতিতে এখন onBehalfOfContentOwner প্যারামিটার কাজ করে, যা আগে থেকেই আরও অনেক পদ্ধতির ক্ষেত্রে কাজ করে।

  • নিম্নলিখিত প্রপার্টি ও সেগুলির চাইল্ড প্রপার্টি বন্ধ করে দেওয়া হয়েছে:

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    মনে রাখবেন: এই প্রপার্টিগুলির কোনওটিই API শীঘ্রই বন্ধ করা সংক্রান্ত নীতির আওতাভুক্ত নয়।

  • video রিসোর্সের নতুন contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons প্রপার্টি সেইসব কারণ শনাক্ত করে যা ব্যাখ্যা করে যে কেন ভিডিওটি DJCQT (ব্রাজিল) রেটিং পেয়েছে।

  • API এখন নিম্নলিখিত সমস্যাগুলি সমাধান করতে পারে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    notFound (404) channelNotFound অনুরোধের id প্যারামিটার এমন কোনও চ্যানেল নির্দিষ্ট করলে যা খুঁজে পাওয়া যায় না, তাহলে channels.update পদ্ধতি এই সমস্যাটি রিটার্ন করে।
    badRequest (400) manualSortRequiredinvalidValue অনুরোধে প্লেলিস্ট আইটেমের পজিশন সেট করার চেষ্টা করা হলে, কিন্তু প্লেলিস্টে ম্যানুয়াল সর্টিং ব্যবহার করা না হলে, playlistItems.insert এবং playlistItems.update পদ্ধতি এই সমস্যা দেখায়। যেমন, প্লেলিস্টের আইটেম তারিখ বা জনপ্রিয়তার ভিত্তিতে সাজানো হতে পারে। অনুরোধের বডিতে পাঠানো রিসোর্স থেকে snippet.position এলিমেন্ট সরিয়ে দিয়ে আপনি এই সমস্যার সমাধান করতে পারবেন। আপনি যদি চান যে প্লেলিস্ট আইটেমটি তালিকায় একটি নির্দিষ্ট অবস্থানে থাকুক, তাহলে আপনাকে প্রথমে প্লেলিস্টের ক্রম সেটিং আপডেট করে ম্যানুয়াল করতে হবে। YouTube ভিডিও ম্যানেজার থেকে এই সেটিং অ্যাডজাস্ট করা যাবে।
    forbidden (403) channelClosed অনুরোধের channelId প্যারামিটার যদি এমন কোনও চ্যানেল নির্দিষ্ট করে যা বন্ধ করে দেওয়া হয়েছে, তাহলে playlists.list পদ্ধতি এই সমস্যাটি দেখায়।
    forbidden (403) channelSuspended অনুরোধের channelId প্যারামিটার যদি সাসপেন্ড করা কোনও চ্যানেলকে নির্দিষ্ট করে, তাহলে playlists.list পদ্ধতি এই সমস্যাটি রিটার্ন করে।
    forbidden (403) playlistForbidden অনুরোধের id প্যারামিটার অনুরোধটি সমর্থন না করলে বা অনুরোধটি সঠিকভাবে অনুমোদিত না হলে playlists.list পদ্ধতিটি এই ত্রুটিটি ফেরত দেয়।
    notFound (404) channelNotFound অনুরোধের channelId প্যারামিটার এমন কোনও চ্যানেল নির্দিষ্ট করলে যা খুঁজে পাওয়া যায় না, তাহলে playlists.list পদ্ধতি এই সমস্যাটি রিটার্ন করে।
    notFound (404) playlistNotFound অনুরোধের id প্যারামিটার এমন একটি প্লেলিস্ট নির্দিষ্ট করলে যা খুঁজে পাওয়া যায় না, playlists.list পদ্ধতিটি এই ত্রুটিটি রিটার্ন করে।
    notFound (404) videoNotFound অনুরোধের id প্যারামিটার এমন কোনও ভিডিও নির্দিষ্ট করলে যা খুঁজে পাওয়া যায়নি, সেক্ষেত্রে videos.list পদ্ধতি এই সমস্যার মেসেজ দেখায়।
    badRequest (400) invalidRating অনুরোধে rating প্যারামিটারের জন্য অপ্রত্যাশিত মান থাকলে, videos.rate পদ্ধতি এই সমস্যা দেখায়।

২ মার্চ, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • search.list পদ্ধতিতে এখন relevanceLanguage প্যারামিটার কাজ করে, এর সাহায্যে আপনি কোনও নির্দিষ্ট ভাষার জন্য সবচেয়ে প্রাসঙ্গিক ফলাফল পাওয়ার অনুরোধ করতে পারেন।

    এই নতুন প্যারামিটার কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করতে YouTube Data API (v3) মাইগ্রেশন গাইড-ও আপডেট করা হয়েছে। এই প্যারামিটারটি বর্তমান API ভার্সন (v3) এবং পূর্ববর্তী ভার্সন (v2)-এর মধ্যে আগে থেকে থাকা ফিচার সংক্রান্ত পার্থক্য দূর করে, যা আগেই বন্ধ করে দেওয়া হয়েছে।

  • YouTube Data API (v3) মাইগ্রেশন গাইড-ও আপডেট করা হয়েছে যাতে বিশেষ ফিড ও মেটাডেটা ফিল্ড বন্ধ হয়ে যাওয়ার বিষয়টি উল্লেখ করা হয়েছে। v2 API-তে সিনেমা, ট্রেলার, টেলিভিশন শো, টেলিভিশন সিজন ও টেলিভিশন পর্বের বিবরণ দেওয়ার জন্য এই ফিল্ডগুলি ব্যবহার করা হত।

১৪ জানুয়ারি, ২০১৫

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • JavaScript ব্যবহার করে ভিডিও আপলোড করার জন্য v3 API কীভাবে ব্যবহার করতে হয় তা ব্যাখ্যা করতে YouTube Data API (v3) মাইগ্রেশন গাইড আপডেট করা হয়েছে। (বিস্তারিত জানতে ভিডিও আপলোড করুন বিভাগ দেখুন।) এই কার্যকারিতা ব্রাউজার-ভিত্তিক আপলোডিং কার্যকারিতার সাথে তুলনীয় যা v2 API-তে কাজ করে। মনে রাখবেন, মাইগ্রেশন গাইডে এই পরিবর্তনটি কোনও প্রকৃত API পরিবর্তনকে প্রতিফলিত করে না বরং ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট সহ ভিডিও আপলোড করার জন্য নতুন স্যাম্পেল কোডের উপলভ্যতাকে প্রতিফলিত করে।

    JavaScript ক্লায়েন্ট লাইব্রেরি এবং CORS-এর মাধ্যমে ভিডিও আপলোড করার সুবিধা দেওয়া হয়েছে। তাই, মাইগ্রেশন নির্দেশিকায় ব্রাউজার-ভিত্তিক আপলোড করার সুবিধাকে আর এমন ফিচার হিসেবে তালিকাভুক্ত করা হয়নি যা v3 API-তে বন্ধ করে দেওয়া হতে পারে।

  • videos.insert পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে যাতে উপরে বর্ণিত নতুন JavaScript কোড স্যাম্পেল অন্তর্ভুক্ত করা যায়। YouTube Data API (v3)-এর জন্য JavaScript কোড স্যাম্পেলের তালিকাও আপডেট করা হয়েছে।

১১ নভেম্বর, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • search.list পদ্ধতিতে কল করার জন্য কোটার খরচ পরিবর্তন করে ১০০ ইউনিট করা হয়েছে।

    গুরুত্বপূর্ণ: অনেক ক্ষেত্রে, কম কোটা খরচে তথ্য পাওয়ার জন্য আপনি অন্যান্য API পদ্ধতি ব্যবহার করতে পারেন। যেমন, GoogleDevelopers চ্যানেলে আপলোড করা ভিডিও খুঁজে পাওয়ার এই দুটি উপায় দেখুন।

    • কোটার খরচ: ১০০ ইউনিট

      search.list মেথড কল করুন এবং GoogleDevelopers সার্চ করুন।

    • কোটা খরচ: ৬ ইউনিট

      সঠিক চ্যানেল আইডি খুঁজে পেতে channels.list মেথড কল করুন। forUsername প্যারামিটার GoogleDevelopers-এ এবং part প্যারামিটার contentDetails-এ সেট করুন। API রেসপন্সে, contentDetails.relatedPlaylists.uploads প্রপার্টি চ্যানেলের আপলোড করা ভিডিওর জন্য প্লেলিস্ট আইডি নির্দিষ্ট করে।

      তারপর playlistItems.list মেথড কল করুন এবং playlistId প্যারামিটারকে ক্যাপচার করা আইডিতে এবং part প্যারামিটারকে snippet-এ সেট করুন।

৮ অক্টোবর, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সে দুটি নতুন প্রপার্টি আছে:

    • status.longUploadsStatus প্রপার্টি থেকে বোঝা যায় যে চ্যানেলটি ১৫ মিনিটের বেশি দৈর্ঘ্যের ভিডিও আপলোড করার জন্য উপযুক্ত কিনা। চ্যানেলের মালিক API অনুরোধ অনুমোদন করলে তবেই এই প্রপার্টি রিটার্ন করা হয়। সঠিক প্রপার্টি ভ্যালু হল:

      • allowed – চ্যানেলটি ১৫ মিনিটের বেশি দৈর্ঘ্যের ভিডিও আপলোড করতে পারবে।
      • eligible – চ্যানেলটি ১৫ মিনিটের বেশি দৈর্ঘ্যের ভিডিও আপলোড করার উপযুক্ত তবে প্রথমে ফিচারটি চালু করতে হবে।
      • disallowed – চ্যানেলটি ১৫ মিনিটের বেশি দৈর্ঘ্যের ভিডিও আপলোড করতে পারছে না বা সেটির জন্য উপযুক্ত নয়।

      এইসব ভ্যালু সম্পর্কে আরও তথ্য পেতে, প্রপার্টির সংজ্ঞা দেখুন। এছাড়াও, YouTube সহায়তা কেন্দ্র এই ফিচার সম্পর্কে আরও বিস্তারিত তথ্য প্রদান করে।

    • invideoPromotion.useSmartTiming প্রপার্টি থেকে বোঝা যায় যে চ্যানেলের প্রোমোশনাল ক্যাম্পেনে "স্মার্ট টাইমিং" ব্যবহার করা হয় কিনা। এই ফিচার ভিডিওর এমন একটি পয়েন্টে প্রোমোশন দেখানোর চেষ্টা করে যেখানে ক্লিক করার সম্ভাবনা বেশি এবং দেখার অভিজ্ঞতা বিঘ্নিত হওয়ার সম্ভাবনা কম। এছাড়াও, এই ফিচার প্রতিটি ভিডিওতে দেখানোর জন্য একটি প্রোমোশন বেছে নেয়।

  • video রিসোর্সের snippet.title এবং snippet.categoryId প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে API যেভাবে videos.update পদ্ধতিতে কল ম্যানেজ করে তা স্পষ্ট করা যায়। video রিসোর্সের snippet অংশ আপডেট করার জন্য আপনি সেই পদ্ধতি কল করলে, আপনাকে অবশ্যই সেই দুটি প্রপার্টির জন্য একটি ভ্যালু সেট করতে হবে।

    আপনি যদি video রিসোর্সের snippet অংশ আপডেট করার চেষ্টা করেন এবং সেইসব প্রপার্টির কোনওটিরই ভ্যালু সেট না করেন, তাহলে API একটি invalidRequest সমস্যা দেখায়। সেই সমস্যার বিবরণও আপডেট করা হয়েছে।

  • video রিসোর্সের contentDetails.contentRating.oflcRating প্রপার্টি, যা নিউজিল্যান্ডের অফিস অফ ফিল্ম অ্যান্ড লিটারেচার ক্লাসিফিকেশন থেকে কোনও ভিডিওর রেটিং শনাক্ত করে, এখন দুটি নতুন রেটিংকে সমর্থন করে: oflcRp13 এবং oflcRp16। এগুলি যথাক্রমে RP13 ও RP16 রেটিংয়ের সাথে সম্পর্কিত।

  • channelBanners.insert পদ্ধতিতে এখন নিম্নলিখিত সমস্যার সমাধান করা যায়:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest bannerAlbumFull চ্যানেলের মালিকের YouTube চ্যানেল আর্ট অ্যালবামে অনেক ছবি আছে। চ্যানেলের মালিককে http://photos.google.com লিঙ্কে গিয়ে অ্যালবাম পৃষ্ঠায় নেভিগেট করতে হবে এবং সেই অ্যালবাম থেকে কিছু ছবি সরাতে হবে।

১২ সেপ্টেম্বর, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • search.list পদ্ধতিতে কল করার জন্য কোটার খরচ নির্দিষ্ট রিসোর্স পার্ট-এর খরচ ছাড়াও ১ ইউনিট থেকে ২ ইউনিটে পরিবর্তিত হয়েছে।

১৩ আগস্ট, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • subscriptions.insert পদ্ধতিতে এখন নিম্নলিখিত সমস্যার সমাধান করা যায়:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest subscriptionLimitExceeded অনুরোধের মাধ্যমে শনাক্ত করা সাবস্ক্রাইবার সাবস্ক্রিপশন রেটের সীমা অতিক্রম করেছেন। কয়েক ঘণ্টা পরে আরও সাবস্ক্রিপশন যোগ করার চেষ্টা করা যেতে পারে।

১২ আগস্ট, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • YouTube Data API (v3)-তে আপনার অ্যাপ্লিকেশন মাইগ্রেট করা শীর্ষক একটি নতুন নির্দেশিকায় ব্যাখ্যা করা হয়েছে যে YouTube Data API (v2)-তে উপলভ্য কার্যকারিতা পারফর্ম করার জন্য কীভাবে YouTube Data API (v3) ব্যবহার করতে হয়। পুরনো API ৪ মার্চ, ২০১৪ থেকে আনুষ্ঠানিকভাবে বন্ধ করে দেওয়া হয়েছে। এই গাইডের উদ্দেশ্য হল, এখনও v2 API ব্যবহার করা অ্যাপ্লিকেশনগুলিকে সবচেয়ে সাম্প্রতিক API ভার্সনে মাইগ্রেট করতে আপনাকে সাহায্য করা।

৮ জুলাই, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • playlists.insert পদ্ধতিতে এখন নিম্নলিখিত সমস্যাগুলি সমাধান করা যায়:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest maxPlaylistExceeded চ্যানেলে আগে থেকেই অনুমোদিত সর্বাধিক সংখ্যক প্লেলিস্ট থাকলে, প্লেলিস্ট তৈরি করা না গেলে এই সমস্যা হয়।

১৮ জুন, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

২৮ মে, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • search.list পদ্ধতি এখন location এবং locationRadius প্যারামিটারকে সমর্থন করে, যা আপনাকে ভৌগোলিক অবস্থানের সাথে সম্পর্কিত ভিডিওগুলি অনুসন্ধান করতে দেয়। লোকেশন ভিত্তিক ফলাফল পেতে হলে, অনুরোধে অবশ্যই দুটি প্যারামিটারেরই ভ্যালু উল্লেখ করতে হবে এবং অনুরোধে দুটি প্যারামিটারের মধ্যে একটি উল্লেখ করা থাকলে API একটি সমস্যা সংক্রান্ত মেসেজ দেখাবে।

    • location প্যারামিটারটি বৃত্তাকার ভৌগোলিক এলাকার কেন্দ্রে অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট নির্দিষ্ট করে।

    • locationRadius প্যারামিটারটি সর্বাধিক দূরত্ব নির্দিষ্ট করে যা কোনও ভিডিওর সাথে যুক্ত লোকেশনটি ভিডিওর জন্য এখনও সার্চ ফলাফলে অন্তর্ভুক্ত থাকার জন্য এলাকার কেন্দ্র থেকে হতে পারে।

১৩ মে, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সের invideoPromotion.items[] প্রপার্টি আপডেট করা হয়েছে যাতে আপনি বুঝতে পারেন যে সাধারণত আপনার চ্যানেলের জন্য শুধুমাত্র একটি প্রোমোট করা আইটেম সেট করতে পারবেন। আপনি যদি খুব বেশি প্রচার করা আইটেম যোগ করার চেষ্টা করেন, তাহলে API একটি tooManyPromotedItems সমস্যা দেখাবে, যার HTTP 400 স্ট্যাটাস কোড আছে।

  • channelSection রিসোর্সে এখন কয়েক ধরনের নতুন ফিচার করা কন্টেন্ট সম্পর্কে তথ্য থাকতে পারে। channelSection রিসোর্সের snippet.type প্রপার্টি এখন নিম্নলিখিত ভ্যালুগুলির সাথে কাজ করে:

    • postedPlaylists - চ্যানেলের মালিকের চ্যানেলের অ্যাক্টিভিটি ফিডে পোস্ট করা প্লেলিস্ট
    • postedVideos - চ্যানেলের মালিকের চ্যানেলের অ্যাক্টিভিটি ফিডে পোস্ট করা ভিডিও
    • subscriptions - চ্যানেলের মালিক সাবস্ক্রাইব করেছেন এমন চ্যানেল

  • video রিসোর্সের নতুন contentDetails.contentRating.ifcoRating প্রপার্টি, আইরিশ ফিল্ম ক্লাসিফিকেশন অফিস থেকে ভিডিওটি পাওয়া রেটিং শনাক্ত করে।

  • watermark রিসোর্সের position.cornerPosition প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যাতে এটি উল্লেখ করা যায় যে ওয়াটারমার্ক সবসময় প্লেয়ারের উপরে ডানদিকের কোণে দেখা যায়।

  • search.list পদ্ধতির জন্য q প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে। এর মাধ্যমে এটি উল্লেখ করা হয়েছে যে কোয়েরি শব্দে বুলিয়ান NOT (-) অপারেটর ব্যবহার করে নির্দিষ্ট সার্চ করা শব্দের সাথে যুক্ত ভিডিও বাদ দেওয়া যেতে পারে। এছাড়াও, একাধিক সার্চ কোয়েরির মধ্যে কোনও একটির সাথে যুক্ত ভিডিও খুঁজে পেতে, ভ্যালু বুলিয়ান OR (|) অপারেটর ব্যবহার করতে পারে।

  • search.list কলের উত্তরে API রেসপন্সে যে pageInfo.totalResults প্রপার্টির সংজ্ঞা রিটার্ন করা হয়, সেটি আপডেট করা হয়েছে। এর ফলে বোঝা যায় যে ভ্যালু হল আনুমানিক এবং সেটি সঠিক ভ্যালু নাও হতে পারে। এছাড়াও, সর্বাধিক মান হল ১,০০০,০০০। পৃষ্ঠা সংখ্যা দেখানোর লিঙ্ক তৈরি করতে আপনার এই ভ্যালু ব্যবহার করা উচিত নয়। পরিবর্তে, পৃষ্ঠা সংখ্যা দেখানোর লিঙ্ক দেখানো হবে কিনা তা নির্ধারণ করতে nextPageToken এবং prevPageToken প্রপার্টি ভ্যালু ব্যবহার করুন।

  • watermarks.set ও watermarks.unset পদ্ধতি আপডেট করা হয়েছে যাতে বোঝা যায় যে এইসব পদ্ধতিতে সফল অনুরোধের জন্য API একটি HTTP 204 রেসপন্স কোড রিটার্ন করে।

২ মে, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন i18nLanguage রিসোর্স YouTube ওয়েবসাইটের সাথে কাজ করে এমন অ্যাপ্লিকেশনের ভাষাকে শনাক্ত করে। অ্যাপ্লিকেশনের ভাষাকে UI ভাষাও বলা যেতে পারে। YouTube ওয়েবসাইটের জন্য, Google অ্যাকাউন্ট সেটিংস, ব্রাউজারের ভাষা বা IP লোকেশনের উপর ভিত্তি করে অ্যাপ্লিকেশনের ভাষা অটোমেটিক বেছে নেওয়া হতে পারে এবং ব্যবহারকারী YouTube সাইটের ফুটার থেকে ম্যানুয়ালি তার পছন্দের UI ভাষা বেছে নিতে পারেন।

    API-তে এমন একটি পদ্ধতি আছে যার মাধ্যমে কাজ করে এমন অ্যাপ্লিকেশন ভাষার তালিকা দেখা যায়। videoCategories.list ও guideCategories.list-এর মতো API পদ্ধতি কল করার সময়, hl প্যারামিটারের ভ্যালু হিসেবে কাজ করে এমন ভাষা ব্যবহার করা যেতে পারে।

  • নতুন i18nRegion রিসোর্স একটি ভৌগোলিক অঞ্চল শনাক্ত করে যা একজন YouTube ব্যবহারকারী পছন্দের কন্টেন্ট অঞ্চল হিসেবে বেছে নিতে পারেন। কন্টেন্ট অঞ্চলকে কন্টেন্ট লোকেলও বলা যেতে পারে। YouTube ওয়েবসাইটের ক্ষেত্রে, YouTube ডোমেন বা ব্যবহারকারীর IP লোকেশনের মতো হিউরিস্টিকসের উপর ভিত্তি করে কন্টেন্ট অঞ্চল অটোমেটিক বেছে নেওয়া হতে পারে এবং ব্যবহারকারী YouTube সাইটের ফুটার থেকে ম্যানুয়ালিও তার পছন্দের কন্টেন্ট অঞ্চল বেছে নিতে পারেন।

    API-তে এমন একটি পদ্ধতি আছে যার মাধ্যমে কন্টেন্ট উপলভ্য আছে এমন অঞ্চলের তালিকা দেখা যায়। search.list, videos.list, activities.list ও videoCategories.list-এর মতো API মেথড কল করার সময় কাজ করে এমন অঞ্চল কোড regionCode প্যারামিটারের ভ্যালু হিসেবে ব্যবহার করা যেতে পারে।

৭ এপ্রিল, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন channelSection রিসোর্সে, কোনও চ্যানেল ফিচার করার জন্য বেছে নিয়েছে এমন ভিডিওর একটি সেট সম্পর্কে তথ্য থাকে। যেমন, কোনও বিভাগে চ্যানেলের লেটেস্ট আপলোড, সবচেয়ে জনপ্রিয় আপলোড অথবা এক বা একাধিক প্লেলিস্টের ভিডিও ফিচার করা যেতে পারে।

    API-তে চ্যানেল বিভাগ তালিকাভুক্ত করা, যোগ করা, আপডেট করা বা মুছে দেওয়া সংক্রান্ত পদ্ধতি কাজ করে। কোনও নির্দিষ্ট চ্যানেল আইডি উল্লেখ করে অথবা অনন্য চ্যানেল বিভাগ আইডির তালিকা উল্লেখ করে, আপনি যাচাই করা ব্যবহারকারীর চ্যানেলের জন্য চ্যানেল বিভাগের একটি তালিকা পেতে পারেন।

    এই নতুন পদ্ধতির জন্য API বিশেষভাবে যে সমস্যার মেসেজ দেখায় তা বর্ণনা করার জন্য সমস্যার ডকুমেন্টেশন আপডেট করা হয়েছে।

  • video রিসোর্সের fileDetails অবজেক্টের সংজ্ঞা আপডেট করে এটি ব্যাখ্যা করা হয়েছে যে ভিডিওর processingDetails.fileDetailsAvailability প্রপার্টির ভ্যালু available হলে তবেই সেই অবজেক্ট রিটার্ন করা হবে।

    একইভাবে, video রিসোর্সের suggestions অবজেক্টের সংজ্ঞা আপডেট করা হয়েছে যাতে এটি ব্যাখ্যা করা যায় যে ভিডিওর processingDetails.tagSuggestionsAvailability প্রপার্টি বা এর processingDetails.editorSuggestionsAvailability প্রপার্টির ভ্যালু available হলে তবেই সেই অবজেক্ট রিটার্ন করা হবে।

  • videos.insert ও videos.update মেথডের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে বোঝা যায় যে এইসব মেথড কল করার সময় status.publishAt প্রপার্টি সেট করা যেতে পারে।

  • channel রিসোর্সের invideoPromotion অবজেক্টের সংজ্ঞা আপডেট করা হয়েছে যাতে ব্যাখ্যা করা যায় যে অবজেক্টটি শুধুমাত্র চ্যানেলের মালিকই ফিরিয়ে আনতে পারবেন।

  • videos.rate পদ্ধতির প্যারামিটার তালিকা আপডেট করা হয়েছে যাতে দেখানো যায় যে এই পদ্ধতি আসলে onBehalfOfContentOwner প্যারামিটার সাপোর্ট করে না। এটি একটি ডকুমেন্টেশন সংক্রান্ত সমস্যা কারণ videos.rate অনুরোধে এই প্যারামিটার সেট করা হলে 500 সমস্যা হয়।

৩১ মার্চ, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • video রিসোর্সের নতুন status.publishAt প্রপার্টি আপনাকে তারিখ ও সময় নির্দিষ্ট করতে দেয় যখন কোনও ব্যক্তিগত ভিডিও প্রকাশ করার জন্য শিডিউল করা হয়। ভিডিওর গোপনীয়তা স্ট্যাটাস private হলে এবং ভিডিওটি কখনও প্রকাশ করা না হলে তবেই এই প্রপার্টি সেট করা যাবে। এই নতুন প্রপার্টি অবসোলিট নীতি মেনে চলে না।

১৩ মার্চ, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • API এখন channel রিসোর্সের জন্য contentOwnerDetails অংশকে সাপোর্ট করে। নতুন অংশে চ্যানেলের সাথে লিঙ্ক করা YouTube পার্টনারদের জন্য প্রাসঙ্গিক চ্যানেল ডেটা থাকে, এর মধ্যে চ্যানেলের সাথে লিঙ্ক করা কন্টেন্টের মালিকের আইডি এবং কন্টেন্টের মালিক ও চ্যানেল লিঙ্ক করার তারিখ ও সময় অন্তর্ভুক্ত। মনে রাখবেন যে এই নতুন অংশটি শীঘ্রই বন্ধ করা সংক্রান্ত নীতির আওতাভুক্ত নয়।

  • ডকুমেন্টেশনে এখন নিম্নলিখিত প্রপার্টির জন্য সর্বাধিক কাজ করে এমন অক্ষরের দৈর্ঘ্য তালিকাভুক্ত করা হয়েছে:

    রিসোর্স প্রপার্টি সর্বাধিক দৈর্ঘ্য
    channel invideoPromotion.items[].customMessage ৪০টি অক্ষর
    video snippet.title ১০০টি অক্ষর
    video snippet.description ৫০০০ বাইট
    video snippet.tags ৫০০টি অক্ষর। মনে রাখবেন যে প্রপার্টির ভ্যালু হল একটি তালিকা এবং তালিকার আইটেমগুলির মধ্যে কমা সীমার মধ্যে গণনা করা হয়।

  • channel রিসোর্সের brandingSettings.watch.featuredPlaylistId প্রপার্টি বন্ধ করা হয়েছে। আপনি এর ভ্যালু সেট করার চেষ্টা করলে, API একটি সমস্যা সংক্রান্ত মেসেজ দেখাবে।

  • ভিডিও যোগ করার বা আপডেট করার সময় সেট করা যেতে পারে এমন ভ্যালুর তালিকায় নিম্নলিখিত video রিসোর্স প্রপার্টি যোগ করা হয়েছে:

  • সমস্যা সংক্রান্ত ডকুমেন্টেশন এখন প্রতিটি সমস্যার ধরনের জন্য HTTP রেসপন্স কোড নির্দিষ্ট করে।

  • API এখন নিম্নলিখিত সমস্যাগুলি সমাধান করতে পারে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest (400) invalidCriteria অনুরোধে যদি এমন ফিল্টার প্যারামিটার উল্লেখ করা থাকে যা একে অপরের সাথে ব্যবহার করা যায় না, তাহলে channels.list পদ্ধতি এই সমস্যার কথা জানায়।
    badRequest (400) channelTitleUpdateForbidden আপনি যদি কোনও চ্যানেলের brandingSettings অংশ আপডেট করার চেষ্টা করেন এবং brandingSettings.channel.title প্রপার্টির ভ্যালু পরিবর্তন করেন, তাহলে channels.update পদ্ধতি এই সমস্যাটি দেখায়। (মনে রাখবেন, আপনি প্রপার্টি বাদ দিলে API কোনও সমস্যা দেখায় না।)
    badRequest (400) invalidRecentlyUploadedBy invideoPromotion.items[].id.recentlyUploadedBy প্রপার্টি ভুল চ্যানেল আইডি উল্লেখ করলে, channels.update পদ্ধতি এই সমস্যা রিটার্ন করে।
    badRequest (400) invalidTimingOffset invideoPromotion অংশে ভুল টাইমিং অফসেট উল্লেখ করা থাকলে, channels.update পদ্ধতি এই সমস্যা দেখায়।
    badRequest (400) tooManyPromotedItems invideoPromotion অংশে অনুমোদিত সংখ্যার চেয়ে বেশি প্রোমোট করা আইটেম উল্লেখ করা হলে, channels.update পদ্ধতি এই সমস্যা দেখায়।
    forbidden (403) promotedVideoNotAllowed invideoPromotion.items[].id.videoId প্রপার্টি এমন কোনও ভিডিও আইডি উল্লেখ করলে যা খুঁজে পাওয়া যায়নি অথবা প্রোমোট করা আইটেম হিসেবে ব্যবহার করা যায়নি, সেক্ষেত্রে channels.update পদ্ধতি এই সমস্যার মেসেজ দেখায়।
    forbidden (403) websiteLinkNotAllowed invideoPromotion.items[].id.websiteUrl প্রপার্টিতে অনুমোদিত নয় এমন URL উল্লেখ করা থাকলে, channels.update মেথড এই সমস্যাটি দেখায়।
    required (400) requiredTimingType YouTube-এর কখন প্রোমোট করা আইটেম দেখানো উচিত সেই সংক্রান্ত ডিফল্ট টাইমিং সেটিংস কোনও অনুরোধে উল্লেখ করা না থাকলে, channels.update পদ্ধতি এই সমস্যার কথা জানায়।
    required (400) requiredTiming channels.update মেথডে প্রতিটি প্রচার করা আইটেমের জন্য একটি invideoPromotion.items[].timing অবজেক্ট নির্দিষ্ট করতে হবে।
    required (400) requiredWebsiteUrl channels.update মেথডে প্রতিটি প্রচার করা আইটেমের জন্য invideoPromotion.items[].id.websiteUrl প্রপার্টি নির্দিষ্ট করতে হবে।
    badRequest (400) invalidPublishAt অনুরোধের মেটাডেটা যদি ভুল শিডিউল করা প্রকাশের সময় উল্লেখ করে, তাহলে videos.insert পদ্ধতি এই সমস্যাটি রিটার্ন করে।

৪ মার্চ, ২০১৪

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

৫ ডিসেম্বর, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • search.list পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে যাতে এটি সঠিকভাবে বোঝা যায় যে সার্চের অনুরোধ জমা দেওয়ার সময় আপনাকে ঠিক একটি ফিল্টার প্যারামিটারের জন্য কোনও ভ্যালু নির্দিষ্ট করতে হবে না। বরং, আপনি শূন্য ফিল্টার প্যারামিটার বা একটি ফিল্টার প্যারামিটারের জন্য ভ্যালু সেট করতে পারেন।

  • search.list পদ্ধতির প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে। এতে উল্লেখ করা হয়েছে যে আপনি যদি নিম্নলিখিত প্যারামিটারগুলির কোনওটির জন্য মান নির্দিষ্ট করেন, তাহলে আপনাকে অবশ্যই type প্যারামিটারের মান video হিসেবে সেট করতে হবে:

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • আপলোড করা চ্যানেল ব্যানার ছবির ন্যূনতম সাইজ কমিয়ে ২০৪৮ পিক্সেল X ১১৫২ পিক্সেল করা হয়েছে। (আগে, ন্যূনতম সাইজ ছিল ২১২০ x ১১৯২ পিক্সেল।) এছাড়াও, মনে রাখবেন যে channel রিসোর্স ডকুমেন্টেশনে API থেকে পরিবেশিত সমস্ত ব্যানার ছবির সর্বাধিক সাইজ নির্দিষ্ট করা আছে। যেমন, টেলিভিশন অ্যাপ্লিকেশনের জন্য brandingSettings.image.bannerTvImageUrl ছবির সর্বাধিক সাইজ হল ২১২০ পিক্সেল বাই ১১৯২ পিক্সেল, কিন্তু আসল ছবি ২০৪৮ পিক্সেল বাই ১১৫২ পিক্সেল হতে পারে। বিভিন্ন ধরনের ডিভাইসে দেখানোর জন্য চ্যানেল আর্ট অপ্টিমাইজ করার ব্যাপারে YouTube সহায়তা কেন্দ্র অতিরিক্ত নির্দেশিকা প্রদান করে।

  • নিম্নলিখিত তথ্য দেখানোর জন্য একাধিক channel রিসোর্স প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে:

    • brandingSettings.channel.description প্রপার্টির ভ্যালুর সর্বাধিক দৈর্ঘ্য ১০০০ অক্ষর।
    • brandingSettings.channel.featuredChannelsTitle প্রপার্টিতে সর্বাধিক ৩০টি অক্ষর থাকতে পারে।
    • brandingSettings.channel.featuredChannelsUrls[] প্রপার্টি এখন সর্বাধিক ১০০টি চ্যানেল তালিকাভুক্ত করতে পারবে।
    • brandingSettings.channel.unsubscribedTrailer প্রপার্টি ভ্যালু সেট করা থাকলে, চ্যানেল মালিকের মালিকানাধীন সর্বজনীন বা তালিকাভুক্ত নয় এমন ভিডিওর YouTube ভিডিও আইডি উল্লেখ করতে হবে।

  • channels.update পদ্ধতি এখন invideoPromotion.items[].promotedByContentOwner প্রপার্টিতে আপডেট করার সুবিধা দেয়। প্রোমোশন দেখানোর সময় কন্টেন্টের মালিকের নাম দেখানো হবে কিনা তা এই প্রপার্টি থেকে জানা যায়। onBehalfOfContentOwner প্যারামিটার ব্যবহার করে কন্টেন্টের মালিকের হয়ে API অনুরোধ করা হলে তবেই এটি সেট করা যাবে।

  • playlistItems.list এবং playlistItems.insert পদ্ধতিতে এখন onBehalfOfContentOwner প্যারামিটার কাজ করে, যা আগে থেকেই অন্যান্য পদ্ধতিতে কাজ করে।

  • contentDetails.contentRating.acbRating প্রপার্টি এখন সিনেমার জন্য অস্ট্রেলিয়ান ক্লাসিফিকেশন বোর্ড (ACB) বা বাচ্চাদের টেলিভিশন প্রোগ্রামের জন্য অস্ট্রেলিয়ান কমিউনিকেশনস অ্যান্ড মিডিয়া অথরিটি (ACMA) থেকে রেটিং নির্দিষ্ট করতে পারে।

  • নতুন contentDetails.contentRating.catvRating এবং contentDetails.contentRating.catvfrRating প্রপার্টি যথাক্রমে কানাডিয়ান টিভি ক্লাসিফিকেশন সিস্টেম এবং ফরাসি-ভাষার Régie du cinéma রেটিং সিস্টেমের অধীনে কোনও ভিডিওর পাওয়া রেটিং শনাক্ত করে, যা কুইবেকে ব্যবহার করা হয়।

  • videoCategory রিসোর্সের নতুন snippet.assignable প্রপার্টি থেকে বোঝা যায় যে আপডেট করা ভিডিও বা নতুন আপলোড করা ভিডিও সেই ভিডিও বিভাগের সাথে যুক্ত করা যাবে কিনা।

  • নিম্নলিখিত পদ্ধতির জন্য কোডের নমুনা যোগ করা হয়েছে:

২৪ অক্টোবর, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • লাইভ ব্রডকাস্ট কন্টেন্ট খুঁজে পেতে এবং ফিচার করতে সাহায্য করার জন্য ডিজাইন করা দুটি অতিরিক্ত ফিচার API-তে অন্তর্ভুক্ত রয়েছে:

    সার্চ ফলাফলে নতুন snippet.liveBroadcastContent প্রপার্টি থেকে বোঝা যায় যে কোনও ভিডিও বা চ্যানেল রিসোর্সে লাইভ ব্রডকাস্ট কন্টেন্ট আছে কিনা। প্রপার্টির সঠিক ভ্যালু হল upcoming, active ও none।

    • video রিসোর্সের snippet.liveBroadcastContent নতুন প্রপার্টি থেকে বোঝা যায় যে ভিডিওটি আসন্ন বা অ্যাক্টিভ লাইভ ব্রডকাস্ট কিনা। নিচের তালিকায় প্রপার্টির সম্ভাব্য মান ব্যাখ্যা করা হয়েছে:

      • upcoming – ভিডিওটি একটি লাইভ ব্রডকাস্ট যা এখনও শুরু হয়নি।
      • active – ভিডিওটি একটি চলমান লাইভ সম্প্রচার।
      • none – ভিডিওটি আসন্ন বা অ্যাক্টিভ লাইভ ব্রডকাস্ট নয়। এটি সম্পূর্ণ হওয়া ব্রডকাস্টের প্রপার্টি ভ্যালু হবে যা এখনও YouTube-এ দেখা যাচ্ছে।

    • video রিসোর্সের নতুন liveStreamingDetails প্রপার্টি হল এমন একটি অবজেক্ট যাতে লাইভ ভিডিও ব্রডকাস্ট সম্পর্কে মেটাডেটা থাকে। এই মেটাডেটা ফিরিয়ে আনতে, রিসোর্স পার্টের part প্যারামিটার ভ্যালুর তালিকায় liveStreamingDetails অন্তর্ভুক্ত করুন। মেটাডেটাতে নিম্নলিখিত নতুন প্রপার্টি অন্তর্ভুক্ত থাকে:

      • liveStreamingDetails.actualStartTime – ব্রডকাস্টটি আসলে যে সময়ে শুরু হয়েছিল। (ব্রডকাস্টের স্ট্যাটাস active হলে তবেই এই ভ্যালু দেখানো হবে।)
      • liveStreamingDetails.actualEndTime – ব্রডকাস্টটি আসলে যে সময়ে শেষ হয়েছে। (ব্রডকাস্ট শেষ হয়ে গেলে এই ভ্যালু দেখা যাবে।)
      • liveStreamingDetails.scheduledStartTime – ব্রডকাস্ট শুরু করার জন্য শিডিউল করা সময়।
      • liveStreamingDetails.scheduledEndTime – ব্রডকাস্ট শেষ হওয়ার শিডিউল করা সময়। প্রপার্টির ভ্যালু খালি থাকলে বা প্রপার্টি না থাকলে, ব্রডকাস্ট অনির্দিষ্টকালের জন্য শিডিউল করা হয়।
      • liveStreamingDetails.concurrentViewers – লাইভ সম্প্রচার দেখছেন এমন ব্যক্তির সংখ্যা।

      এই মেটাডেটা পেতে, videos.list, videos.insert বা videos.update মেথড কল করার সময় part প্যারামিটারের ভ্যালুতে liveStreamingDetails যোগ করুন।

    মনে রাখবেন, লাইভ ব্রডকাস্ট কন্টেন্ট শনাক্ত করার জন্য আরও দুটি ফিচার ১ অক্টোবর, ২০১৩-এ রিলিজ করা হয়েছিল – search.list পদ্ধতির eventType প্যারামিটার এবং সার্চ ফলাফলের snippet.liveBroadcastContent প্রপার্টি।

  • videos.insert পদ্ধতিতে এখন notifySubscribers প্যারামিটার কাজ করে, যা থেকে বোঝা যায় যে YouTube-কে নতুন ভিডিওর ব্যাপারে সেইসব ব্যবহারকারীকে বিজ্ঞপ্তি পাঠানো উচিত কিনা যারা ভিডিওর চ্যানেল সাবস্ক্রাইব করেছেন। প্যারামিটারের ডিফল্ট ভ্যালু হল True, যার অর্থ হল নতুন আপলোড করা ভিডিওর ব্যাপারে সাবস্ক্রাইবারদের বিজ্ঞপ্তি পাঠানো হবে। তবে, কোনও চ্যানেল মালিক অনেক ভিডিও আপলোড করলে, চ্যানেলের সাবস্ক্রাইবারদের প্রতিটি নতুন ভিডিও সম্পর্কে বিজ্ঞপ্তি পাঠানো এড়াতে, তিনি ভ্যালু False-এ সেট করতে পছন্দ করতে পারেন।

  • channels.update মেথড কল করার সময় যেসব প্রপার্টি পরিবর্তন করা যায় তার তালিকায় invideoPromotion.items[].customMessage ও invideoPromotion.items[].websiteUrl প্রপার্টি যোগ করা হয়েছে। এছাড়াও, পরিবর্তনযোগ্য brandingSettings প্রপার্টি শনাক্ত করতে তালিকাটি পরিবর্তন করা হয়েছে। এই brandingSettingsটি প্রপার্টি আগে থেকেই পরিবর্তন করা যেত, তাই ডকুমেন্টেশনে করা পরিবর্তন API-এর বর্তমান কার্যকারিতায় কোনও পরিবর্তন দেখায় না।

  • playlists.insert, playlists.update ও playlists.delete পদ্ধতিতে এখন onBehalfOfContentOwner প্যারামিটার কাজ করে, যা আগে থেকেই আরও অনেক পদ্ধতিতে কাজ করে।

  • playlists.insert পদ্ধতিতে এখন onBehalfOfContentOwnerChannel প্যারামিটার কাজ করে, যা আগে থেকেই অন্যান্য পদ্ধতিতে কাজ করে।

  • video রিসোর্সের contentDetails.contentRating.tvpgRating প্রপার্টি এখন pg14 ভ্যালু সাপোর্ট করে, যা TV-14 রেটিংয়ের সাথে সম্পর্কিত।

  • snippet.liveBroadcastContent প্রপার্টির সংজ্ঞা, যা সার্চ ফলাফলের অংশ, তা সংশোধন করে দেখানো হয়েছে যে live হল একটি সঠিক প্রপার্টি ভ্যালু, কিন্তু active হল একটি সঠিক প্রপার্টি ভ্যালু নয়।

  • video রিসোর্সের contentDetails.contentRating.mibacRating প্রপার্টি এখন দুটি অতিরিক্ত রেটিং সমর্থন করে:

    • mibacVap (VAP) – বাচ্চাদের সাথে কোনও প্রাপ্তবয়স্ককে থাকতে হবে।
    • mibacVm6 (V.M.6) – ৬ বছর ও তার বেশি বয়সীদের জন্য সীমাবদ্ধ।
    • mibacVm12 (V.M.12) – ১২ বছর ও তার বেশি বয়সীদের জন্য সীমাবদ্ধ।

  • channel রিসোর্সের নতুন invideoPromotion.items[].promotedByContentOwner প্রপার্টি থেকে বোঝা যায় যে প্রোমোশন দেখানোর সময় কন্টেন্টের মালিকের নাম দেখানো হবে কিনা। কন্টেন্টের মালিকের হয়ে API অনুরোধ করা হলে তবেই এই ফিল্ড সেট করা যাবে। আরও তথ্যের জন্য onBehalfOfContentOwner প্যারামিটার দেখুন।

১ অক্টোবর, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • channel রিসোর্সের নতুন auditDetails অবজেক্টে চ্যানেল ডেটা থাকে যা মাল্টিচ্যানেল নেটওয়ার্ক (MCN) কোনও নির্দিষ্ট চ্যানেল গ্রহণ বা প্রত্যাখ্যান করার সিদ্ধান্ত নেওয়ার সময় মূল্যায়ন করে। মনে রাখবেন, যে API অনুরোধ এই রিসোর্স পার্ট ফিরিয়ে আনে, সেটিতে অবশ্যই এমন একটি অথরাইজেশন টোকেন থাকতে হবে যাতে https://www.googleapis.com/auth/youtubepartner-channel-audit স্কোপ আছে। এছাড়াও, MCN চ্যানেল গ্রহণ বা বাতিল করার সিদ্ধান্ত নিলে অথবা টোকেন ইস্যু করার তারিখের দুই সপ্তাহের মধ্যে সেই স্কোপ ব্যবহার করা যেকোনও টোকেন প্রত্যাহার করতে হবে।

  • channel রিসোর্সের invideoPromotion.items[].id.type প্রপার্টি এখন recentUpload ভ্যালু সাপোর্ট করে, যা দেখায় যে প্রোমোট করা আইটেমটি নির্দিষ্ট চ্যানেল থেকে সবচেয়ে সম্প্রতি আপলোড করা ভিডিও।

    ডিফল্ট হিসেবে, যে চ্যানেলের জন্য ইন-ভিডিও প্রচার সংক্রান্ত ডেটা সেট করা হয়েছে, এটি সেই চ্যানেল। তবে, আপনি অন্য চ্যানেল থেকে সবচেয়ে সম্প্রতি আপলোড করা ভিডিও প্রচার করতে পারেন, এর জন্য নতুন invideoPromotion.items[].id.recentlyUploadedBy প্রপার্টির ভ্যালু সেই চ্যানেলের চ্যানেল আইডিতে সেট করতে হবে।

  • channel রিসোর্সে তিনটি নতুন প্রপার্টি আছে – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl – যা টেলিভিশন অ্যাপ্লিকেশনে চ্যানেল পৃষ্ঠায় দেখানো ব্যানার ছবির URL নির্দিষ্ট করে।

  • সার্চ ফলাফলে নতুন snippet.liveBroadcastContent প্রপার্টি থেকে বোঝা যায় যে কোনও ভিডিও বা চ্যানেল রিসোর্সে লাইভ ব্রডকাস্ট কন্টেন্ট আছে কিনা। সঠিক প্রপার্টি ভ্যালু হল upcoming, active এবং none।

    • video রিসোর্সের জন্য, upcoming ভ্যালু থেকে বোঝা যায় যে ভিডিওটি একটি লাইভ সম্প্রচার যা এখনও শুরু হয়নি, অন্যদিকে active ভ্যালু থেকে বোঝা যায় যে ভিডিওটি একটি লাইভ সম্প্রচার যা চলছে।
    • channel রিসোর্সের ক্ষেত্রে, upcoming ভ্যালু থেকে বোঝা যায় যে চ্যানেলে একটি শিডিউল করা ব্রডকাস্ট আছে যা এখনও শুরু হয়নি, অন্যদিকে acive ভ্যালু থেকে বোঝা যায় যে চ্যানেলে একটি লাইভ ব্রডকাস্ট চলছে।

  • watermark রিসোর্সে, targetChannelId প্রপার্টি অবজেক্ট থেকে স্ট্রিংয়ে পরিবর্তন করা হয়েছে। যে চ্যানেলের সাথে ওয়াটারমার্ক ছবি লিঙ্ক করা আছে, সেটির YouTube চ্যানেল আইডি নির্দিষ্ট করে এমন চাইল্ড প্রপার্টি থাকার পরিবর্তে, targetChannelId প্রপার্টি এখন সেই ভ্যালু নিজেই নির্দিষ্ট করে। সেই অনুযায়ী, রিসোর্সের targetChannelId.value প্রপার্টি সরিয়ে দেওয়া হয়েছে।

  • thumbnails.set পদ্ধতিতে এখন onBehalfOfContentOwner প্যারামিটার কাজ করে, যা আগে থেকেই অন্যান্য পদ্ধতিতে কাজ করে।

  • search.list পদ্ধতিতে এখন eventType প্যারামিটার কাজ করে, যা কোনও সার্চকে শুধুমাত্র অ্যাক্টিভ, আসন্ন বা সম্পূর্ণ হওয়া ব্রডকাস্ট ইভেন্ট দেখানোর মধ্যে সীমাবদ্ধ রাখে।

  • নতুন contentDetails.contentRating.mibacRating প্রপার্টি, ইতালির Ministero dei Beni e delle Attivita Culturali e del Turismo থেকে কোনও ভিডিওর পাওয়া রেটিং শনাক্ত করে।

  • API এখন নিম্নলিখিত সমস্যার ক্ষেত্রে কাজ করে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest invalidImage প্রদত্ত ছবির কন্টেন্ট ভুল হলে thumbnails.set পদ্ধতি এই সমস্যাটি দেখায়।
    forbidden videoRatingDisabled যে ভিডিও রেট করা হচ্ছে সেটির মালিক রেটিং বন্ধ করে দিলে videos.rate পদ্ধতি এই সমস্যাটি দেখায়।

২৭ আগস্ট, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • নতুন watermark রিসোর্স এমন একটি ছবি শনাক্ত করে যা নির্দিষ্ট চ্যানেলের ভিডিও প্লেব্যাকের সময় দেখানো হয়। এছাড়াও, আপনি একটি টার্গেট চ্যানেল নির্দিষ্ট করতে পারেন যার সাথে ছবিটি লিঙ্ক করা হবে এবং সেইসাথে টাইমিংয়ের বিবরণ যা নির্ধারণ করে যে ভিডিও প্লেব্যাকের সময় ওয়াটারমার্ক কখন দেখা যাবে এবং কতক্ষণ দেখা যাবে।

    watermarks.set পদ্ধতি চ্যানেলের ওয়াটারমার্ক ছবি আপলোড ও সেট করে। watermarks.unset পদ্ধতি চ্যানেলের ওয়াটারমার্ক ছবি মুছে দেয়।

    সমস্যা সংক্রান্ত ডকুমেন্টেশনে সেইসব সমস্যার মেসেজ বর্ণনা করা থাকে যেগুলি API বিশেষভাবে watermarks.set এবং watermarks.unset পদ্ধতির জন্য সাপোর্ট করে।

  • channel রিসোর্সের নতুন statistics.hiddenSubscriberCount প্রপার্টিতে একটি বুলিয়ান ভ্যালু থাকে যা চ্যানেলের সাবস্ক্রাইবার সংখ্যা লুকানো আছে কিনা তা নির্দেশ করে। যেমন, চ্যানেলের সাবস্ক্রাইবার সংখ্যা সর্বজনীনভাবে দৃশ্যমান হলে, প্রপার্টির ভ্যালু false হবে।

  • playlists.list পদ্ধতিতে এখন onBehalfOfContentOwner ও onBehalfOfContentOwnerChannel প্যারামিটার কাজ করে। অন্যান্য পদ্ধতির ক্ষেত্রে এই দুটি প্যারামিটার আগেই কাজ করে।

  • videos.list পদ্ধতিতে এখন regionCode প্যারামিটার কাজ করে, যা কন্টেন্ট অঞ্চল শনাক্ত করে যার জন্য চার্ট ফিরিয়ে আনা উচিত। এই প্যারামিটার শুধুমাত্র chart প্যারামিটারের সাথে ব্যবহার করা যাবে। প্যারামিটারের মান হল ISO 3166-1 alpha-2 দেশের কোড।

  • error documentation-এ নিম্নলিখিত নতুন সাধারণ অনুরোধ সংক্রান্ত সমস্যার বিবরণ দেওয়া হয়েছে, যা একাধিক API পদ্ধতির জন্য হতে পারে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    forbidden insufficientPermissions অনুরোধের জন্য প্রদান করা OAuth 2.0 টোকেনের সাথে যুক্ত স্কোপ, অনুরোধ করা ডেটা অ্যাক্সেস করার জন্য যথেষ্ট নয়।

১৫ আগস্ট, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channel রিসোর্সের invideoPromotion অবজেক্টে নিম্নলিখিত নতুন ও আপডেট করা প্রপার্টি আছে:

    • API এখন প্রোমোট করা আইটেম হিসেবে কোনও ওয়েবসাইট নির্দিষ্ট করার সুবিধা প্রদান করে। এটি করতে, invideoPromotion.items[].id.type প্রপার্টির ভ্যালু website হিসেবে সেট করুন এবং URL নির্দিষ্ট করতে নতুন invideoPromotion.items[].id.websiteUrl প্রপার্টি ব্যবহার করুন। এছাড়াও, প্রচারের জন্য দেখানোর জন্য একটি কাস্টম মেসেজ নির্ধারণ করতে নতুন invideoPromotion.items[].customMessage প্রপার্টি ব্যবহার করুন।

      লিঙ্কগুলি সংশ্লিষ্ট ওয়েবসাইট, মার্চেন্ট সাইট বা সোশ্যাল নেটওয়ার্কিং সাইটের হতে পারে। আপনার কন্টেন্টের জন্য লিঙ্ক চালু করা সম্পর্কে আরও তথ্য পেতে, অ্যাসোসিয়েটেড ওয়েবসাইট ও মার্চেন্ট সাইট সংক্রান্ত YouTube সহায়তা কেন্দ্রের নির্দেশাবলী দেখুন।

      প্রচারমূলক লিঙ্ক যোগ করার মাধ্যমে আপনি সম্মতি জানাচ্ছেন যে সেইসব লিঙ্ক অননুমোদিত সাইটে ট্রাফিক রিডাইরেক্ট করার জন্য ব্যবহার করা হবে না এবং সেইসব লিঙ্ক YouTube-এর AdWords নীতি, YouTube বিজ্ঞাপন নীতি, YouTube কমিউনিটি নির্দেশিকা ও YouTube পরিষেবার শর্তাবলী মেনে চলবে।

    • ভিডিও প্লেব্যাকের সময় প্রচার করা আইটেম দেখানোর জন্য টাইমিং সেটিংস সম্পর্কিত প্রপার্টি নতুন করে সাজানো হয়েছে:

      • invideoPromotion.timing অবজেক্টটি invideoPromotion.items[].timing-এ সরানো হয়েছে। এই অবজেক্ট এখন আপনাকে invideoPromotion.items[] তালিকায় প্রতিটি প্রোমোট করা আইটেমের জন্য টাইমিং ডেটা কাস্টমাইজ করতে দেয়।

      • নতুন invideoPromotion.defaultTiming অবজেক্ট আপনার প্রচারের জন্য ডিফল্ট টাইমিং সেটিংস নির্দিষ্ট করে। আপনার চ্যানেলের কোনও ভিডিও প্লেব্যাক করার সময় প্রোমোট করা আইটেম কখন দেখানো হবে তা এইসব সেটিংস নির্ধারণ করে। invideoPromotion.items[].timing অবজেক্ট ব্যবহার করে আপনি যেকোনও প্রোমোট করা আইটেমের ডিফল্ট টাইমিং ওভাররাইড করতে পারবেন।

      • নতুন invideoPromotion.items[].timing.durationMs প্রপার্টি, প্রোমোশন কতক্ষণ দেখানো হবে তা মিলিসেকেন্ডে নির্দিষ্ট করে। invideoPromotion.defaultTiming অবজেক্টে একটি durationMs ফিল্ডও থাকে যা প্রোমোট করা আইটেমটি কতক্ষণ দেখানো হবে তার ডিফল্ট সময় নির্দিষ্ট করে।

    • invideoPromotion.items[].type ও invideoPromotion.items[].videoId প্রপার্টি, দু'টিকেই invideoPromotion.items[].id অবজেক্টে সরানো হয়েছে।

  • subscriptions.list পদ্ধতিতে এখন onBehalfOfContentOwner ও onBehalfOfContentOwnerChannel প্যারামিটার কাজ করে। অন্যান্য পদ্ধতির ক্ষেত্রে এই দুটি প্যারামিটার আগেই কাজ করে।

  • thumbnails.set অনুরোধের API উত্তরের মধ্যে, kind প্রপার্টির ভ্যালু youtube#thumbnailListResponse থেকে পরিবর্তিত হয়ে youtube#thumbnailSetResponse হয়েছে।

  • নিম্নলিখিত পদ্ধতির জন্য কোডের নমুনা যোগ করা হয়েছে:

    মনে রাখবেন, playlistItems.insert পদ্ধতির Python উদাহরণও সরিয়ে দেওয়া হয়েছে, কারণ এটি যে ফাংশনালিটি দেখায় তা এখন videos.rate পদ্ধতি দ্বারা পরিচালিত হয়।

  • error documentation-এ নিম্নলিখিত নতুন অনুরোধের প্রসঙ্গ সংক্রান্ত সমস্যার বিবরণ দেওয়া হয়েছে, যা mine অনুরোধের প্যারামিটারকে সমর্থন করে এমন যেকোনও API পদ্ধতির জন্য ঘটতে পারে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest invalidMine যাচাই করা ব্যবহারকারী YouTube পার্টনার হলে, অনুরোধে mine প্যারামিটার ব্যবহার করা যাবে না। আপনাকে mine প্যারামিটার সরিয়ে দিতে হবে, onBehalfOfContentOwner প্যারামিটার সরিয়ে YouTube ব্যবহারকারী হিসেবে যাচাই করাতে হবে অথবা কল করা পদ্ধতির জন্য উপলভ্য থাকলে onBehalfOfContentOwnerChannel প্যারামিটার প্রদান করে পার্টনারের চ্যানেলগুলির একটি হিসেবে কাজ করতে হবে।

৮ আগস্ট, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

৩০ জুলাই, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • channelBanner রিসোর্সে, kind প্রপার্টির ভ্যালু youtube#channelBannerInsertResponse থেকে youtube#channelBannerResource-এ পরিবর্তন করা হয়েছে। channelBanners.insert অনুরোধের উত্তরে এই রিসোর্স ফেরত দেওয়া হয়েছে।

  • channel রিসোর্সের নতুন brandingSettings.channel.profileColor প্রপার্টি একটি বিশিষ্ট রঙ নির্দিষ্ট করে যা চ্যানেলের কন্টেন্টকে পরিপূরক করে। প্রপার্টির ভ্যালু হল একটি পাউন্ড চিহ্ন (#) এবং তারপরে ছয় অক্ষরের হেক্সাডেসিমেল স্ট্রিং, যেমন #2793e6।

  • API এখন এটি নির্দিষ্ট করার সুবিধা দেয় যে কোনও সাবস্ক্রিপশন চ্যানেলের সব অ্যাক্টিভিটির জন্য নাকি শুধু নতুন আপলোডের জন্য। subscription রিসোর্সের' নতুন contentDetails.activityType প্রপার্টি সাবস্ক্রাইবারকে কোন ধরনের অ্যাক্টিভিটি সম্পর্কে বিজ্ঞপ্তি পাঠানো হবে তা শনাক্ত করে। প্রপার্টির সঠিক মান হল all এবং uploads।

  • videos.list পদ্ধতিটি YouTube-এ সবচেয়ে জনপ্রিয় ভিডিওগুলির একটি চার্ট পুনরুদ্ধার করার জন্য নতুন প্যারামিটার সমর্থন করে:

    • chart প্যারামিটারটি আপনি যে চার্টটি ফিরিয়ে আনতে চান তা শনাক্ত করে। বর্তমানে, শুধুমাত্র mostPopular ভ্যালু কাজ করে। মনে রাখবেন, chart প্যারামিটার হল একটি ফিল্টার প্যারামিটার, যার অর্থ হল এটি অন্যান্য ফিল্টার প্যারামিটারের (id এবং myRating) মতো একই অনুরোধে ব্যবহার করা যাবে না।
    • videoCategoryId প্যারামিটারটি ভিডিওর বিভাগ শনাক্ত করে যার জন্য চার্টটি পুনরুদ্ধার করা উচিত। এই প্যারামিটার শুধুমাত্র chart প্যারামিটারের সাথে ব্যবহার করা যাবে। ডিফল্ট হিসেবে, চার্ট কোনও নির্দিষ্ট বিভাগের মধ্যে সীমাবদ্ধ থাকে না।

  • video রিসোর্সের topicDetails.relevantTopicIds[] নতুন প্রপার্টিতে Freebase টপিক আইডির একটি তালিকা দেওয়া থাকে যা ভিডিও বা এর কন্টেন্টের সাথে প্রাসঙ্গিক। এইসব বিষয়ের কন্টেন্ট ভিডিওতে উল্লেখ করা বা দেখানো হতে পারে।

  • video রিসোর্সের recordingDetails.location.elevation প্রপার্টির নাম পরিবর্তন করে recordingDetails.location.altitude করা হয়েছে এবং এর fileDetails.recordingLocation.location.elevation প্রপার্টির নাম পরিবর্তন করে fileDetails.recordingLocation.location.altitude করা হয়েছে।

  • video রিসোর্সের contentDetails.contentRating অবজেক্ট, MPAA রেটিং, TVPG রেটিং ইত্যাদি সহ বিভিন্ন রেটিং স্কিমের অধীনে কোনও ভিডিও যে রেটিং পেয়েছে তা নির্দিষ্ট করে। প্রতিটি রেটিং সিস্টেমের জন্য, API এখন এমন একটি রেটিং ভ্যালু কাজ করে যা থেকে বোঝা যায় যে ভিডিওটি রেট করা হয়নি। মনে রাখবেন, MPAA রেটিংয়ের ক্ষেত্রে, "রেটিং নেই" রেটিংটি প্রায়শই সিনেমার আনকাট ভার্সন শনাক্ত করতে ব্যবহৃত হয়, যার কাট ভার্সনটি অফিসিয়াল রেটিং পেয়েছে।

  • video রিসোর্সের নতুন contentDetails.contentRating.ytRating প্রপার্টি বয়স সংক্রান্ত বিধিনিষেধযুক্ত কন্টেন্ট শনাক্ত করে। YouTube যদি শনাক্ত করে যে ভিডিওতে এমন কন্টেন্ট আছে যা ১৮ বছরের কম বয়সী ব্যবহারকারীদের জন্য অনুপযুক্ত, তাহলে প্রপার্টির ভ্যালু ytAgeRestricted হবে। প্রপার্টি না থাকলে বা প্রপার্টির ভ্যালু খালি থাকলে, কন্টেন্টটি বয়স সংক্রান্ত বিধিনিষেধযুক্ত হিসেবে চিহ্নিত করা হয়নি।

  • channels.list পদ্ধতির mySubscribers প্যারামিটার অবচিত করা হয়েছে৷ যাচাই করা ব্যবহারকারীর চ্যানেলের সাবস্ক্রাইবারদের তালিকা পেতে subscriptions.list পদ্ধতি এবং এর mySubscribers প্যারামিটার ব্যবহার করুন।

  • channelBanners.insert, channels.update, videos.getRating এবং videos.rate মেথডগুলি এখন onBehalfOfContentOwner প্যারামিটার ব্যবহার করতে পারে। এই প্যারামিটার থেকে বোঝা যায় যে যাচাই করা ব্যবহারকারী প্যারামিটার ভ্যালুতে উল্লেখ করা কন্টেন্টের মালিকের হয়ে কাজ করছেন।

  • channels.update মেথডের ডকুমেন্টেশন আপডেট করা হয়েছে যাতে এটি দেখানো যায় যে channel রিসোর্সের brandingSettings অবজেক্ট ও তার চাইল্ড প্রপার্টি আপডেট করার জন্য এই মেথড ব্যবহার করা যেতে পারে। এছাড়াও, ডকুমেন্টেশনে এখন channel রিসোর্সের invideoPromotion অবজেক্টের জন্য সেট করা যায় এমন প্রপার্টির আপডেট করা তালিকা দেওয়া আছে।

  • error documentation-এ নিম্নলিখিত নতুন সমস্যার বিবরণ দেওয়া হয়েছে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    forbidden accountDelegationForbidden এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির সাথে সম্পর্কিত নয়। এটি ইঙ্গিত করে যে যাচাইকৃত ব্যবহারকারীর কাছে নির্দিষ্ট Google অ্যাকাউন্টের হয়ে কাজ করার অনুমতি নেই।
    forbidden authenticatedUserAccountClosed এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির সাথে সম্পর্কিত নয়। এটি থেকে বোঝা যায় যে যাচাই করা ব্যবহারকারীর YouTube অ্যাকাউন্ট বন্ধ করা হয়েছে। ব্যবহারকারী যদি অন্য কোনও Google অ্যাকাউন্টের হয়ে কাজ করেন, তাহলে এই সমস্যার অর্থ হল সেই অন্য অ্যাকাউন্টটি বন্ধ করে দেওয়া হয়েছে।
    forbidden authenticatedUserAccountSuspended এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির সাথে সম্পর্কিত নয়। এটি থেকে বোঝা যায় যে যাচাই করা ব্যবহারকারীর YouTube অ্যাকাউন্ট সাসপেন্ড করা হয়েছে। ব্যবহারকারী যদি অন্য কোনও Google অ্যাকাউন্টের হয়ে কাজ করেন, তাহলে এই সমস্যার অর্থ হল সেই অন্য অ্যাকাউন্টটি সাসপেন্ড করা হয়েছে।
    forbidden authenticatedUserNotChannel এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির জন্য নয়। এটি থেকে বোঝা যায় যে API সার্ভার, API অনুরোধের সাথে যুক্ত চ্যানেল শনাক্ত করতে পারছে না। অনুরোধটি অনুমোদিত হলে এবং onBehalfOfContentOwner প্যারামিটার ব্যবহার করলে, আপনাকেও onBehalfOfContentOwnerChannel প্যারামিটার সেট করতে হবে।
    forbidden cmsUserAccountNotFound এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির জন্য নয়। CMS ব্যবহারকারীকে নির্দিষ্ট কন্টেন্টের মালিকের হয়ে কাজ করার অনুমতি দেওয়া হয়নি।
    notFound contentOwnerAccountNotFound এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির জন্য নয়। উল্লেখ করা কন্টেন্টের মালিকের অ্যাকাউন্ট খুঁজে পাওয়া যায়নি।
    badRequest invalidPart এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির জন্য নয়। অনুরোধের part প্যারামিটার এমন অংশ নির্দিষ্ট করে যা একই সময়ে লেখা যাবে না।
    badRequest videoChartNotFound অনুরোধে কাজ করে না বা উপলভ্য নয় এমন ভিডিও চার্ট উল্লেখ করা হলে, videos.list পদ্ধতি এই সমস্যাটি দেখায়।
    notFound videoNotFound আপনি যে ভিডিও আপডেট করার চেষ্টা করছেন সেটি খুঁজে পাওয়া যায়নি, এই সমস্যার কথা জানাতে videos.update পদ্ধতি এই সমস্যা দেখায়। অনুরোধের বডিতে id প্রপার্টির ভ্যালু সঠিক কিনা তা নিশ্চিত করতে চেক করুন।

১০ জুন, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • channels.list পদ্ধতির' নতুন forUsername প্যারামিটার আপনাকে YouTube ইউজারনেম নির্দিষ্ট করে কোনও চ্যানেল সম্পর্কে তথ্য রিট্রিভ করতে দেয়।

  • activities.list পদ্ধতিতে এখন regionCode প্যারামিটার কাজ করে, যা API-কে নির্দিষ্ট দেশের সাথে প্রাসঙ্গিক ফলাফল দেখাতে নির্দেশ দেয়। YouTube-এ অনুমোদিত ব্যবহারকারীর আগের অ্যাক্টিভিটি থেকে অ্যাক্টিভিটি ফিড তৈরি করার জন্য পর্যাপ্ত তথ্য না পাওয়া গেলে, YouTube এই ভ্যালু ব্যবহার করে।

  • প্লেলিস্ট রিসোর্সে এখন snippet.tags প্রপার্টি আছে। প্রপার্টিটি শুধুমাত্র অনুমোদিত ব্যবহারকারীদের কাছে ফেরত দেওয়া হবে যারা তাদের নিজস্ব প্লেলিস্ট সম্পর্কে ডেটা ফিরিয়ে আনছেন। এছাড়াও, অনুমোদিত ব্যবহারকারীরা playlists.insert বা playlists.update পদ্ধতি কল করার সময় প্লেলিস্ট ট্যাগ সেট করতে পারেন।

  • onBehalfOfContentOwner প্যারামিটার, যা আগে channels.list এবং search.list পদ্ধতির জন্য কাজ করত, এখন videos.insert, videos.update এবং videos.delete পদ্ধতির জন্যও কাজ করে। মনে রাখবেন, videos.insert পদ্ধতিতে কল করার সময় এই প্যারামিটার ব্যবহার করা হলে, অনুরোধে অবশ্যই নতুন onBehalfOfContentOwnerChannel প্যারামিটারের জন্য একটি ভ্যালু উল্লেখ করতে হবে, যা ভিডিওটি কোন চ্যানেলে যোগ করা হবে তা শনাক্ত করে। onBehalfOfContentOwner প্যারামিটার যে কন্টেন্টের মালিককে নির্দিষ্ট করে, চ্যানেলটি তার সাথে লিঙ্ক করা থাকতে হবে।

    প্যারামিটারটি ইঙ্গিত করে যে অনুরোধের অনুমোদন ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্ট মালিকের হয়ে কাজ করছেন। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

    এই প্যারামিটারটি সেইসব কন্টেন্ট পার্টনারদের জন্য যারা একাধিক YouTube চ্যানেলের মালিক ও ম্যানেজ করেন। এই প্যারামিটার সেইসব পার্টনারকে একবারই যাচাই করিয়ে তাদের সব ভিডিও ও চ্যানেল ডেটা অ্যাক্সেস করার সুবিধা দেয়। এর ফলে, প্রতিটি আলাদা আলাদা চ্যানেলের জন্য যাচাইকরণের ক্রেডেনশিয়াল দিতে হয় না।

    বিশেষ করে এই রিলিজের ক্ষেত্রে, প্যারামিটারটি এখন কন্টেন্ট পার্টনারকে তার মালিকানাধীন যেকোনও YouTube চ্যানেলে ভিডিও যোগ, আপডেট বা মুছে ফেলার সুবিধা দেয়।

  • error documentation-এ নিম্নলিখিত নতুন সমস্যার বিবরণ দেওয়া হয়েছে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    forbidden insufficientCapabilities এই সমস্যাটি কোনও নির্দিষ্ট API পদ্ধতির জন্য নয়। এটি ইঙ্গিত করে যে API কল করা CMS ব্যবহারকারীর কাছে অনুরোধ করা অপারেশন করার জন্য পর্যাপ্ত অনুমতি নেই। এই সমস্যা onBehalfOfContentOwner প্যারামিটার ব্যবহারের সাথে সম্পর্কিত, যা একাধিক API পদ্ধতির জন্য কাজ করে।
    unauthorized authorizationRequired অনুরোধে home প্যারামিটার ব্যবহার করা হলে কিন্তু যথাযথভাবে অনুমোদিত না হলে activities.list পদ্ধতি এই সমস্যাটি দেখায়।

  • channels রিসোর্সে, invideoPromotion.channelId প্রপার্টি সরিয়ে দেওয়া হয়েছে কারণ রিসোর্সের id প্রপার্টি ব্যবহার করে চ্যানেল আইডি আগে থেকেই নির্দিষ্ট করা আছে।

  • নতুন চ্যানেল আইডি নিয়ে কাজ করা সংক্রান্ত নির্দেশিকা থেকে API কীভাবে চ্যানেল আইডি ব্যবহার করে তা জানা যায়। এই নির্দেশিকাটি বিশেষ করে সেইসব ডেভেলপারদের জন্য উপযোগী হতে পারে যারা API-এর আগের ভার্সন থেকে মাইগ্রেট করছেন এবং যাদের এমন অ্যাপ্লিকেশন আছে যা default ব্যবহারকারীর জন্য কন্টেন্টের অনুরোধ করে অথবা এই ধারণার উপর নির্ভর করে যে প্রতিটি YouTube চ্যানেলের একটি অনন্য ইউজারনেম আছে, যা এখন আর নেই।

২২ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন channelBanners.insert পদ্ধতির মাধ্যমে আপনি ব্যানার ছবি আপলোড করতে পারবেন যা পরে channel রিসোর্সের নতুন brandingSettings.image.bannerExternalUrl প্রপার্টি ব্যবহার করে চ্যানেলের ব্যানার ছবি হিসেবে সেট করা যাবে।

  • channels.update পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে। এই পদ্ধতি কল করার সময় যেসব প্রপার্টি পরিবর্তন করা যায়, সেগুলির তালিকা এতে দেওয়া আছে।

  • video রিসোর্স ডকুমেন্টে suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] ও suggestions.editorSuggestions[] প্রপার্টির জন্য unspecified-কে আর বৈধ প্রপার্টি ভ্যালু হিসেবে দেখানো হয় না।

  • videos.list পদ্ধতির maxResults প্যারামিটারের ডিফল্ট ভ্যালু এখন 5।

  • error documentation এখন channelBanners.insert এবং subscriptions.list পদ্ধতির জন্য সমস্যার তালিকা দেখায়। এছাড়াও, এটি channels.update পদ্ধতির জন্য বেশ কিছু নতুন সমস্যার তালিকা তৈরি করে।

১৪ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • স্ট্যান্ড-অ্যালোন পৃষ্ঠায় এখন Java, .NET, PHP ও Ruby-এর জন্য কোড স্যাম্পেল তালিকাভুক্ত করা আছে।

  • যে পৃষ্ঠায় Python কোড স্যাম্পেল তালিকাভুক্ত করা আছে, সেখানে এখন সাবস্ক্রিপশন যোগ করা, প্লেলিস্ট তৈরি করা এবং ভিডিও আপডেট করার উদাহরণ অন্তর্ভুক্ত করা হয়েছে।

১০ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

৮ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি করা হয়েছে:

  • চ্যানেল রিসোর্স এখন inVideoPromotion অবজেক্টে কাজ করে, যা চ্যানেলের সাথে যুক্ত প্রোমোশনাল ক্যাম্পেন সম্পর্কে তথ্য এনক্যাপসুলেট করে। চ্যানেলের ভিডিও প্লেব্যাক চলাকালীন, কোনও চ্যানেলের ভিডিও প্লেয়ারের মধ্যে প্রচারিত ভিডিওর থাম্বনেল ছবি দেখাতে, চ্যানেলটি ইন-ভিডিও প্রচারমূলক ক্যাম্পেন ব্যবহার করতে পারে।

    channels.list অনুরোধে part প্যারামিটার ভ্যালুতে invideoPromotion যোগ করে আপনি এই ডেটা রিট্রিভ করতে পারবেন।

  • নতুন channels.update পদ্ধতি ব্যবহার করে চ্যানেলের ইন-ভিডিও প্রোমোশনাল ক্যাম্পেন ডেটা আপডেট করা যাবে। মনে রাখবেন যে পদ্ধতিটি শুধুমাত্র channel রিসোর্সের invideoPromotion অংশের আপডেট সমর্থন করে এবং এখনও সেই রিসোর্সের অন্যান্য অংশের আপডেট সমর্থন করে না।

২ মে, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • চ্যানেল রিসোর্স এখন status.isLinked প্রপার্টি কাজ করে, যা থেকে বোঝা যায় যে চ্যানেল ডেটা এমন কোনও ব্যবহারকারীকে শনাক্ত করে কিনা যিনি আগে থেকেই YouTube ইউজারনেম বা Google+ অ্যাকাউন্টের সাথে লিঙ্ক করেছেন। যে ব্যবহারকারীর কাছে এই লিঙ্কগুলির মধ্যে একটি আছে, তার ইতিমধ্যেই একটি সর্বজনীন YouTube পরিচয় আছে, যা ভিডিও আপলোড করার মতো বিভিন্ন অ্যাকশনের জন্য পূর্বশর্ত।

  • সাবস্ক্রিপশন রিসোর্স এখন subscriberSnippet পার্টকে সাপোর্ট করে। সেই অবজেক্টে সাবস্ক্রাইবারের চ্যানেলের জন্য স্নিপেট ডেটা থাকে।

  • API এখন videos.getRating পদ্ধতি সমর্থন করে, যা যাচাইকৃত ব্যবহারকারীর এক বা একাধিক ভিডিওর তালিকায় দেওয়া রেটিংগুলি পুনরুদ্ধার করে।

  • videos.list পদ্ধতির নতুন myRating প্যারামিটার আপনাকে এমন ভিডিওর তালিকা পেতে সাহায্য করে যেগুলি যাচাই করা ব্যবহারকারী like বা dislike রেটিং দিয়েছেন।

    myRating প্যারামিটার এবং id প্যারামিটার, দুটিকেই এখন ফিল্টার প্যারামিটার হিসেবে বিবেচনা করা হয়, যার অর্থ হল একটি API অনুরোধে অবশ্যই প্যারামিটারগুলির মধ্যে একটি নির্দিষ্ট করতে হবে। (আগে, এই পদ্ধতির জন্য id প্যারামিটারটি একটি প্রয়োজনীয় প্যারামিটার ছিল।)

    ভিডিও রেটিং সংক্রান্ত তথ্য ফিরিয়ে আনার চেষ্টা করা হলেও সঠিকভাবে অনুমোদিত না হলে, এই পদ্ধতি forbidden সংক্রান্ত সমস্যার মেসেজ দেখায়।

  • myRating প্যারামিটার চালু করার সাথে সাথে, পেজিনেশন সাপোর্ট করার জন্য videos.list পদ্ধতিও আপডেট করা হয়েছে। তবে মনে রাখবেন, পেজিং প্যারামিটার শুধুমাত্র myRating প্যারামিটার ব্যবহার করা অনুরোধের ক্ষেত্রে কাজ করে। (id প্যারামিটার ব্যবহার করে এমন অনুরোধের ক্ষেত্রে পেজিং প্যারামিটার এবং তথ্য কাজ করে না।)

    • maxResults প্যারামিটারটি API-এর মাধ্যমে ফলাফল সেটে সর্বাধিক কতগুলি ভিডিও দেখানো যেতে পারে তা নির্দিষ্ট করে এবং pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা আপনি ফিরিয়ে আনতে চান।

    • youtube#videoListResponse রিসোর্স, যা videos.list অনুরোধের উত্তরে ফেরত দেওয়া হয়, এখন pageInfo অবজেক্ট রয়েছে, যাতে ফলাফলের মোট সংখ্যা এবং বর্তমান ফলাফল সেটে অন্তর্ভুক্ত ফলাফলের সংখ্যার মতো বিবরণ রয়েছে। youtube#videoListResponse রিসোর্সে nextPageToken এবং prevPageToken প্রপার্টিও অন্তর্ভুক্ত থাকতে পারে, যার প্রতিটি একটি টোকেন প্রদান করে যা ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে।

  • videos.insert পদ্ধতিতে নিম্নলিখিত নতুন প্যারামিটার কাজ করে:

    • autoLevels – ভিডিওর আলো ও রঙ অটোমেটিক উন্নত করার জন্য YouTube-কে নির্দেশ দিতে এই প্যারামিটারের মান true-এ সেট করুন।
    • stabilize – এই প্যারামিটারের মান true-এ সেট করুন যাতে YouTube-কে ক্যামেরা নড়াচড়ার ফলে হওয়া কাঁপুনি সরিয়ে ভিডিওটি অ্যাডজাস্ট করার নির্দেশ দেওয়া যায়।

  • channelTitle প্রপার্টিটি নিম্নলিখিত রিসোর্সের জন্য snippet-এ যোগ করা হয়েছে:

    • playlistItem – এই প্রপার্টিটি সেই চ্যানেলের নাম নির্দিষ্ট করে যেটি প্লেলিস্ট আইটেম যোগ করেছে।
    • playlist – এই প্রপার্টি সেই চ্যানেলের নাম উল্লেখ করে যেটি প্লেলিস্ট তৈরি করেছে।
    • subscription – এই প্রপার্টি সাবস্ক্রাইব করা চ্যানেলের নাম নির্দিষ্ট করে।

  • নিম্নলিখিত পদ্ধতির জন্য কোডের নমুনা যোগ করা হয়েছে:

  • subscriptions.list পদ্ধতির নতুন mySubscribers প্যারামিটার আপনাকে বর্তমানে যাচাই করা ব্যবহারকারীর সাবস্ক্রাইবারদের একটি তালিকা ফিরিয়ে আনতে দেয়। এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।

    মনে রাখবেন: এই কার্যকারিতা channels.list পদ্ধতির জন্য বর্তমানে কাজ করে এমন mySubscribers প্যারামিটারকে প্রতিস্থাপন করার জন্য তৈরি করা হয়েছে। সেই প্যারামিটার বন্ধ করে দেওয়া হবে।

  • video রিসোর্সে, unspecified প্রপার্টি ভ্যালু নিম্নলিখিত যেকোনও প্রপার্টির জন্য আর সম্ভাব্য ভ্যালু নয়:

  • API অনুরোধে অপ্রত্যাশিত প্যারামিটার থাকলে এখন badRequest সমস্যা দেখায় এবং সমস্যার কারণ হিসেবে unexpectedParameter উল্লেখ করা হয়।

  • প্লেলিস্টে সর্বাধিক অনুমোদিত আইটেম আগে থেকেই থাকলে playlistItems.insert পদ্ধতি যে সমস্যা দেখায় সেটি আপডেট করা হয়েছে। সমস্যাটি এখন forbidden সমস্যা হিসেবে রিপোর্ট করা হয়েছে এবং সমস্যার কারণ হল playlistContainsMaximumNumberOfVideos।

১৯ এপ্রিল, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন videos.rate পদ্ধতি ব্যবহারকারীকে ভিডিওতে like বা dislike রেটিং সেট করতে বা ভিডিও থেকে রেটিং সরাতে দেয়।

    videos.rate মেথড কলের উত্তরে API যেসব সমস্যা দেখাতে পারে, সেগুলি তালিকাভুক্ত করতে সমস্যা সংক্রান্ত ডকুমেন্টেশনও আপডেট করা হয়েছে।

  • API ডকুমেন্টেশনে থাম্বনেল ছবিকে এখন আলাদা রিসোর্স হিসেবে শনাক্ত করা হয় এবং নতুন thumbnails.set মেথড আপনাকে YouTube-এ কাস্টম ভিডিও থাম্বনেল আপলোড করতে এবং কোনও ভিডিওর জন্য সেটি সেট করতে দেয়।

    thumbnails.set মেথড কলের উত্তরে API যেসব সমস্যা দেখাতে পারে, তার তালিকা দেখানোর জন্য সমস্যা সংক্রান্ত ডকুমেন্টেশন আপডেট করা হয়েছে।

    মনে রাখবেন, এই পরিবর্তনটি থাম্বনেল ছবি ফিরিয়ে দেয় এমন আগে থেকে থাকা রিসোর্সকে প্রভাবিত করে না। থাম্বনেল ছবিগুলি সেই রিসোর্সে আগের মতোই ফেরত দেওয়া হয়, যদিও ডকুমেন্টেশনে এখন বিভিন্ন থাম্বনেল সাইজের নাম তালিকাভুক্ত করা হয়েছে যা API ফেরত দিতে পারে।

  • channel রিসোর্সের নতুন brandingSettings পার্ট চ্যানেলের চ্যানেল পৃষ্ঠা ও ভিডিও দেখার পৃষ্ঠার জন্য সেটিংস, টেক্সট ও ছবি শনাক্ত করে।

  • playlistItem রিসোর্সে নিম্নলিখিত নতুন প্রপার্টি রয়েছে:

    • নতুন status অবজেক্ট প্লেলিস্ট আইটেম সম্পর্কে স্ট্যাটাস তথ্য এনক্যাপসুলেট করে এবং status.privacyStatus প্রপার্টি প্লেলিস্ট আইটেমের গোপনীয়তা স্ট্যাটাস শনাক্ত করে।

  • video রিসোর্সে নিম্নলিখিত নতুন প্রপার্টি রয়েছে:

    • status.publicStatsViewable প্রপার্টি থেকে বোঝা যায় যে দেখার পৃষ্ঠায় ভিডিওর এক্সটেন্ডেড পরিসংখ্যান সর্বজনীনভাবে দেখা যাবে কিনা। ডিফল্ট হিসেবে, সেইসব পরিসংখ্যান দেখা যায় এবং এই প্রপার্টির ভ্যালু false হিসেবে সেট করা থাকলেও ভিডিওর ভিউ সংখ্যা ও রেটিংয়ের মতো পরিসংখ্যান এখনও সর্বজনীনভাবে দেখা যাবে। videos.insert বা videos.update মেথড কল করার সময় আপনি এই প্রপার্টির ভ্যালু সেট করতে পারবেন।

    • contentDetails.contentRating অবজেক্টে বিভিন্ন রেটিং স্কিমের অধীনে ভিডিওর পাওয়া রেটিং এনক্যাপসুলেট করা থাকে। নিচের তালিকা থেকে কাজ করে এমন রেটিং সিস্টেম শনাক্ত করা যায় এবং প্রতিটি রেটিং সিস্টেমের সাথে যুক্ত প্রপার্টির লিঙ্ক পাওয়া যায়। প্রপার্টি সংজ্ঞা প্রতিটি সিস্টেমের জন্য কাজ করে এমন রেটিং ভ্যালু শনাক্ত করে।

      দেশ রেটিং সিস্টেম প্রপার্টি
      United States মোশন পিকচার অ্যাসোসিয়েশন অফ আমেরিকা (MPAA) contentDetails.contentRating.mpaaRating
      United States অভিভাবকদের জন্য টিভি সম্পর্কিত নির্দেশিকা contentDetails.contentRating.tvpgRating
      Australia অস্ট্রেলিয়ান ক্লাসিফিকেশন বোর্ড (ACB) contentDetails.contentRating.acbRating
      Brazil Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
      Canada কানাডিয়ান হোম ভিডিও রেটিং সিস্টেম (CHVRS) contentDetails.contentRating.chvrsRating
      France Centre national du cinéma et de l'image animée (French Ministry of Culture) contentDetails.contentRating.fmocRating
      Germany Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
      Great Britain ব্রিটিশ বোর্ড অফ ফিল্ম ক্লাসিফিকেশন (BBFC) contentDetails.contentRating.bbfcRating
      India সেন্ট্রাল বোর্ড অফ ফিল্ম সার্টিফিকেশন (CBFC) contentDetails.contentRating.cbfcRating
      Japan 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
      Korea 영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
      Mexico রেডিও, টেলিভিশন এবং সিনেমাটোগ্রাফির জেনারেল ডিরেক্টরেট (RTC) contentDetails.contentRating.rtcRating
      New Zealand অফিস অফ ফিল্ম অ্যান্ড লিটারেচার ক্লাসিফিকেশন contentDetails.contentRating.oflcRating
      Russia রাশিয়ান ফেডারেশনের ন্যাশনাল ফিল্ম রেজিস্ট্রি contentDetails.contentRating.russiaRating
      Spain Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating

  • playlistItems.update পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে যাতে বোঝা যায় যে অনুরোধের বডি হিসেবে পাঠানো রিসোর্সে snippet.resourceId প্রপার্টি উল্লেখ করতে হবে।

  • search.list পদ্ধতিতে এখন নিম্নলিখিত কার্যকারিতা কাজ করে:

    • নতুন forMine প্যারামিটার কোনও সার্চকে শুধুমাত্র যাচাই করা ব্যবহারকারীর ভিডিও খুঁজে পাওয়ার মধ্যে সীমাবদ্ধ করে।

    • order প্যারামিটার এখন বর্ণানুক্রমিকভাবে শিরোনাম (order=title) বা ভিডিও সংখ্যা অনুসারে নিম্নক্রম (order=videoCount) অনুযায়ী ফলাফল সাজানোর সুবিধা দেয়।

    • নতুন safeSearch প্যারামিটার থেকে বোঝা যায় যে সার্চ ফলাফলে বিধিনিষেধযুক্ত কন্টেন্ট অন্তর্ভুক্ত করা উচিত কিনা।

  • videos.insert পদ্ধতিতে বেশ কিছু নতুন সমস্যার সমাধান করা যায়, যেগুলি নিচের সারণীতে তালিকাভুক্ত করা হয়েছে:

    সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    badRequest invalidCategoryId snippet.categoryId প্রপার্টি ভুল ক্যাটাগরি আইডি নির্দিষ্ট করে। কাজ করে এমন বিভাগ ফিরিয়ে আনতে videoCategories.list পদ্ধতি ব্যবহার করুন।
    badRequest invalidRecordingDetails metadata-এ রেকর্ডিংয়ের ভুল বিবরণ উল্লেখ করা আছে।
    badRequest invalidVideoGameRating অনুরোধের মেটাডেটা একটি ভুল ভিডিও গেম রেটিং উল্লেখ করে।
    badRequest invalidVideoMetadata অনুরোধের মেটাডেটা সঠিক নয়।

  • videos.update এবং videos.delete পদ্ধতির জন্য কাজ করে এমন প্যারামিটারের তালিকা থেকে onBehalfOfContentOwner প্যারামিটারটি সরিয়ে দেওয়া হয়েছে।

১২ মার্চ, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নিম্নলিখিত রিসোর্সের জন্য snippet-এ channelTitle প্রপার্টি যোগ করা হয়েছে:

    • activity – এই প্রপার্টি অ্যাক্টিভিটির জন্য দায়ী চ্যানেলের নাম নির্দিষ্ট করে।
    • search – এই প্রপার্টি সার্চ ফলাফলের মাধ্যমে শনাক্ত করা রিসোর্সের সাথে যুক্ত চ্যানেলের নাম নির্দিষ্ট করে।
    • video – এই প্রপার্টি সেই চ্যানেলের নাম নির্দিষ্ট করে যেটি ভিডিও আপলোড করেছে।

  • search.list পদ্ধতিতে নিম্নলিখিত নতুন প্যারামিটার কাজ করে:

    • channelType প্যারামিটার আপনাকে সব চ্যানেল বা শুধুমাত্র শো খুঁজে পেতে চ্যানেল সার্চ সীমাবদ্ধ করতে দেয়।

    • videoType প্যারামিটার আপনাকে ভিডিওর সার্চ সীমাবদ্ধ করতে দেয় যাতে সব ভিডিও বা শুধুমাত্র সিনেমা বা শুধুমাত্র শোয়ের পর্ব খুঁজে পাওয়া যায়।

  • video রিসোর্সের recordingDetails অংশের সংজ্ঞা আপডেট করা হয়েছে যাতে এটি উল্লেখ করা যায় যে ভিডিওর জিওলোকেশন ডেটা বা রেকর্ডিং সময় সেট করা থাকলে তবেই অবজেক্টটি ভিডিওর জন্য রিটার্ন করা হবে।

  • playlistItems.update পদ্ধতি এখন একটি invalidSnippet সমস্যা দেখায়, যা API অনুরোধে সঠিক স্নিপেট উল্লেখ না থাকলে দেখানো হয়।

  • বেশ কয়েকটি API পদ্ধতিতে নতুন প্যারামিটার কাজ করে যা শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে। YouTube কন্টেন্ট পার্টনারদের মধ্যে সিনেমা ও টেলিভিশন স্টুডিও, রেকর্ড লেবেল এবং অন্যান্য কন্টেন্ট ক্রিয়েটররা অন্তর্ভুক্ত যারা YouTube-এ তাদের কন্টেন্ট উপলভ্য করে।

    • onBehalfOfContentOwner প্যারামিটার থেকে বোঝা যায় যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল এমন একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে উল্লেখ করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

      এই প্যারামিটারটি সেইসব কন্টেন্ট পার্টনারদের জন্য যারা একাধিক YouTube চ্যানেলের মালিক ও ম্যানেজ করেন। এই প্যারামিটার সেইসব পার্টনারকে একবার যাচাইকরণ করার এবং তাদের সব ভিডিও ও চ্যানেল ডেটার অ্যাক্সেস পাওয়ার সুবিধা দেয়, যার ফলে প্রতিটি চ্যানেলের জন্য আলাদা করে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল দিতে হয় না।

      channels.list, search.list, videos.delete, videos.list এবং videos.update পদ্ধতিগুলি এই প্যারামিটারকে সমর্থন করে।

    • channels.list মেথড দ্বারা কাজ করে এমন managedByMe প্যারামিটার, API-কে নির্দেশ দেয় যে কন্টেন্টের মালিকের মালিকানাধীন সেইসব চ্যানেল ফেরত দিতে হবে যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে।

    • forContentOwner প্যারামিটার, যা search.list পদ্ধতি দ্বারা সমর্থিত, API-কে নির্দেশ দেয় যে সার্চ ফলাফলকে শুধুমাত্র সেই রিসোর্সের মধ্যে সীমাবদ্ধ রাখতে যা onBehalfOfContentOwner প্যারামিটার দ্বারা নির্দিষ্ট করা কন্টেন্টের মালিকের মালিকানাধীন।

২৫ ফেব্রুয়ারি, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • API-তে video রিসোর্সের জন্য একাধিক নতুন পার্ট ও প্রপার্টি কাজ করে:

    • নতুন fileDetails, processingDetails ও suggestions অংশ ভিডিওর মালিকদের তাদের আপলোড করা ভিডিও সম্পর্কে তথ্য প্রদান করে। ভিডিও আপলোড করার সুবিধা আছে এমন অ্যাপ্লিকেশনে এই ডেটা খুব কাজে লাগে এবং এর মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:

      • প্রসেসিং স্ট্যাটাস ও প্রোগ্রেস
      • ভিডিও প্রসেস করার সময় কোনও সমস্যা বা ত্রুটি দেখা দেওয়া
      • থাম্বনেল ছবির উপলভ্যতা
      • ভিডিও বা মেটাডেটার কোয়ালিটি উন্নত করার সাজেশন
      • YouTube-এ আপলোড করা আসল ফাইল সম্পর্কে বিবরণ

      এইসব অংশ শুধুমাত্র ভিডিওর মালিকই পুনরুদ্ধার করতে পারবেন। নিচের তালিকায় নতুন অংশগুলি সংক্ষেপে বর্ণনা করা হয়েছে এবং video রিসোর্স ডকুমেন্টেশনে প্রতিটি অংশের সব প্রপার্টি সংজ্ঞায়িত করা হয়েছে।

      • fileDetails অবজেক্টে YouTube-এ আপলোড করা ভিডিও ফাইল সংক্রান্ত তথ্য থাকে, যার মধ্যে ফাইলের রেজোলিউশন, দৈর্ঘ্য, অডিও ও ভিডিও কোডেক, স্ট্রিম বিটরেট ও আরও অনেক কিছু অন্তর্ভুক্ত।

      • আপলোড করা ভিডিও ফাইল প্রসেস করার ব্যাপারে YouTube-এর অগ্রগতি সংক্রান্ত তথ্য processingProgress অবজেক্টে থাকে। অবজেক্টের প্রপার্টি বর্তমান প্রসেসিং স্ট্যাটাস শনাক্ত করে এবং YouTube-এর ভিডিও প্রসেস করা শেষ হতে কত সময় বাকি আছে তা অনুমান করে। এছাড়াও, এই অংশটি থেকে বোঝা যায় যে ভিডিওর জন্য ফাইলের বিবরণ বা থাম্বনেল ছবির মতো বিভিন্ন ধরনের ডেটা বা কন্টেন্ট উপলভ্য আছে কিনা।

        এই অবজেক্টটি পোল করার জন্য ডিজাইন করা হয়েছে যাতে ভিডিও আপলোডার আপলোড করা ভিডিও ফাইল প্রসেস করার ক্ষেত্রে YouTube-এর অগ্রগতি ট্র্যাক করতে পারে।

      • suggestions অবজেক্টে এমন সাজেশন থাকে যা আপলোড করা ভিডিওর কোয়ালিটি বা মেটাডেটা উন্নত করার সুযোগ শনাক্ত করে।

    • contentDetails অংশে চারটি নতুন প্রপার্টি আছে। অননুমোদিত অনুরোধের মাধ্যমে এইসব প্রপার্টি পুনরুদ্ধার করা যেতে পারে।

      • dimension – ভিডিওটি 2D বা 3D ফর্ম্যাটে উপলভ্য কিনা তা নির্দেশ করে।
      • definition – ভিডিওটি স্ট্যান্ডার্ড নাকি হাই ডেফিনিশনে উপলভ্য তা দেখায়।
      • caption – ভিডিওর জন্য ক্যাপশন উপলভ্য আছে কিনা তা নির্দেশ করে।
      • licensedContent – ভিডিওতে এমন কন্টেন্ট আছে কিনা তা দেখায় যার জন্য YouTube কন্টেন্ট পার্টনার দাবি জানিয়েছেন।

    • status অংশে দুটি নতুন প্রপার্টি রয়েছে। ভিডিও মালিকরা ভিডিও যোগ বা আপডেট করার সময় দুটি প্রপার্টির জন্য ভ্যালু সেট করতে পারেন। এছাড়াও, যাচাই না করা অনুরোধের মাধ্যমে এইসব প্রপার্টি রিট্রিভ করা যেতে পারে।

      • embeddable – ভিডিওটি অন্য কোনও ওয়েবসাইটে এম্বেড করা যাবে কিনা তা দেখায়।
      • license – ভিডিওর লাইসেন্স নির্দিষ্ট করে। সঠিক ভ্যালু হল creativeCommon এবং youtube।

  • videos.list, videos.insert ও videos.update পদ্ধতির জন্য part প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে। এর ফলে উপরে বর্ণিত নতুন যোগ করা পার্ট এবং recordingDetails পার্ট তালিকাভুক্ত করা যাবে। পার্টটি ভুলবশত বাদ পড়ে গিয়েছিল।

  • channel রিসোর্সের নতুন contentDetails.googlePlusUserId প্রপার্টি চ্যানেলের সাথে যুক্ত Google+ প্রোফাইল আইডি নির্দিষ্ট করে। Google+ প্রোফাইলের লিঙ্ক তৈরি করতে এই ভ্যালু ব্যবহার করা যেতে পারে।

  • প্রতিটি থাম্বনেল ইমেজ অবজেক্ট এখন ছবির প্রস্থ এবং উচ্চতা নির্দিষ্ট করে। থাম্বনেল ছবি বর্তমানে activity, channel, playlist, playlistItem, search result, subscription এবং video রিসোর্সে ফেরত দেওয়া হয়।

  • playlistItems.list এখন videoId প্যারামিটারকে সাপোর্ট করে, যা playlistId প্যারামিটারের সাথে ব্যবহার করে শুধুমাত্র নির্দিষ্ট ভিডিওর প্লেলিস্ট আইটেম ফিরিয়ে আনা যায়।

    প্যারামিটার দ্বারা শনাক্ত করা ভিডিও প্লেলিস্টে খুঁজে পাওয়া না গেলে API notFound ত্রুটি দেখায়।

  • সমস্যার ডকুমেন্টেশনে একটি নতুন forbidden সমস্যার কথা বলা হয়েছে, যা থেকে বোঝা যায় যে অনুরোধ করা অ্যাকশনের জন্য কোনও অনুরোধ সঠিকভাবে অনুমোদিত নয়।

  • channel রিসোর্সের snippet.channelId প্রপার্টি সরিয়ে দেওয়া হয়েছে। রিসোর্সের id প্রপার্টি একই ভ্যালু প্রদান করে।

৩০ জানুয়ারি, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নতুন সমস্যা সংক্রান্ত পৃষ্ঠায় API-এর মাধ্যমে ফেরত পাঠানো যেতে পারে এমন সমস্যার তালিকা দেওয়া আছে। এই পৃষ্ঠায় সাধারণ সমস্যা অন্তর্ভুক্ত থাকে, যা একাধিক আলাদা API পদ্ধতির জন্য ঘটতে পারে, সেইসাথে পদ্ধতি-নির্দিষ্ট সমস্যাও থাকে।

১৬ জানুয়ারি, ২০১৩

এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

  • নিচের তালিকায় দেখানো পদ্ধতি ও ভাষার জন্য কোড স্যাম্পেল এখন উপলভ্য:

  • activity রিসোর্স এখন channelItem অ্যাকশন রিপোর্ট করতে পারে, যা YouTube কোনও ভিডিও অটোমেটিক তৈরি হওয়া YouTube চ্যানেলে যোগ করলে ঘটে। (YouTube অ্যালগরিদম এমন বিষয় শনাক্ত করে যেগুলি YouTube ওয়েবসাইটে উল্লেখযোগ্যভাবে উপস্থিত থাকে এবং সেইসব বিষয়ের জন্য অটোমেটিক চ্যানেল তৈরি করে।)

  • নিম্নলিখিত search.listটি প্যারামিটার আপডেট করা হয়েছে:

    • q প্যারামিটারটি আর ফিল্টার হিসেবে মনোনীত করা হয়নি, যার অর্থ হল ....
    • relatedToVideo প্যারামিটারের নাম পরিবর্তন করে relatedToVideoId করা হয়েছে।
    • published প্যারামিটারের পরিবর্তে দুটি নতুন প্যারামিটার, publishedAfter ও publishedBefore যোগ করা হয়েছে, যেগুলির বিবরণ নিচে দেওয়া হল।

  • search.list পদ্ধতিতে নিম্নলিখিত নতুন প্যারামিটার কাজ করে:

    প্যারামিটারের নাম ভ্যালু বিবরণ
    channelId string নির্দিষ্ট চ্যানেলের তৈরি করা রিসোর্স রিটার্ন করে।
    publishedAfter datetime নির্দিষ্ট সময়ের পরে তৈরি করা রিসোর্স ফেরত দেয়।
    publishedBefore datetime নির্দিষ্ট সময়ের আগে তৈরি করা রিসোর্স ফেরত দেয়।
    regionCode string নির্দিষ্ট দেশের জন্য রিসোর্স ফেরত দিন।
    videoCategoryId string ভিডিওর বিভাগ উল্লেখ করে ভিডিও সার্চ ফলাফল ফিল্টার করুন যাতে শুধু সেই বিভাগের ভিডিওই দেখানো হয়।
    videoEmbeddable string ভিডিও সার্চ ফলাফল ফিল্টার করুন যাতে শুধুমাত্র এমন ভিডিও অন্তর্ভুক্ত থাকে যা কোনও ওয়েব পৃষ্ঠায় এম্বেড করা প্লেয়ারে চালানো যায়। শুধুমাত্র এম্বেড করা যায় এমন ভিডিও পেতে প্যারামিটারের ভ্যালু true হিসেবে সেট করুন।
    videoSyndicated string ভিডিও সার্চ ফলাফল ফিল্টার করুন যাতে শুধুমাত্র YouTube.com-এর বাইরে চালানো যায় এমন ভিডিও অন্তর্ভুক্ত করা যায়। শুধুমাত্র সিন্ডিকেট করা ভিডিও পেতে প্যারামিটারের মান true-এ সেট করুন।

  • একাধিক API রিসোর্সে নতুন প্রপার্টি কাজ করে। নিচের সারণীতে রিসোর্স ও সেগুলির নতুন প্রপার্টি শনাক্ত করা হয়েছে:

    রিসোর্স প্রপার্টির নাম ভ্যালু বিবরণ
    activity contentDetails.playlistItem.playlistItemId string প্লেলিস্ট আইটেম আইডি যা YouTube প্লেলিস্টে আইটেমকে অনন্যভাবে শনাক্ত করার জন্য অ্যাসাইন করেছে।
    activity contentDetails.channelItem object একটি অবজেক্ট যাতে চ্যানেলে যোগ করা রিসোর্স সম্পর্কে তথ্য থাকে। snippet.type channelItem হলে তবেই এই প্রপার্টি থাকে।
    activity contentDetails.channelItem.resourceId object চ্যানেলে যোগ করা রিসোর্সকে শনাক্ত করে এমন একটি অবজেক্ট। অন্যান্য resourceId প্রপার্টির মতো, এতে একটি kind প্রপার্টি থাকে যা ভিডিও বা প্লেলিস্টের মতো রিসোর্সের ধরন নির্দিষ্ট করে। এছাড়াও, এতে একাধিক প্রপার্টির মধ্যে ঠিক একটি প্রপার্টি – videoId, playlistId ইত্যাদি – থাকে যা সেই আইডি নির্দিষ্ট করে যা অনন্যভাবে সেই রিসোর্সকে শনাক্ত করে।
    channel status object এই অবজেক্ট চ্যানেলের গোপনীয়তা স্ট্যাটাস সংক্রান্ত তথ্য এনক্যাপসুলেট করে।
    channel status.privacyStatus string চ্যানেলের গোপনীয়তা সংক্রান্ত স্ট্যাটাস। সঠিক ভ্যালু হল private এবং public।
    playlist contentDetails object এই অবজেক্টে প্লেলিস্টের কন্টেন্ট সম্পর্কিত মেটাডেটা থাকে।
    playlist contentDetails.itemCount unsigned integer প্লেলিস্টে থাকা ভিডিওর সংখ্যা।
    playlist player object এই অবজেক্টে এমন তথ্য থাকে যা আপনি এম্বেড করা প্লেয়ারে প্লেলিস্ট চালানোর জন্য ব্যবহার করবেন।
    playlist player.embedHtml string একটি <iframe> ট্যাগ যা প্লেলিস্ট চালানো ভিডিও প্লেয়ারকে এম্বেড করে।
    video recordingDetails object এই অবজেক্টে ভিডিও রেকর্ড করার স্থান এবং সময় শনাক্ত বা বর্ণনা করে এমন তথ্য এনক্যাপসুলেট করা থাকে।
    video recordingDetails.location object এই অবজেক্টে ভিডিওর সাথে যুক্ত ভৌগোলিক লোকেশন সংক্রান্ত তথ্য থাকে।
    video recordingDetails.location.latitude double ডিগ্রিতে অক্ষাংশ।
    video recordingDetails.location.longitude double ডিগ্রিতে দ্রাঘিমাংশ।
    video recordingDetails.location.elevation double পৃথিবীর উপরে উচ্চতা, মিটারে।
    video recordingDetails.locationDescription string ভিডিওটি যেখানে রেকর্ড করা হয়েছে সেই লোকেশনের টেক্সট বিবরণ।
    video recordingDetails.recordingDate datetime ভিডিও রেকর্ড করার তারিখ ও সময়। ভ্যালু ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে উল্লেখ করা হয়েছে।

  • বিভিন্ন API পদ্ধতির ডকুমেন্টেশনে এখন এমন প্রপার্টি শনাক্ত করা হয় যেগুলি অনুরোধের বডিতে উল্লেখ করতে হবে অথবা অনুরোধের বডিতে থাকা ভ্যালুর উপর ভিত্তি করে আপডেট করা হয়। নিচের সারণীতে সেইসব পদ্ধতি এবং প্রয়োজনীয় বা পরিবর্তনযোগ্য প্রপার্টির তালিকা দেওয়া আছে।

    মনে রাখবেন: অন্যান্য পদ্ধতির ডকুমেন্টেশনে আগে থেকেই প্রয়োজনীয় ও পরিবর্তনযোগ্য প্রপার্টির তালিকা থাকতে পারে।

    পদ্ধতি প্রপার্টি
    activities.insert প্রয়োজনীয় প্রপার্টি:
    • snippet.description
    পরিবর্তনযোগ্য প্রপার্টি:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update প্রয়োজনীয় প্রপার্টি:
    • id
    playlistItems.update প্রয়োজনীয় প্রপার্টি:
    • id
    videos.update প্রয়োজনীয় প্রপার্টি:
    • id

  • একই চ্যানেলে আগে থেকে আছে এমন প্লেলিস্টের একই নাম দিয়ে আপনি কোনও প্লেলিস্ট তৈরি বা আপডেট করার চেষ্টা করলে, API আর playlistAlreadyExists সংক্রান্ত সমস্যার কথা জানায় না।

  • বেশ কিছু API পদ্ধতিতে নতুন ধরনের সমস্যার সমাধান করা যায়। নিচের টেবিলে পদ্ধতি ও নতুন কাজ করে এমন সমস্যাগুলি চিহ্নিত করা হয়েছে:

    পদ্ধতি সমস্যার ধরন সমস্যার বিবরণ বিবরণ
    guideCategories.list notFound notFound id প্যারামিটার দ্বারা শনাক্ত করা গাইড বিভাগ খুঁজে পাওয়া যায়নি। সঠিক মানের তালিকা পেতে guideCategories.list পদ্ধতি ব্যবহার করুন।
    playlistItems.delete forbidden playlistItemsNotAccessible নির্দিষ্ট প্লেলিস্ট আইটেম মুছে ফেলার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
    videoCategories.list notFound videoCategoryNotFound id প্যারামিটার দ্বারা শনাক্ত করা ভিডিওর বিভাগ খুঁজে পাওয়া যায়নি। বৈধ ভ্যালুর তালিকা পেতে videoCategories.list পদ্ধতি ব্যবহার করুন।