এই পৃষ্ঠাটি YouTube ডেটা API (v3) পরিবর্তন এবং ডকুমেন্টেশন আপডেটগুলি তালিকাভুক্ত করে৷ এই চেঞ্জলগে সাবস্ক্রাইব করুন ।
13 মার্চ, 2024
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
captions.insert
এবং captions.update
পদ্ধতির জন্য sync
পরামিতি অবমুক্ত করা হয়েছে। YouTube 12 এপ্রিল, 2024 থেকে প্যারামিটার সমর্থন করা বন্ধ করবে।
এই পরিবর্তনের ফলে, ক্যাপশন ট্র্যাকগুলি সন্নিবেশিত বা আপডেট করার সময় বিকাশকারীদের অবশ্যই সময়ের তথ্য অন্তর্ভুক্ত করতে হবে বা আপলোড ব্যর্থ হবে৷
12 মার্চ, 2024
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
captions
রিসোর্সের জন্য ডকুমেন্টেশন আপডেট করা হয়েছে লক্ষ্য করুন যে snippet.name
ক্ষেত্রের সর্বোচ্চ অনুমোদিত দৈর্ঘ্য হল 150 অক্ষর। ট্র্যাকের নাম তার চেয়ে দীর্ঘ হলে API একটি nameTooLong
ত্রুটি প্রদান করে।
7 মার্চ, 2024
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
channel
রিসোর্স সম্পত্তি brandingSettings.channel.moderateComments
অবমুক্ত করা হয়েছে। 7 মার্চ, 2024 থেকে YouTube প্যারামিটার সমর্থন করা বন্ধ করবে।
31 জানুয়ারী, 2024
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channels.list
পদ্ধতির নতুন forHandle
প্যারামিটার আপনাকে একটি চ্যানেলের YouTube হ্যান্ডেল নির্দিষ্ট করে তার সম্পর্কে তথ্য পুনরুদ্ধার করতে সক্ষম করে।
নভেম্বর 09, 2023
Comments
অধীনে videoId
সংস্থানের সমস্ত উল্লেখ মুছে ফেলা হয়েছে কারণ একটি API কল ব্যবহার করে videoId
সংস্থানটি ফেরত দেওয়া হচ্ছে না৷
12 সেপ্টেম্বর, 2023
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
comments.markAsSpam
পদ্ধতিটি বেশ কয়েক বছর ধরে বাতিল করা হয়েছে। এই পদ্ধতিটি ইতিমধ্যেই YouTube-এ অসমর্থিত এবং API এর মাধ্যমে আর সমর্থিত নয়৷
comments.markAsSpam
পদ্ধতির উল্লেখ করে সমস্ত নথিতে একটি অবচয় বিজ্ঞপ্তি যোগ করা হয়েছে।
22 আগস্ট, 2023
search.list
পদ্ধতি এখন videoPaidProductPlacement
প্যারামিটার সমর্থন করে। এই প্যারামিটারটি আপনাকে কেবলমাত্র সেই ভিডিওগুলি অন্তর্ভুক্ত করতে অনুসন্ধান ফলাফলগুলিকে ফিল্টার করতে সক্ষম করে যা নির্মাতা অর্থপ্রদানের প্রচার হিসাবে চিহ্নিত করেছেন৷
18 আগস্ট, 2023
video
রিসোর্সের liveStreamingDetails.concurrentViewers
এর সংজ্ঞা আপডেট করা হয়েছে নোট করার জন্য যে সমসাময়িক দর্শক গণনা করে যে YouTube ডেটা এপিআই রিটার্ন করে প্রসেসড, ডিস্প্যামড সমসাময়িক ভিউয়ার সংখ্যা YouTube অ্যানালিটিক্সের মাধ্যমে উপলব্ধ থেকে ভিন্ন হতে পারে। YouTube সহায়তা কেন্দ্র লাইভ স্ট্রিমিং মেট্রিক্স সম্পর্কে আরও তথ্য প্রদান করে।
7 আগস্ট, 2023
12 জুন, 2023-এ ঘোষণা করা হয়েছে , search.list
পদ্ধতির relatedToVideoId
প্যারামিটারটি বাতিল করা হয়েছে। সেই প্যারামিটারটি আর সমর্থিত নয়, এবং পরামিতির উল্লেখগুলি API ডকুমেন্টেশন থেকে সরানো হয়েছে।
জুন 28, 2023
thumbnails.set পদ্ধতিটি এখন uploadRateLimitExceeded
ত্রুটি সমর্থন করে, যা নির্দেশ করে যে চ্যানেলটি গত 24 ঘন্টার মধ্যে অনেকগুলি থাম্বনেল আপলোড করেছে এবং পরে আবার চেষ্টা করা উচিত।
জুন 12, 2023
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
search.list পদ্ধতির relatedToVideoId
প্যারামিটারটি বাতিল করা হয়েছে। 7 আগস্ট, 2023 থেকে YouTube প্যারামিটার সমর্থন করা বন্ধ করবে।
এই সময়ে, search.list
পদ্ধতির ডকুমেন্টেশনে একটি অবচয় বিজ্ঞপ্তি যোগ করা হয়েছে। এই প্যারামিটারটি 7 আগস্ট, 2023 তারিখে বা তার পরে search.list
ডকুমেন্টেশন থেকে সম্পূর্ণরূপে মুছে ফেলা হবে।
এছাড়াও, সম্পর্কিত ভিডিওগুলি কীভাবে পুনরুদ্ধার করা যায় তা প্রদর্শনের একটি উদাহরণ API বাস্তবায়ন গাইড থেকে সরানো হয়েছে।
22 আগস্ট, 2022
ভিডিও. পরিসংখ্যান ক্ষেত্রগুলির জন্য অসাক্ষরবিহীন লম্বা থেকে স্ট্রিং করার জন্য সঠিক টাইপ টীকা৷
5 আগস্ট, 2022
YouTube ক্যাপশন আইডি তৈরি করার উপায় পরিবর্তন করেছে এবং সেই পরিবর্তনের অংশ হিসাবে, সমস্ত ক্যাপশন ট্র্যাকগুলিতে নতুন ক্যাপশন আইডি বরাদ্দ করছে৷ caption_id
মান সংরক্ষণ করে এমন অ্যাপ্লিকেশনগুলির জন্য এই পরিবর্তনটি একটি পশ্চাদগামী-অসঙ্গত পরিবর্তন হতে পারে, যদিও এটি caption_id
মান সংরক্ষণ করে না এমন অ্যাপ্লিকেশনগুলিকে প্রভাবিত করবে না।
এখন থেকে 1 ডিসেম্বর, 2022-এর মধ্যে, captions.list
, captions.update
, captions.download
, এবং captions.delete
পদ্ধতিগুলি পুরানো এবং নতুন উভয় ক্যাপশন ট্র্যাক আইডি সমর্থন করবে৷ যাইহোক, 1 ডিসেম্বর, 2022 তারিখে বা তার পরে, YouTube পুরানো ক্যাপশন ট্র্যাক আইডি সমর্থন করা বন্ধ করবে। সেই সময়ে, একটি পুরানো ক্যাপশন ট্র্যাক আইডি সহ এই API পদ্ধতিগুলির যেকোনও কল করলে একটি captionNotFound
ত্রুটি দেখা দেবে৷
এই পরিবর্তনের জন্য প্রস্তুত করার জন্য, আপনার এখন থেকে 1 ডিসেম্বর, 2022 এর মধ্যে সমস্ত সঞ্চিত ক্যাপশন ট্র্যাক ডেটা সম্পূর্ণভাবে প্রতিস্থাপন করার পরিকল্পনা করা উচিত। এর মানে হল যে কোনও ভিডিওর জন্য আপনি ক্যাপশন ট্র্যাক ডেটা সঞ্চয় করেন, আপনার বর্তমানে সঞ্চিত ডেটা মুছে ফেলা উচিত, তারপরে কল করুন ভিডিওর জন্য ক্যাপশন ট্র্যাকগুলির বর্তমান সেট পুনরুদ্ধার করার জন্য captions.list
পদ্ধতি এবং API প্রতিক্রিয়াতে ডেটা সঞ্চয় করার জন্য যেমন আপনি সাধারণত করেন।
12 জুলাই, 2022
YouTube API পরিষেবা পরিষেবার শর্তাবলী আপডেট করা হয়েছে৷ আরও তথ্যের জন্য দয়া করে YouTube API পরিষেবার পরিষেবার শর্তাবলী দেখুন - পুনর্বিবেচনার ইতিহাস ৷
এপ্রিল 27, 2022
videos.insert
পদ্ধতির বিবরণ আপডেট করা হয়েছে যে আপলোড করা ভিডিওগুলির জন্য সর্বোচ্চ ফাইলের আকার 128GB থেকে 256GB হয়েছে।
8 এপ্রিল, 2022
subscriptions.list
পদ্ধতির myRecentSubscribers
এবং mySubscribers
প্যারামিটার সংজ্ঞা উভয়ই আপডেট করা হয়েছে যাতে লক্ষ্য করা যায় যে API দ্বারা প্রত্যাবর্তিত গ্রাহকের সর্বাধিক সংখ্যা সীমিত হতে পারে। এই পরিবর্তনটি একটি ডকুমেন্টেশন সংশোধনের প্রতিনিধিত্ব করে এবং API আচরণের পরিবর্তন নয়।
15 ডিসেম্বর, 2021
18 নভেম্বর, 2021- এ ঘোষণা করা হয়েছে, সমগ্র YouTube প্ল্যাটফর্ম জুড়ে ভিডিও অপছন্দের গণনাকে ব্যক্তিগত করার পরিবর্তনের সাথে, video
সংস্থানের statistics.dislikeCount
প্রপার্টি এখন ব্যক্তিগত।
আপনি YouTube এর অফিসিয়াল ব্লগে এই পরিবর্তন সম্পর্কে আরও জানতে পারেন৷
18 নভেম্বর, 2021
সমগ্র YouTube প্ল্যাটফর্ম জুড়ে ভিডিও অপছন্দের গণনাকে ব্যক্তিগত করার জন্য পরিবর্তনের সাথে সাথে, video
সংস্থানের statistics.dislikeCount
প্রপার্টিটি 13 ডিসেম্বর, 2021 থেকে ব্যক্তিগত করা হবে। এর মানে হল যে সম্পত্তিটি শুধুমাত্র videos.list
একটি API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে যদি API অনুরোধ ভিডিও মালিক দ্বারা প্রমাণীকৃত হয় তাহলে videos.list
endpoint.
videos.rate
এন্ডপয়েন্ট এই পরিবর্তন দ্বারা প্রভাবিত হয় না।
যে সকল ডেভেলপাররা অপছন্দের গণনা সর্বজনীনভাবে প্রদর্শন করেন না এবং এখনও তাদের API ক্লায়েন্টের জন্য অপছন্দের সংখ্যা প্রয়োজন তারা একটি ছাড়ের জন্য অনুমতি তালিকায় রাখার জন্য আবেদন করতে পারেন। একটি ছাড়ের জন্য আবেদন করতে, আপনাকে অবশ্যই এই আবেদনপত্রটি পূরণ করতে হবে।
আপনি YouTube এর অফিসিয়াল ব্লগে এই পরিবর্তন সম্পর্কে আরও জানতে পারেন৷
2 জুলাই, 2021
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
commentThreads.update
এন্ডপয়েন্টটি অবহেলিত হয়েছে এবং এটি আর সমর্থিত নয়। এই এন্ডপয়েন্ট সদৃশ কার্যকারিতা অন্যান্য API এন্ডপয়েন্টের মাধ্যমে উপলব্ধ। পরিবর্তে, আপনি comments.update
কল করতে পারেন
commentThreads
সম্পদের প্রয়োজন হয়, তাহলে commentThreads.list
পদ্ধতিতে একটি মাধ্যমিক কল করুন। জুলাই 1, 2021
10,000 ইউনিটের ডিফল্ট কোটা বরাদ্দের চেয়ে বেশি মঞ্জুর করার জন্য YouTube-এর API পরিষেবাগুলি ব্যবহারকারী সমস্ত বিকাশকারীদের অবশ্যই একটি API কমপ্লায়েন্স অডিট সম্পূর্ণ করতে হবে৷ আজ অবধি, কমপ্লায়েন্স অডিট প্রক্রিয়া এবং অতিরিক্ত কোটা ইউনিট বরাদ্দের জন্য অনুরোধ উভয়ই ডেভেলপাররা YouTube API পরিষেবাগুলি পূরণ এবং জমা দিয়ে পরিচালনা করেছে - অডিট এবং কোটা এক্সটেনশন ফর্ম ৷
এই প্রক্রিয়াগুলিকে স্পষ্ট করতে এবং আমাদের API পরিষেবাগুলি ব্যবহার করে ডেভেলপারদের চাহিদাগুলি আরও ভালভাবে মেটাতে, আমরা তিনটি নতুন ফর্ম এবং সেই ফর্মগুলি পূরণ করার জন্য একটি নির্দেশিকা যুক্ত করছি:
- অডিটেড ডেভেলপার রিকোয়েস্ট ফর্ম : ডেভেলপাররা যারা ইতিমধ্যেই একটি API কমপ্লায়েন্স অডিট পাস করেছেন তারা একটি বরাদ্দকৃত কোটা এক্সটেনশনের অনুরোধ করতে এই ছোট ফর্মটি পূরণ করতে এবং জমা দিতে পারেন।
- আপিল ফর্ম : যে ডেভেলপারদের API প্রকল্পগুলি একটি কমপ্লায়েন্স অডিটে ব্যর্থ হয়েছে (বা একটি কোটা ইউনিট বৃদ্ধি অস্বীকার করা হয়েছে) তারা এই ফর্মটি পূরণ করতে এবং জমা দিতে পারেন৷
- কন্ট্রোল ফর্মের পরিবর্তন : ডেভেলপার, অথবা যে কোনো পক্ষ একজন ডেভেলপারের পক্ষ থেকে এপিআই ক্লায়েন্ট পরিচালনা করছে, যারা এপিআই প্রজেক্টের সাথে সংশ্লিষ্ট নিয়ন্ত্রণের পরিবর্তন (উদাহরণস্বরূপ, স্টক ক্রয় বা বিক্রয়, একীভূতকরণ বা কর্পোরেট লেনদেনের অন্য ফর্মের মাধ্যমে) অনুভব করে এই ফর্মটি পূরণ করুন এবং জমা দিন। এটি YouTube এর API টিমকে আমাদের রেকর্ড আপডেট করতে, নতুন API প্রকল্পের ব্যবহারের ক্ষেত্রে সম্মতি নিরীক্ষণ করতে এবং বিকাশকারীর বর্তমান কোটা বরাদ্দ যাচাই করতে সক্ষম করে৷
প্রতিটি নতুন ফর্ম YouTube-এর API-এর আপনার উদ্দিষ্ট ব্যবহার সম্পর্কে আমাদের অবহিত করবে এবং আপনাকে আরও ভালভাবে সহায়তা করতে আমাদের সক্ষম করবে৷
আমাদের নতুন API কমপ্লায়েন্স অডিট গাইডে আরও বিশদ পাওয়া যায়।
12 মে, 2021
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
এই আপডেটটি নিম্নলিখিত API পরিবর্তনগুলিকে কভার করে:
channel
রিসোর্সেরcontentDetails.relatedPlaylists.favorites
প্রপার্টি বাতিল করা হয়েছে। 28 এপ্রিল, 2016 , রিভিশন হিস্ট্রি এন্ট্রিতে উল্লেখিত পছন্দের ভিডিওগুলির কার্যকারিতা ইতিমধ্যেই বেশ কয়েক বছর ধরে বাতিল করা হয়েছে৷এই আপডেটের আগে, 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-এর মাধ্যমে সমর্থিত নয়।
ফেব্রুয়ারী 9, 2021
playlistItem
সংস্থান দুটি নতুন বৈশিষ্ট্য সমর্থন করে:
-
snippet.videoOwnerChannelId
বৈশিষ্ট্যটি সেই চ্যানেলের আইডি সনাক্ত করে যেটি প্লেলিস্ট ভিডিও আপলোড করেছে৷ -
snippet.videoOwnerChannelTitle
বৈশিষ্ট্যটি সেই চ্যানেলের নাম চিহ্নিত করে যেটি প্লেলিস্ট ভিডিও আপলোড করেছে৷
28 জানুয়ারী, 2021
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
playlistItems.delete
,playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
, এবংplaylists.update
পদ্ধতিগুলি সবই একটি নতুনplaylistOperationUnsupported
ত্রুটি সমর্থন করে৷ ত্রুটিটি ঘটে যখন একটি অনুরোধ এমন একটি অপারেশন করার চেষ্টা করে যা একটি নির্দিষ্ট প্লেলিস্টের জন্য অনুমোদিত নয়৷ উদাহরণস্বরূপ, একজন ব্যবহারকারী তাদের আপলোড করা ভিডিও প্লেলিস্ট থেকে একটি ভিডিও মুছতে পারে না বা প্লেলিস্ট নিজেই মুছে ফেলতে পারে না।সব ক্ষেত্রে, এই ত্রুটিটি একটি
400
HTTP প্রতিক্রিয়া কোড (খারাপ অনুরোধ) প্রদান করে।playlistItems.list
পদ্ধতিরwatchHistoryNotAccessible
এবংwatchLaterNotAccessible
ত্রুটিগুলি ডকুমেন্টেশন থেকে সরানো হয়েছে৷ যদিও ব্যবহারকারীদের দেখার ইতিহাস এবং পরে দেখার তালিকাগুলি প্রকৃতপক্ষে, API এর মাধ্যমে অ্যাক্সেসযোগ্য নয়, এই বিশেষ ত্রুটিগুলি API দ্বারা ফেরত দেওয়া হয় না৷
15 অক্টোবর, 2020
বিকাশকারী নীতিতে দুটি নতুন বিভাগ যুক্ত করা হয়েছে:
- নতুন বিভাগ III.E.4.i YouTube এম্বেড করা প্লেয়ারের মাধ্যমে সংগৃহীত এবং পাঠানো ডেটা সম্পর্কে অতিরিক্ত তথ্য প্রদান করে। প্লেব্যাকের অভিপ্রায় নির্দেশ করার জন্য ব্যবহারকারী প্লেয়ারের সাথে ইন্টারঅ্যাক্ট করার আগে যেকোন ইউটিউব এমবেডেড প্লেয়ারের মাধ্যমে আপনি আমাদের কাছে পাঠানো যেকোন ব্যবহারকারীর ডেটার জন্য আপনি দায়ী। অটোপ্লে মিথ্যা সেট করে একজন ব্যবহারকারী প্লেয়ারের সাথে ইন্টারঅ্যাক্ট করার আগে আপনি YouTube-এর সাথে শেয়ার করা ডেটা সীমিত করতে পারেন।
- নতুন বিভাগ III.E.4.j আপনার সাইট এবং অ্যাপে এম্বেড করার আগে কন্টেন্টের মেড ফর কিডস (MFK) স্ট্যাটাস চেক করার সাথে সম্পর্কিত। আপনি আপনার API ক্লায়েন্টে এম্বেড করা ভিডিওগুলি কখন বাচ্চাদের জন্য তৈরি করা হয় তা জানার জন্য এবং সেই অনুযায়ী এমবেড করা প্লেয়ার থেকে সংগৃহীত ডেটা ব্যবহার করার জন্য আপনি দায়ী৷ যেমন, কোনো YouTube এম্বেড করা প্লেয়ারের মাধ্যমে আপনার API ক্লায়েন্টে এম্বেড করার আগে আপনাকে YouTube ডেটা API পরিষেবা ব্যবহার করে বিষয়বস্তুর স্থিতি পরীক্ষা করতে হবে।
একটি ভিডিও গাইডের নতুন ফাইন্ডিং দ্য MadeForKids স্ট্যাটাস ব্যাখ্যা করে যে কীভাবে YouTube ডেটা API পরিষেবা ব্যবহার করে একটি ভিডিওর MFK স্থিতি দেখতে হয়৷
এই পরিবর্তনগুলির সাথে একত্রে, এমবেডেড প্লেয়ার প্যারামিটার ডকুমেন্টেশনে একটি অনুস্মারক যোগ করা হয়েছে ব্যাখ্যা করার জন্য যে আপনি যদি অটোপ্লে সক্ষম করেন, প্লেব্যাক প্লেয়ারের সাথে কোনও ব্যবহারকারীর মিথস্ক্রিয়া ছাড়াই ঘটবে; প্লেব্যাক ডেটা সংগ্রহ এবং ভাগ করে নেওয়া তাই পৃষ্ঠা লোড হওয়ার পরে ঘটবে৷
8 অক্টোবর, 2020
এই আপডেটটি channel
সংস্থান সম্পর্কিত তিনটি ছোট পরিবর্তন কভার করে:
-
snippet.thumbnails
অবজেক্ট, যা একটি চ্যানেলের থাম্বনেইল চিত্রগুলি সনাক্ত করে, নতুন তৈরি চ্যানেলগুলির জন্য খালি হতে পারে এবং জনসংখ্যা হতে এক দিন পর্যন্ত সময় লাগতে পারে৷ -
statistics.videoCount
বৈশিষ্ট্য শুধুমাত্র চ্যানেলের সর্বজনীন ভিডিওর গণনাকে প্রতিফলিত করে, এমনকি মালিকদের কাছেও। এই আচরণ YouTube ওয়েবসাইটে দেখানো গণনার সাথে সামঞ্জস্যপূর্ণ। - চ্যানেল কীওয়ার্ডগুলি, যেগুলি
brandingSettings.channel.keywords
প্রপার্টিতে চিহ্নিত করা হয়, যদি সেগুলি সর্বাধিক অনুমোদিত দৈর্ঘ্য 500 অক্ষর অতিক্রম করে বা যদি সেগুলি অপ্রকাশিত উদ্ধৃতি চিহ্ন ("
) থাকে তবে ছেঁটে ফেলা হতে পারে৷ মনে রাখবেন যে 500 অক্ষরের সীমা প্রতি- নয়৷ কীওয়ার্ড সীমা কিন্তু সব কীওয়ার্ডের মোট দৈর্ঘ্যের একটি সীমা। এই আচরণটি YouTube ওয়েবসাইটের সাথে সামঞ্জস্যপূর্ণ।
সেপ্টেম্বর 9, 2020
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
এই আপডেটটি নিম্নলিখিত API পরিবর্তনগুলিকে কভার করে৷ এই ঘোষণার তারিখ 9 সেপ্টেম্বর 2020 থেকে বা তার পরে সমস্ত পরিবর্তন কার্যকর হবে৷ এটি মাথায় রেখে, বিকাশকারীদের আর নীচে তালিকাভুক্ত API বৈশিষ্ট্যগুলির উপর নির্ভর করা উচিত নয়।
- নিম্নলিখিত API সংস্থানগুলি, পদ্ধতিগুলি, পরামিতিগুলি এবং সংস্থান বৈশিষ্ট্যগুলি অবিলম্বে বাতিল করা হয়েছে এবং এই ঘোষণার তারিখে বা তার পরে কাজ করা বন্ধ করবে:
- নিম্নলিখিত
channel
সম্পদ বৈশিষ্ট্য:-
statistics.commentCount
সম্পত্তি -
brandingSettings.image
অবজেক্ট এবং এর সমস্ত চাইল্ড প্রপার্টি -
brandingSettings.hints
তালিকা এবং এর সমস্ত চাইল্ড প্রপার্টি
-
-
channels.list
পদ্ধতিরcategoryId
ফিল্টার প্যারামিটার -
guideCategories
রিসোর্স এবংguideCategories.list
পদ্ধতি
- নিম্নলিখিত
-
channels.list
পদ্ধতির API প্রতিক্রিয়াতে আরprevPageToken
প্রপার্টি থাকবে না যদি API অনুরোধmanagedByMe
প্যারামিটারটিকেtrue
সেট করে। এই পরিবর্তন অন্যান্যchannels.list
অনুরোধের জন্যprevPageToken
বৈশিষ্ট্যকে প্রভাবিত করে না এবং এটি কোনো অনুরোধের জন্যnextPageToken
সম্পত্তিকে প্রভাবিত করে না। -
channel
রিসোর্সেরcontentDetails.relatedPlaylists.watchLater
এবংcontentDetails.relatedPlaylists.watchHistory
বৈশিষ্ট্য উভয়ই 11 আগস্ট 2016- এ অবমুক্ত ঘোষণা করা হয়েছিল। এই প্লেলিস্টগুলির জন্যplaylistItems.insert
মেথড এবংplaylistItems.delete
মেথডের সমর্থনও এখন সম্পূর্ণরূপে অবহেলিত, এবং দুটি বৈশিষ্ট্য ডকুমেন্টেশন থেকে মুছে ফেলা হয়েছে৷ -
channels.list
পদ্ধতিরmySubscribers
প্যারামিটার, যা 30 জুলাই 2013 তারিখে অবচয় হিসাবে ঘোষণা করা হয়েছিল, ডকুমেন্টেশন থেকে সরানো হয়েছে৷ প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে সদস্যদের একটি তালিকা পুনরুদ্ধার করতেsubscriptions.list
পদ্ধতি এবং এরmySubscribers
প্যারামিটার ব্যবহার করুন। -
channel
রিসোর্সেরinvideoPromotion
অবজেক্ট এবং এর সমস্ত চাইল্ড প্রপার্টি, যেগুলিকে 27 নভেম্বর 2017 তারিখে বাতিল ঘোষণা করা হয়েছিল, ডকুমেন্টেশন থেকে সরানো হয়েছে।
জুলাই 29, 2020
আমরা part
প্যারামিটারের সাথে যুক্ত অতিরিক্ত খরচ সরিয়ে API অনুরোধের জন্য কোটা চার্জ করার জন্য আমাদের প্রক্রিয়াটিকে সহজ করেছি। অবিলম্বে কার্যকর, আমরা যে পদ্ধতিটি বলা হয় তার জন্য শুধুমাত্র ভিত্তি খরচ চার্জ করব। আপনি এখানে সরলীকৃত কোটা সম্পর্কে আরও তথ্য পেতে পারেন।
এই পরিবর্তনের প্রভাব হল যে বেশিরভাগ API কলের কোটা খরচ কিছুটা কম হবে, কিছু API কলের এখনও একই খরচ থাকবে। এই পরিবর্তন কোনো API কলের খরচ বাড়ায় না। সামগ্রিকভাবে, সম্ভাব্য প্রভাব হল আপনার বরাদ্দ করা কোটা, যা Google ক্লাউড কনসোলে দেখা যায়, একটু এগিয়ে যাবে৷
আমরা দৃঢ়ভাবে সুপারিশ করছি যে সকল ডেভেলপাররা তাদের প্রকল্পগুলির জন্য YouTube API পরিষেবাগুলিতে অবিরত অ্যাক্সেস নিশ্চিত করতে একটি কমপ্লায়েন্স অডিট সম্পূর্ণ করুন৷
এই পুনর্বিবেচনা ইতিহাস এন্ট্রি মূলত 20 জুলাই, 2020 এ প্রকাশিত হয়েছিল।
জুলাই 28, 2020
28 জুলাই 2020-এর পরে তৈরি করা অযাচাইকৃত API প্রকল্পগুলি থেকে videos.insert
endpoint এর মাধ্যমে আপলোড করা সমস্ত ভিডিও ব্যক্তিগত দেখার মোডে সীমাবদ্ধ থাকবে। এই নিষেধাজ্ঞা প্রত্যাহার করতে, পরিষেবার শর্তাবলীর সাথে সম্মতি যাচাই করার জন্য প্রতিটি প্রকল্পকে অবশ্যই একটি অডিট করতে হবে৷
যে নির্মাতারা ভিডিও আপলোড করার জন্য একটি অসমাপ্ত API ক্লায়েন্ট ব্যবহার করেন তারা একটি ইমেল পাবেন যাতে ব্যাখ্যা করা হয় যে তাদের ভিডিওটি ব্যক্তিগত হিসাবে লক করা হয়েছে এবং তারা একটি অফিসিয়াল বা নিরীক্ষিত ক্লায়েন্ট ব্যবহার করে সীমাবদ্ধতা এড়াতে পারে৷
28 জুলাই 2020-এর আগে তৈরি করা API প্রকল্পগুলি বর্তমানে এই পরিবর্তন দ্বারা প্রভাবিত হয় না। যাইহোক, আমরা দৃঢ়ভাবে সুপারিশ করি যে সমস্ত বিকাশকারীরা তাদের প্রকল্পগুলির জন্য YouTube API পরিষেবাগুলিতে অবিরত অ্যাক্সেস নিশ্চিত করতে একটি কমপ্লায়েন্স অডিট সম্পূর্ণ করুন ৷
জুলাই 21, 2020
[জুলাই 28, 2020 আপডেট করা হয়েছে।] এই পুনর্বিবেচনার ইতিহাস এন্ট্রিতে উল্লেখ করা ডকুমেন্টেশন আপডেটটি 28 জুলাই, 2020-এ পুনঃপ্রকাশিত হয়েছিল।
গতকাল, আমরা কোটা চার্জ করার জন্য আমাদের প্রক্রিয়া সম্পর্কিত একটি ডকুমেন্টেশন আপডেট প্রকাশ করেছি। তবে অপ্রত্যাশিত পরিস্থিতির কারণে কোটা পরিবর্তন এখনো কার্যকর হয়নি। ফলস্বরূপ, ডকুমেন্টেশন সঠিকতার স্বার্থে ফিরিয়ে দেওয়া হয়েছে। বিভ্রান্তি এড়াতে, পরিবর্তনের ব্যাখ্যাকারী পুনর্বিবেচনার ইতিহাসের এন্ট্রিটি সরানো হয়েছে এবং অদূর ভবিষ্যতে পুনরায় প্রকাশ করা হবে।
জুলাই 7, 2020
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
videos.insert
পদ্ধতির autoLevels
এবং stabilize
প্যারামিটার এখন অবহেলিত, এবং উভয় প্যারামিটার ডকুমেন্টেশন থেকে সরানো হয়েছে। তাদের মানগুলি উপেক্ষা করা হয় এবং নতুন আপলোড করা ভিডিওগুলি প্রক্রিয়া করার পদ্ধতিকে প্রভাবিত করে না৷
15 জুন, 2020
আপনার API ক্লায়েন্টরা YouTube API পরিষেবার শর্তাবলী এবং নীতি (API TOS) এর নির্দিষ্ট অংশগুলি মেনে চলে তা নিশ্চিত করতে সাহায্য করার জন্য নতুন YouTube বিকাশকারী নীতির নির্দেশিকা নির্দেশিকা এবং উদাহরণ প্রদান করে৷
এই নির্দেশিকাটি কীভাবে YouTube API TOS-এর নির্দিষ্ট দিকগুলিকে প্রয়োগ করে কিন্তু বিদ্যমান কোনও নথি প্রতিস্থাপন করে না সে সম্পর্কে অন্তর্দৃষ্টি প্রদান করে৷ এপিআই কমপ্লায়েন্স অডিট করার সময় ডেভেলপাররা যে সব সাধারণ প্রশ্ন জিজ্ঞাসা করে সেগুলি গাইডটিতে রয়েছে। আমরা আশা করি যে আমরা কীভাবে আমাদের নীতিগুলি ব্যাখ্যা করি এবং প্রয়োগ করি তা বুঝতে সাহায্য করার মাধ্যমে এটি আপনার বৈশিষ্ট্য বিকাশের প্রক্রিয়াটিকে সহজ করবে৷
জুন 4, 2020
দ্রষ্টব্য: এটি একটি পূর্ববর্তী অবচয় ঘোষণার একটি আপডেট৷
চ্যানেল বুলেটিন বৈশিষ্ট্য এখন সম্পূর্ণরূপে অবজ্ঞা করা হয়েছে. এই পরিবর্তনটি প্রাথমিকভাবে 17 এপ্রিল 2020-এ ঘোষণা করা হয়েছিল এবং এখন কার্যকর হয়েছে। ফলস্বরূপ, activities.insert
পদ্ধতি আর সমর্থিত নয়, এবং activities.list
পদ্ধতি আর চ্যানেল বুলেটিন ফেরত দেয় না। আরও বিশদ বিবরণের জন্য, অনুগ্রহ করে YouTube সহায়তা কেন্দ্র দেখুন৷
এপ্রিল 17, 2020
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
ইউটিউব চ্যানেল বুলেটিন বৈশিষ্ট্যটি বাতিল করছে৷ ফলস্বরূপ, activities.insert
পদ্ধতিটি অবমূল্যায়িত হবে, এবং activities.list
পদ্ধতি চ্যানেল বুলেটিন ফেরত দেওয়া বন্ধ করবে। এই পরিবর্তনগুলি এপিআই-এ 18 মে, 2020 বা তার পরে কার্যকর হবে। আরও বিশদ বিবরণের জন্য, অনুগ্রহ করে YouTube সহায়তা কেন্দ্র দেখুন।
31 মার্চ, 2020
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
member
সম্পদ একটি YouTube চ্যানেলের জন্য একটি চ্যানেল সদস্য প্রতিনিধিত্ব করে। একজন সদস্য একজন সৃষ্টিকর্তাকে পুনরাবৃত্ত আর্থিক সহায়তা প্রদান করেন এবং বিশেষ সুবিধা পান। উদাহরণস্বরূপ, যখন ক্রিয়েটর একটি চ্যাটের জন্য শুধুমাত্র সদস্যদের মোড চালু করেন তখন সদস্যরা চ্যাট করতে সক্ষম হন।এই সংস্থানটি
sponsor
সংস্থানকে প্রতিস্থাপন করে, যা YouTube লাইভ স্ট্রিমিং API-এর অংশ হিসাবে নথিভুক্ত করা হয়েছে৷sponsor
রিসোর্সটি এখন অবহেলিত হয়েছে এবং API ক্লায়েন্টদের পরিবর্তেmembers.list
পদ্ধতি ব্যবহার করতেsponsors.list
পদ্ধতিতে কল আপডেট করা উচিত।নতুন
membershipsLevel
রিসোর্স এমন একটি মূল্যের স্তর চিহ্নিত করে যা নির্মাতার দ্বারা পরিচালিত হয় যেটি API অনুরোধ অনুমোদন করে।membershipsLevels.list
পদ্ধতিটি স্রষ্টার সদস্যতার সমস্ত স্তরের একটি তালিকা পুনরুদ্ধার করে।
জানুয়ারী 10, 2020
API এখন শিশু-নির্দেশিত সামগ্রী সনাক্ত করার ক্ষমতা সমর্থন করে, যাকে YouTube বলে "বাচ্চাদের জন্য তৈরি"৷ YouTube সহায়তা কেন্দ্রে "বাচ্চাদের জন্য তৈরি" সামগ্রী সম্পর্কে আরও জানুন ৷
channel
এবং video
সংস্থান দুটি নতুন বৈশিষ্ট্য সমর্থন করে যাতে কন্টেন্ট নির্মাতা এবং দর্শকদের বাচ্চাদের জন্য তৈরি সামগ্রী শনাক্ত করতে সক্ষম করে:
-
selfDeclaredMadeForKids
প্রপার্টি কন্টেন্ট নির্মাতাদের একটি চ্যানেল বা ভিডিও বাচ্চাদের জন্য তৈরি কিনা তা নির্দিষ্ট করতে সক্ষম করে।
চ্যানেলগুলির জন্য,channels.update
পদ্ধতিতে কল করার সময় এই বৈশিষ্ট্যটি সেট করা যেতে পারে। ভিডিওর জন্য,videos.insert
বাvideos.update
পদ্ধতিতে কল করার সময় এই সম্পত্তি সেট করা যেতে পারে।
মনে রাখবেন যে চ্যানেলের মালিক যদি API অনুরোধ অনুমোদন করেন তবে এই বৈশিষ্ট্যটি শুধুমাত্র এপিআই প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত করা হয় যাতেchannel
বাvideo
সংস্থান থাকে। -
madeForKids
সম্পত্তি যেকোনো ব্যবহারকারীকে একটি চ্যানেল বা ভিডিওর "বাচ্চাদের জন্য তৈরি" স্ট্যাটাস পুনরুদ্ধার করতে সক্ষম করে। উদাহরণস্বরূপ,selfDeclaredMadeForKids
সম্পত্তির মানের উপর ভিত্তি করে স্থিতি নির্ধারণ করা যেতে পারে। আপনার চ্যানেল, ভিডিও বা সম্প্রচারের জন্য দর্শক সেট করার বিষয়ে আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।
আমরা YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলী এবং বিকাশকারী নীতিগুলিও আপডেট করেছি৷ আরও তথ্যের জন্য দয়া করে YouTube API পরিষেবার পরিষেবার শর্তাবলী দেখুন - পুনর্বিবেচনার ইতিহাস ৷ YouTube API পরিষেবাগুলির পরিষেবার শর্তাবলী এবং বিকাশকারী নীতিগুলির পরিবর্তনগুলি 10 জানুয়ারী, 2020 প্রশান্ত মহাসাগরীয় সময় থেকে কার্যকর হবে৷
সেপ্টেম্বর 10, 2019
এপিআই রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে যেভাবে ইউটিউবে এবং ফলস্বরূপ, এপিআই প্রতিক্রিয়াগুলিতে গ্রাহক সংখ্যা রিপোর্ট করা হয় তার পরিবর্তন প্রতিফলিত করতে। পরিবর্তনের ফলে, ইউটিউব ডেটা এপিআই পরিষেবা দ্বারা প্রত্যাবর্তিত গ্রাহক সংখ্যা 1000-এর বেশি গ্রাহক সংখ্যার জন্য তিনটি উল্লেখযোগ্য পরিসংখ্যানে বৃত্তাকার করা হয়েছে৷ এই পরিবর্তন channel
রিসোর্সের statistics.subscriberCount বৈশিষ্ট্যকে প্রভাবিত করে।
দ্রষ্টব্য: এই পরিবর্তনটি এই সম্পত্তির মানকে প্রভাবিত করে এমন ক্ষেত্রেও যেখানে কোনও ব্যবহারকারী তাদের নিজস্ব চ্যানেল সম্পর্কে ডেটার জন্য একটি অনুমোদিত অনুরোধ পাঠায়। চ্যানেলের মালিকরা এখনও YouTube স্টুডিওতে গ্রাহকের সঠিক সংখ্যা দেখতে পারেন।
উদাহরণস্বরূপ, যদি একটি চ্যানেলের 123,456 গ্রাহক থাকে, তাহলে statistics.subscriberCount
প্রপার্টিতে মান 123000
থাকবে। নীচের সারণীটি কীভাবে গ্রাহক সংখ্যা API প্রতিক্রিয়াগুলিতে বৃত্তাকার এবং অন্যান্য সর্বজনীনভাবে দৃশ্যমান YouTube ব্যবহারকারী ইন্টারফেসে সংক্ষেপিত হয় তার উদাহরণগুলি দেখায়:
গ্রাহক সংখ্যার উদাহরণ | YouTube ডেটা API | সর্বজনীনভাবে দৃশ্যমান YouTube UI |
---|---|---|
1,234 | 1230 | 1.23K |
12,345 | 12300 | 12.3K |
123,456 | 123000 | 123K |
1,234,567 | 1230000 | 1.23M |
12,345,678 | 12300000 | 12.3M |
123,456,789 | 123000000 | 123M |
4 এপ্রিল, 2019
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে প্রতিটি পদ্ধতির জন্য সাধারণ ব্যবহারের ক্ষেত্রে আরও ভালভাবে ব্যাখ্যা করতে এবং APIs এক্সপ্লোরার উইজেটের মাধ্যমে গতিশীল, উচ্চ-মানের কোড নমুনা প্রদান করতে। একটি উদাহরণের জন্য
channels.list
পদ্ধতির ডকুমেন্টেশন দেখুন। পৃষ্ঠাগুলিতে এখন দুটি নতুন উপাদান রয়েছে যা API পদ্ধতিগুলি বর্ণনা করে:APIs এক্সপ্লোরার উইজেট আপনাকে অনুমোদনের সুযোগ নির্বাচন করতে, নমুনা পরামিতি এবং সম্পত্তি মান লিখতে এবং তারপর প্রকৃত API অনুরোধ পাঠাতে এবং প্রকৃত API প্রতিক্রিয়া দেখতে দেয়। উইজেটটি একটি পূর্ণস্ক্রীন দৃশ্যও অফার করে যা সম্পূর্ণ কোড নমুনা দেখায়, যা আপনার প্রবেশ করানো স্কোপ এবং মানগুলি ব্যবহার করার জন্য গতিশীলভাবে আপডেট হয়।
সাধারণ ব্যবহারের ক্ষেত্রে বিভাগটি পৃষ্ঠায় ব্যাখ্যা করা পদ্ধতির জন্য এক বা একাধিক সাধারণ ব্যবহারের ক্ষেত্রে বর্ণনা করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করতে বা বর্তমান ব্যবহারকারীর চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করতে
channels.list
পদ্ধতিতে কল করতে পারেন।আপনি আপনার ব্যবহারের ক্ষেত্রে নমুনা মান সহ APIs এক্সপ্লোরারকে পপুলেট করতে বা ইতিমধ্যেই জনবহুল সেই মানগুলির সাথে পূর্ণস্ক্রীন APIs এক্সপ্লোরার খুলতে সেই বিভাগে লিঙ্কগুলি ব্যবহার করতে পারেন৷ এই পরিবর্তনগুলির লক্ষ্য হল আপনার জন্য কোড নমুনাগুলি দেখতে সহজ করে যা আপনি নিজের অ্যাপ্লিকেশনে প্রয়োগ করার চেষ্টা করছেন এমন ব্যবহারের ক্ষেত্রে সরাসরি প্রযোজ্য৷
কোড নমুনা বর্তমানে Java, JavaScript, PHP, Python, এবং curl-এর জন্য সমর্থিত।
কোড নমুনা সরঞ্জামটি একটি নতুন UI এর সাথে আপডেট করা হয়েছে যা উপরে বর্ণিত একই বৈশিষ্ট্যগুলি অফার করে৷ সেই টুলটি ব্যবহার করে, আপনি বিভিন্ন পদ্ধতির জন্য ব্যবহারের ক্ষেত্রে অন্বেষণ করতে পারেন, APIs এক্সপ্লোরারে মান লোড করতে পারেন এবং Java, JavaScript, PHP এবং Python-এ কোড নমুনা পেতে ফুলস্ক্রিন APIs এক্সপ্লোরার খুলতে পারেন।
এই পরিবর্তনের সাথে একত্রে, যে পৃষ্ঠাগুলি আগে জাভা, জাভাস্ক্রিপ্ট, পিএইচপি, এবং পাইথনের জন্য উপলব্ধ কোড নমুনাগুলি তালিকাভুক্ত করেছিল সেগুলি সরানো হয়েছে৷
Java , JavaScript , PHP , এবং Python- এর জন্য কুইকস্টার্ট গাইড আপডেট করা হয়েছে৷ সংশোধিত গাইড ব্যাখ্যা করে কিভাবে একটি API কী দিয়ে একটি নমুনা এবং APIs এক্সপ্লোরার থেকে কোড নমুনা ব্যবহার করে OAuth 2.0 ক্লায়েন্ট আইডি সহ আরেকটি নমুনা চালানো যায়।
উল্লেখ্য যে উপরে বর্ণিত পরিবর্তনগুলি একটি ইন্টারেক্টিভ টুল প্রতিস্থাপন করে যা 2017 সালে API ডকুমেন্টেশনে যোগ করা হয়েছিল।
জুলাই 9, 2018
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সেরsnippet.thumbnails
প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে যে আপনার অ্যাপ্লিকেশানে থাম্বনেইলগুলি প্রদর্শন করার সময়, আপনার কোডটি চিত্র URLগুলিকে ঠিক যেমন API প্রতিক্রিয়াগুলিতে ফেরত দেওয়া হয় ঠিক সেইভাবে ব্যবহার করা উচিত৷ উদাহরণস্বরূপ, আপনার অ্যাপ্লিকেশনটি একটি API প্রতিক্রিয়াতে ফিরে আসা URL-এhttps
ডোমেনের পরিবর্তেhttp
ডোমেন ব্যবহার করা উচিত নয়।জুলাই 2018 থেকে শুরু করে, চ্যানেল থাম্বনেল URLগুলি শুধুমাত্র
https
ডোমেনে উপলব্ধ হবে, যেভাবে URLগুলি API প্রতিক্রিয়াগুলিতে প্রদর্শিত হবে৷ সেই সময়ের পরে, আপনি আপনার অ্যাপ্লিকেশনটিতে ভাঙা ছবি দেখতে পেতে পারেন যদি এটিhttp
ডোমেন থেকে YouTube চিত্রগুলি লোড করার চেষ্টা করে৷দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
video
রিসোর্সেরrecordingDetails.location.altitude
প্রপার্টি বাতিল করা হয়েছে। ভিডিওগুলি এই সম্পত্তির জন্য মান ফিরিয়ে দেবে এমন কোনও গ্যারান্টি নেই৷ একইভাবে, API অনুরোধগুলি সেই সম্পত্তির জন্য একটি মান সেট করার চেষ্টা করলেও, এটি সম্ভব যে আগত ডেটা সংরক্ষণ করা হবে না।
জুন 22, 2018
ইমপ্লিমেন্টেশন গাইড , পূর্বে ইমপ্লিমেন্টেশন এবং মাইগ্রেশন গাইড নামে পরিচিত, v2 API থেকে v3 API-তে স্থানান্তরিত করার নির্দেশাবলী মুছে ফেলার জন্য আপডেট করা হয়েছে। এছাড়াও, পছন্দের ভিডিওগুলির মতো v3 API-তে অবচয়িত বৈশিষ্ট্যগুলির জন্য নির্দেশাবলীও সরানো হয়েছে৷
নভেম্বর 27, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
YouTube বৈশিষ্ট্যযুক্ত ভিডিও এবং বৈশিষ্ট্যযুক্ত ওয়েবসাইট বৈশিষ্ট্যগুলির জন্য সমর্থন সরিয়ে দিচ্ছে, যেগুলি
channel
সংস্থানেরinvideoPromotion
অবজেক্টের মাধ্যমে API-তে সমর্থিত৷ ফলস্বরূপ, সেই বস্তুটি, এর সমস্ত চাইল্ড প্রপার্টি সহ অবচয়িত হচ্ছে৷আপনি এখনও 14 ডিসেম্বর, 2017 পর্যন্ত
invideoPromotion
ডেটা পুনরুদ্ধার এবং সেট করতে পারেন। সেই তারিখের পরে:-
channels.list
কল করার সময়invideoPromotion
অংশ পুনরুদ্ধার করার প্রচেষ্টা একটি খালিinvideoPromotion
ফেরত দেবে বা কোনোinvideoPromotion
ডেটা ফেরত দেবে না। -
channels.update
কল করার সময়invideoPromotion
ডেটা আপডেট করার প্রচেষ্টা কমপক্ষে 27 মে, 2018 পর্যন্ত একটি সফল প্রতিক্রিয়া প্রদান করবে, তবে সেগুলিকে নো-অপস হিসাবে গণ্য করা হবে, যার অর্থ তারা আসলে কোনও আপডেট সম্পাদন করবে না৷
27 মে, 2018-এর পরে, এটা সম্ভব যে এই অনুরোধগুলি ইঙ্গিত করার জন্য ত্রুটি বার্তাগুলি ফেরত দিতে পারে, উদাহরণস্বরূপ, যে
invalidPromotion
একটি অবৈধ অংশ৷-
নভেম্বর 16, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইন্টারেক্টিভ কোড স্নিপেট টুল এখন Node.js কোড নমুনা সমর্থন করে। নমুনাগুলি প্রায় সমস্ত API পদ্ধতির জন্য ডকুমেন্টেশনেও দৃশ্যমান, যেমন
channels.list
পদ্ধতি।কাস্টমাইজযোগ্য নমুনাগুলি আপনাকে একটি Node.js অ্যাপ্লিকেশনের জন্য একটি ব্যবহার-কেস-নির্দিষ্ট সূচনা পয়েন্ট দেওয়ার জন্য ডিজাইন করা হয়েছে। কার্যকারিতাটি Node.js quickstart গাইডের কোডের অনুরূপ। যাইহোক, নমুনাগুলিতে কিছু ইউটিলিটি ফাংশন রয়েছে যা কুইকস্টার্টে প্রদর্শিত হয় না:
-
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' } }
এই সমস্ত নমুনা স্থানীয়ভাবে ডাউনলোড এবং চালানোর জন্য ডিজাইন করা হয়েছে। আরও তথ্যের জন্য, কোড স্নিপেট টুল নির্দেশাবলীতে স্থানীয়ভাবে সম্পূর্ণ কোড নমুনা চালানোর পূর্বশর্তগুলি দেখুন।
-
25 অক্টোবর, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইন্টারেক্টিভ কোড স্নিপেট টুলের পাইথন কোড নমুনাগুলি
oauth2client
লাইব্রেরির পরিবর্তেgoogle-auth
এবংgoogle-auth-oauthlib
লাইব্রেরি ব্যবহার করার জন্য আপডেট করা হয়েছে, যা এখন অবমূল্যায়িত হয়েছে।সেই পরিবর্তন ছাড়াও, টুলটি এখন ইনস্টল করা পাইথন অ্যাপ্লিকেশন এবং পাইথন ওয়েব সার্ভার অ্যাপ্লিকেশনগুলির জন্য সম্পূর্ণ কোড নমুনা সরবরাহ করে, যা সামান্য ভিন্ন অনুমোদনের প্রবাহ ব্যবহার করে। সম্পূর্ণ নমুনা দেখতে (এবং এই পরিবর্তন):
- ইন্টারেক্টিভ কোড স্নিপেট টুলে যান বা যেকোনো API পদ্ধতির ডকুমেন্টেশনে যান, যেমন
channels.list
পদ্ধতি। - কোড নমুনার উপরে
Python
ট্যাবে ক্লিক করুন। - একটি স্নিপেট দেখা থেকে একটি সম্পূর্ণ নমুনায় স্যুইচ করতে ট্যাবগুলির উপরের টগলটিতে ক্লিক করুন৷
- ট্যাবটিতে এখন একটি সম্পূর্ণ কোড নমুনা দেখানো উচিত যা
InstalledAppFlow
অনুমোদন প্রবাহ ব্যবহার করে। নমুনার উপরের বিবরণটি এটি ব্যাখ্যা করে এবং একটি ওয়েব সার্ভার অ্যাপ্লিকেশনের জন্য একটি নমুনার সাথে লিঙ্কও করে৷ - ওয়েব সার্ভারের উদাহরণে স্যুইচ করতে লিঙ্কটিতে ক্লিক করুন। সেই নমুনাটি ফ্লাস্ক ওয়েব অ্যাপ্লিকেশন ফ্রেমওয়ার্ক এবং একটি ভিন্ন অনুমোদন প্রবাহ ব্যবহার করে।
এই সমস্ত নমুনা স্থানীয়ভাবে ডাউনলোড এবং চালানোর জন্য ডিজাইন করা হয়েছে। আপনি যদি নমুনা চালাতে চান, কোড স্নিপেট টুল নির্দেশাবলীতে স্থানীয়ভাবে সম্পূর্ণ কোড নমুনা চালানোর নির্দেশাবলী দেখুন।
- ইন্টারেক্টিভ কোড স্নিপেট টুলে যান বা যেকোনো API পদ্ধতির ডকুমেন্টেশনে যান, যেমন
আগস্ট 29, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
-
search.list
পদ্ধতিরforContentOwner
প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে লক্ষ্য করার জন্য যে যদি সেই প্যারামিটারটিtrue
সেট করা হয়, তাহলেtype
প্যারামিটারটিকেvideo
সেট করতে হবে। -
search.list
পদ্ধতিরregionCode
প্যারামিটারের সংজ্ঞাটি স্পষ্ট করার জন্য আপডেট করা হয়েছে যে প্যারামিটারটি নির্দিষ্ট অঞ্চলে দেখা যেতে পারে এমন ভিডিওগুলিতে অনুসন্ধান ফলাফল সীমাবদ্ধ করে। - YouTube তার ব্র্যান্ডিং লোগো এবং আইকন আপডেট করেছে। নতুন "ইউটিউব দিয়ে তৈরি" লোগোগুলি ব্র্যান্ডিং নির্দেশিকা পৃষ্ঠা থেকে ডাউনলোড করা যেতে পারে। অন্যান্য নতুন YouTube লোগো এবং আইকনগুলিও সেই পৃষ্ঠায় দেখানো হয়েছে এবং YouTube ব্র্যান্ড সাইট থেকে ডাউনলোড করা যেতে পারে৷
জুলাই 24, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
- iOS এর জন্য একটি নতুন YouTube Data API Quickstart গাইড উপলব্ধ। নির্দেশিকা ব্যাখ্যা করে যে কীভাবে অবজেক্টিভ-সি বা সুইফটে লেখা একটি সাধারণ iOS অ্যাপ্লিকেশনে YouTube ডেটা API ব্যবহার করতে হয়।
- ইউটিউব ডেটা API-এর জন্য ইন্টারেক্টিভ কোড স্নিপেট টুলটিতে এখন টুলের কিছু বৈশিষ্ট্য ব্যাখ্যা করে ডকুমেন্টেশন অন্তর্ভুক্ত রয়েছে:
- API অনুরোধ নির্বাহ করা হচ্ছে
- কোড স্নিপেট এবং সম্পূর্ণ কোড নমুনার মধ্যে টগল করা
- বয়লারপ্লেট ফাংশন ব্যবহার করে
- বিদ্যমান সম্পদ লোড হচ্ছে (আপডেট পদ্ধতির জন্য)
দ্রষ্টব্য: টুলটি API পদ্ধতির জন্য API রেফারেন্স ডকুমেন্টেশনেও এম্বেড করা আছে ( উদাহরণ )।
জুন 1, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
নিচের
video
রিসোর্স প্রপার্টি অবলোপন করা হচ্ছে। যদিও বৈশিষ্ট্যগুলি 1 ডিসেম্বর, 2017 পর্যন্ত সমর্থিত হবে, সেই সময় পর্যন্ত ভিডিওগুলি সেই সম্পত্তিগুলির জন্য মান ফেরত দেবে এমন কোনও গ্যারান্টি নেই৷ একইভাবে,videos.insert
এবংvideos.update
অনুরোধগুলি যে সম্পত্তি মানগুলি সেট করে সেই তারিখের আগে ত্রুটি তৈরি করবে না, তবে এটি সম্ভব যে আগত ডেটা সংরক্ষণ করা হবে না।
17 মে, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
কোড স্নিপেটগুলিকে আরও সর্বব্যাপী এবং ইন্টারেক্টিভ করতে API রেফারেন্স ডকুমেন্টেশন আপডেট করা হয়েছে। যে পৃষ্ঠাগুলি API পদ্ধতিগুলি ব্যাখ্যা করে, যেমন
channels.list
বাvideos.rate
, এখন একটি ইন্টারেক্টিভ টুল রয়েছে যা আপনাকে Java, JavaScript, PHP, Python, Ruby, Apps Script এবং Go-এ কোড স্নিপেট দেখতে এবং কাস্টমাইজ করতে দেয়৷যে কোনো পদ্ধতির জন্য, টুলটি এক বা একাধিক ব্যবহারের ক্ষেত্রে কোড স্নিপেট দেখায় এবং প্রতিটি ব্যবহারের ক্ষেত্রে সেই পদ্ধতিটিকে কল করার একটি সাধারণ উপায় বর্ণনা করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট চ্যানেল বা বর্তমান ব্যবহারকারীর চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করতে
channels.list
পদ্ধতিতে কল করতে পারেন।আপনি কোড নমুনার সাথে যোগাযোগ করতে পারেন:
প্যারামিটার এবং সম্পত্তি মান পরিবর্তন করুন, এবং কোড স্নিপেটগুলি আপনার প্রদান করা মানগুলিকে প্রতিফলিত করতে গতিশীলভাবে আপডেট করুন।
কোড স্নিপেট এবং সম্পূর্ণ নমুনার মধ্যে টগল করুন। একটি কোড স্নিপেট কোডের অংশ দেখায় যা API পদ্ধতিকে কল করে। একটি সম্পূর্ণ নমুনায় সেই স্নিপেটটির পাশাপাশি অনুরোধগুলি অনুমোদন এবং পাঠানোর জন্য বয়লারপ্লেট কোড রয়েছে৷ সম্পূর্ণ নমুনা অনুলিপি এবং কমান্ড লাইন বা একটি স্থানীয় ওয়েব সার্ভার থেকে চালানো যেতে পারে.
একটি বোতামে ক্লিক করে অনুরোধগুলি সম্পাদন করুন। (অনুরোধ চালানোর জন্য, আপনাকে আপনার পক্ষ থেকে API কল করার জন্য টুলটিকে অনুমোদন করতে হবে।)
মনে রাখবেন যে এই টুলটি যে পৃষ্ঠাগুলিতে উপলব্ধ সেখানে APIs এক্সপ্লোরারকে প্রতিস্থাপন করেছে৷ (প্রতিটি পৃষ্ঠা একটি লিঙ্ক প্রদর্শন করে যাতে আপনি APIs এক্সপ্লোরারে কাজ করছেন এমন অনুরোধটি লোড করার বিকল্পও থাকে।)
ডেটা API কোড স্নিপেট টুলটিও একটি নতুন UI এর সাথে আপডেট করা হয়েছে যা উপরে বর্ণিত একই বৈশিষ্ট্যগুলি অফার করে৷ এই পৃষ্ঠায় উপলব্ধ প্রধান নতুন বৈশিষ্ট্য হল:
- API অনুরোধের জন্য সমর্থন যা ডেটা লেখে।
- জাভা নমুনার জন্য সমর্থন.
- ব্যবহারকারীদের অনুমোদন এবং API অনুরোধগুলি তৈরি করার জন্য আরও নমনীয় এবং ব্যাপক বয়লারপ্লেট কোড৷
এপ্রিল 27, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
- নতুন কুইকস্টার্ট গাইড ব্যাখ্যা করে যে কীভাবে একটি সাধারণ অ্যাপ্লিকেশন সেট আপ করতে হয় যা YouTube ডেটা API অনুরোধ করে। গাইড বর্তমানে Android , Apps Script , Go , Java , JavaScript , Node.js , PHP , Python , এবং Ruby- এর জন্য উপলব্ধ।
30 মার্চ, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
-
channel
রিসোর্সের নতুনtopicDetails.topicCategories[]
সম্পত্তিতে উইকিপিডিয়া ইউআরএলের একটি তালিকা রয়েছে যা চ্যানেলের বিষয়বস্তু বর্ণনা করে। ইউআরএলগুলি রিসোর্সেরtopicDetails.topicIds[]
প্রপার্টিতে প্রত্যাবর্তিত বিষয় আইডিগুলির সাথে মিলে যায়। -
playlistItem
রিসোর্সের নতুনcontentDetails.videoPublishedAt
প্রপার্টি ভিডিওটি YouTube-এ প্রকাশিত হওয়ার সময় চিহ্নিত করে। সংস্থানটিতে ইতিমধ্যেইsnippet.publishedAt
সম্পত্তি রয়েছে, যা প্লেলিস্টে আইটেমটি যোগ করার সময় চিহ্নিত করে৷ -
channel
রিসোর্সের মতো,video
রিসোর্সটি এখনtopicDetails.topicCategories[]
প্রপার্টি প্রদান করে, যেটিতে উইকিপিডিয়া ইউআরএলের একটি তালিকা রয়েছে যা ভিডিওর বিষয়বস্তু বর্ণনা করে।video
রিসোর্সের জন্য, ইউআরএলগুলি রিসোর্সেরtopicDetails.relevantTopicIds[]
প্রপার্টিতে প্রত্যাবর্তিত বিষয় আইডির সাথে মিলে যায়। -
video
রিসোর্সের নতুনcontentDetails.contentRating.mpaatRating
প্রপার্টি সেই রেটিংটিকে চিহ্নিত করে যা আমেরিকার মোশন পিকচার অ্যাসোসিয়েশন একটি সিনেমার ট্রেলার বা প্রিভিউকে দিয়েছে।
27 ফেব্রুয়ারি, 2017
11 আগস্ট, 2016-এ প্রাথমিকভাবে ঘোষণা করা হয়েছে , 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[]
প্রপার্টি ভ্যালুতে ফেরত দেওয়া হয়।
নভেম্বর 29, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ফেব্রুয়ারী 10, 2017 থেকে সমর্থিত বিষয় আইডিগুলির তালিকায় তিনটি ছোট পরিবর্তন রয়েছে:
-
Professional wrestling
বিভাগ, যা আগেSports
বিভাগের সন্তান ছিল, এখনEntertainment
সন্তান। -
TV shows
ক্যাটাগরি, যাEntertainment
সন্তান, নতুন। -
Health
বিভাগ, পূর্বেLifestyle
একটি শিশু, সরানো হয়েছে।
এছাড়াও মনে রাখবেন যে কয়েকটি অভিভাবক বিভাগ রয়েছে (
Entertainment
,Gaming
,Lifestyle
,Music
এবংSports
)।Tennis
মতো শিশু বিভাগের সাথে যুক্ত যে কোনো ভিডিওও অভিভাবক বিভাগের সাথে যুক্ত হবে (Sports
)।-
নভেম্বর 10, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
11 অগাস্ট, 2016-এ প্রথম ঘোষিত হিসাবে, Freebase এবং Freebase API-এর অবচয়নের জন্য বিষয় আইডি সম্পর্কিত বেশ কিছু পরিবর্তন প্রয়োজন। টপিক আইডি
channel
এবংvideo
সংস্থানগুলির সাথে সম্পর্কিত বিষয়গুলি সনাক্ত করে এবং আপনি একটি নির্দিষ্ট বিষয়ের সাথে সম্পর্কিত চ্যানেল বা ভিডিওগুলি খুঁজতেtopicId
অনুসন্ধান প্যারামিটার ব্যবহার করতে পারেন৷ফেব্রুয়ারী 10, 2017-এ, YouTube এ পর্যন্ত ফিরে আসা আইডিগুলির আরও বেশি দানাদার সেটের পরিবর্তে একটি ছোট বিষয় আইডি ফেরত দেওয়া শুরু করবে৷ এছাড়াও, মনে রাখবেন যে চ্যানেল এবং ভিডিওগুলি বর্তমান API আচরণের সাথে সামঞ্জস্যপূর্ণ কোনো বিষয়ের সাথে যুক্ত হওয়ার গ্যারান্টি দেওয়া হয় না।
যাতে আপনি সেই পরিবর্তনগুলির জন্য আপনার API ক্লায়েন্টদের প্রস্তুত করতে পারেন, নিম্নলিখিত API পরামিতি এবং বৈশিষ্ট্যগুলির সংজ্ঞাগুলি সেই সময়ের পরে সমর্থিত বিষয় আইডিগুলির তালিকা করার জন্য আপডেট করা হয়েছে৷ নোট করুন যে সমস্ত বৈশিষ্ট্যের জন্য বিভাগের তালিকা একই।
-
channel
রিসোর্সেরtopicDetails.topicIds[]
প্রপার্টি। -
video
সম্পদেরtopicDetails.relevantTopicIds[]
সম্পত্তি। -
search.list
পদ্ধতিরtopicId
প্যারামিটার।
-
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
নিম্নলিখিত বৈশিষ্ট্যগুলিকে অবমূল্যায়ন করা হচ্ছে:
-
channel
রিসোর্সেরtopicDetails.topicIds[]
প্রপার্টি। এই সম্পত্তি 10 নভেম্বর, 2017 পর্যন্ত সমর্থিত হবে। -
video
সম্পদেরtopicDetails.relevantTopicIds[]
সম্পত্তি। এই সম্পত্তি 10 নভেম্বর, 2017 পর্যন্ত সমর্থিত হবে। -
video
রিসোর্সেরtopicDetails.topicIds[]
প্রপার্টি। এই সম্পত্তিতে 10 ফেব্রুয়ারী, 2017-এর পরে মান থাকবে না। (সেই তারিখের পরে,topicDetails.relevantTopicIds[]
সম্পত্তির মান একটি ভিডিওর সাথে যুক্ত সমস্ত বিষয় চিহ্নিত করবে।)
-
যেহেতু Freebase ইতিমধ্যেই অবমূল্যায়িত হয়েছে, তাই অনুসন্ধানের সাথে Freebase বিষয় নির্দেশিকা ডকুমেন্টেশন থেকে সরানো হয়েছে। একটি অ্যাপ্লিকেশন ফ্রিবেস API এর সাথে কীভাবে কাজ করবে তা দেখানোর জন্য সেই নির্দেশিকা কোড নমুনা প্রদান করেছে।
এছাড়াও,
search.list
পদ্ধতির ডকুমেন্টেশন থেকে টপিক আইডি সম্পর্কিত বেশ কিছু কোড নমুনা সরিয়ে দেওয়া হয়েছে।
নভেম্বর 2, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন বৈশিষ্ট্য এবং পরামিতি
video
সংস্থানটিতে বেশ কয়েকটি নতুন বৈশিষ্ট্য রয়েছে:player.embedHtml
প্রপার্টিতে একটি<iframe>
ট্যাগ রয়েছে যা আপনি ভিডিও চালায় এমন একটি প্লেয়ার এম্বেড করতে ব্যবহার করতে পারেন। নতুনplayer.embedHeight
এবংplayer.embedWidth
বৈশিষ্ট্য এমবেড করা প্লেয়ারের মাত্রা চিহ্নিত করে। এই বৈশিষ্ট্যগুলি শুধুমাত্র তখনই ফেরত দেওয়া হয় যদি API অনুরোধটিmaxHeight
বাmaxWidth
প্যারামিটারগুলির মধ্যে অন্তত একটির জন্য একটি মান নির্দিষ্ট করে। এই দুটি নতুন প্যারামিটার পরে এই সংশোধন ইতিহাস এন্ট্রিতে ব্যাখ্যা করা হয়েছে।নতুন
hasCustomThumbnail
সম্পত্তি নির্দেশ করে যে ভিডিও আপলোডার ভিডিওটির জন্য একটি কাস্টম থাম্বনেইল চিত্র প্রদান করেছে কিনা। মনে রাখবেন যে এই সম্পত্তিটি শুধুমাত্র ভিডিও আপলোডারের কাছে দৃশ্যমান।নতুন
fpbRatingReasons[]
ভিডিওটি FPB (দক্ষিণ আফ্রিকা) রেটিং পাওয়ার কারণগুলি চিহ্নিত করে৷নতুন
mcstRating
ভিডিওটি ভিয়েতনামে যে রেটিং পেয়েছে তা চিহ্নিত করে৷
videos.list
পদ্ধতি দুটি নতুন প্যারামিটার,maxHeight
এবংmaxWidth
সমর্থন করে।video
রিসোর্সেplayer
অংশ পুনরুদ্ধার করার সময় আপনি প্যারামিটার বা উভয় প্যারামিটার ব্যবহার করতে পারেন।ডিফল্টরূপে,
player.embedHtml
প্রপার্টিতে ফিরে আসা<iframe>
এর উচ্চতা হল 360px। ভিডিওর আকৃতির অনুপাতের সাথে মেলে প্রস্থ সামঞ্জস্য করে, যার ফলে এমবেড করা প্লেয়ারে ভিডিও ফ্রেমিং করা কালো বার নেই তা নিশ্চিত করে। সুতরাং, উদাহরণস্বরূপ, যদি একটি ভিডিওর অনুপাত 16:9 হয়, প্লেয়ারের প্রস্থ 640px হবে৷নতুন পরামিতিগুলির সাথে, আপনি নির্দিষ্ট করতে পারেন যে ডিফল্ট মাত্রার পরিবর্তে, এম্বেড কোডটি আপনার অ্যাপ্লিকেশন লেআউটের জন্য উপযুক্ত উচ্চতা এবং/অথবা প্রস্থ ব্যবহার করা উচিত। এম্বেড করা প্লেয়ারে ভিডিও ফ্রেমিং করা কালো বার নেই তা নিশ্চিত করার জন্য API সার্ভার প্লেয়ারের মাত্রা যথাযথভাবে স্কেল করে। মনে রাখবেন যে উভয় পরামিতি এমবেড করা প্লেয়ারের সর্বোচ্চ মাত্রা নির্দিষ্ট করে। এইভাবে, যদি উভয় প্যারামিটার নির্দিষ্ট করা হয়, তবে একটি মাত্রা সেই মাত্রার জন্য অনুমোদিত সর্বাধিক পরিমাণের চেয়ে ছোট হতে পারে।
উদাহরণস্বরূপ, ধরুন একটি ভিডিওর একটি 16:9 অনুপাত রয়েছে৷ এইভাবে,
player.embedHtml
ট্যাগে একটি 640x360 প্লেয়ার থাকবে যদিmaxHeight
বাmaxWidth
প্যারামিটার সেট করা না থাকে।-
maxHeight
প্যারামিটার720
এ সেট করা থাকলে এবংmaxWidth
প্যারামিটার সেট না থাকলে, API একটি 1280x720 প্লেয়ার ফিরিয়ে দেবে। -
maxWidth
প্যারামিটারটি960
এ সেট করা থাকলে এবংmaxHeight
প্যারামিটার সেট না থাকলে, API একটি 960x540 প্লেয়ার ফিরিয়ে দেবে। -
maxWidth
প্যারামিটারটি960
এ সেট করা থাকলে এবংmaxHeight
প্যারামিটারটি450
এ সেট করা থাকলে, API একটি 800x450 প্লেয়ার ফিরিয়ে দেবে।
উপরে বর্ণিত নতুন
player.embedHeight
এবংplayer.embedWidth
বৈশিষ্ট্যগুলি প্লেয়ারের মাত্রা চিহ্নিত করে৷-
বিদ্যমান পদ্ধতি, বৈশিষ্ট্য এবং পরামিতিগুলির আপডেট
channelSection
রিসোর্সের বিবরণ আপডেট করা হয়েছে যাতে লক্ষ্য করা যায় যে একটি চ্যানেল টার্গেটিং ডেটা সেট না করে সর্বোচ্চ 10টি তাক তৈরি করতে পারে এবং টার্গেটিং ডেটা সহ সর্বাধিক 100টি তাক তৈরি করতে পারে।উপরন্তু,
channelSection
রিসোর্সেরtargeting
প্রপার্টি আপডেট করা হয়েছে এই সত্যটি প্রতিফলিত করার জন্য যে টার্গেটিং বিকল্পগুলি শুধুমাত্র API ব্যবহার করে সেট করা যেতে পারে। YouTube ওয়েবসাইটে ইউজার ইন্টারফেস ব্যবহার করে চ্যানেল সেকশন পরিবর্তন করা হলে টার্গেটিং অপশন মুছে ফেলা হয়।i18nLanguage
রিসোর্সেরsnippet.name
প্রপার্টির সংজ্ঞাটি প্রতিফলিত করার জন্য সংশোধন করা হয়েছে যে মানটি একটি ভাষার নামের প্রতিনিধিত্ব করে কারণ এটিi18nLanguage.list
পদ্ধতিরhl
প্যারামিটার দ্বারা নির্দিষ্ট ভাষায় লেখা হয়েছে।playlistItem
আইটেম রিসোর্সেরcontentDetails.note
প্রপার্টি আপডেট করা হয়েছে নোট করার জন্য যে প্রপার্টির মান সর্বোচ্চ দৈর্ঘ্য 280 অক্ষর।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
পদ্ধতির বিবরণ আপডেট করা হয়েছে যে আপলোড করা ভিডিওগুলির জন্য সর্বোচ্চ ফাইলের আকার 64GB থেকে 128GB হয়েছে।
নতুন এবং আপডেট ত্রুটি
API নিম্নলিখিত নতুন ত্রুটি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা forbidden (403)
homeParameterDeprecated
activities.list
পদ্ধতিটি এই ত্রুটিটি প্রদান করে যে ব্যবহারকারীর হোম পেজ কার্যকলাপ ডেটা এই API এর মাধ্যমে উপলব্ধ নয়। আপনি যদি একটি অননুমোদিত অনুরোধেhome
প্যারামিটারটিকেtrue
হিসাবে সেট করেন তবে এই ত্রুটি ঘটতে পারে৷invalidValue (400)
invalidContentDetails
playlistItems.insert
পদ্ধতিটি অনুরোধেরcontentDetails
অবৈধ তা নির্দেশ করতে এই ত্রুটিটি ফেরত দেয়। এই ত্রুটিটি হওয়ার একটি কারণ হলcontentDetails.note
ক্ষেত্রটি 280 অক্ষরের বেশি।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
পদ্ধতিটি আর একটি ত্রুটি ফেরত দেয় না৷ এই ত্রুটিটি পূর্বে কিছু প্লেলিস্টের জন্য ঘটেছে, যেমন প্রিয় ভিডিওগুলি, যা সদৃশগুলিকে অনুমতি দেয়নি কিন্তু আর সমর্থিত নয়৷ সাধারণভাবে, প্লেলিস্টগুলি ডুপ্লিকেট ভিডিওগুলিকে অনুমতি দেয়৷
অন্যান্য আপডেট
15 সেপ্টেম্বর, 2016-এর পুনর্বিবেচনার ইতিহাসের এন্ট্রি, স্পষ্ট করার জন্য আপডেট করা হয়েছে যে, যখনই
channel
সম্পদেরcontentDetails.relatedPlaylists.watchHistory
এবংcontentDetails.relatedPlaylists.watchLater
বৈশিষ্ট্যগুলি একটি প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হয়, সেগুলিতে সর্বদা যথাক্রমেHL
এবংWL
মান থাকে৷ অধিকন্তু, এই বৈশিষ্ট্যগুলি শুধুমাত্র তখনই অন্তর্ভুক্ত করা হয় যদি একজন অনুমোদিত ব্যবহারকারী ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে।
15 সেপ্টেম্বর, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
11 অগাস্ট, 2016-এর পুনর্বিবেচনার ইতিহাসের আপডেটে বিষয় আইডি সম্পর্কিত বেশ কয়েকটি পরিবর্তন নিয়ে আলোচনা করা হয়েছে, যার মধ্যে রয়েছে যে সমর্থিত বিষয় আইডিগুলির সেটটি 10 ফেব্রুয়ারি, 2017 থেকে পরিবর্তিত হবে৷ সমর্থিত বিষয়গুলির তালিকা 10 নভেম্বরের মধ্যে প্রকাশ করা হবে৷ , 2016।
নিম্নলিখিত পরিবর্তনগুলি এখন কার্যকর। এই পরিবর্তনগুলির বিজ্ঞপ্তি 11 আগস্ট, 2016 তারিখে সংশোধন ইতিহাস আপডেটে দেওয়া হয়েছিল:
যদি
activities.list
মেথডটিকেhome
প্যারামিটারটিtrue
তে সেট করে কল করা হয়, তাহলে API প্রতিক্রিয়াতে এখন লগ-আউট হওয়া ইউটিউব ব্যবহারকারী হোম পৃষ্ঠাতে যা দেখতে পাবে তার অনুরূপ আইটেম রয়েছে।এটি একটি সামান্য পরিবর্তন যা 11 অগাস্ট, 2016-এ পুনর্বিবেচনার ইতিহাস আপডেটে বর্ণিত আচরণের চেয়ে আরও ভাল ব্যবহারকারীর অভিজ্ঞতা প্রদানের উদ্দেশ্যে। সেই আপডেটটি বলেছিল যে
home
প্যারামিটার ব্যবহার করে অনুরোধগুলি একটি খালি তালিকা ফিরিয়ে দেবে।channel
রিসোর্সেরcontentDetails.relatedPlaylists.watchHistory
এবংcontentDetails.relatedPlaylists.watchLater
বৈশিষ্ট্যে এখন সব চ্যানেলের জন্য যথাক্রমেHL
এবংWL
এর মান রয়েছে।স্পষ্ট করে বলতে গেলে, এই বৈশিষ্ট্যগুলি শুধুমাত্র একজন অনুমোদিত ব্যবহারকারীর কাছে দৃশ্যমান যা ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে৷ বৈশিষ্ট্যগুলিতে সর্বদা
HL
এবংWL
মান থাকে, এমনকি একজন অনুমোদিত ব্যবহারকারীর জন্য ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে। সুতরাং, দেখার ইতিহাস এবং পরে দেখার প্লেলিস্ট আইডিগুলি API এর মাধ্যমে পুনরুদ্ধার করা যাবে না।এছাড়াও, একটি চ্যানেলের দেখার ইতিহাসের জন্য প্লেলিস্টের বিবরণ (
playlists.list
) বা প্লেলিস্ট আইটেমগুলি (playlistItems.list
) পুনরুদ্ধার করার অনুরোধগুলি এখন খালি তালিকা ফেরত দেয়৷ এই আচরণটি নতুন মানগুলির জন্য সত্য,HL
এবংWL
, সেইসাথে আপনার API ক্লায়েন্ট ইতিমধ্যেই সঞ্চয় করে থাকতে পারে এমন যেকোনো দেখার ইতিহাস বা পরবর্তী প্লেলিস্ট আইডিগুলির জন্য সত্য৷
video
রিসোর্সেরfileDetails.recordingLocation
অবজেক্ট এবং এর চাইল্ড প্রপার্টি আর ফেরত দেওয়া হয় না। পূর্বে, এই ডেটা (যেমন প্যারেন্টfileDetails
অবজেক্ট) শুধুমাত্র ভিডিওর মালিক দ্বারা পুনরুদ্ধার করা যেতে পারে।
11 আগস্ট, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
সদ্য প্রকাশিত YouTube API পরিষেবার পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), যা YouTube ইঞ্জিনিয়ারিং এবং ডেভেলপারস ব্লগে বিশদভাবে আলোচনা করা হয়েছে, বর্তমান পরিষেবার শর্তাবলীতে আপডেটের একটি সমৃদ্ধ সেট প্রদান করে৷ আপডেট করা শর্তাদি ছাড়াও, যা 10 ফেব্রুয়ারী, 2017 থেকে কার্যকর হবে, এই আপডেটে অনেকগুলি সমর্থনকারী নথি অন্তর্ভুক্ত রয়েছে যা বিকাশকারীদের অনুসরণ করা আবশ্যক নীতিগুলি ব্যাখ্যা করতে সহায়তা করে৷
নতুন নথির সম্পূর্ণ সেট আপডেট করা শর্তাবলীর পুনর্বিবেচনার ইতিহাসে বর্ণনা করা হয়েছে। উপরন্তু, আপডেট করা শর্তাবলী বা সেই সমর্থনকারী নথিগুলিতে ভবিষ্যতের পরিবর্তনগুলিও সেই সংশোধন ইতিহাসে ব্যাখ্যা করা হবে। আপনি সেই নথির একটি লিঙ্ক থেকে সেই পুনর্বিবেচনার ইতিহাসে একটি RSS ফিড তালিকা পরিবর্তনের সদস্যতা নিতে পারেন।
Freebase এবং Freebase API-এর অবচয় টপিক আইডি সম্পর্কিত বিভিন্ন পরিবর্তন ঘটাচ্ছে। নিম্নলিখিত API সংস্থান এবং পদ্ধতিতে বিষয় আইডি ব্যবহার করা হয়:
-
channel
রিসোর্সেরtopicDetails
অংশ চ্যানেলের সাথে সংশ্লিষ্ট বিষয়গুলিকে চিহ্নিত করে। -
video
রিসোর্সেরtopicDetails
অংশ ভিডিওটির সাথে সংশ্লিষ্ট বিষয়গুলোকে চিহ্নিত করে। -
search.list
পদ্ধতিরtopicId
প্যারামিটার আপনাকে একটি নির্দিষ্ট বিষয়ের সাথে সম্পর্কিত ভিডিও বা চ্যানেল অনুসন্ধান করতে দেয়।
এই বৈশিষ্ট্যগুলির পরিবর্তনগুলি হল:
ফেব্রুয়ারী 10, 2017 থেকে, YouTube এ পর্যন্ত ফিরে আসা আইডিগুলির আরও বেশি দানাদার সেটের পরিবর্তে বিষয়ের আইডিগুলির একটি ছোট সেট ফেরত দেওয়া শুরু করবে৷ সমর্থিত বিষয়গুলির সেটটি খেলাধুলা বা বাস্কেটবলের মতো উচ্চ-স্তরের শ্রেণীবিভাগ সনাক্ত করবে, কিন্তু, উদাহরণস্বরূপ, তারা নির্দিষ্ট দল বা খেলোয়াড়দের সনাক্ত করবে না। আমরা সমর্থিত বিষয়গুলির সেট ঘোষণা করব যাতে আপনি এই পরিবর্তনের জন্য আপনার আবেদন প্রস্তুত করার সময় পান৷
যেকোন ফ্রিবেস টপিক আইডি যা আপনি ইতিমধ্যেই পুনরুদ্ধার করেছেন তা 10 ফেব্রুয়ারী, 2017 পর্যন্ত বিষয়বস্তু অনুসন্ধানের জন্য ব্যবহার করা যেতে পারে। যাইহোক, সেই সময়ের পরে, আপনি অনুসন্ধান ফলাফল পুনরুদ্ধার করতে পূর্ববর্তী আইটেমে চিহ্নিত বিষয়গুলির শুধুমাত্র ছোট সেট ব্যবহার করতে সক্ষম হবেন বিষয়
ফেব্রুয়ারী 10, 2017 এর পরে, আপনি যদি সমর্থিত টপিক আইডিগুলির ছোট সেটে নেই এমন একটি বিষয় আইডি ব্যবহার করে ফলাফল অনুসন্ধান করার চেষ্টা করেন, তাহলে API একটি খালি ফলাফল সেট ফিরিয়ে দেবে।
-
12 সেপ্টেম্বর, 2016 থেকে কার্যকরী বেশ কিছু API ক্ষেত্র এবং পরামিতি বাতিল করা হচ্ছে:
activities.list
পদ্ধতিরhome
প্যারামিটার একজন অনুমোদিত ব্যবহারকারীকে সক্রিয় করে যে কার্যকলাপ ফিডটি পুনরুদ্ধার করতে যা সেই ব্যবহারকারীর জন্য YouTube হোম পেজে প্রদর্শিত হবে। 12 সেপ্টেম্বর, 2016 এর পরে এই প্যারামিটার ব্যবহার করা অনুরোধগুলি একটি খালি তালিকা ফিরিয়ে দেবে।channel
রিসোর্সেরcontentDetails.relatedPlaylists.watchHistory
এবংcontentDetails.relatedPlaylists.watchLater
বৈশিষ্ট্যগুলি শুধুমাত্র একজন অনুমোদিত ব্যবহারকারীর কাছে দৃশ্যমান যা ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে৷ 12 সেপ্টেম্বর, 2016-এর পরে,contentDetails.relatedPlaylists.watchHistory
HL
এর একটি মান ফেরত দেবে এবংcontentDetails.relatedPlaylists.watchLater
প্রপার্টি সমস্ত চ্যানেলের জন্যWL
এর একটি মান ফেরত দেবে।একটি চ্যানেলের দেখার ইতিহাসের জন্য প্লেলিস্টের বিশদ বিবরণ (
playlists.list
) পুনরুদ্ধার করার অনুরোধগুলি 12 সেপ্টেম্বর, 2016 এর পরে একটি খালি তালিকা ফিরিয়ে দেবে৷ সেই প্লেলিস্টগুলির যেকোনো একটিতে প্লেলিস্ট আইটেমগুলি (playlistItems.list
) পুনরুদ্ধার করার অনুরোধগুলিও একটি খালি ফেরত দেবে৷ সেই সময়ের পরে তালিকা। এটি নতুন মানগুলির জন্য সত্য,HL
এবংWL
, সেইসাথে আপনার API ক্লায়েন্ট ইতিমধ্যেই সঞ্চয় করে থাকতে পারে এমন যেকোনো দেখার ইতিহাস বা পরবর্তী প্লেলিস্ট আইডিগুলির জন্য সত্য৷video
রিসোর্সেরfileDetails.recordingLocation
অবজেক্ট বা এর কোনো চাইল্ড প্রপার্টি 12 সেপ্টেম্বর, 2016 এর পর আর ফেরত দেওয়া হবে না। এই ডেটা শুধুমাত্র একজন ভিডিওর মালিক দ্বারা পুনরুদ্ধার করা যেতে পারে যেহেতু মূলfileDetails
অবজেক্ট শুধুমাত্র একজন ভিডিও মালিক দ্বারা পুনরুদ্ধার করা যেতে পারে।
13 জুন, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সেরcontentDetails.googlePlusUserId
প্রপার্টি বাতিল করা হয়েছে। পূর্বে, চ্যানেলটি একটি Google+ প্রোফাইলের সাথে যুক্ত হলেই সম্পত্তিটি উপস্থিত ছিল। অবমূল্যায়নের পরে, সম্পত্তিটি আর কোনোchannel
সংস্থানে অন্তর্ভুক্ত করা হবে না।comment
সংস্থানেরsnippet.authorGoogleplusProfileUrl
প্রপার্টি বাতিল করা হয়েছে। পূর্বে, চ্যানেলটি একটি Google+ প্রোফাইলের সাথে যুক্ত হলেই সম্পত্তিটি উপস্থিত ছিল। অবমূল্যায়নের পরে, সম্পত্তিটি আর কোনোcomment
সংস্থানে অন্তর্ভুক্ত করা হবে না।
যেহেতু এই বৈশিষ্ট্যগুলির কোনটিই অবমূল্যায়নের পরে ফেরত দেওয়া হবে না, তাই সংশ্লিষ্ট সংস্থান ডকুমেন্টেশন থেকে উভয় বৈশিষ্ট্যই সরানো হয়েছে।
31 মে, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
subscriptions.list
পদ্ধতির নতুনmyRecentSubscribers
প্যারামিটারটি প্রমাণীকৃত ব্যবহারকারীর চ্যানেলের গ্রাহকদের একটি তালিকা পুনরুদ্ধার করে তাদের চ্যানেলে সাবস্ক্রাইব করা সময়ের বিপরীত কালানুক্রমিক ক্রমে।নোট করুন যে নতুন প্যারামিটার শুধুমাত্র প্রমাণীকৃত ব্যবহারকারীর চ্যানেলের সাম্প্রতিকতম 1000 গ্রাহকের পুনরুদ্ধার সমর্থন করে। গ্রাহকদের একটি সম্পূর্ণ তালিকা পুনরুদ্ধার করতে,
mySubscribers
প্যারামিটার ব্যবহার করুন। সেই প্যারামিটার, যা একটি নির্দিষ্ট ক্রমে গ্রাহকদের ফেরত দেয় না, পুনরুদ্ধার করা যেতে পারে এমন গ্রাহকদের সংখ্যা সীমাবদ্ধ করে না।snippet.thumbnails.(key)
সম্পত্তির সংজ্ঞা কার্যকলাপ , প্লেলিস্ট আইটেম , প্লেলিস্ট , অনুসন্ধান ফলাফল , থাম্বনেইল এবং ভিডিও সংস্থানগুলির জন্য আপডেট করা হয়েছে যাতে লক্ষ্য করা যায় যে কিছু ভিডিওর জন্য অতিরিক্ত থাম্বনেইল চিত্রের আকার উপলব্ধ।-
standard
চিত্রটি 640px চওড়া এবং 480px লম্বা৷ -
maxres
চিত্রটি 1280px চওড়া এবং 720px লম্বা৷
-
channelSection.list
পদ্ধতিরpart
প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে যাতেtargeting
অংশটি2
কোটা ইউনিটের খরচে পুনরুদ্ধার করা যায়।videos.list
পদ্ধতিটি এখন একটি নিষিদ্ধ (403
) ত্রুটি ফেরত দেয় যখন একটি ভুলভাবে অনুমোদিত অনুরোধfileDetails
,processingDetails
, বাvideo
সংস্থানেরsuggestions
অংশগুলি পুনরুদ্ধার করার চেষ্টা করে। এই অংশগুলি শুধুমাত্র ভিডিওর মালিকের কাছে উপলব্ধ৷
17 মে, 2016
নতুন ডেটা API কোড স্নিপেট টুল সাধারণ YouTube ডেটা API ব্যবহারের ক্ষেত্রে শর্ট কোড স্নিপেট প্রদান করে। কোড স্নিপেট বর্তমানে Apps Script, Go, JavaScript, PHP, Python, এবং Ruby-এ সমস্ত পঠনযোগ্য API পদ্ধতির জন্য উপলব্ধ।
প্রতিটি পদ্ধতির জন্য, টুলটি এক বা একাধিক ব্যবহারের ক্ষেত্রে কোড নমুনা দেখায়। উদাহরণস্বরূপ, এটি search.list
পদ্ধতির জন্য পাঁচটি কোড স্নিপেট প্রদান করে:
- কীওয়ার্ড অনুসারে ভিডিও তালিকা করুন
- অবস্থান অনুযায়ী ভিডিও তালিকা
- লাইভ ইভেন্টের তালিকা করুন
- প্রমাণীকৃত ব্যবহারকারীর ভিডিও অনুসন্ধান করুন
- সম্পর্কিত ভিডিও তালিকা
প্রতিটি ব্যবহারের ক্ষেত্রে, টুলটি API অনুরোধে ব্যবহৃত পরামিতিগুলি প্রদর্শন করে। আপনি প্যারামিটার মানগুলি সংশোধন করতে পারেন, এই ক্ষেত্রে টুলটি আপনার দেওয়া প্যারামিটার মানগুলিকে প্রতিফলিত করতে কোড স্নিপেট আপডেট করে।
অবশেষে, টুলটি প্রতিটি অনুরোধের API প্রতিক্রিয়া প্রদর্শন করে। আপনি যদি অনুরোধের প্যারামিটার পরিবর্তন করে থাকেন, তাহলে API প্রতিক্রিয়া আপনার প্রদত্ত পরামিতি মানগুলির উপর ভিত্তি করে। মনে রাখবেন যে API প্রতিক্রিয়া প্রদর্শনের জন্য আপনার পক্ষ থেকে অনুরোধ জমা দেওয়ার জন্য আপনাকে টুলটিকে অনুমোদন করতে হবে।
এপ্রিল 28, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
video
রিসোর্সের নতুনcontentDetails.projection
প্রপার্টি ভিডিওর প্রজেকশন ফরম্যাট নির্দিষ্ট করে। বৈধ সম্পত্তি মান360
এবংrectangular
।video
রিসোর্সেরrecordingDetails.location
এবংfileDetails.recordingLocation
বৈশিষ্ট্য দুটিই আপডেট করা হয়েছে দুটি বৈশিষ্ট্যের মধ্যে পার্থক্য ব্যাখ্যা করার জন্য:-
recordingDetails.location
প্রপার্টি সেই অবস্থানকে চিহ্নিত করে যা ভিডিওর মালিক ভিডিওটির সাথে যুক্ত করতে চান৷ এই অবস্থানটি সম্পাদনাযোগ্য, সর্বজনীন ভিডিওগুলিতে অনুসন্ধানযোগ্য এবং সর্বজনীন ভিডিওগুলির জন্য ব্যবহারকারীদের কাছে প্রদর্শিত হতে পারে৷ -
fileDetails.recordingLocation
সম্পত্তির মান অপরিবর্তনীয় এবং আসল, আপলোড করা ভিডিও ফাইলের সাথে যুক্ত অবস্থানের প্রতিনিধিত্ব করে। মানটি শুধুমাত্র ভিডিও মালিকের কাছে দৃশ্যমান।
-
channel
রিসোর্সেরcontentDetails.relatedPlaylists.favorites
সম্পত্তির সংজ্ঞা আপডেট করা হয়েছে নোট করার জন্য যে সম্পত্তির মানটিতে একটি প্লেলিস্ট আইডি থাকতে পারে যা একটি খালি প্লেলিস্টকে নির্দেশ করে এবং এটি আনা যাবে না। এটি এই কারণে যে প্রিয় ভিডিওগুলির কার্যকারিতা ইতিমধ্যেই বাতিল করা হয়েছে৷ মনে রাখবেন যে এই সম্পত্তি API অবচয় নীতির অধীন নয় ।ineligibleAccount
ত্রুটির সংজ্ঞা, যাcomments.insert
,comments.update
,commentThreads.insert
, বাcommentThreads.update
পদ্ধতি দ্বারা ফেরত দেওয়া যেতে পারে, এটি প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে যখন YouTube অ্যাকাউন্ট API অনুরোধ অনুমোদন করতে ব্যবহৃত হয় তখন ত্রুটিটি ঘটে ব্যবহারকারীর Google অ্যাকাউন্টের সাথে মার্জ করা হয়নি।
এপ্রিল 20, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channels.update
পদ্ধতিরpart
প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে লক্ষ্য করার জন্য যেlocalizations
সেই প্যারামিটারের জন্য একটি বৈধ মান।শুরু করা গাইডের কোটা ব্যবহার বিভাগটি Google বিকাশকারী কনসোলের সাথে লিঙ্ক করার জন্য আপডেট করা হয়েছে, যেখানে আপনি আপনার প্রকৃত কোটা এবং কোটার ব্যবহার দেখতে পাবেন।
16 মার্চ, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
channelBanner
রিসোর্স ডকুমেন্টেশন আপডেট করা হয়েছে নোট করার জন্য যে আপলোড করা চ্যানেল ব্যানার ছবির জন্য প্রস্তাবিত আকার হল 2560px x 1440px। ন্যূনতম আকার (2048px x 1152px) পরিবর্তিত হয়নি।channel
সংস্থানের নতুনsnippet.customUrl
বৈশিষ্ট্য চ্যানেলের সাথে যুক্ত কাস্টম 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
(দক্ষিণ আফ্রিকা)
রেটিং: 10; সম্পত্তি মান: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
আপলোড করা video
রিসোর্সেsnippet.description
প্রপার্টি একটি অবৈধ মান নির্দিষ্ট করেছে তা বোঝাতেvideos.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
invalidPublishAt
videos.update
পদ্ধতিটি এই ত্রুটিটি ইঙ্গিত করে যে আপলোড করাvideo
রিসোর্সেstatus.publishAt
সম্পত্তিটি একটি অবৈধ নির্ধারিত প্রকাশনার সময় নির্দিষ্ট করেছে৷badRequest (400)
invalidRecordingDetails
videos.update
পদ্ধতিটি এই ত্রুটিটি ইঙ্গিত করে যে আপলোড করাvideo
রিসোর্সেrecordingDetails
ডিটেইলস অবজেক্টটি অবৈধ রেকর্ডিং বিশদ উল্লেখ করেছে।badRequest (400)
invalidTags
আপলোড করা video
রিসোর্সেsnippet.tags
প্রপার্টি একটি অবৈধ মান নির্দিষ্ট করেছে তা বোঝাতেvideos.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
invalidTitle
আপলোড করা video
রিসোর্সেsnippet.title
প্রপার্টি একটি অবৈধ বা খালি ভিডিও শিরোনাম নির্দিষ্ট করেছে তা বোঝাতেvideos.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
invalidVideoMetadata
অনুরোধের মেটাডেটা অবৈধ তা নির্দেশ করতে videos.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয়। এই ত্রুটিটি ঘটে যদি অনুরোধটি একটিvideo
সংস্থানেরsnippet
অংশ আপডেট করে কিন্তুsnippet.title
এবংsnippet.categoryId
বৈশিষ্ট্য উভয়ের জন্য একটি মান সেট না করে।
ডিসেম্বর 18, 2015
ইউরোপীয় ইউনিয়নের (ইইউ) আইনের প্রয়োজন হয় যে নির্দিষ্ট কিছু প্রকাশ অবশ্যই দিতে হবে এবং EU-এর শেষ ব্যবহারকারীদের কাছ থেকে সম্মতি নিতে হবে। তাই, ইউরোপীয় ইউনিয়নের শেষ ব্যবহারকারীদের জন্য, আপনাকে অবশ্যই EU ব্যবহারকারীর সম্মতি নীতি মেনে চলতে হবে। আমরা আমাদের YouTube API পরিষেবার শর্তাবলীতে এই প্রয়োজনীয়তার একটি বিজ্ঞপ্তি যুক্ত করেছি৷
নভেম্বর 19, 2015
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 একটি সম্পদের জন্য স্থানীয় মান পুনরুদ্ধার করার দুটি উপায় সমর্থন করে:
আপনার
channels.list
,channelSections.list
,playlists.list
, বাvideos.list
অনুরোধেhl
প্যারামিটার যোগ করুন একটি নির্দিষ্ট অ্যাপ্লিকেশন ভাষার জন্য স্থানীয় ডেটা পুনরুদ্ধার করার জন্য যা YouTube ওয়েবসাইট সমর্থন করে । যদি সেই ভাষায় স্থানীয়কৃত সম্পদের বিবরণ পাওয়া যায়, তাহলে সম্পদের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
প্যারামিটার কেবলমাত্র এমন মানগুলিকে সমর্থন করে যা ইউটিউব ওয়েবসাইট সমর্থন করে এমন অ্যাপ্লিকেশন ভাষাগুলি সনাক্ত করে। স্থানীয়ভাবে পাঠ্য অন্যান্য ভাষার জন্য উপলব্ধ কিনা তা নির্ধারণের জন্য, স্থানীয় পাঠ্যটি বিদ্যমান কিনা তা নির্ধারণের জন্য আপনাকে সংস্থান এবং ফিল্টারটির জন্যlocalizations
অংশটি পুনরুদ্ধার করতে হবে।
উদাহরণস্বরূপ, স্থানীয়করণ পাঠ্য অ্যাপাল্যাচিয়ান ইংরেজিতে উপলব্ধ কিনা তা নির্ধারণ করতে আপনাকে স্থানীয়করণের সম্পূর্ণ তালিকাটি পুনরুদ্ধার করতে হবে।কোনও সংস্থান পুনরুদ্ধার করার সময়, সেই সংস্থানটির জন্য স্থানীয় সমস্ত বিবরণ পুনরুদ্ধার করতে
part
প্যারামিটার মানটিতেlocalizations
অন্তর্ভুক্ত করুন। আপনি যদি এমন কোনও ভাষার জন্য স্থানীয় ডেটা পুনরুদ্ধার করছেন যা বর্তমান ইউটিউব অ্যাপ্লিকেশন ভাষা নয়, তবে আপনাকে সমস্ত স্থানীয়করণ পুনরুদ্ধার করতে এই পদ্ধতির ব্যবহার করতে হবে এবং তারপরে কাঙ্ক্ষিত স্থানীয় ডেটা বিদ্যমান কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে।
স্থানীয় পাঠ্য মান সম্পর্কিত ত্রুটিগুলি
এপিআই স্থানীয় পাঠ্য মানগুলির জন্য নিম্নলিখিত নতুন ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা 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
playlists.update
playlists.insert
channelSections.update
নভেম্বর 4, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সংস্থান এবং পদ্ধতিগুলির আপডেট
search.list
পদ্ধতিরorder
প্যারামিটারটি নোট করার জন্য আপডেট করা হয়েছে যে আপনি যদিviewCount
দ্বারা সরাসরি সম্প্রচার বাছাই করেন তবে সম্প্রচারের ফলাফলগুলি সম্প্রচারের সমকালীন দর্শকদের সংখ্যা দ্বারা বাছাই করা হয় যখন সম্প্রচারগুলি এখনও চলছে।search.list
পদ্ধতিরrelatedToVideoId
প্যারামিটারটি নোট করার জন্য আপডেট করা হয়েছে যে প্যারামিটারটি সেট করা থাকলে, কেবলমাত্র অন্যান্য সমর্থিত প্যারামিটারগুলিpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(যা অবশ্যইvideo
সেট করা উচিত) এবংfields
। এই আপডেটটি এপিআই আচরণের পরিবর্তনকে প্রতিফলিত করে না।video
রিসোর্সেরsnippet.publishedAt
সংজ্ঞাটি upbulishishedat সম্পত্তিটি আপডেট করা হয়েছে যে সম্পত্তিটির মান, যা ভিডিওটি প্রকাশিত হওয়ার তারিখ এবং সময় নির্দিষ্ট করে, ভিডিওটি আপলোড করার সময়টির চেয়ে আলাদা হতে পারে। উদাহরণস্বরূপ, যদি কোনও ভিডিও কোনও ব্যক্তিগত ভিডিও হিসাবে আপলোড করা হয় এবং তারপরে পরবর্তী সময়ে সর্বজনীন করা হয়, তবে সম্পত্তিটির মানটি ভিডিওটি সর্বজনীন করার সময়টি নির্দিষ্ট করে। আপডেট হওয়া সংজ্ঞাটি কীভাবে ব্যক্তিগত এবং তালিকাভুক্ত ভিডিওগুলির জন্য মানটি জনবহুল হয় তাও ব্যাখ্যা করে।এই পরিবর্তনটি এপিআই আচরণের পরিবর্তনকে প্রতিফলিত করে না।
video
রিসোর্সেরstatus.publishAt
সংজ্ঞাটি upbulishat সম্পত্তিটি নোট করার জন্য আপডেট করা হয়েছে:-
videos.update
কল করার সময় আপনি যদি এই সম্পত্তির মানটি সেট করেন তবে ভিডিওটি ইতিমধ্যে ব্যক্তিগত থাকলেও আপনাকে অবশ্যইstatus.privacyStatus
সম্পত্তি মানটিprivate
সেট করতে হবে। - যদি অনুরোধটি অতীতে কোনও সময় প্রকাশিত হওয়ার জন্য কোনও ভিডিওর সময়সূচী করে, তবে তা এখনই প্রকাশিত হয়।
public
,status.publishAt
নির্ধারণেরprivacyStatus
private
-
video
রিসোর্সেরcontentDetails.contentRating.cncRating
C এই সম্পত্তিটিcontentDetails.contentRating.fmocRating
প্রতিস্থাপন করে Contchannel
রিসোর্সের ব্র্যান্ডিংসেটেটিংস.চ্যানেল.কিওয়ার্ডসের সংজ্ঞাটি সঠিকভাবে প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে সম্পত্তির মানটিতে স্ট্রিংগুলির একটি স্পেস-বিচ্ছিন্ন তালিকা রয়েছে এবং কমা-বিচ্ছিন্ন তালিকা নয়, যেমন পূর্বে নথিভুক্ত করা হয়েছে। এই আপডেটটি এপিআই আচরণের পরিবর্তনকে প্রতিফলিত করে না।থাম্বনেইলগুলির জন্য
thumbnails.set
পদ্ধতিটি সঠিকভাবে প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে অনুরোধের বডিটিতে থাম্বনেইল চিত্র রয়েছে যা আপনি আপলোড করছেন এবং একটি ভিডিওর সাথে যুক্ত করছেন। অনুরোধ বডিটিতে একটিthumbnail
রিসোর্স নেই। পূর্বে, ডকুমেন্টেশন বলেছিল যে এই পদ্ধতিটি কল করার সময় আপনার কোনও অনুরোধের বডি সরবরাহ করা উচিত নয়। এই আপডেটটি এপিআই আচরণের পরিবর্তনকে প্রতিফলিত করে না।activity
বিবরণটি প্রতিফলিত করতে আপডেট করা হয়েছে যেactivities.list
পদ্ধতিতে বর্তমানে নতুন ভিডিও মন্তব্য সম্পর্কিত সংস্থানগুলি অন্তর্ভুক্ত নয়। রিসোর্সেরsnippet.type
এবংcontentDetails.comment
আপডেট করা হয়েছে।
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ভুল তথ্য 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
বর্ণনা অনুরোধটি ডিফল্ট সম্প্রচারের জন্য একটি অবৈধ গোপনীয়তা সেটিং সেট করার চেষ্টা করে।
আগস্ট 28, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সংস্থান এবং পদ্ধতিগুলির আপডেট
video
রিসোর্সেরstatistics.favoriteCount
সম্পত্তিটি হ্রাস করা হয়েছে।আমাদের অবমূল্যায়ন নীতি অনুসারে, এই সম্পত্তি এই ঘোষণার পরে কমপক্ষে এক বছরের জন্য
video
সংস্থায় অন্তর্ভুক্ত থাকবে। তবে সম্পত্তির মান এখন সর্বদা0
এ সেট করা থাকে।
আগস্ট 7, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সংস্থান এবং পদ্ধতিগুলির আপডেট
video
রিসোর্সেরsnippet.tags[]
সম্পত্তি কীভাবে এপিআই সার্ভার সম্পত্তির মানের দৈর্ঘ্য গণনা করে সে সম্পর্কে আরও তথ্য সরবরাহ করতে আপডেট করা হয়েছে। নোট করুন যে এই আপডেটটি এপিআইয়ের আচরণের কোনও পরিবর্তন প্রতিফলিত করে না।বিশেষত, সংজ্ঞাটি এখন ব্যাখ্যা করে যে কোনও ট্যাগে যদি কোনও স্থান থাকে তবে এপিআই সার্ভারটি ট্যাগের মানটিকে এমনভাবে পরিচালনা করে যেন এটি উদ্ধৃতি চিহ্নগুলিতে আবৃত ছিল এবং উদ্ধৃতি চিহ্নগুলি চরিত্রের সীমাটির দিকে গণনা করে। সুতরাং, চরিত্রের সীমাগুলির উদ্দেশ্যে, ট্যাগ ফু-বাজে সাতটি অক্ষর রয়েছে তবে ট্যাগ ফু বাজে নয়টি অক্ষর রয়েছে।
commentThreads.insert
shareOnGooglePlus
যদি কোনও অনুরোধ প্যারামিটারটি জমা দেয় তবে এপিআই সার্ভার প্যারামিটারটিকে উপেক্ষা করে তবে অন্যথায় অনুরোধটি পরিচালনা করে।
18 জুন, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সংস্থান এবং পদ্ধতিগুলির আপডেট
commentThreads.list
order
থ্রেডগুলি সময় বা প্রাসঙ্গিকতা দ্বারা অর্ডার করা যেতে পারে। ডিফল্ট আচরণটি সময়মতো তাদের অর্ডার করা।video
রিসোর্সের নতুনsnippet.defaultAudioLanguage
সম্পত্তি ভিডিওটির ডিফল্ট অডিও ট্র্যাকটিতে কথিত ভাষাটি নির্দিষ্ট করে।video
রিসোর্সেরcontentDetails.licensedContent
সংজ্ঞাটি L এটি প্রকৃত এপিআই আচরণের পরিবর্তনের প্রতিনিধিত্ব করে না।captions.delete
captions.update
captions.insert
onBehalfOfContentOwner
captions.list
captions.download
সেই পদ্ধতিটি ব্যবহার করে এমন অনুরোধগুলিও একটি টোকেন দিয়ে অনুমোদিত হওয়া দরকার যাhttps://www.googleapis.com/auth/youtubepartner
স্কোপে অ্যাক্সেস সরবরাহ করে।
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ভুল তথ্য videos.rate
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ emailNotVerified
বর্ণনা ভিডিওটি রেটিং করার আগে ব্যবহারকারীকে অবশ্যই তার ইমেল ঠিকানাটি যাচাই করতে হবে। videos.rate
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ videoPurchaseRequired
বর্ণনা ভাড়া ভিডিওগুলি কেবল তাদের ভাড়া নেওয়া ব্যবহারকারীরা রেট দেওয়া যেতে পারে। subscriptions.delete
এবংsubscriptions.insert
পদ্ধতিগুলি আরaccountClosed
এবংaccountSuspended
ত্রুটিগুলিকে সমর্থন করে না।
এপ্রিল 27, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
videoAbuseReportReason
রিসোর্সে এমন একটি কারণ সম্পর্কে তথ্য রয়েছে যা কোনও ভিডিওকে আপত্তিজনক সামগ্রী ধারণ করার জন্য পতাকাঙ্কিত করা হবে।videoAbuseReportReasons.list
পদ্ধতি আপনাকে ভিডিওগুলি পতাকাঙ্কিত হতে পারে তার সমস্ত কারণগুলির একটি তালিকা পুনরুদ্ধার করতে দেয়।নতুন
videos.reportAbuse
পদ্ধতিটি আসলে কোনও ভিডিওকে পতাকাঙ্কিত করার একটি উপায় সরবরাহ করে যাতে আপত্তিজনক সামগ্রী রয়েছে। অনুরোধের বডিটিতে একটি জেএসওএন অবজেক্ট রয়েছে যা ভিডিওটিকে পতাকাঙ্কিত করার পাশাপাশি ভিডিওটি আপত্তিজনক সামগ্রী ধারণ করে বলে মনে করা হয় এমন কারণটি নির্দিষ্ট করে। বৈধ কারণগুলি উপরে বর্ণিতvideoAbuseReportReason.list
পদ্ধতি থেকে প্রাপ্ত করা যেতে পারে।মাইগ্রেশন গাইডটি একটি আপত্তিজনক ভিডিওর প্রতিবেদনের জন্য একটি উদাহরণ সহ আপডেট করা হয়েছে। এই পরিবর্তনের সাথে সাথে, ভি 3 এপিআই এখন ভি 2 এপিআই বৈশিষ্ট্যগুলিকে সমর্থন করে যা এটি সমর্থন করার জন্য নির্ধারিত হয়েছে। এই বৈশিষ্ট্যগুলিও মাইগ্রেশন গাইডে ব্যাখ্যা করা হয়েছে।
বিদ্যমান সংস্থান এবং পদ্ধতিগুলির আপডেট
search.list
পদ্ধতির নতুনforDeveloper
ফিল্টার প্যারামিটারটি কেবল বিকাশকারীর অ্যাপ্লিকেশন বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওগুলি পুনরুদ্ধার করতে একটি অনুসন্ধানকে সীমাবদ্ধ করে।q
প্যারামিটারের মতো al চ্ছিক অনুসন্ধান প্যারামিটারের সাথে একত্রেforDeveloper
প্যারামিটার ব্যবহার করা যেতে পারে।এই বৈশিষ্ট্যের জন্য, প্রতিটি আপলোড করা ভিডিও স্বয়ংক্রিয়ভাবে গুগল ডেভেলপারস কনসোলে বিকাশকারীদের অ্যাপ্লিকেশনটির সাথে সম্পর্কিত প্রকল্প নম্বরটির সাথে স্বয়ংক্রিয়ভাবে ট্যাগ করা হয়।
যখন কোনও অনুসন্ধানের অনুরোধটি পরবর্তীকালে
forDeveloper
প্যারামিটারটিকেtrue
সেট করে, এপিআই সার্ভারটি বিকাশকারীকে সনাক্ত করতে অনুরোধের অনুমোদনের শংসাপত্রগুলি ব্যবহার করে। অতএব, কোনও বিকাশকারী বিকাশকারীর নিজস্ব অ্যাপ্লিকেশন বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওগুলিতে ফলাফলগুলি সীমাবদ্ধ করতে পারে তবে অন্যান্য অ্যাপ্লিকেশন বা সাইটের মাধ্যমে আপলোড করা ভিডিওগুলিতে নয়।নতুন বৈশিষ্ট্যটি কার্যকারিতা সরবরাহ করে যা একই রকম, যদিও অভিন্ন নয়, বিকাশকারী ট্যাগ কার্যকারিতা যা ভি 2 এপিআই সমর্থন করেছে।
channel
রিসোর্সের নতুনsnippet.country
সম্পত্তি চ্যানেল মালিকদের তাদের চ্যানেলগুলিকে একটি নির্দিষ্ট দেশের সাথে সংযুক্ত করতে দেয়।দ্রষ্টব্য: একটি
channel
রিসোর্সের জন্যsnippet.country
সম্পত্তি সেট করতে, আপনাকে আসলেbrandingSettings.channel.country
সম্পত্তি আপডেট করতে হবে।এপিআই এখন
channelSection
রিসোর্সগুলির জন্য লক্ষ্যবস্তু সমর্থন করে। চ্যানেল বিভাগ লক্ষ্যমাত্রা নির্দিষ্ট মানদণ্ডের সাথে মেলে এমন ব্যবহারকারীদের কাছে কোনও সামগ্রী বিভাগের দৃশ্যমানতা সীমাবদ্ধ করার একটি উপায় সরবরাহ করে।এপিআই তিনটি টার্গেটিং বিকল্প প্রকাশ করে। কোনও ব্যবহারকারীকে অবশ্যই চ্যানেল বিভাগটি দৃশ্যমান হওয়ার জন্য সমস্ত টার্গেটিং সেটিংস পূরণ করতে হবে।
targeting.languages[]
: ইউটিউব অ্যাপ্লিকেশন ভাষার একটি তালিকা। এই ভাষাগুলির মধ্যে একটি বেছে নেওয়া ব্যবহারকারীরা সংশ্লিষ্ট চ্যানেল বিভাগটি দেখতে পারেন।targeting.regions[]
। চ্যানেল বিভাগটি এমন ব্যবহারকারীদের কাছে দৃশ্যমান যা সেই অঞ্চলগুলির মধ্যে একটি পাশাপাশি ব্যবহারকারীদের জন্য যাদের জন্য সেই অঞ্চলগুলির মধ্যে একটি স্বয়ংক্রিয়ভাবে নির্বাচিত হয়েছে।targeting.countries[]
: চ্যানেল বিভাগটি দৃশ্যমান এমন দেশগুলির একটি তালিকা। তালিকার প্রতিটি মান একটি আইএসও 3166-1 আলফা -2 দেশ কোড ।
video
রিসোর্সেরcontentDetails.duration
সংজ্ঞাটি DchannelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
এবংvideos.delete
পদ্ধতিটি প্রতিফলিত করার জন্য সংশোধন করা হয়েছে, যখন সফল হয়, সেই পদ্ধতিগুলি সমস্ত পদ্ধতিগুলি একটি এইচটিটিপি204
প্রতিক্রিয়া কোড (No Content
) তা সংশোধন করা হয়েছে।
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
targetInvalidCountry
channelSections.insert
channelSections.update
channelSection
targeting.countries[]
badRequest (400)
targetInvalidLanguage
channelSections.insert
channelSections.update
channelSection
targeting.languages[]
badRequest (400)
targetInvalidRegion
channelSections.insert
channelSections.update
channelSection
targeting.regions[]
badRequest (400)
operationNotSupported
comments.insert
পদ্ধতিটি যদি এপিআই ব্যবহারকারীsnippet.parentId
সম্পত্তি দ্বারা চিহ্নিত শীর্ষ-স্তরের মন্তব্যে উত্তরে কোনও মন্তব্য সন্নিবেশ করতে সক্ষম না হয় তবে এই ত্রুটিটি ফিরিয়ে দেয়। একটিcommentThread
রিসোর্সে,snippet.canReply
সম্পত্তিটি নির্দেশ করে যে বর্তমান দর্শক থ্রেডে জবাব দিতে পারে কিনা।badRequest (400)
invalidChannelId
অনুরোধের channelId
প্যারামিটারটি যদি কোনও অবৈধ চ্যানেল আইডি নির্দিষ্ট করে থাকে তবেsearch.list
পদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয়।badRequest (400)
subscriptionForbidden
subscriptions.insert
পদ্ধতিটি যদি এপিআই ব্যবহারকারী ব্যবহারকারীর নিজস্ব চ্যানেলে সাবস্ক্রাইব করার চেষ্টা করে তবে এই ত্রুটিটি ফেরত দেয়।captions.update
পদ্ধতিটি আরinvalidMetadata
এবংvideoNotFound
ত্রুটিগুলি সমর্থন করে না।
16 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ভি 2 এপিআই থেকে মন্তব্য কার্যকারিতা ব্যবহার করে কীভাবে অ্যাপ্লিকেশনগুলি স্থানান্তর করতে হয় তা ব্যাখ্যা করার জন্য মাইগ্রেশন গাইডটি আপডেট করা হয়েছে।
গাইডটি বেশ কয়েকটি মন্তব্য করার বৈশিষ্ট্যও কল করে যা ভি 2 এপিআই সমর্থন করে না তবে এটি ভি 3 এপিআইতে সমর্থিত । এর মধ্যে রয়েছে:
- একটি চ্যানেল সম্পর্কে মন্তব্য পুনরুদ্ধার
- একটি চ্যানেল সম্পর্কিত সমস্ত মন্তব্য থ্রেড পুনরুদ্ধার করা, যার অর্থ এপিআই প্রতিক্রিয়াটিতে চ্যানেল বা এর কোনও ভিডিও সম্পর্কে মন্তব্য থাকতে পারে।
- একটি মন্তব্যের পাঠ্য আপডেট করা
- স্প্যাম হিসাবে একটি মন্তব্য চিহ্নিত
- একটি মন্তব্যের সংযম স্থিতি সেট করা
সাবস্ক্রাইব টু পুশ বিজ্ঞপ্তি গাইডকে এই সত্যটি প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে বিজ্ঞপ্তিগুলি কেবল গুগল পাবসুববুব হাবের দিকে ঠেলে দেওয়া হয়েছে এবং পূর্বের নির্দেশিত হিসাবে সুপারফিডার হাবটিতেও নয়।
9 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
এপিআইয়ের নতুন
commentThread
এবংcomment
সংস্থানগুলি আপনাকে পুনরুদ্ধার করতে, সন্নিবেশ, আপডেট, মুছতে এবং মাঝারি মন্তব্য করতে দেয়।একটি
commentThread
রিসোর্সে একটি ইউটিউব মন্তব্য থ্রেড সম্পর্কে তথ্য রয়েছে, যা একটি মন্তব্যে একটি শীর্ষ-স্তরের মন্তব্য এবং জবাব দেয়, যদি কোনও উপস্থিত থাকে তবে তা রয়েছে। একটিcommentThread
রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে মন্তব্যগুলি উপস্থাপন করতে পারে।শীর্ষ স্তরের মন্তব্য এবং উত্তরগুলি আসলে
comment
সংস্থানগুলি যাcommentThread
রিসোর্সের ভিতরে বাসা বাঁধে। এটি লক্ষণীয় গুরুত্বপূর্ণ যেcommentThread
রিসোর্সটিতে কোনও মন্তব্যের জন্য সমস্ত জবাব অগত্যা থাকে না এবং আপনি যদি কোনও নির্দিষ্ট মন্তব্যের জন্য সমস্ত উত্তর পুনরুদ্ধার করতে চান তবে আপনাকে মন্তব্যগুলি ব্যবহার করতে হবেcomments.list
পদ্ধতি। এছাড়াও, কিছু মন্তব্যে জবাব নেই।এপিআই
commentThread
রিসোর্সগুলির জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:-
commentThreads.list
- মন্তব্য থ্রেডগুলির একটি তালিকা পুনরুদ্ধার করুন। কোনও নির্দিষ্ট ভিডিও বা চ্যানেলের সাথে সম্পর্কিত মন্তব্যগুলি পুনরুদ্ধার করতে এই পদ্ধতিটি ব্যবহার করুন। -
commentThreads.insert
-একটি নতুন শীর্ষ স্তরের মন্তব্য তৈরি করুন। (বিদ্যমান মন্তব্যে জবাব দেওয়ার জন্যcomments.insert
ব্যবহার করুন। -
commentThreads.update
-একটি শীর্ষ স্তরের মন্তব্য সংশোধন করুন।
-
একটি
comment
সংস্থানটিতে একটি একক ইউটিউব মন্তব্য সম্পর্কে তথ্য রয়েছে। একটিcomment
সংস্থান কোনও ভিডিও বা চ্যানেল সম্পর্কে একটি মন্তব্য উপস্থাপন করতে পারে। এছাড়াও, মন্তব্যটি শীর্ষ-স্তরের মন্তব্য বা শীর্ষ-স্তরের মন্তব্যের উত্তর হতে পারে।এপিআই
comment
সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:-
comments.list
- মন্তব্যের একটি তালিকা পুনরুদ্ধার করুন। একটি নির্দিষ্ট মন্তব্যে সমস্ত উত্তর পুনরুদ্ধার করতে এই পদ্ধতিটি ব্যবহার করুন। -
comments.insert
- একটি বিদ্যমান মন্তব্যে একটি উত্তর তৈরি করুন। -
comments.update
- একটি মন্তব্য সংশোধন করুন। -
comments.markAsSpam
- স্প্যাম হিসাবে এক বা একাধিক মন্তব্য পতাকা। -
comments.setModerationStatus
- এক বা একাধিক মন্তব্যের সংযম স্থিতি সেট করুন। উদাহরণস্বরূপ, জনসাধারণের প্রদর্শনের জন্য একটি মন্তব্য সাফ করুন বা প্রদর্শনের জন্য অযোগ্য হিসাবে কোনও মন্তব্য প্রত্যাখ্যান করুন। এপিআই অনুরোধটি অবশ্যই মন্তব্যের সাথে সম্পর্কিত চ্যানেল বা ভিডিওর মালিক দ্বারা অনুমোদিত হতে হবে .. -
comments.delete
- একটি মন্তব্য মুছুন।
-
নোট করুন যে এপিআইয়ের নতুন
https://www.googleapis.com/auth/youtube.force-ssl
স্কোপ, 2 এপ্রিল, 2015 এর সংশোধন ইতিহাসে বর্ণিত,comments.update
কলcomments.insert
জন্য প্রয়োজনীয়comments.markAsSpam
comments.setModerationStatus
comments.delete
commentThreads.insert
commentThreads.update
নতুন সাবস্ক্রাইব টু পুশ বিজ্ঞপ্তি গাইডটি ওয়েব-অ্যাক্সেসযোগ্য সংস্থানগুলির জন্য সার্ভার-টু-সার্ভার প্রকাশ/সাবস্ক্রাইব প্রোটোকল, পাবসুববাবের মাধ্যমে পুশ বিজ্ঞপ্তিগুলির জন্য এপিআইয়ের নতুন সমর্থন ব্যাখ্যা করে। আপনার পাবসুবুবব কলব্যাক সার্ভার যখন কোনও চ্যানেল নিম্নলিখিত ক্রিয়াকলাপগুলির কোনওটি করে তখন পরমাণু ফিড বিজ্ঞপ্তিগুলি গ্রহণ করতে পারে:
- একটি ভিডিও আপলোড করে
- একটি ভিডিওর শিরোনাম আপডেট করে
- একটি ভিডিওর বিবরণ আপডেট করে
পুশ বিজ্ঞপ্তিগুলির জন্য নতুন সমর্থন নোট করার জন্য মাইগ্রেশন গাইডও আপডেট করা হয়েছে। তবে, যেহেতু ভি 2 এপিআই ভি 3 এপিআইতে সমর্থিত নয় এমন অন্যান্য ধরণের পুশ বিজ্ঞপ্তিগুলিকে সমর্থন করেছে, তাই পাবসুবুববকে সমর্থনটির উল্লেখটি এখনও সেই গাইডের অবমূল্যায়িত বিভাগে তালিকাভুক্ত রয়েছে।
এপিআইয়ের নতুন
https://www.googleapis.com/auth/youtube.force-ssl
স্কোপ এখনhttps://www.googleapis.com/auth/youtube
স্কোপকে সমর্থন করে এমন কোনও এপিআই পদ্ধতির জন্য একটি বৈধ স্কোপ।এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
invalidRating
videos.rate
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যদি অনুরোধটিতেrating
প্যারামিটারের জন্য একটি অপ্রত্যাশিত মান থাকে।subscriptions.insert
পদ্ধতিটি আর সাবস্ক্রিপশনsubscriptionLimitExceeded
ত্রুটি সমর্থন করে না, যা পূর্বে ইঙ্গিত করেছিল যে অনুরোধের সাথে চিহ্নিত গ্রাহক সাবস্ক্রিপশন হারের সীমা ছাড়িয়ে গেছে।
2শে এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
captions
রিসোর্স একটি ইউটিউব ক্যাপশন ট্র্যাক উপস্থাপন করে। একটি ক্যাপশন ট্র্যাক ঠিক একটি ইউটিউব ভিডিওর সাথে সম্পর্কিত।এপিআই ক্যাপশন ট্র্যাকগুলি তালিকাভুক্ত , সন্নিবেশ , আপডেট , ডাউনলোড এবং মুছতে পদ্ধতিগুলিকে সমর্থন করে।
ভি 2 এপিআই -তে ক্যাপশন কার্যকারিতা ব্যবহার করে কীভাবে অ্যাপ্লিকেশনগুলি স্থানান্তর করতে হয় তা ব্যাখ্যা করার জন্য মাইগ্রেশন গাইডটিও আপডেট করা হয়েছে।
এপিআইয়ের নতুন
https://www.googleapis.com/auth/youtube.force-ssl
সুযোগের জন্য এসএসএল সংযোগের মাধ্যমে এপিআই সার্ভারের সাথে যোগাযোগের প্রয়োজন।এই নতুন সুযোগটি
https://www.googleapis.com/auth/youtube
স্কোপের মতো একই অ্যাক্সেসকে মঞ্জুরি দেয়। এবং, প্রকৃতপক্ষে, এই দুটি স্কোপগুলি কার্যকরীভাবে অভিন্ন কারণ ইউটিউব এপিআই সার্ভারটি কেবল একটি এইচটিটিপিএস এন্ডপয়েন্টের মাধ্যমে উপলব্ধ। ফলস্বরূপ, যদিওhttps://www.googleapis.com/auth/youtube
স্কোপের জন্য এসএসএল সংযোগের প্রয়োজন নেই, তবে এপিআইয়ের অনুরোধ করার আর কোনও উপায় নেই।caption
রিসোর্সের সমস্ত পদ্ধতিতে কলগুলির জন্য নতুন সুযোগটি প্রয়োজন।
11 মার্চ, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডে ভি 3 এপিআই -তে নতুন নামে একটি নতুন ট্যাব রয়েছে, যা ভি 3 এপিআই সমর্থন করে এবং ভি 2 এপিআই সমর্থন করে না এমন বৈশিষ্ট্যগুলি তালিকাভুক্ত করে। একই বৈশিষ্ট্যগুলি আগে ছিল এবং এখনও গাইডের অন্যান্য ট্যাবে তালিকাভুক্ত রয়েছে। উদাহরণস্বরূপ, কোনও চ্যানেলের ইন-ভিডিও প্রচার প্রচারের ডেটা কীভাবে আপডেট করবেন তা ব্যাখ্যা করে এমন নতুন বৈশিষ্ট্যটিও চ্যানেলগুলি (প্রোফাইল) ট্যাবের অধীনে তালিকাভুক্ত করা হয়েছে।
ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডটি আপডেট করা হয়েছে যে ভি 3 এপিআই নিম্নলিখিত ভি 2 এপিআই বৈশিষ্ট্যটিকে সমর্থন করবে:
ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডটি আপডেট করা হয়েছে যে নিম্নলিখিত ভি 2 এপিআই বৈশিষ্ট্যগুলি ভি 3 এপিআইতে সমর্থিত হবে না:
ভিডিও সুপারিশগুলি পুনরুদ্ধার করুন - ভি 3 এপিআই এমন একটি তালিকা পুনরুদ্ধার করে না যাতে কেবলমাত্র বর্তমান এপিআই ব্যবহারকারীর জন্য প্রস্তাবিত ভিডিও রয়েছে। তবে, আপনি
activities.list
কল করে এবংhome
প্যারামিটারের মানটিtrue
সেট করে কল করে প্রস্তাবিত ভিডিওগুলি সন্ধান করতে ভি 3 এপিআই ব্যবহার করতে পারেন।এপিআই প্রতিক্রিয়াতে, একটি সংস্থান প্রস্তাবিত ভিডিওর সাথে মিলে যায় যদি
snippet.type
সম্পত্তির মানrecommendation
হয়। সেক্ষেত্রে,contentDetails.recommendation.reason
এবংcontentDetails.recommendation.seedResourceId
বৈশিষ্ট্যগুলিতে ভিডিওটি কেন সুপারিশ করা হয়েছিল সে সম্পর্কে তথ্য থাকবে। নোট করুন যে কোনও গ্যারান্টি নেই যে প্রতিক্রিয়াটিতে কোনও নির্দিষ্ট সংখ্যক প্রস্তাবিত ভিডিও থাকবে।নতুন সাবস্ক্রিপশন ভিডিওগুলি পুনরুদ্ধার করুন - ভি 3 এপিআই এমন কোনও তালিকা পুনরুদ্ধার করে না যাতে কেবলমাত্র এমন ভিডিও রয়েছে যা সম্প্রতি এপিআই ব্যবহারকারী সাবস্ক্রাইব করে এমন চ্যানেলগুলিতে আপলোড করা হয়েছে। তবে, আপনি
activities.list
কল করে এবংhome
প্যারামিটার মানটিtrue
সেট করে নতুন সাবস্ক্রিপশন ভিডিওগুলি সন্ধান করতে ভি 3 এপিআই ব্যবহার করতে পারেন।এপিআই প্রতিক্রিয়াতে, একটি সংস্থান একটি নতুন সাবস্ক্রিপশন ভিডিওর সাথে মিলে যায় যদি
snippet.type
সম্পত্তির মানupload
হয়। নোট করুন যে কোনও গ্যারান্টি নেই যে প্রতিক্রিয়াটিতে কোনও নির্দিষ্ট সংখ্যক নতুন সাবস্ক্রিপশন ভিডিও থাকবে।ফিড আপডেটের জন্য পুশ বিজ্ঞপ্তিগুলি - ইউটিউব ব্যবহারকারীদের জন্য ব্যবহারকারীর ক্রিয়াকলাপ ফিডগুলি নিরীক্ষণ করতে ভি 2 এপিআই সহজ আপডেট প্রোটোকল (এসইউপি) বা পাবসুভবাবকে ব্যবহার করে পুশ বিজ্ঞপ্তিগুলি সমর্থন করে। নতুন চ্যানেল সাবস্ক্রিপশনগুলির জন্য বিজ্ঞপ্তিগুলি সরবরাহ করা হয়েছিল এবং যখন ভিডিওগুলি রেট দেওয়া হয়, ভাগ করা হয়, পছন্দ হিসাবে চিহ্নিত করা হয়, মন্তব্য করা হয় বা আপলোড করা হয়।
ভি 3 এপিআই পাবসুববাব প্রোটোকল ব্যবহার করে পুশ বিজ্ঞপ্তিগুলি সমর্থন করবে, তবে বিজ্ঞপ্তিগুলি কেবল ভিডিও আপলোড এবং ভিডিও শিরোনাম বা ভিডিও বর্ণনার আপডেটগুলি কভার করবে।
চ্যানেল অবস্থান - ভি 2 এপিআই চ্যানেলের ইউটিউব পাবলিক প্রোফাইলে প্রবেশের মতো ব্যবহারকারীর অবস্থান সনাক্ত করতে
<yt:location>
ট্যাগ ব্যবহার করেছে। কিছু বিকাশকারী এই ক্ষেত্রটি একটি নির্দিষ্ট দেশের সাথে একটি চ্যানেলকে সংযুক্ত করার জন্য ব্যবহার করার সময়, ক্ষেত্রের ডেটা ধারাবাহিকভাবে সেই উদ্দেশ্যে ব্যবহার করা যায়নি।বিকাশকারী ট্যাগগুলি সেট বা পুনরুদ্ধার করুন - ভি 2 এপিআই ভিডিওটি আপলোড করার সময় একটি ভিডিও সহ কীওয়ার্ডগুলি বা বিকাশকারী ট্যাগগুলি সংযুক্ত করার ক্ষমতা সমর্থন করে। বিকাশকারী ট্যাগগুলি ইউটিউব ব্যবহারকারীদের কাছে প্রদর্শিত হবে না, তবে ভিডিও মালিকরা এমন ভিডিওগুলি পুনরুদ্ধার করতে পারেন যা একটি নির্দিষ্ট বিকাশকারী ট্যাগের সাথে মেলে।
ভি 3 এপিআই একটি অনুরূপ, তবে অভিন্ন নয়, বৈশিষ্ট্য সরবরাহ করবে। বিশেষত, একজন বিকাশকারী বিকাশকারীর নিজস্ব অ্যাপ্লিকেশন দ্বারা আপলোড করা ভিডিওগুলি অনুসন্ধান করতে সক্ষম হবেন। এই বৈশিষ্ট্যের জন্য, প্রতিটি আপলোড করা ভিডিও স্বয়ংক্রিয়ভাবে গুগল ডেভেলপারস কনসোলে বিকাশকারীদের অ্যাপ্লিকেশনটির সাথে সম্পর্কিত প্রকল্প নম্বরটির সাথে স্বয়ংক্রিয়ভাবে ট্যাগ করা হয়। বিকাশকারী তারপরে ভিডিওগুলি অনুসন্ধান করতে একই প্রকল্প নম্বর ব্যবহার করে।
প্রকাশনার তারিখ, ভিউকাউন্ট বা রেটিং অনুসারে ভিডিওগুলি তালিকাভুক্ত করুন - ভি 2 এপিআইতে,
orderby
প্যারামিটার আপনাকে প্লেলিস্টে অবস্থান, সময়কাল, প্রকাশের তারিখ, শিরোনাম এবং অন্যান্য বেশ কয়েকটি মান অনুসারে ভিডিওগুলি বাছাই করতে দেয়। ভি 3 এপিআইতে, প্লেলিস্ট আইটেমগুলি সাধারণত আরোহী ক্রমে অবস্থান অনুসারে বাছাই করা হয় এবং অন্যান্য বাছাই বিকল্পগুলি উপলভ্য নয়।কয়েকটি ব্যতিক্রম আছে। নিম্নলিখিত ধরণের প্লেলিস্টগুলির জন্য একটি নতুন আপলোড, প্রিয় ভিডিও, পছন্দ করা ভিডিও বা সম্প্রতি দেখা ভিডিওটি স্বয়ংক্রিয়ভাবে প্রথম আইটেম (
snippet.position
=0
) হিসাবে যুক্ত করা হয়েছে। সুতরাং, এই তালিকাগুলির প্রত্যেকটিই তালিকায় আইটেমগুলি যুক্ত করার সময়গুলির উপর ভিত্তি করে নতুন থেকে প্রাচীনতম আইটেমের ক্রমে কার্যকরভাবে বাছাই করা হয়।- ব্যবহারকারী আপলোড
- প্রিয় ভিডিও
- ভিডিও পছন্দ হয়েছে
- ইতিহাস দেখুন
তবে দ্রষ্টব্য, "পরে দেখুন" প্লেলিস্টে যুক্ত একটি নতুন আইটেম সেই তালিকার শেষ আইটেম হিসাবে যুক্ত করা হয়েছে, যাতে সেই তালিকাটি কার্যকরভাবে প্রাচীনতম থেকে নতুন আইটেম পর্যন্ত বাছাই করা হয়।
ব্যাচ প্রসেসিং - ভি 3 এপিআই ভি 2 এপিআই সমর্থন করেছিল এমন একটি ব্যাচ প্রসেসিং ব্যবহারের ক্ষেত্রে সমর্থন করে। ভি 3 এপিআই এর
channels.list
,channelSections.list
,guideCategories.list
ক্যাটাগরিজ.লিস্ট,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
, এবংvideos.list
পদ্ধতিগুলি সমস্তid
প্যারামিটারকে সমর্থন করে, যা একটি কমা নির্দিষ্ট করতে ব্যবহার করা যেতে পারে -আইডিএস (ভিডিও আইডি, চ্যানেল আইডিএস ইত্যাদি) এর তালিকাভুক্ত তালিকা। এই পদ্ধতিগুলি ব্যবহার করে, আপনি একক অনুরোধ সহ একাধিক সংস্থার একটি তালিকা পুনরুদ্ধার করতে পারেন।
এই পরিবর্তনগুলির সাথে, গাইডটি এখন সমস্ত কার্যকারিতা চিহ্নিত করে যা পুরানো (ভি 2) এপিআইতে সমর্থিত ছিল যা বর্তমান এপিআই সংস্করণে (ভি 3) অবমূল্যায়িত হবে।
4 মার্চ, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channelSections.delete
এবংchannelSections.update
পদ্ধতিগুলি এখনonBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত।নিম্নলিখিত সম্পত্তি এবং তাদের সন্তানের সম্পত্তিগুলি হ্রাস করা হয়েছে:
-
brandingSettings.image.backgroundImageUrl
-
brandingSettings.image.largeBrandedBannerImageImapScript
-
brandingSettings.image.largeBrandedBannerImageUrl
-
brandingSettings.image.smallBrandedBannerImageImapScript
-
brandingSettings.image.smallBrandedBannerImageUrl
দ্রষ্টব্য: এই সম্পত্তিগুলির কোনওটিই এপিআই হ্রাস নীতি সাপেক্ষে ছিল না।
-
video
রিসোর্সের নতুনcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
।এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা notFound (404)
channelNotFound
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদি অনুরোধেরid
প্যারামিটারটি এমন একটি চ্যানেল নির্দিষ্ট করে যা খুঁজে পাওয়া যায় না।badRequest (400)
manualSortRequiredinvalidValue
playlistItems.insert
এবংplaylistItems.update
পদ্ধতিগুলি যদি অনুরোধটি প্লেলিস্ট আইটেমের অবস্থান নির্ধারণের চেষ্টা করে তবে এই ত্রুটিটি ফিরিয়ে দেয় তবে প্লেলিস্টটি ম্যানুয়াল বাছাই ব্যবহার করে না। উদাহরণস্বরূপ, প্লেলিস্ট আইটেমগুলি তারিখ বা জনপ্রিয়তার দ্বারা বাছাই করা যেতে পারে। অনুরোধের বডিটিতে প্রেরিত সংস্থান থেকেsnippet.position
উপাদানটি সরিয়ে আপনি এই ত্রুটিটি সমাধান করতে পারেন। আপনি যদি প্লেলিস্ট আইটেমটি তালিকায় একটি নির্দিষ্ট অবস্থান পেতে চান তবে আপনাকে প্রথমে ম্যানুয়ালটিতে প্লেলিস্টের অর্ডারিং সেটিংটি আপডেট করতে হবে। এই সেটিংটি ইউটিউব ভিডিও ম্যানেজারে সামঞ্জস্য করা যেতে পারে।forbidden (403)
channelClosed
playlists.list
পদ্ধতিটি যদি অনুরোধেরchannelId
প্যারামিটারটি বন্ধ হয়ে গেছে এমন একটি চ্যানেল নির্দিষ্ট করে তবে এই ত্রুটিটি ফেরত দেয়।forbidden (403)
channelSuspended
playlists.list
পদ্ধতিটি যদি অনুরোধেরchannelId
প্যারামিটারটি স্থগিত করা হয়েছে এমন একটি চ্যানেল নির্দিষ্ট করে তবে এই ত্রুটিটি ফেরত দেয়।forbidden (403)
playlistForbidden
playlists.list
পদ্ধতিটি যদি অনুরোধেরid
প্যারামিটারটি অনুরোধটিকে সমর্থন না করে বা অনুরোধটি সঠিকভাবে অনুমোদিত না হয় তবে এই ত্রুটিটি ফেরত দেয়।notFound (404)
channelNotFound
playlists.list
পদ্ধতিটি যদি অনুরোধেরchannelId
প্যারামিটারটি এমন একটি চ্যানেল নির্দিষ্ট করে যা খুঁজে পাওয়া যায় না তবে এই ত্রুটিটি ফেরত দেয়।notFound (404)
playlistNotFound
playlists.list
পদ্ধতিটি যদি অনুরোধেরid
প্যারামিটারটি কোনও প্লেলিস্ট নির্দিষ্ট করে যা খুঁজে পাওয়া যায় না তবে এই ত্রুটিটি ফেরত দেয়।notFound (404)
videoNotFound
videos.list
পদ্ধতিটি যদি অনুরোধেরid
প্যারামিটারটি এমন একটি ভিডিও নির্দিষ্ট করে যা খুঁজে পাওয়া যায় না তবে এই ত্রুটিটি ফেরত দেয়।badRequest (400)
invalidRating
videos.rate
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যদি অনুরোধটিতেrating
প্যারামিটারের জন্য একটি অপ্রত্যাশিত মান থাকে।
2 মার্চ, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
search.list
পদ্ধতিটি এখনrelevanceLanguage
প্যারামিটারটিকে সমর্থন করে, যা আপনাকে এমন ফলাফলের জন্য অনুরোধ করতে দেয় যা কোনও নির্দিষ্ট ভাষার সাথে সবচেয়ে প্রাসঙ্গিক।ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডও এই নতুন প্যারামিটারটি কীভাবে ব্যবহার করবেন তা ব্যাখ্যা করার জন্য আপডেট করা হয়েছে। প্যারামিটারটি এমন একটি বৈশিষ্ট্য ফাঁককে সম্বোধন করে যা বর্তমান এপিআই সংস্করণ (ভি 3) এবং পূর্ববর্তী সংস্করণ (ভি 2) এর মধ্যে পূর্বে বিদ্যমান ছিল, যা ইতিমধ্যে অবমূল্যায়িত হয়েছে।
ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডকেও বিশেষ ফিড এবং মেটাডেটা ক্ষেত্রগুলির অবমূল্যায়ন নির্দেশ করতে আপডেট করা হয়েছে যা ভি 2 এপিআই চলচ্চিত্র, ট্রেইলার, টেলিভিশন শো, টেলিভিশন asons তু এবং টেলিভিশন পর্বগুলি বর্ণনা করার জন্য সরবরাহ করেছিল।
14 জানুয়ারী, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব ডেটা এপিআই (ভি 3) মাইগ্রেশন গাইডটি জাভাস্ক্রিপ্ট ব্যবহার করে ভিডিওগুলি আপলোড করতে ভি 3 এপিআই কীভাবে ব্যবহার করবেন তা ব্যাখ্যা করার জন্য আপডেট করা হয়েছে। (বিশদগুলির জন্য একটি ভিডিও বিভাগ আপলোড করুন দেখুন)) এই কার্যকারিতাটি ভি 2 এপিআই সমর্থন করে এমন ব্রাউজার-ভিত্তিক আপলোডিং কার্যকারিতার সাথে তুলনীয়। নোট করুন যে মাইগ্রেশন গাইডে এই পরিবর্তনটি প্রকৃত এপিআই পরিবর্তনকে প্রতিফলিত করে না বরং ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট সহ ভিডিওগুলি আপলোড করার জন্য নতুন নমুনা কোডের প্রাপ্যতা।
জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরি এবং কর্সের সাথে ভিডিওগুলি আপলোড করার জন্য সমর্থন দেওয়া, মাইগ্রেশন গাইড আর ব্রাউজার-ভিত্তিক আপলোডকে এমন একটি বৈশিষ্ট্য হিসাবে তালিকাভুক্ত করে না যা ভি 3 এপিআইতে অবমূল্যায়িত হতে পারে।
উপরে বর্ণিত নতুন জাভাস্ক্রিপ্ট কোড নমুনা অন্তর্ভুক্ত করার জন্য
videos.insert
পদ্ধতির জন্য ডকুমেন্টেশন আপডেট করা হয়েছে। ইউটিউব ডেটা এপিআই (ভি 3) এর জন্য জাভাস্ক্রিপ্ট কোডের নমুনাগুলির তালিকাও আপডেট করা হয়েছে।
11 নভেম্বর, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
অনুসন্ধানে কলের জন্য কোটা খরচ
search.list
পদ্ধতিটি 100 ইউনিটে পরিবর্তিত হয়েছে।গুরুত্বপূর্ণ: অনেক ক্ষেত্রে, আপনি কম কোটা ব্যয়ে তথ্য পুনরুদ্ধার করতে অন্যান্য এপিআই পদ্ধতি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, গুগলডভেলপার্স চ্যানেলে আপলোড করা ভিডিওগুলি সন্ধানের এই দুটি উপায় বিবেচনা করুন।
কোটা ব্যয়: 100 ইউনিট
search.list
পদ্ধতিতে কল করুন এবংGoogleDevelopers
অনুসন্ধান করুন।কোটা ব্যয়: 6 ইউনিট
সঠিক চ্যানেল আইডি খুঁজতে
channels.list
পদ্ধতিতে কল করুন।GoogleDevelopers
forUsername
প্যারামিটার এবংcontentDetails
part
প্যারামিটার সেট করুন। এপিআই প্রতিক্রিয়াতে,contentDetails.relatedPlaylists.uploads
সম্পত্তি চ্যানেলের আপলোড করা ভিডিওগুলির জন্য প্লেলিস্ট আইডি নির্দিষ্ট করে।তারপরে
playlistItems.list
পদ্ধতিতে কল করুন এবংplaylistId
প্যারামিটারটি ক্যাপচারড আইডিতে এবংsnippet
part
প্যারামিটার সেট করুন।
অক্টোবর 8, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সে দুটি নতুন বৈশিষ্ট্য রয়েছে:status.longUploadsStatus
সম্পত্তিটি নির্দেশ করে যে চ্যানেলটি 15 মিনিটের বেশি দীর্ঘ ভিডিও আপলোড করার যোগ্য কিনা। এই সম্পত্তিটি কেবল তখনই ফিরে আসে যদি চ্যানেলের মালিক এপিআই অনুরোধটি অনুমোদিত করে। বৈধ সম্পত্তি মানগুলি:-
allowed
- চ্যানেল 15 মিনিটেরও বেশি দীর্ঘ ভিডিও আপলোড করতে পারে। -
eligible
- চ্যানেলটি 15 মিনিটেরও বেশি দীর্ঘ ভিডিও আপলোড করার যোগ্য তবে প্রথমে বৈশিষ্ট্যটি সক্ষম করতে হবে। -
disallowed
- চ্যানেলটি 15 মিনিটেরও বেশি দীর্ঘ ভিডিও আপলোড করতে সক্ষম বা যোগ্য নয়।
এই মানগুলি সম্পর্কে আরও তথ্যের জন্য সম্পত্তি সংজ্ঞা দেখুন। ইউটিউব সহায়তা কেন্দ্রও এই বৈশিষ্ট্য সম্পর্কে আরও বিশদ তথ্য সরবরাহ করে।
-
invideoPromotion.useSmartTiming
সম্পত্তি চ্যানেলের প্রচারমূলক প্রচার "স্মার্ট টাইমিং" ব্যবহার করে কিনা তা নির্দেশ করে। এই বৈশিষ্ট্যটি ভিডিওর এক পর্যায়ে প্রচারগুলি দেখানোর চেষ্টা করে যখন তারা ক্লিক করার সম্ভাবনা বেশি থাকে এবং দেখার অভিজ্ঞতা ব্যাহত হওয়ার সম্ভাবনা কম থাকে। এই বৈশিষ্ট্যটি প্রতিটি ভিডিওতে দেখানোর জন্য একটি একক প্রচারও করে।
video
রিসোর্সেরsnippet.title
এবংsnippet.categoryId
বৈশিষ্ট্যগুলির সংজ্ঞাগুলি উভয়ইvideos.update
পদ্ধতিতে যেভাবে কলগুলি পরিচালনা করে তা স্পষ্ট করার জন্য উভয়ই আপডেট করা হয়েছে। আপনি যদি কোনওvideo
রিসোর্সেরsnippet
অংশটি আপডেট করার জন্য সেই পদ্ধতিটি কল করেন তবে আপনাকে অবশ্যই সেই উভয় বৈশিষ্ট্যের জন্য একটি মান নির্ধারণ করতে হবে।আপনি যদি কোনও
video
রিসোর্সেরsnippet
অংশটি আপডেট করার চেষ্টা করেন এবং এই উভয় সম্পত্তিগুলির জন্য কোনও মান নির্ধারণ না করেন তবে এপিআই একটিinvalidRequest
ত্রুটি দেয়। এই ত্রুটির বিবরণটিও আপডেট করা হয়েছে।video
রিসোর্সেরcontentDetails.contentRating.oflcRating
প্রপার্টি, যা নিউজিল্যান্ডের ফিল্ম অ্যান্ড লিটারচারের শ্রেণিবিন্যাসের অফিস থেকে একটি ভিডিওর রেটিং চিহ্নিত করে, এখন দুটি নতুন রেটিং সমর্থন করে:oflcRp13
এবংoflcRp16
। এগুলি যথাক্রমেRP13
এবংRP16
রেটিংয়ের সাথে মিলে যায়।channelBanners.insert
পদ্ধতি এখন নিম্নলিখিত ত্রুটিটিকে সমর্থন করে:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
bannerAlbumFull
চ্যানেলের মালিকের ইউটিউব চ্যানেল আর্ট অ্যালবামের অনেকগুলি চিত্র রয়েছে। চ্যানেলের মালিককে http://photos.google.com এ যেতে হবে, অ্যালবাম পৃষ্ঠায় নেভিগেট করা উচিত এবং সেই অ্যালবাম থেকে চিত্রগুলি থেকে কিছু সরানো উচিত।
সেপ্টেম্বর 12, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
search.list
কলের জন্য কোটা ব্যয়টি নির্দিষ্ট সংস্থানগুলির অংশগুলির ব্যয় ছাড়াও 1 ইউনিট থেকে 2 ইউনিটে পরিবর্তিত হয়েছে।
13 আগস্ট, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
subscriptions.insert
পদ্ধতি এখন নিম্নলিখিত ত্রুটিটিকে সমর্থন করে:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
subscriptionLimitExceeded
অনুরোধের সাথে চিহ্নিত গ্রাহক সাবস্ক্রিপশন হারের সীমা ছাড়িয়ে গেছে। আরও সাবস্ক্রিপশন কয়েক ঘন্টার মধ্যে চেষ্টা করা যেতে পারে।
12 আগস্ট, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব ডেটা এপিআই (ভি 3) এ আপনার অ্যাপ্লিকেশনটি স্থানান্তরিত করার শিরোনামে একটি নতুন গাইড, ইউটিউব ডেটা এপিআই (ভি 2) এ উপলব্ধ কার্যকারিতা সম্পাদনের জন্য কীভাবে ইউটিউব ডেটা এপিআই (ভি 3) ব্যবহার করবেন তা ব্যাখ্যা করে। পুরানো এপিআই আনুষ্ঠানিকভাবে 4 মার্চ, 2014 পর্যন্ত অবহেলা করা হয়েছিল The গাইডটি আপনাকে সাম্প্রতিকতম এপিআই সংস্করণে ভি 2 এপিআই ব্যবহার করে এখনও অ্যাপ্লিকেশনগুলি স্থানান্তর করতে সহায়তা করতে চায়।
8ই জুলাই, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
playlists.insert
পদ্ধতি এখন নিম্নলিখিত ত্রুটিটিকে সমর্থন করে:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
maxPlaylistExceeded
এই ত্রুটিটি ঘটে যদি কোনও প্লেলিস্ট তৈরি করা যায় না কারণ চ্যানেলটিতে ইতিমধ্যে সর্বাধিক সংখ্যক প্লেলিস্ট অনুমোদিত রয়েছে।
জুন 18, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
প্রতিটি এপিআই পদ্ধতির বিবরণ সেই পদ্ধতিতে কল দ্বারা ব্যয়িত কোটা ব্যয় অন্তর্ভুক্ত করার জন্য আপডেট করা হয়েছে। একইভাবে,
part
পরামিতিগুলির সংজ্ঞাগুলি প্রতিটি অংশের কোটা ব্যয় নির্দিষ্ট করতে আপডেট করা হয়েছে যা একটি এপিআই কলটিতে পুনরুদ্ধার করা যায়। উদাহরণস্বরূপ,subscriptions.insert
একটি কল.ইনসার্ট পদ্ধতিতে প্রায় 50 টি ইউনিটের কোটা ব্যয় রয়েছে। Thesubscription
resource also contains three parts (snippet
,contentDetails
, andsubscriberSnippet
), and each of those has a cost of two units.Please remember that quota costs can change without warning.
The
video
resource now supports 43 new content rating systems, which identify the ratings that videos received from various national rating agencies. The newly supported rating systems are from Argentina , Austria , Belgium , Bulgaria , Chile ( television ), Chile ( film ), Czech Republic , Colombia , Denmark , Egypt , Estonia , Finland , France , Greece , Hong Kong , Iceland , Indonesia , Ireland , Israel , Italy , Kenya , Latvia , Luxembourg , Malaysia , Maldives , Malta , Netherlands , Nigeria , Norway , Peru , Philippines , Portugal , Romania , Singapore , Slovakia , South Africa , Sweden , Switzerland , Taiwan , Thailand , and Venezuela .
28 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
search.list
method now supports thelocation
andlocationRadius
parameters, which let you search for videos associated with a geographic location. A request must specify a value for both parameters to retrieve results based on location, and the API will return an error if a request includes only one of the two parameters.The
location
parameter specifies the latitude/longitude coordinates at the center of the circular geographic area.The
locationRadius
parameter specifies the maximum distance that the location associated with a video can be from the center of the area for the video to still be included in search results.
13 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channel
resource'sinvideoPromotion.items[]
property has been updated to note that you can typically only set one promoted item for your channel. If you try to insert too many promoted items, the API will return atooManyPromotedItems
error, which has an HTTP400
status code.The
channelSection
resource now can contain information about a few new types of featured content. ThechannelSection
resource'ssnippet.type
property now supports the following values:-
postedPlaylists
- playlists that the channel's owner posted to the channel's activity feed -
postedVideos
- videos that the channel's owner posted to the channel's activity feed -
subscriptions
- channels that the channel owner has subscribed to
-
The
video
resource's newcontentDetails.contentRating.ifcoRating
property identifies the rating that a video received from the Irish Film Classification Office.The definition of the
watermark
resource'sposition.cornerPosition
property has been updated to note that the watermark always appear in the upper right corner of the player.The definition of the
q
parameter for thesearch.list
method has been updated to note that the query term can use the Boolean NOT (-
) operator to exclude videos associated with a particular search term. The value can also use the Boolean OR (|
) operator to find videos associated with one of several search terms.The definition of the
pageInfo.totalResults
property that is returned in an API response to asearch.list
call has been updated to note that the value is an approximation and may not represent an exact value. In addition, the maximum value is 1,000,000. You should not use this value to create pagination links. Instead, use thenextPageToken
andprevPageToken
property values to determine whether to show pagination links.The
watermarks.set
andwatermarks.unset
methods have been updated to reflect that the API returns an HTTP204
response code for successful requests to those methods.
2 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
i18nLanguage
resource identifies an application language that the YouTube website supports. The application language can also be referred to as a UI language. For the YouTube website, an application language could be automatically selected based on Google Account settings, browser language, or IP location, and a user could also manually select the desired UI language from the YouTube site footer.The API supports a method to list supported application languages. Supported languages can be used as the value of the
hl
parameter when calling API methods likevideoCategories.list
andguideCategories.list
.The new
i18nRegion
resource identifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale. For the YouTube website, a content region could be automatically selected based on heuristics like the YouTube domain or the user's IP location, and a user could also manually select the desired content region from the YouTube site footer.The API supports a method to list supported content regions. Supported region codes can be used as the value of the
regionCode
parameter when calling API methods likesearch.list
,videos.list
,activities.list
, andvideoCategories.list
.
এপ্রিল 7, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
channelSection
resource contains information about a set of videos that a channel has chosen to feature. For example, a section could feature a channel's latest uploads, most popular uploads, or videos from one or more playlists.The API supports methods to list , insert , update , or delete channel sections. You can retrieve a list of channel sections for the authenticated user's channel, by specifying a particular channel ID, or by specifying a list of unique channel section IDs.
The error documentation has also been updated to describe the error messages that the API supports specifically for these new methods.
The definition of the
video
resource'sfileDetails
object has been updated to explain that that object will only be returned if the video'sprocessingDetails.fileDetailsAvailability
property has a value ofavailable
.Similarly, the definition of the
video
resource'ssuggestions
object has been updated to explain that that object will only be returned if the video'sprocessingDetails.tagSuggestionsAvailability
property or itsprocessingDetails.editorSuggestionsAvailability
property has a value ofavailable
.The documentation for the
videos.insert
andvideos.update
methods has been updated to reflect that thestatus.publishAt
property can be set when calling those methods.The definition of the
channel
resource'sinvideoPromotion
object has been updated to explain that the object can only be retrieved by the channel's owner.The parameter list for the
videos.rate
method has been updated to reflect that that method does not actually support theonBehalfOfContentOwner
parameter. This was a documentation error asvideos.rate
requests that set this parameter return a500
error.
মার্চ 31, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
video
resource's newstatus.publishAt
property lets you specify the date and time when a private video is scheduled to be published. This property can only be set if the video's privacy status isprivate
and the video has never been published. This new property is not subject to the deprecation policy .
13 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API now supports the
contentOwnerDetails
part forchannel
resources. The new part contains channel data that is relevant for YouTube partners linked with the channel, including the ID of the content owner linked to the channel and the date and time when the content owner and channel were linked. Note that this new part is not subject to the deprecation policy .The documentation now lists the maximum supported character length for the following properties:
সম্পদ সম্পত্তি সর্বোচ্চ দর্ঘ্য channel
invideoPromotion.items[].customMessage
40টি অক্ষর video
snippet.title
100টি অক্ষর video
snippet.description
5000 bytes video
snippet.tags
500 characters. Note that the property value is a list and that commas between items in the list count toward the limit. The
channel
resource'sbrandingSettings.watch.featuredPlaylistId
property has been deprecated. The API will return an error if you attempt to set its value.The following
video
resource properties have been added to the list of values that can be set when inserting or updating a video:The error documentation now specifies the HTTP response code for each error type.
The API now supports the following errors:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
invalidCriteria
The channels.list
method returns this error if the request specifies filter parameters that cannot be used in conjunction with each other.badRequest (400)
channelTitleUpdateForbidden
The channels.update
method returns this error if you attempt to update a channel'sbrandingSettings
part and change the value of thebrandingSettings.channel.title
property. (Note that the API does not return the error if you omit the property.)badRequest (400)
invalidRecentlyUploadedBy
The channels.update
method returns this error if theinvideoPromotion.items[].id.recentlyUploadedBy
property specifies an invalid channel ID.badRequest (400)
invalidTimingOffset
The channels.update
method returns this error if theinvideoPromotion
part specifies an invalid timing offset.badRequest (400)
tooManyPromotedItems
The channels.update
method returns this error if theinvideoPromotion
part specifies more than the allowed number of promoted items.forbidden (403)
promotedVideoNotAllowed
The channels.update
method returns this error if theinvideoPromotion.items[].id.videoId
property specifies a video ID that either cannot be found or cannot be used as a promoted item.forbidden (403)
websiteLinkNotAllowed
The channels.update
method returns this error if theinvideoPromotion.items[].id.websiteUrl
property specifies a URL that is not allowed.required (400)
requiredTimingType
The channels.update
method returns this error if a request does not specify default timing settings for when YouTube should display a promoted item.required (400)
requiredTiming
The channels.update
method must specify aninvideoPromotion.items[].timing
object for each promoted item.required (400)
requiredWebsiteUrl
The channels.update
method must specify aninvideoPromotion.items[].id.websiteUrl
property for each promoted item.badRequest (400)
invalidPublishAt
The videos.insert
method returns this error if the request metadata specifies an invalid scheduled publishing time.
4 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The YouTube Data API, v3 is now subject to the Deprecation Policy described in the YouTube APIs Terms of Service . Note that the page that lists the APIs that are subject to the deprecation policy specifically excludes some v3 API functionality from being subject to the policy.
5 ডিসেম্বর, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
search.list
method's documentation has been updated to properly reflect that you do not need to specify a value for exactly one filter parameter when submitting a search request. Rather, you can set a value for zero filter parameters or for one filter parameter.The definitions for the
search.list
method's parameters have been updated to note that you must set thetype
parameter's value tovideo
if you also specify a value for any of the following parameters:-
eventType
-
videoCaption
-
videoCategoryId
-
videoDefinition
-
videoDimension
-
videoDuration
-
videoEmbeddable
-
videoLicense
-
videoSyndicated
-
videoType
-
The minimum size of uploaded channel banner images has been reduced to 2048px by 1152px. (Previously, the minimum size was 2120px by 1192px.) In addition, note that the
channel
resource documentation specifies the maximum sizes of all of the banner images served from the API. For example, the maximum size of thebrandingSettings.image.bannerTvImageUrl
image for television applications is 2120px by 1192px, but the actual image may be 2048px by 1152px. The YouTube Help Center provides additional guidance for optimizing channel art for display on different types of devices.Several
channel
resource property definitions have been updated to reflect the following information:- The
brandingSettings.channel.description
property's value has a maximum length of 1000 characters. - The
brandingSettings.channel.featuredChannelsTitle
property has a maximum length of 30 characters. - The
brandingSettings.channel.featuredChannelsUrls[]
property can now list up to 100 channels. - The
brandingSettings.channel.unsubscribedTrailer
property value, if set, must specify the YouTube video ID of a public or unlisted video that is owned by the channel owner.
- The
The
channels.update
method now supports updates to theinvideoPromotion.items[].promotedByContentOwner
property. That property indicates whether the content owner's name will be shown when displaying the promotion. It can only be set if the API request that sets the property value is being made on the content owner's behalf using theonBehalfOfContentOwner
parameter.The
playlistItems.list
andplaylistItems.insert
methods now support theonBehalfOfContentOwner
parameter, which is already supported for several other methods.The
contentDetails.contentRating.acbRating
property can now specify a rating from either the Australian Classification Board (ACB) for movies or from the Australian Communications and Media Authority (ACMA) for children's television programming.The new
contentDetails.contentRating.catvRating
andcontentDetails.contentRating.catvfrRating
properties identify the ratings that a video received under the Canadian TV Classification System and the French-language Régie du cinéma rating system, which is used in Québec, respectively.The
videoCategory
resource's newsnippet.assignable
property indicates whether updated videos or newly uploaded videos can be associated with that video category.Code samples have been added for the following methods:
-
activities.insert
(Go) -
channelBanners.insert
(Python) -
channels.update
(Python) -
playlistItems.list
(Go) -
search.list
(Go) -
thumbnails.set
(Java) -
videos.insert
(Go)
-
অক্টোবর 24, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API includes two additional features designed to help find and feature live broadcast content:
The new
snippet.liveBroadcastContent
property in search results indicates whether a video or channel resource has live broadcast content. Valid property values areupcoming
,active
, andnone
.The
video
resource's newsnippet.liveBroadcastContent
property indicates whether the video is an upcoming or active live broadcast. The list below explains the property's possible values:-
upcoming
– The video is a live broadcast that has not yet started. -
active
– The video is an ongoing live broadcast. -
none
– The video is not an upcoming or active live broadcast. This will be the property value for completed broadcasts that are still viewable on YouTube.
-
The
video
resource's newliveStreamingDetails
property is an object that contains metadata about a live video broadcast. To retrieve this metadata, includeliveStreamingDetails
in thepart
parameter value's list of resource parts. The metadata includes the following new properties:-
liveStreamingDetails.actualStartTime
– The time that the broadcast actually started. (This value will be present once the broadcast's state isactive
.) -
liveStreamingDetails.actualEndTime
– The time that the broadcast actually ended. (This value will be present once the broadcast is over.) -
liveStreamingDetails.scheduledStartTime
– The time that the broadcast is scheduled to begin. -
liveStreamingDetails.scheduledEndTime
– The time that the broadcast is scheduled to end. If the property value is empty or the property is not present, then the broadcast is scheduled to go on indefinitely. -
liveStreamingDetails.concurrentViewers
– The number of people watching the live broadcast.
To retrieve this metadata, include
liveStreamingDetails
in thepart
parameter value when calling thevideos.list
,videos.insert
, orvideos.update
method.-
Note that two other features for identifying live broadcast content were released on October 1, 2013 – the
search.list
method'seventType
parameter and the search result'ssnippet.liveBroadcastContent
property.The
videos.insert
method now supports thenotifySubscribers
parameter, which indicates whether YouTube should send a notification about the new video to users who subscribe to the video's channel. The parameter's default value isTrue
, which indicates that subscribers will be notified of newly uploaded videos. However, a channel owner who is uploading many videos might prefer to set the value toFalse
to avoid sending a notification about each new video to the channel's subscribers.The list of properties that can be modified when calling the
channels.update
method has been updated to include theinvideoPromotion.items[].customMessage
andinvideoPromotion.items[].websiteUrl
properties. In addition, the list has been modified to identify thebrandingSettings
properties that are modifiable. ThesebrandingSettings
properties were already modifiable, so the documentation change does not reflect a change to the API's existing functionality.The
playlists.insert
,playlists.update
, andplaylists.delete
methods now support theonBehalfOfContentOwner
parameter, which is already supported for several other methods.The
playlists.insert
method now supports theonBehalfOfContentOwnerChannel
parameter, which is already supported for several other methods.The
video
resource'scontentDetails.contentRating.tvpgRating
property now supports a value ofpg14
, which corresponds to aTV-14
rating.The definition of the
snippet.liveBroadcastContent
property, which is part of search results, has been corrected to reflect thatlive
is a valid property value, butactive
is not a valid property value.The
video
resource'scontentDetails.contentRating.mibacRating
property now supports two additional ratings:-
mibacVap
(VAP) – Children should be accompanied by an adult. -
mibacVm6
(VM6) – Restricted to 6 and over. -
mibacVm12
(VM12) – Restricted to 12 and over.
-
The
channel
resource's newinvideoPromotion.items[].promotedByContentOwner
property indicates whether the content owner's name will be shown when displaying the promotion. This field can only be set if the API request that sets the value is being made on the content owner's behalf. See theonBehalfOfContentOwner
parameter for more information.
অক্টোবর 1, ২ 013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channel
resource's newauditDetails
object contains channel data that a multichannel network (MCN) would evaluate while determining whether to accept or reject a particular channel. Note that any API request that retrieves this resource part must provide an authorization token that contains thehttps://www.googleapis.com/auth/youtubepartner-channel-audit
scope. In addition, any token that uses that scope must be revoked when the MCN decides to accept or reject the channel or within two weeks of the date that the token was issued.The
channel
resource'sinvideoPromotion.items[].id.type
property now supports a value ofrecentUpload
, which indicates that the promoted item is the most recently uploaded video from a specified channel.By default, the channel is the same as the one for which the in-video promotion data is set. However, you can promote the most recently uploaded video from another channel by setting the value of the new
invideoPromotion.items[].id.recentlyUploadedBy
property to the channel ID for that channel.The
channel
resource contains three new properties –brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
– that specify the URLs for the banner images that display on channel pages in television applications.The new
snippet.liveBroadcastContent
property in search results indicates whether a video or channel resource has live broadcast content. Valid property values areupcoming
,active
, andnone
.- For a
video
resource, a value ofupcoming
indicates that the video is a live broadcast that has not yet started, while a value ofactive
indicates that the video is an ongoing live broadcast. - For a
channel
resource, a value ofupcoming
indicates that the channel has a scheduled broadcast that has not yet started, while a value ofacive
indicates that the channel has an ongoing live broadcast.
- For a
In the
watermark
resource, thetargetChannelId
property has changed from an object to a string. Instead of containing a child property that specifies the YouTube channel ID of the channel that the watermark image links to, thetargetChannelId
property now specifies that value itself. Accordingly, the resource'stargetChannelId.value
property has been removed.The
thumbnails.set
method now supports theonBehalfOfContentOwner
parameter, which is already supported for several other methods.The
search.list
method now supports theeventType
parameter, which restricts a search to only return either active, upcoming, or completed broadcast events.The new
contentDetails.contentRating.mibacRating
property identifies the rating that a video received from Italy's Ministero dei Beni e delle Attivita Culturali e del Turismo.The API now supports the following errors:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
invalidImage
The thumbnails.set
method returns this error if the provided image content is invalid.forbidden
videoRatingDisabled
The videos.rate
method returns this error if the owner of the video that is being rated has disabled ratings for that video.
আগস্ট 27, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
watermark
resource identifies an image that displays during playbacks of a specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears during video playbacks and the length of time it is visible.The
watermarks.set
method uploads and sets a channel's watermark image. Thewatermarks.unset
method deletes a channel's watermark image.The error documentation describes the error messages that the API supports specifically for the
watermarks.set
andwatermarks.unset
methods.The
channel
resource's newstatistics.hiddenSubscriberCount
property contains a boolean value that indicates whether the channel's number of subscribers is hidden. As such, the property's value isfalse
if the channel's subscriber count is publicly visible.The
playlists.list
method now supports theonBehalfOfContentOwner
andonBehalfOfContentOwnerChannel
parameters. Both parameters are already supported for several other methods.The
videos.list
method now supports theregionCode
parameter, which identifies the content region for which a chart should be retrieved. This parameter can only be used in conjunction with thechart
parameter. The parameter value is an ISO 3166-1 alpha-2 country code.The
error documentation
describes the following new common request error, which could occur for multiple API methods:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা forbidden
insufficientPermissions
The scopes associated with the OAuth 2.0 token provided for the request are insufficient for accessing the requested data.
আগস্ট 15, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channel
resource'sinvideoPromotion
object has the following new and updated properties:The API now supports the ability to specify a website as a promoted item. To do so, set the
invideoPromotion.items[].id.type
property value towebsite
and use the newinvideoPromotion.items[].id.websiteUrl
property to specify the URL. Also use the newinvideoPromotion.items[].customMessage
property to define a custom message to display for the promotion.Links can be to associated websites, merchant sites, or social networking sites. See the YouTube Help Center instructions for associated websites and merchant sites for more information about enabling links for your content.
By adding promotional links, you agree that those links will not be used to redirect traffic to unauthorized sites and that those links will comply with YouTube's AdWords policies , YouTube ad policies , YouTube Community Guidelines and YouTube Terms of Service .
The properties related to the timing settings for displaying promoted items during video playback have been restructured:
The
invideoPromotion.timing
object has been moved toinvideoPromotion.items[].timing
. This object now enables you to customize the timing data for each promoted item in theinvideoPromotion.items[]
list.The new
invideoPromotion.defaultTiming
object specifies default timing settings for your promotion. Those settings define when a promoted item will display during playback of one of your channel's videos. You can override the default timing for any given promoted item using theinvideoPromotion.items[].timing
object.The new
invideoPromotion.items[].timing.durationMs
property specifies the amount of time, in milliseconds, that the promotion should display. TheinvideoPromotion.defaultTiming
object also contains adurationMs
field that specifies the default amount of time that the promoted item will display.
The
invideoPromotion.items[].type
andinvideoPromotion.items[].videoId
properties both have been moved into theinvideoPromotion.items[].id
object.
The
subscriptions.list
method now supports theonBehalfOfContentOwner
andonBehalfOfContentOwnerChannel
parameters. Both parameters are already supported for several other methods.In the API response to a
thumbnails.set
request, thekind
property value has changed fromyoutube#thumbnailListResponse
toyoutube#thumbnailSetResponse
.Code samples have been added for the following methods:
-
channels.update
(Java, Python) -
playlists.insert
(.NET, PHP) -
subscriptions.insert
(PHP, Python) -
thumbnails.set
(PHP, Python) -
videos.insert
(PHP) -
videos.list
(PHP) -
videos.rate
(Python) -
videos.update
(Java, PHP, Python)
Note that the Python example for the
playlistItems.insert
method was also removed since the functionality it demonstrated is now handled by thevideos.rate
method.-
The
error documentation
describes the following new request context error, which could occur for any API method that supports themine
request parameter:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
invalidMine
The mine
parameter cannot be used in requests where the authenticated user is a YouTube partner. You should either remove themine
parameter, authenticate as a YouTube user by removing theonBehalfOfContentOwner
parameter, or act as one of the partner's channels by providing theonBehalfOfContentOwnerChannel
parameter if available for the called method.
আগস্ট 8, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The Getting Started with the YouTube Data API guide's Quota Usage section has been updated to reflect a change in the quota cost of a video upload from approximately 16000 units to approximately 1600 units.
জুলাই 30, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
In a
channelBanner
resource, the value of thekind
property's value has changed fromyoutube#channelBannerInsertResponse
toyoutube#channelBannerResource
. This resource is returned in response to achannelBanners.insert
request.The
channel
resource's newbrandingSettings.channel.profileColor
property specifies a prominent color that complements the channel's content. The property value is a pound sign (#
) followed by a six-character hexadecimal string, such as#2793e6
.The API now supports the ability to specify whether a subscription is for all of a channel's activities or just for new uploads. The
subscription
resource's newcontentDetails.activityType
property identifies the types of activities that the subscriber will be notified about. Valid property values areall
anduploads
.The
videos.list
method supports new parameters for retrieving a chart of the most popular videos on YouTube:- The
chart
parameter identifies the chart that you want to retrieve. Currently, the only supported value ismostPopular
. Note that thechart
parameter is a filter parameter, which means it cannot be used in the same request as other filter parameters (id
andmyRating
). - The
videoCategoryId
parameter identifies the video category for which the chart should be retrieved. This parameter can only be used in conjunction with thechart
parameter. By default, charts are not restricted to a particular category.
- The
The
video
resource's newtopicDetails.relevantTopicIds[]
property provides a list of Freebase topic IDs that are relevant to the video or its content. The subjects of these topics may be mentioned in or appear in the video.The
video
resource'srecordingDetails.location.elevation
property has been renamed torecordingDetails.location.altitude
, and itsfileDetails.recordingLocation.location.elevation
property has been renamed tofileDetails.recordingLocation.location.altitude
.The
video
resource'scontentDetails.contentRating
object specifies the ratings that a video received under various rating schemes, including MPAA ratings, TVPG ratings, and so forth. For each rating system, the API now supports a rating value that indicates that the video has not been rated. Note that for MPAA ratings , an "unrated" rating is frequently used to identify uncut versions of films for which the cut version of the film did receive an official rating.The
video
resource's newcontentDetails.contentRating.ytRating
property identifies age-restricted content. The property value will beytAgeRestricted
if YouTube has identified the video as containing content that is inappropriate for users less than 18 years old. If the property is absent or if the property value is empty, then the content has not been identified as age-restricted.The
channels.list
method'smySubscribers
parameter has been deprecated. প্রমাণীকৃত ব্যবহারকারীর চ্যানেলে সদস্যদের একটি তালিকা পুনরুদ্ধার করতেsubscriptions.list
পদ্ধতি এবং এরmySubscribers
প্যারামিটার ব্যবহার করুন।The
channelBanners.insert
,channels.update
,videos.getRating
, andvideos.rate
methods all now support theonBehalfOfContentOwner
parameter. That parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value.The
channels.update
method's documentation has been updated to reflect the fact that that method can be used to update thechannel
resource'sbrandingSettings
object and its child properties. The documentation also now lists the updated list of properties that you can set for thechannel
resource'sinvideoPromotion
object.The
error documentation
describes the following new errors:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা forbidden
accountDelegationForbidden
This error is not specific to a particular API method. It indicates that the authenticated user is not authorized to act on behalf of the specified Google account. forbidden
authenticatedUserAccountClosed
This error is not specific to a particular API method. It indicates that the authenticated user's YouTube account is closed. If the user is acting on behalf of another Google Account, then this error would indicate that that other account is closed. forbidden
authenticatedUserAccountSuspended
This error is not specific to a particular API method. It indicates that the authenticated user's YouTube account is suspended. If the user is acting on behalf of another Google Account, then this error would indicate that that other account is suspended. forbidden
authenticatedUserNotChannel
This error is not specific to a particular API method. It indicates that the API server cannot identify the channel associated with the API request. If the request is authorized and uses the onBehalfOfContentOwner
parameter, you should also set theonBehalfOfContentOwnerChannel
parameter.forbidden
cmsUserAccountNotFound
This error is not specific to a particular API method. The CMS user is not allowed to act on behalf of the specified content owner. notFound
contentOwnerAccountNotFound
This error is not specific to a particular API method. The specified content owner account was not found. badRequest
invalidPart
This error is not specific to a particular API method. The request's part
parameter specifies parts that cannot be written at the same time.badRequest
videoChartNotFound
The videos.list
method returns this error when the request specifies an unsupported or unavailable video chart.notFound
videoNotFound
The videos.update
method returns this error to indicate that the video you are trying to update cannot be found. Check the value of theid
property in the request body to ensure it is correct.
জুন 10, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channels.list
method's newforUsername
parameter enables you to retrieve information about a channel by specifying its YouTube username.The
activities.list
method now supports theregionCode
parameter, which instructs the API to return results relevant to the specified country. YouTube uses this value when the authorized user's previous activity on YouTube does not provide enough information to generate the activity feed.Playlist resources now contain the
snippet.tags
property. The property will be only be returned to authorized users who are retrieving data about their own playlists. Authorized users can also set playlist tags when calling either theplaylists.insert
orplaylists.update
methods.The
onBehalfOfContentOwner
parameter, which was previously supported for thechannels.list
andsearch.list
methods, is now also supported for thevideos.insert
,videos.update
, andvideos.delete
methods. Note that when this parameter is used in a call to thevideos.insert
method, the request must also specify a value for the newonBehalfOfContentOwnerChannel
parameter, which identifies the channel to which the video will be added. The channel must be linked to the content owner that theonBehalfOfContentOwner
parameter specifies.The parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. ব্যবহারকারী যে CMS অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।
This parameter is intended for content partners that own and manage many different YouTube channels. The parameter enables those partners to authenticate once and get access to all of their video and channel data, without having to provide authentication credentials for each individual channel.
Specifically in regard to this release, the parameter now enables a content partner to insert, update, or delete videos in any of the YouTube channels that the partner owns.
The
error documentation
describes the following new errors:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা forbidden
insufficientCapabilities
This error is not specific to a particular API method. It indicates that the CMS user calling the API does not have sufficient permissions to perform the requested operation. This error is associated with the use of the onBehalfOfContentOwner
parameter, which is supported for several API methods.unauthorized
authorizationRequired
The activities.list
method returns this error when the request uses thehome
parameter but is not properly authorized.In the
channels
resource, theinvideoPromotion.channelId
property has been removed because the channel ID is already specified using the resource'sid
property.The new Working with Channel IDs guide explains how the API uses channel IDs. The guide may be especially useful for developers migrating from the previous version of the API and who have applications that either request content for the
default
user or that rely on the notion that every YouTube channel has a unique username, which is no longer the case.
22 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
channelBanners.insert
method enables you to upload a banner image that can subsequently be set as the banner image for a channel using thechannel
resource's newbrandingSettings.image.bannerExternalUrl
property.The documentation for the
channels.update
method has been updated to list the properties that can be modified when calling the method.The
video
resource documentation no longer listsunspecified
as a valid property value for thesuggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
, andsuggestions.editorSuggestions[]
properties.The
videos.list
method'smaxResults
parameter now has a default value of5
.The
error documentation
now lists errors for thechannelBanners.insert
andsubscriptions.list
methods. It also lists several new errors for thechannels.update
method.
14 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Standalone pages now list code samples for Java , .NET , PHP , and Ruby .
The page that lists Python code samples now includes examples for adding a subscription, creating a playlist, and updating a video.
10 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
YouTube no longer identifies experimental API features and services. Instead, we now provide a list of YouTube APIs that are subject to the deprecation policy .
8 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Channel resources now support the
inVideoPromotion
object, which encapsulates information about a promotional campaign associated with the channel. A channel can use an in-video promotional campaign to display thumbnail images for a promoted video within the video player during playbacks of the channel's videos.You can retrieve this data by including
invideoPromotion
in thepart
parameter value in achannels.list
request.The new
channels.update
method can be used to update a channel's in-video promotional campaign data. Note that the method only supports updates to theinvideoPromotion
part of thechannel
resource and does not yet support updates to other parts of that resource.
2 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Channel resources now support the
status.isLinked
property, which indicates whether the channel data identifies a user that is already linked to either a YouTube username or a Google+ account. A user that has one of these links already has a public YouTube identity, which is a prerequisite for several actions, such as uploading videos.Subscription resources now support the
subscriberSnippet
part. That object encapsulates contains snippet data for the subscriber's channel.The API now supports the
videos.getRating
method, which retrieves the ratings that the authenticated user gave to a list of one or more videos.The
videos.list
method's newmyRating
parameter enables you to retrieve a list of videos that the authenticated user rated with alike
ordislike
rating.The
myRating
parameter and theid
parameter are both now considered filter parameters, which means that an API request must specify exactly one of the parameters. (Previously, theid
parameter was a required parameter for this method.)The method returns a
forbidden
error for requests that attempt to retrieve video rating information but are not properly authorized to do so.With the introduction of the
myRating
parameter, thevideos.list
method has also been updated to support pagination. Note, however, that paging parameters are only supported for requests using themyRating
parameter. (Paging parameters and information are not supported for requests that use theid
parameter.)The
maxResults
parameter specifies the maximum number of videos that the API can return in the result set, and thepageToken
parameter identifies a specific page in the result set that you want to retrieve.The
youtube#videoListResponse
resource, which is returned in response to avideos.list
request, now contains thepageInfo
object, which contains details like the total number of results and the number of results included in the current result set. Theyoutube#videoListResponse
resource can also includenextPageToken
andprevPageToken
properties, each of which provides a token that could be used to retrieve a specific page in the result set.
The
videos.insert
method supports the following new parameters:-
autoLevels
– Set this parameter value totrue
to instruct YouTube to automatically enhance the video's lighting and color. -
stabilize
– Set this parameter value totrue
to instruct YouTube to adjust the video by removing shakiness resulting from camera motions.
-
The
channelTitle
property has been added to thesnippet
for the following resources:-
playlistItem
– The property specifies the name of the channel that added the playlist item. -
playlist
– The property specifies the name of the channel that created the playlist. -
subscription
– The property specifies the name of the channel that is subscribed to.
-
Code samples have been added for the following methods:
-
activities.insert
(Ruby) -
playlistItems.list
(.NET) -
search.list
(.NET) -
subscriptions.insert
(Java, Ruby) -
videos.insert
(.NET, Ruby)
-
The
subscriptions.list
method's newmySubscribers
parameter enables you to retrieve a list of the currently authenticated user's subscribers. This parameter can only be used in a properly authorized request.Note: This functionality is intended to replace the
mySubscribers
parameter currently supported for thechannels.list
method. That parameter will be deprecated.In a
video
resource, the property valueunspecified
is no longer a possible value for any of the following properties:API requests that contain an unexpected parameter now return a
badRequest
error, and the reported reason for the error isunexpectedParameter
.The error that the
playlistItems.insert
method returns when the playlist already contains the maximum number of allowed items has been updated. The error is now reported as aforbidden
error, and the error reason isplaylistContainsMaximumNumberOfVideos
.
এপ্রিল 19, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
videos.rate
method lets a user set alike
ordislike
rating on a video or remove a rating from a video.The error documentation has also been updated to list the errors that the API might return in response to a
videos.rate
method call.Thumbnail images are now identified in the API documentation as a separate resource , and the new
thumbnails.set
method enables you to upload a custom video thumbnail to YouTube and set it for a video.The error documentation has also been updated to list the errors that the API might return in response to a
thumbnails.set
method call.Note that this change does not really affect existing resources that return thumbnail images. Thumbnail images are returned in those resources in the same way that they were previously, though the documentation does now list the names of the different thumbnail sizes that the API might return.
The
channel
resource's newbrandingSettings
part identifies settings, text, and images for the channel's channel page and video watch pages.The
playlistItem
resource contains the following new properties:The new
status
object encapsulates status information about the playlist item, and thestatus.privacyStatus
property identifies the playlist item's privacy status.
The
video
resource contains the following new properties:The
status.publicStatsViewable
property indicates whether extended video statistics on the watch page are publicly viewable. By default, those statistics are viewable, and statistics like a video's viewcount and ratings will still be publicly visible even if this property's value is set tofalse
. You can set this property's value when calling thevideos.insert
orvideos.update
method.The
contentDetails.contentRating
object encapsulates ratings that the video received under various rating schemes. The list below identifies the supported rating systems and provides a link to the property associated with each rating system. The property definitions identify the supported rating values for each system.দেশ গুণমান নির্দেশক্রম সম্পত্তি যুক্তরাষ্ট্র Motion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRating
যুক্তরাষ্ট্র টিভি অভিভাবকীয় নির্দেশিকা contentDetails.contentRating.tvpgRating
অস্ট্রেলিয়া Australian Classification Board (ACB) contentDetails.contentRating.acbRating
ব্রাজিল Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
কানাডা Canadian Home Video Rating System (CHVRS) contentDetails.contentRating.chvrsRating
ফ্রান্স Centre national du cinéma et de l'image animée (French Ministry of Culture) contentDetails.contentRating.fmocRating
জার্মানি Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
গ্রেট ব্রিটেন British Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRating
ভারত সেন্ট্রাল বোর্ড অফ ফিল্ম সার্টিফিকেশন (সিবিএফসি) contentDetails.contentRating.cbfcRating
জাপান 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
কোরিয়া 영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
মেক্সিকো General Directorate of Radio, Television and Cinematography (RTC) contentDetails.contentRating.rtcRating
নিউজিল্যান্ড চলচ্চিত্র ও সাহিত্য শ্রেণীবিভাগের অফিস contentDetails.contentRating.oflcRating
রাশিয়া National Film Registry of the Russian Federation contentDetails.contentRating.russiaRating
স্পেন Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
The
playlistItems.update
method's documentation has been updated to reflect the fact that thesnippet.resourceId
property must be specified in the resource sent as the request body.The
search.list
method now supports the following functionality:The new
forMine
parameter restricts a search to only retrieve the authenticated user's videos.The
order
parameter now supports the ability to sort results alphabetically by title (order=title
) or by video count in descending order (order=videoCount
).The new
safeSearch
parameter indicates whether search results should include restricted content.
The
videos.insert
method supports several new errors, which are listed in the table below:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
invalidCategoryId
The snippet.categoryId
property specifies an invalid category ID. সমর্থিত বিভাগগুলি পুনরুদ্ধার করতেvideoCategories.list
পদ্ধতিটি ব্যবহার করুন।badRequest
invalidRecordingDetails
The metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
The request metadata specifies an invalid video game rating. badRequest
invalidVideoMetadata
The request metadata is invalid. The
onBehalfOfContentOwner
parameter has been removed from the list of supported parameters for thevideos.update
andvideos.delete
methods.
12 মার্চ, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelTitle
property has been added to thesnippet
for the following resources:The
search.list
method supports the following new parameters:The
channelType
parameter lets you restrict a search for channels to retrieve all channels or to retrieve only shows.The
videoType
parameter lets you restrict a search for videos to retrieve all videos or to retrieve only movies or only episodes of shows.
The definition of the
video
resource'srecordingDetails
part has been updated to note that the object will only be returned for a video if the video's geolocation data or recording time has been set.The
playlistItems.update
method now returns aninvalidSnippet
error, which is returned if the API request does not specify a valid snippet.Several API methods support new parameters that are intended exclusively for YouTube content partners. YouTube content partners include movie and television studios, record labels, and other content creators that make their content available on YouTube.
onBehalfOfContentOwner
প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের শংসাপত্রগুলি একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার মানতে নির্দিষ্ট সামগ্রীর মালিকের পক্ষে কাজ করছেন৷ ব্যবহারকারী যে CMS অ্যাকাউন্টের সাথে প্রমাণীকরণ করে সেটি অবশ্যই নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করতে হবে।This parameter is intended for content partners that own and manage many different YouTube channels. The parameter enables those partners to authenticate once and get access to all of their video and channel data, without having to provide authentication credentials for each individual channel.
The
channels.list
,search.list
,videos.delete
,videos.list
, andvideos.update
methods all support this parameter.The
managedByMe
parameter, which is supported by thechannels.list
method, instructs the API to return all channels owned by the content owner that theonBehalfOfContentOwner
parameter specifies.The
forContentOwner
parameter, which is supported by thesearch.list
method, instructs the API to restrict search results to only include resources that are owned by the content owner that theonBehalfOfContentOwner
parameter specifies.
25 ফেব্রুয়ারি, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API supports several new parts and properties for
video
resources:The new
fileDetails
,processingDetails
, andsuggestions
parts provide information to video owners about their uploaded videos. This data is very useful in applications that enable video uploads and includes the following:- processing status and progress
- errors or other issues encountered while processing a video
- availability of thumbnail images
- suggestions for improving video or metadata quality
- details about the original file uploaded to YouTube
All of these parts can only be retrieved by the video owner. The list below briefly describes the new parts, and the
video
resource documentation defines all of the properties that each part contains.The
fileDetails
object contains information about the video file that was uploaded to YouTube, including the file's resolution, duration, audio and video codecs, stream bitrates, and more.The
processingProgress
object contains information about YouTube's progress in processing the uploaded video file. The object's properties identify the current processing status and estimate the time remaining until YouTube finishes processing the video. This part also indicates whether different types of data or content, such as file details or thumbnail images, are available for the video.This object is designed to be polled so that the video uploader can track the progress that YouTube has made in processing the uploaded video file.
The
suggestions
object contains suggestions that identify opportunities to improve the video quality or the metadata for the uploaded video.
The
contentDetails
part contains four new properties. These properties can be retrieved with unauthenticated requests.-
dimension
– Indicates whether the video is available in 2D or 3D. -
definition
– Indicates whether the video is available in standard or high definition. -
caption
– Indicates whether captions are available for the video. -
licensedContent
– Indicates whether the video contains content that has been claimed by a YouTube content partner.
-
The
status
part contains two new properties. Video owners can set values for both properties when inserting or updating a video. These properties can also be retrieved with unauthenticated requests.-
embeddable
– Indicates whether the video can be embedded on another website. -
license
– Specifies the video's license. Valid values arecreativeCommon
andyoutube
.
-
The definition of the
part
parameter has been updated for thevideos.list
,videos.insert
, andvideos.update
methods to list the newly added parts described above as well as therecordingDetails
part, which had been inadvertently omitted.The
channel
resource's newcontentDetails.googlePlusUserId
property specifies the Google+ profile ID associated with the channel. This value can be used to generate a link to the Google+ profile.Each thumbnail image object now specifies the image's width and height. Thumbnail images are currently returned in
activity
,channel
,playlist
,playlistItem
,search result
,subscription
, andvideo
resources.The
playlistItems.list
now supports thevideoId
parameter, which can be used in conjunction with theplaylistId
parameter to only retrieve the playlist item that represents the specified video.The API returns a
notFound
error if the video that the parameter identifies cannot be found in the playlist.The error documentation describes a new
forbidden
error, which indicates that a request is not properly authorized for the requested action.The
channel
resource'ssnippet.channelId
property has been removed. The resource'sid
property provides the same value.
30 জানুয়ারী, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new error page lists errors that the API can return. The page includes general errors, which might occur for multiple different API methods, as well as method-specific errors.
16 জানুয়ারী, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Code samples are now available for the methods and languages shown in the list below:
-
activities.insert
– Java -
playlistItems.insert
– Python -
playlistItems.list
– Java, JavaScript, PHP, Python, Ruby -
playlists.insert
– Java, JavaScript, Python -
search.list
– Java, JavaScript, Python, Ruby -
videos.insert
– Java
-
An
activity
resource can now report achannelItem
action, which occurs when YouTube adds a video to an automatically generated YouTube channel . (YouTube algorithmically identifies topics that have a significant presence on the YouTube website and automatically generates channels for those topics.)The following
search.list
parameters have been updated:- The
q
parameter is no longer designated as a filter, which means .... - The
relatedToVideo
parameter has been renamedrelatedToVideoId
. - The
published
parameter has been replaced with two new parameters,publishedAfter
andpublishedBefore
, which are described below.
- The
The
search.list
method supports the following new parameters:পরামিতি নাম মান বর্ণনা channelId
string
Return resources created by the specified channel. publishedAfter
datetime
Return resources created after the specified time. publishedBefore
datetime
Return resources created before the specified time. regionCode
string
Return resources for the specified country. videoCategoryId
string
Filter video search results to only include videos associated with the specified video category . videoEmbeddable
string
Filter video search results to only include videos that can be played in an embedded player on a web page. Set the parameter value to true
to only retrieve embeddable videos.videoSyndicated
string
Filter video search results to only include videos that can be played outside of YouTube.com. Set the parameter value to true
to only retrieve syndicated videos.Several API resources support new properties. The table below identifies the resources and their new properties:
সম্পদ সম্পত্তির নাম মান বর্ণনা activity
contentDetails.playlistItem.playlistItemId
string
The playlist item ID that YouTube assigned to uniquely identify the item in the playlist. activity
contentDetails.channelItem
object
An object that contains information about a resource that was added to a channel. This property is only present if the snippet.type
ischannelItem
.activity
contentDetails.channelItem.resourceId
object
An object that identifies the resource that was added to the channel. Like other resourceId
properties, it contains akind
property that specifies the resource type, such as video or playlist. It also contains exactly one of several properties –videoId
,playlistId
, etc. – that specifies the ID that uniquely identifies that resource.channel
status
object
This object encapsulates information about the channel's privacy status. channel
status.privacyStatus
string
The channel's privacy status. Valid values are private
andpublic
.playlist
contentDetails
object
This object contains metadata about the playlist's content. playlist
contentDetails.itemCount
unsigned integer
The number of videos in the playlist. playlist
player
object
This object contains information that you would use to play the playlist in an embedded player. playlist
player.embedHtml
string
An <iframe>
tag that embeds a video player that plays the playlist.video
recordingDetails
object
This object encapsulates information that identifies or describes the place and time that the video was recorded. video
recordingDetails.location
object
This object contains geolocation information associated with the video. video
recordingDetails.location.latitude
double
Latitude in degrees. video
recordingDetails.location.longitude
double
Longitude in degrees. video
recordingDetails.location.elevation
double
Altitude above the Earth, in meters. video
recordingDetails.locationDescription
string
A text description of the location where the video was recorded. video
recordingDetails.recordingDate
datetime
The date and time when the video was recorded. The value is specified in ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
) format.The documentation for several API methods now identifies properties that must be specified in the request body or that are updated based on values in the request body. The table below lists those methods as well as the required or modifiable properties.
Note: Documentation for other methods may already list required and modifiable properties.
পদ্ধতি বৈশিষ্ট্য activities.insert
প্রয়োজনীয় বৈশিষ্ট্য: -
snippet.description
-
snippet.description
-
contentDetails.bulletin.resourceId
playlists.update
প্রয়োজনীয় বৈশিষ্ট্য: -
id
playlistItems.update
প্রয়োজনীয় বৈশিষ্ট্য: -
id
videos.update
প্রয়োজনীয় বৈশিষ্ট্য: -
id
-
The API no longer reports a
playlistAlreadyExists
error if you try to create or update a playlist that would have the same title as a playlist that already exists in the same channel.Several API methods support new error types. The table below identifies the method and the newly supported errors:
পদ্ধতি ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা guideCategories.list
notFound
notFound
The guide category identified by the id
parameter cannot be found. Use the guideCategories.list method to retrieve a list of valid values.playlistItems.delete
forbidden
playlistItemsNotAccessible
The request is not properly authorized to delete the specified playlist item. videoCategories.list
notFound
videoCategoryNotFound
The video category identified by the id
parameter cannot be found. Use the videoCategories.list method to retrieve a list of valid values.