এই পৃষ্ঠাটি YouTube ডেটা API (v3) পরিবর্তন এবং ডকুমেন্টেশন আপডেটগুলি তালিকাভুক্ত করে৷ এই চেঞ্জলগে সাবস্ক্রাইব করুন ।
30 এপ্রিল, 2024
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API আর চ্যানেল আলোচনা সন্নিবেশ বা পুনরুদ্ধার করার ক্ষমতা সমর্থন করে না। এই পরিবর্তনটি YouTube ওয়েবসাইটে সমর্থিত কার্যকারিতার সাথে সামঞ্জস্যপূর্ণ, যা চ্যানেলগুলিতে মন্তব্য পোস্ট করা সমর্থন করে না।
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
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 সনাক্ত করে৷ (সকল চ্যানেলের কাস্টম URL নেই।) YouTube সহায়তা কেন্দ্র একটি কাস্টম URL পাওয়ার পাশাপাশি কীভাবে URL সেট আপ করতে হয় তার জন্য যোগ্যতার প্রয়োজনীয়তা ব্যাখ্যা করে।channel
রিসোর্সেরbrandingSettings.watch
অবজেক্ট এবং এর সমস্ত চাইল্ড প্রপার্টি বাতিল করা হয়েছে।একটি
search.list
অনুরোধের API প্রতিক্রিয়াতে এখন একটিregionCode
প্রপার্টি রয়েছে। সম্পত্তিটি সেই অঞ্চলের কোড সনাক্ত করে যা অনুসন্ধান ক্যোয়ারির জন্য ব্যবহৃত হয়েছিল। অঞ্চল কোড নির্দিষ্ট দেশের জন্য অনুসন্ধান ফলাফল ফেরত দিতে API নির্দেশ.সম্পত্তির মান হল একটি দুই-অক্ষরের ISO কান্ট্রি কোড যা অঞ্চলটিকে চিহ্নিত করে।
i18nRegions.list
পদ্ধতি সমর্থিত অঞ্চলগুলির একটি তালিকা প্রদান করে। ডিফল্ট মান হলUS
। যদি একটি অ-সমর্থিত অঞ্চল নির্দিষ্ট করা হয়, তবে ক্যোয়ারীটি পরিচালনা করার জন্য YouTube এখনও ডিফল্ট মানের পরিবর্তে অন্য একটি অঞ্চল নির্বাচন করতে পারে৷videoAbuseReportReason
রিসোর্সেরsnippet.label
এবংsnippet.secondaryReasons[].label
বৈশিষ্ট্যগুলির সংজ্ঞাগুলি আপডেট করা হয়েছে নোট করার জন্য যে বৈশিষ্ট্যগুলিতে অপব্যবহারের প্রতিবেদনের কারণে স্থানীয় লেবেল পাঠ্য রয়েছে৷উপরন্তু,
videoAbuseReportReasons.list
পদ্ধতিটি এখনhl
প্যারামিটার সমর্থন করে, যা API প্রতিক্রিয়াতে লেবেল পাঠ্যের জন্য যে ভাষা ব্যবহার করা উচিত তা নির্দিষ্ট করে। ডিফল্ট প্যারামিটার মান হলen_US
।video
রিসোর্সের নতুনcontentDetails.contentRating.ecbmctRating
প্রপার্টি তুরস্কের সংস্কৃতি ও পর্যটন মন্ত্রণালয়ের মূল্যায়ন ও শ্রেণিবিন্যাস বোর্ড থেকে ভিডিওর রেটিং শনাক্ত করে।উপরন্তু, অন্যান্য রেটিং সিস্টেমের জন্য API বৈশিষ্ট্য নিম্নলিখিত নতুন সম্পত্তি মান সমর্থন করে:
-
contentDetails.contentRating.fpbRating
(দক্ষিণ আফ্রিকা)
রেটিং: 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
প্যারামিটার শুধুমাত্র সেই মানগুলিকে সমর্থন করে যা YouTube ওয়েবসাইট সমর্থন করে এমন অ্যাপ্লিকেশন ভাষাগুলি সনাক্ত করে৷ স্থানীয়কৃত পাঠ্য অন্যান্য ভাষার জন্য উপলব্ধ কিনা তা নির্ধারণ করতে, আপনাকে সংস্থানগুলির জন্যlocalizations
অংশ পুনরুদ্ধার করতে হবে এবং স্থানীয়কৃত পাঠ্য বিদ্যমান কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে।
উদাহরণ স্বরূপ, অ্যাপালাচিয়ান ইংরেজিতে স্থানীয়কৃত পাঠ্য উপলব্ধ কিনা তা নির্ধারণ করতে আপনাকে স্থানীয়করণের সম্পূর্ণ তালিকা পুনরুদ্ধার করতে হবে।একটি সংস্থান পুনরুদ্ধার করার সময়, সেই সংস্থানের জন্য সমস্ত স্থানীয় বিবরণ পুনরুদ্ধার করতে
part
প্যারামিটার মানের মধ্যেlocalizations
অন্তর্ভুক্ত করুন। আপনি যদি এমন একটি ভাষার জন্য স্থানীয়কৃত ডেটা পুনরুদ্ধার করছেন যা একটি বর্তমান YouTube অ্যাপ্লিকেশন ভাষা নয়, তাহলে আপনাকে সমস্ত স্থানীয়করণ পুনরুদ্ধার করতে এই পদ্ধতিটি ব্যবহার করতে হবে এবং তারপরে পছন্দসই স্থানীয়করণ ডেটা বিদ্যমান কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে৷
স্থানীয়কৃত পাঠ্য মান সম্পর্কিত ত্রুটি
এপিআই স্থানীয় টেক্সট মানগুলির জন্য নিম্নলিখিত নতুন ত্রুটিগুলিকে সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
defaultLanguageNotSetError
এই ত্রুটিটি নির্দেশ করে যে একটি অনুরোধ যা একটি সংস্থানের জন্য localizations
অবজেক্ট সন্নিবেশ বা আপডেট করার চেষ্টা করে তা ব্যর্থ হচ্ছে কারণ সেই সংস্থানের জন্যsnippet.defaultLanguage
বৈশিষ্ট্য সেট করা নেই৷channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
, এবংvideos.update
পদ্ধতিগুলি এই ত্রুটিটিকে সমর্থন করে৷badRequest (400)
localizationValidationError
এই ত্রুটিটি নির্দেশ করে যে একটি সম্পদের localizations
বস্তুর মানগুলির একটি যাচাই করতে ব্যর্থ হয়েছে৷ উদাহরণস্বরূপ, এই ত্রুটি ঘটতে পারে যদি বস্তুটিতে একটি অবৈধ ভাষা কোড থাকে।channels.update
,channelSections.insert
,channelSections.update
,playlists.insert
, এবংplaylists.update
পদ্ধতিগুলি এই ত্রুটিটিকে সমর্থন করে৷
নভেম্বর 4, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
search.list
পদ্ধতিরorder
প্যারামিটার আপডেট করা হয়েছে লক্ষ্য করার জন্য যে আপনি যদিviewCount
দ্বারা লাইভ সম্প্রচারগুলি সাজান, তাহলে API ফলাফলগুলি সম্প্রচার চলাকালীন সমসাময়িক দর্শকদের সম্প্রচারের সংখ্যা অনুসারে সাজানো হয়৷search.list
পদ্ধতিরrelatedToVideoId
ToVideoId প্যারামিটার আপডেট করা হয়েছে নোট করার জন্য যে প্যারামিটার সেট করা থাকলে, শুধুমাত্র অন্যান্য সমর্থিত প্যারামিটারগুলি হলpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(যাvideo
সেট করা আবশ্যক), এবংfields
। এই আপডেটটি API আচরণের পরিবর্তনকে প্রতিফলিত করে না।video
রিসোর্সেরsnippet.publishedAt
প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে নোট করার জন্য যে সম্পত্তির মান, যা ভিডিওটি প্রকাশিত হওয়ার তারিখ এবং সময় নির্দিষ্ট করে, ভিডিওটি আপলোড করার সময় থেকে ভিন্ন হতে পারে। উদাহরণস্বরূপ, যদি একটি ভিডিও একটি ব্যক্তিগত ভিডিও হিসাবে আপলোড করা হয় এবং তারপরে পরবর্তী সময়ে সর্বজনীন করা হয়, তাহলে সম্পত্তির মান নির্দিষ্ট করে যে ভিডিওটি সর্বজনীন করা হয়েছিল। আপডেট করা সংজ্ঞাটিও ব্যাখ্যা করে যে ব্যক্তিগত এবং তালিকাবিহীন ভিডিওগুলির জন্য মানটি কীভাবে পূরণ করা হয়।এই পরিবর্তনটি API আচরণের পরিবর্তনকে প্রতিফলিত করে না।
video
রিসোর্স এরstatus.publishAt
সংজ্ঞা.publishAt প্রপার্টি নোট করার জন্য আপডেট করা হয়েছে:-
videos.update
পদ্ধতিতে কল করার সময় আপনি যদি এই সম্পত্তির মান সেট করেন, তাহলে আপনাকে অবশ্যইstatus.privacyStatus
সম্পত্তির মানটিprivate
হিসাবে সেট করতে হবে যদিও ভিডিওটি ইতিমধ্যে ব্যক্তিগত হয়। - যদি অনুরোধটি অতীতের কোনো সময়ে প্রকাশ করার জন্য একটি ভিডিওর সময়সূচী নির্ধারণ করে, তাহলে তা অবিলম্বে প্রকাশ করা হয়। যেমন, অতীতের তারিখ এবং সময়ে
status.publishAt
সম্পত্তি সেট করার প্রভাব ভিডিওরprivacyStatus
private
থেকেpublic
পরিবর্তন করার মতোই।
-
video
সম্পদেরcontentDetails.contentRating.cncRating
সম্পত্তি ফ্রান্সের কমিশন ডি ক্লাসিফিকেশন সিনেমাটোগ্রাফিক থেকে ভিডিওর রেটিং নির্দিষ্ট করে। এই প্রপার্টিcontentDetails.contentRating.fmocRating
প্রপার্টি প্রতিস্থাপন করে, যা এখন অবহেলিত।channel
রিসোর্সের brandingSettings.channel.keywords- এর সংজ্ঞা সঠিকভাবে প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে সম্পত্তির মানটিতে স্ট্রিংগুলির একটি স্থান-বিচ্ছিন্ন তালিকা রয়েছে এবং একটি কমা-বিচ্ছিন্ন তালিকা নয়, যেমন পূর্বে নথিভুক্ত করা হয়েছে। এই আপডেটটি API আচরণের পরিবর্তনকে প্রতিফলিত করে না।thumbnails.set
পদ্ধতির জন্য ডকুমেন্টেশনটি সঠিকভাবে প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে অনুরোধের মূল অংশে থাম্বনেইল চিত্রটি রয়েছে যা আপনি একটি ভিডিও আপলোড করছেন এবং তার সাথে যুক্ত করছেন। অনুরোধের মূল অংশে একটিthumbnail
সংস্থান নেই৷ পূর্বে, ডকুমেন্টেশন বলেছিল যে এই পদ্ধতিতে কল করার সময় আপনার অনুরোধের বডি প্রদান করা উচিত নয়। এই আপডেটটি API আচরণের পরিবর্তনকে প্রতিফলিত করে না।activities.list
পদ্ধতিতে বর্তমানে নতুন ভিডিও মন্তব্য সম্পর্কিত রিসোর্স অন্তর্ভুক্ত নয় তা প্রতিফলিত করার জন্যactivity
সম্পদের বিবরণ আপডেট করা হয়েছে। সম্পদেরsnippet.type
এবংcontentDetails.comment
পাশাপাশি আপডেট করা হয়েছে।
নতুন এবং আপডেট ত্রুটি
API এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটি বিবরণ activities.insert
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ invalidMetadata
বর্ণনা প্রদত্ত আইডির প্রকারের সাথে kind
সম্পত্তি মেলে না।commentThreads.update
comments.insert
comments.update
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ commentTextTooLong
বর্ণনা যে comment
সংস্থানটি সন্নিবেশিত বা আপডেট করা হচ্ছে তাতেsnippet.topLevelComment.snippet.textOriginal
সম্পত্তিতে অনেক বেশি অক্ষর রয়েছে৷playlistItems.insert
playlistItems.update
HTTP প্রতিক্রিয়া কোড forbidden (403)
কারণ playlistItemsNotAccessible
বর্ণনা অনুরোধটি নির্দিষ্ট প্লেলিস্ট আইটেম সন্নিবেশ, আপডেট বা মুছে ফেলার জন্য সঠিকভাবে অনুমোদিত নয়। playlists.delete
playlists.insert
playlists.update
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ playlistForbidden
বর্ণনা এই অপারেশন নিষিদ্ধ বা অনুরোধ সঠিকভাবে অনুমোদিত নয়. search.list
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ invalidLocation
বর্ণনা location
এবং/অথবাlocationRadius
প্যারামিটার মান ভুলভাবে বিন্যাস করা হয়েছে।search.list
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ invalidRelevanceLanguage
বর্ণনা relevanceLanguage
প্যারামিটার মান ভুলভাবে বিন্যাস করা হয়েছে।subscriptions.insert
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ subscriptionForbidden
বর্ণনা এই ত্রুটিটি ঘটে যখন নিম্নলিখিতগুলির মধ্যে যেকোনো একটি সত্য হয়: - আপনি যে সাবস্ক্রিপশন তৈরি করার চেষ্টা করছেন তা ইতিমধ্যেই বিদ্যমান
- আপনি ইতিমধ্যেই আপনার সদস্যতার সর্বোচ্চ সংখ্যায় পৌঁছেছেন৷
- আপনি আপনার নিজের চ্যানেলে সদস্যতা নেওয়ার চেষ্টা করছেন, যা সমর্থিত নয়৷
- আপনি সম্প্রতি অনেকগুলি সদস্যতা তৈরি করেছেন এবং অনুরোধটি পুনরায় চেষ্টা করার আগে কয়েক ঘন্টা অপেক্ষা করতে হবে৷
videos.update
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ invalidDefaultBroadcastPrivacySetting
বর্ণনা অনুরোধটি ডিফল্ট সম্প্রচারের জন্য একটি অবৈধ গোপনীয়তা সেটিং সেট করার চেষ্টা করে৷
আগস্ট 28, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
video
রিসোর্সেরstatistics.favoriteCount
প্রপার্টি বাতিল করা হয়েছে।আমাদের অবচয় নীতি অনুসারে, এই ঘোষণার পরে অন্তত এক বছরের জন্য এই সম্পত্তি
video
সংস্থানগুলিতে অন্তর্ভুক্ত করা অব্যাহত থাকবে৷ যাইহোক, সম্পত্তির মান এখন সর্বদা0
তে সেট করা হয়।
আগস্ট 7, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
video
রিসোর্সেরsnippet.tags[]
সম্পত্তির সংজ্ঞা আপডেট করা হয়েছে কিভাবে API সার্ভার প্রপার্টির মানের দৈর্ঘ্য গণনা করে সে সম্পর্কে আরও তথ্য প্রদান করতে। মনে রাখবেন যে এই আপডেটটি API-এর আচরণে কোনো পরিবর্তন প্রতিফলিত করে না।বিশেষভাবে, সংজ্ঞাটি এখন ব্যাখ্যা করে যে যদি একটি ট্যাগে একটি স্থান থাকে, তাহলে API সার্ভার ট্যাগ মানটিকে এমনভাবে পরিচালনা করে যেন এটি উদ্ধৃতি চিহ্নে মোড়ানো থাকে এবং উদ্ধৃতি চিহ্নগুলি অক্ষর সীমার দিকে গণনা করা হয়। সুতরাং, অক্ষর সীমার উদ্দেশ্যে, ফু-বাজ ট্যাগটিতে সাতটি অক্ষর রয়েছে, তবে ফু বাজ ট্যাগটিতে নয়টি অক্ষর রয়েছে।
commentThreads.insert
পদ্ধতিটি আরshareOnGooglePlus
প্যারামিটারকে সমর্থন করে না, যা পূর্বে নির্দেশ করে যে একটি মন্তব্য এবং সেই মন্তব্যের উত্তরও লেখকের Google+ প্রোফাইলে পোস্ট করা উচিত কিনা। যদি একটি অনুরোধ প্যারামিটার জমা দেয়, API সার্ভার পরামিতি উপেক্ষা করে কিন্তু অন্যথায় অনুরোধটি পরিচালনা করে।
18 জুন, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
commentThreads.list
পদ্ধতির নতুনorder
প্যারামিটার নির্দিষ্ট করে যে ক্রমটিতে API প্রতিক্রিয়া মন্তব্য থ্রেড তালিকাভুক্ত করা উচিত। থ্রেড সময় বা প্রাসঙ্গিকতা দ্বারা আদেশ করা যেতে পারে. ডিফল্ট আচরণ হল সময় অনুযায়ী তাদের অর্ডার করা।video
রিসোর্সের নতুনsnippet.defaultAudioLanguage
প্রপার্টি ভিডিওর ডিফল্ট অডিও ট্র্যাকে কথ্য ভাষা নির্দিষ্ট করে।video
রিসোর্সেরcontentDetails.licensedContent
সম্পত্তির সংজ্ঞাটি স্পষ্ট করার জন্য আপডেট করা হয়েছে যে বিষয়বস্তুটি অবশ্যই একটি YouTube সামগ্রী অংশীদারের সাথে লিঙ্কযুক্ত একটি চ্যানেলে আপলোড করা হয়েছে এবং তারপর সেই অংশীদার দ্বারা দাবি করা হয়েছে৷ এটি প্রকৃত API আচরণের পরিবর্তনের প্রতিনিধিত্ব করে না।captions.delete
,captions.download
,captions.insert
,captions.list
, এবংcaptions.update
পদ্ধতিগুলি এখনonBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যেই অন্যান্য পদ্ধতির জন্য সমর্থিত৷ সেই পদ্ধতিটি ব্যবহার করে এমন অনুরোধগুলিকে একটি টোকেন দিয়ে অনুমোদিত হতে হবে যাhttps://www.googleapis.com/auth/youtubepartner
স্কোপে অ্যাক্সেস প্রদান করে।
নতুন এবং আপডেট ত্রুটি
API এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটি বিবরণ videos.rate
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ emailNotVerified
বর্ণনা ভিডিও রেটিং দেওয়ার আগে ব্যবহারকারীকে অবশ্যই তার ইমেল ঠিকানা যাচাই করতে হবে। videos.rate
HTTP প্রতিক্রিয়া কোড badRequest (400)
কারণ videoPurchaseRequired
বর্ণনা ভাড়া করা ভিডিওগুলি শুধুমাত্র সেই ব্যবহারকারীদের দ্বারা রেট করা যেতে পারে যারা সেগুলি ভাড়া করেছে৷ subscriptions.delete
এবংsubscriptions.insert
পদ্ধতিগুলি আরaccountClosed
এবংaccountSuspended
ত্রুটিগুলিকে সমর্থন করে না৷
এপ্রিল 27, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
videoAbuseReportReason
রিসোর্সে এমন একটি কারণ সম্পর্কে তথ্য রয়েছে যে ভিডিওতে অপমানজনক বিষয়বস্তু থাকার জন্য ফ্ল্যাগ করা হবে৷videoAbuseReportReasons.list
পদ্ধতি আপনাকে ভিডিওগুলিকে পতাকাঙ্কিত করার সমস্ত কারণগুলির একটি তালিকা পুনরুদ্ধার করতে দেয়৷নতুন
videos.reportAbuse
পদ্ধতি একটি ভিডিওকে প্রকৃতপক্ষে পতাকাঙ্কিত করার একটি উপায় প্রদান করে যাতে অপমানজনক সামগ্রী রয়েছে৷ অনুরোধের মূল অংশে একটি JSON অবজেক্ট রয়েছে যা ভিডিওটিকে পতাকাঙ্কিত করার পাশাপাশি ভিডিওটিতে অপমানজনক সামগ্রী রয়েছে বলে বিবেচিত হওয়ার কারণও উল্লেখ করে৷ উপরে বর্ণিতvideoAbuseReportReason.list
পদ্ধতি থেকে বৈধ কারণ পাওয়া যেতে পারে।একটি আপত্তিজনক ভিডিও প্রতিবেদন করার জন্য একটি উদাহরণ সহ মাইগ্রেশন গাইড আপডেট করা হয়েছে৷ এই পরিবর্তনের সাথে, v3 API এখন সমস্ত v2 API বৈশিষ্ট্য সমর্থন করে যা এটি সমর্থন করার জন্য নির্ধারিত হয়েছে। এই বৈশিষ্ট্যগুলিও মাইগ্রেশন গাইডে ব্যাখ্যা করা হয়েছে।
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
search.list
পদ্ধতির নতুনforDeveloper
ফিল্টার প্যারামিটার একটি অনুসন্ধানকে শুধুমাত্র বিকাশকারীর অ্যাপ্লিকেশন বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওগুলি পুনরুদ্ধার করতে সীমাবদ্ধ করে৷forDeveloper
প্যারামিটারটিq
প্যারামিটারের মতো ঐচ্ছিক অনুসন্ধান পরামিতির সাথে একত্রে ব্যবহার করা যেতে পারে।এই বৈশিষ্ট্যটির জন্য, প্রতিটি আপলোড করা ভিডিও স্বয়ংক্রিয়ভাবে Google বিকাশকারী কনসোলে বিকাশকারীর অ্যাপ্লিকেশনের সাথে যুক্ত প্রকল্প নম্বরের সাথে ট্যাগ করা হয়৷
যখন একটি অনুসন্ধানের অনুরোধ পরবর্তীতে
forDeveloper
প্যারামিটারটিকেtrue
তে সেট করে, তখন API সার্ভার বিকাশকারীকে সনাক্ত করতে অনুরোধের অনুমোদনের শংসাপত্র ব্যবহার করে। অতএব, একজন বিকাশকারী বিকাশকারীর নিজস্ব অ্যাপ বা ওয়েবসাইটের মাধ্যমে আপলোড করা ভিডিওগুলিতে ফলাফল সীমাবদ্ধ করতে পারে তবে অন্যান্য অ্যাপ বা সাইটের মাধ্যমে আপলোড করা ভিডিওগুলিতে নয়৷নতুন বৈশিষ্ট্যটি কার্যকারিতা অফার করে যা একই রকম, যদিও অভিন্ন নয়, বিকাশকারী ট্যাগ কার্যকারিতা যা v2 API সমর্থিত।
channel
রিসোর্সের নতুনsnippet.country
প্রপার্টি চ্যানেল মালিকদের তাদের চ্যানেলগুলিকে একটি নির্দিষ্ট দেশের সাথে যুক্ত করতে দেয়।দ্রষ্টব্য:
channel
রিসোর্সের জন্যsnippet.country
প্রপার্টি সেট করতে, আপনাকে আসলেbrandingSettings.channel.country
প্রপার্টি আপডেট করতে হবে।API এখন
channelSection
রিসোর্সের জন্য টার্গেটিং সমর্থন করে। চ্যানেল বিভাগ টার্গেটিং নির্দিষ্ট মানদণ্ডের সাথে মেলে এমন ব্যবহারকারীদের জন্য একটি বিষয়বস্তু বিভাগের দৃশ্যমানতা সীমাবদ্ধ করার একটি উপায় প্রদান করে।API তিনটি টার্গেটিং বিকল্প প্রকাশ করে। একটি চ্যানেল বিভাগ দৃশ্যমান হওয়ার জন্য একজন ব্যবহারকারীকে অবশ্যই লক্ষ্য নির্ধারণের সমস্ত সেটিংস পূরণ করতে হবে।
targeting.languages[]
: YouTube অ্যাপ্লিকেশন ভাষার একটি তালিকা। ব্যবহারকারীরা যারা এই ভাষাগুলির মধ্যে একটি বেছে নিয়েছেন তারা সংশ্লিষ্ট চ্যানেল বিভাগটি দেখতে পারেন।targeting.regions[]
: YouTube পছন্দের বিষয়বস্তু অঞ্চলের একটি তালিকা। চ্যানেল বিভাগটি সেইসব ব্যবহারকারীদের কাছে দৃশ্যমান যারা সেই অঞ্চলগুলির মধ্যে একটি নির্বাচন করেছেন এবং সেইসাথে সেই ব্যবহারকারীদের জন্য যাদের জন্য সেই অঞ্চলগুলির মধ্যে একটি স্বয়ংক্রিয়ভাবে নির্বাচিত হয়েছে৷targeting.countries[]
: দেশগুলির একটি তালিকা যেখানে চ্যানেল বিভাগটি দৃশ্যমান। তালিকার প্রতিটি মান হল একটি ISO 3166-1 alpha-2 দেশের কোড ।
video
রিসোর্সেরcontentDetails.duration
প্রপার্টির সংজ্ঞা সংশোধন করা হয়েছে যাতে প্রতিফলিত হয় মান ঘন্টা, দিন ইত্যাদি প্রতিফলিত করতে পারে।channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
, এবংvideos.delete
পদ্ধতির ডকুমেন্টেশন সংশোধন করা হয়েছে যাতে প্রতিফলিত হয় যে, সফল হলে, এই পদ্ধতিগুলি সবই একটি HTTP204
প্রতিক্রিয়া কোড (No Content
) প্রদান করে।
নতুন এবং আপডেট ত্রুটি
API এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
targetInvalidCountry
যদি সন্নিবেশিত channelSection
রিসোর্সেtargeting.countries[]
বৈশিষ্ট্যের জন্য একটি অবৈধ মান থাকে তাহলেchannelSections.insert
এবংchannelSections.update
পদ্ধতিগুলি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
targetInvalidLanguage
channelSections.insert
এবংchannelSections.update
পদ্ধতিগুলি এই ত্রুটিটি ফেরত দেয় যদি সন্নিবেশিতchannelSection
রিসোর্সেtargeting.languages[]
বৈশিষ্ট্যের জন্য একটি অবৈধ মান থাকে।badRequest (400)
targetInvalidRegion
channelSections.insert
এবংchannelSections.update
পদ্ধতিগুলি এই ত্রুটিটি ফেরত দেয় যদি সন্নিবেশিতchannelSection
রিসোর্সেtargeting.regions[]
বৈশিষ্ট্যের জন্য একটি অবৈধ মান থাকে।badRequest (400)
operationNotSupported
API ব্যবহারকারী snippet.parentId
বৈশিষ্ট্য দ্বারা চিহ্নিত শীর্ষ-স্তরের মন্তব্যের উত্তরে একটি মন্তব্য সন্নিবেশ করতে সক্ষম না হলেcomments.insert
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয়। একটিcommentThread
রিসোর্সে,snippet.canReply
প্রপার্টি নির্দেশ করে যে বর্তমান দর্শক থ্রেডের উত্তর দিতে পারবে কিনা।badRequest (400)
invalidChannelId
অনুরোধে channelId
প্যারামিটারটি একটি অবৈধ চ্যানেল আইডি উল্লেখ করলেsearch.list
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
subscriptionForbidden
API ব্যবহারকারী ব্যবহারকারীর নিজস্ব চ্যানেলে সদস্যতা নেওয়ার চেষ্টা করলে subscriptions.insert
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয়।captions.update
পদ্ধতিটি আরinvalidMetadata
এবংvideoNotFound
ত্রুটি সমর্থন করে না।
16 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
v2 API থেকে মন্তব্য কার্যকারিতা ব্যবহার করে এখনও অ্যাপ্লিকেশনগুলিকে কীভাবে স্থানান্তর করা যায় তা ব্যাখ্যা করার জন্য মাইগ্রেশন গাইড আপডেট করা হয়েছে।
গাইডটিতে বেশ কিছু মন্তব্য করার বৈশিষ্ট্যও রয়েছে যা v2 API সমর্থন করে না কিন্তু যেগুলি v3 API-তে সমর্থিত । এর মধ্যে রয়েছে:
- একটি চ্যানেল সম্পর্কে মন্তব্য পুনরুদ্ধার করা হচ্ছে
- একটি চ্যানেলের সাথে সম্পর্কিত সমস্ত মন্তব্য থ্রেড পুনরুদ্ধার করা, যার অর্থ হল API প্রতিক্রিয়া চ্যানেল বা এর যেকোনো ভিডিও সম্পর্কে মন্তব্য থাকতে পারে।
- একটি মন্তব্যের পাঠ্য আপডেট করা হচ্ছে
- একটি মন্তব্যকে স্প্যাম হিসেবে চিহ্নিত করা হচ্ছে
- একটি মন্তব্যের সংযম অবস্থা সেট করা হচ্ছে
সাবস্ক্রাইবিং টু পুশ নোটিফিকেশন গাইডটি আপডেট করা হয়েছে যাতে নোটিফিকেশনগুলি শুধুমাত্র Google PubSubHubBub হাবে পুশ করা হয় এবং পূর্বে নির্দেশিত হিসাবে Superfeedr হাবেও নয়।
9 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API-এর নতুন
commentThread
এবংcomment
সংস্থানগুলি আপনাকে মন্তব্যগুলি পুনরুদ্ধার করতে, সন্নিবেশ করাতে, আপডেট করতে, মুছে ফেলতে এবং সংযত করতে দেয়৷একটি
commentThread
সংস্থান একটি YouTube মন্তব্য থ্রেড সম্পর্কে তথ্য ধারণ করে, যেটিতে একটি শীর্ষ-স্তরের মন্তব্য রয়েছে এবং সেই মন্তব্যের উত্তর, যদি থাকে, তাহলে। একটিcommentThread
সংস্থান একটি ভিডিও বা একটি চ্যানেল সম্পর্কে মন্তব্য উপস্থাপন করতে পারে।শীর্ষ-স্তরের মন্তব্য এবং উত্তরগুলি আসলে
comment
সংস্থান যাcommentThread
সংস্থানের ভিতরে নেস্ট করা হয়। এটা মনে রাখা গুরুত্বপূর্ণ যেcommentThread
রিসোর্সে একটি মন্তব্যের সমস্ত উত্তর অগত্যা থাকে না, এবং যদি আপনি একটি নির্দিষ্ট মন্তব্যের জন্য সমস্ত উত্তর পুনরুদ্ধার করতে চান তাহলে আপনাকেcomments.list
পদ্ধতি ব্যবহার করতে হবে। এছাড়াও, কিছু মন্তব্যের উত্তর নেই।API
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.markAsSpam
,comments.insert
কল করার জন্য প্রয়োজনীয়comments.update
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
কলের জন্য কোটা খরচ 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 টি ইউনিটের কোটা ব্যয় রয়েছে।subscription
রিসোর্সটিতে তিনটি অংশ রয়েছে (snippet
,contentDetails
এবংsubscriberSnippet
) এবং এগুলির প্রত্যেকটিরই দুটি ইউনিটের ব্যয় রয়েছে।দয়া করে মনে রাখবেন যে সতর্কতা ছাড়াই কোটা ব্যয়গুলি পরিবর্তন করতে পারে।
video
রিসোর্স এখন 43 টি নতুন কন্টেন্ট রেটিং সিস্টেম সমর্থন করে, যা বিভিন্ন জাতীয় রেটিং এজেন্সি থেকে প্রাপ্ত ভিডিওগুলি সনাক্ত করে। সদ্য সমর্থিত রেটিং সিস্টেমগুলি আর্জেন্টিনা , অস্ট্রিয়া , বেলজিয়াম , বুলগেরিয়া , চিলি ( টেলিভিশন ), চিলি ( ফিল্ম ), চেক প্রজাতন্ত্র , কলম্বিয়া , ডেনমার্ক , মিশর , এস্তোনিয়া, ফিনল্যান্ড , ফ্রান্স , গ্রীস , হংকং , আইসল্যান্ড , ইন্দোনেশিয়া, আয়ারল্যান্ড , আইসল্যান্ড, ইন্দোনেশিয়া , আয়ারল্যান্ডের। , ইস্রায়েল , ইতালি , কেনিয়া , লাটভিয়া , লাক্সেমবার্গ , মালয়েশিয়া , মালদ্বীপ, মাল্টা, নেদারল্যান্ডস, নাইজেরিয়া, নরওয়ে , পেরু , ফিলিপাইন , পর্তুগাল , রোমানিয়া , সিঙ্গাপুর , স্লোভাকিয়া , দক্ষিণ আফ্রিকা , সুইডেন , সুইজারল্যান্ড , তাইওয়ান , থাইল্যান্ড এবং ভিনেজুয়েল ।
28 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
search.list
পদ্ধতিটি এখনlocation
এবংlocationRadius
প্যারামিটারগুলিকে সমর্থন করে, যা আপনাকে কোনও ভৌগলিক অবস্থানের সাথে সম্পর্কিত ভিডিওগুলি অনুসন্ধান করতে দেয়। অবস্থানের ভিত্তিতে ফলাফলগুলি পুনরুদ্ধার করতে একটি অনুরোধ অবশ্যই উভয় পরামিতিগুলির জন্য একটি মান নির্দিষ্ট করতে হবে এবং যদি কোনও অনুরোধে দুটি পরামিতিগুলির মধ্যে একটিতে অন্তর্ভুক্ত থাকে তবে এপিআই একটি ত্রুটি ফিরিয়ে দেবে।location
প্যারামিটারটি বৃত্তাকার ভৌগলিক অঞ্চলের কেন্দ্রে অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্কগুলি নির্দিষ্ট করে।locationRadius
প্যারামিটারটি কোনও ভিডিওর সাথে সম্পর্কিত অবস্থানটি সর্বাধিক দূরত্ব নির্দিষ্ট করে যা ভিডিওটির কেন্দ্র থেকে ভিডিওটি এখনও অনুসন্ধানের ফলাফলগুলিতে অন্তর্ভুক্ত করার জন্য হতে পারে।
13 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সেরinvideoPromotion.items[]
সম্পত্তিটি আপডেট করা হয়েছে যে আপনি সাধারণত আপনার চ্যানেলের জন্য কেবল একটি প্রচারিত আইটেম সেট করতে পারেন। আপনি যদি অনেক বেশি প্রচারিত আইটেম সন্নিবেশ করার চেষ্টা করেন তবে এপিআই একটিtooManyPromotedItems
ত্রুটি ফিরিয়ে দেবে, যার একটি এইচটিটিপি400
স্ট্যাটাস কোড রয়েছে।channelSection
রিসোর্সটিতে এখন কয়েকটি নতুন ধরণের বৈশিষ্ট্যযুক্ত সামগ্রী সম্পর্কিত তথ্য থাকতে পারে।channelSection
রিসোর্সেরsnippet.type
টাইপ সম্পত্তি এখন নিম্নলিখিত মানগুলিকে সমর্থন করে:-
postedPlaylists
- প্লেলিস্টগুলি যে চ্যানেলের মালিক চ্যানেলের ক্রিয়াকলাপ ফিডে পোস্ট করেছেন -
postedVideos
- চ্যানেলের মালিক চ্যানেলের ক্রিয়াকলাপ ফিডে পোস্ট করেছেন এমন ভিডিও -
subscriptions
- চ্যানেলগুলি যা চ্যানেল মালিককে সাবস্ক্রাইব করেছেন
-
video
রিসোর্সের নতুনcontentDetails.contentRating.ifcoRating
সম্পত্তি আইরিশ ফিল্ম শ্রেণিবদ্ধকরণ অফিস থেকে প্রাপ্ত একটি ভিডিও রেটিং চিহ্নিত করে।watermark
রিসোর্সেরposition.cornerPosition
সংজ্ঞাটি orn কোর্নারপজিশন সম্পত্তিটি আপডেট করা হয়েছে যে ওয়াটারমার্কটি সর্বদা প্লেয়ারের উপরের ডানদিকে কোণে উপস্থিত হয়।search.list
জন্যq
প্যারামিটারের সংজ্ঞাটি List লিস্ট পদ্ধতির জন্য আপডেট করা হয়েছে যে ক্যোয়ারী শব্দটি কোনও নির্দিষ্ট অনুসন্ধানের শব্দের সাথে সম্পর্কিত ভিডিওগুলি বাদ দিতে বুলিয়ান নয় (-
) অপারেটরটি ব্যবহার করতে পারে। মানটি বেশ কয়েকটি অনুসন্ধান পদগুলির একটির সাথে সম্পর্কিত ভিডিওগুলি খুঁজে পেতে বুলিয়ান বা (|
) অপারেটরটিও ব্যবহার করতে পারে।pageInfo.totalResults
সম্পত্তির সংজ্ঞা যা কোনওsearch.list
এপিআই প্রতিক্রিয়াতে ফিরে আসে List লিস্ট কলটি আপডেট করা হয়েছে যে মানটি একটি আনুমানিক এবং সঠিক মান উপস্থাপন করতে পারে না তা লক্ষ করার জন্য আপডেট করা হয়েছে। এছাড়াও, সর্বাধিক মান 1000,000। পৃষ্ঠাগুলি লিঙ্কগুলি তৈরি করতে আপনার এই মানটি ব্যবহার করা উচিত নয়। পরিবর্তে, প্যাগিনেশন লিঙ্কগুলি প্রদর্শন করতে হবে কিনা তা নির্ধারণ করতেnextPageToken
এবংprevPageToken
সম্পত্তি মানগুলি ব্যবহার করুন।watermarks.set
এবংwatermarks.unset
পদ্ধতিগুলি আপডেট করা হয়েছে যে এপিআই এই পদ্ধতিগুলিতে সফল অনুরোধগুলির জন্য একটি এইচটিটিপি204
প্রতিক্রিয়া কোডটি প্রদান করে।
2 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
i18nLanguage
রিসোর্স একটি অ্যাপ্লিকেশন ভাষা সনাক্ত করে যা ইউটিউব ওয়েবসাইট সমর্থন করে। অ্যাপ্লিকেশন ভাষাটিকে ইউআই ভাষা হিসাবেও উল্লেখ করা যেতে পারে। ইউটিউব ওয়েবসাইটের জন্য, গুগল অ্যাকাউন্ট সেটিংস, ব্রাউজার ভাষা বা আইপি অবস্থানের ভিত্তিতে একটি অ্যাপ্লিকেশন ভাষা স্বয়ংক্রিয়ভাবে নির্বাচন করা যেতে পারে এবং কোনও ব্যবহারকারী ইউটিউব সাইট ফুটার থেকে ম্যানুয়ালি পছন্দসই ইউআই ভাষা নির্বাচন করতে পারে।এপিআই সমর্থিত অ্যাপ্লিকেশন ভাষাগুলি তালিকাভুক্ত করার জন্য একটি পদ্ধতি সমর্থন করে। সমর্থিত ভাষাগুলি
hl
প্যারামিটারের মান হিসাবে ব্যবহার করা যেতে পারে যখনvideoCategories.list
এবংguideCategories.list
মতো এপিআই পদ্ধতিগুলি কল করে।নতুন
i18nRegion
রিসোর্স একটি ভৌগলিক অঞ্চল চিহ্নিত করে যা কোনও ইউটিউব ব্যবহারকারী পছন্দসই সামগ্রী অঞ্চল হিসাবে নির্বাচন করতে পারে। সামগ্রী অঞ্চলটিকে সামগ্রী লোকেল হিসাবেও উল্লেখ করা যেতে পারে। ইউটিউব ওয়েবসাইটের জন্য, ইউটিউব ডোমেন বা ব্যবহারকারীর আইপি অবস্থানের মতো হিউরিস্টিক্সের ভিত্তিতে একটি সামগ্রী অঞ্চল স্বয়ংক্রিয়ভাবে নির্বাচন করা যেতে পারে এবং কোনও ব্যবহারকারী ইউটিউব সাইট ফুটার থেকে ম্যানুয়ালি পছন্দসই সামগ্রী অঞ্চল নির্বাচন করতে পারে।এপিআই সমর্থিত সামগ্রী অঞ্চলগুলি তালিকাভুক্ত করার জন্য একটি পদ্ধতি সমর্থন করে। সমর্থিত অঞ্চল কোডগুলি
search.list
,videos.list
,activities.list
এবংvideoCategories.list
মতো এপিআই পদ্ধতিগুলি কল করার সময়regionCode
প্যারামিটারের মান হিসাবে ব্যবহার করা যেতে পারে।
এপ্রিল 7, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
channelSection
রিসোর্সে কোনও চ্যানেল বৈশিষ্ট্যযুক্ত ভিডিওগুলির একটি সেট সম্পর্কিত তথ্য রয়েছে। উদাহরণস্বরূপ, একটি বিভাগে একটি চ্যানেলের সর্বশেষ আপলোড, সর্বাধিক জনপ্রিয় আপলোড বা এক বা একাধিক প্লেলিস্টের ভিডিও বৈশিষ্ট্য থাকতে পারে।এপিআই চ্যানেল বিভাগগুলি তালিকা , সন্নিবেশ , আপডেট বা মুছতে পদ্ধতিগুলিকে সমর্থন করে। আপনি কোনও নির্দিষ্ট চ্যানেল আইডি নির্দিষ্ট করে, বা অনন্য চ্যানেল বিভাগের আইডিগুলির একটি তালিকা নির্দিষ্ট করে আপনি অনুমোদিত ব্যবহারকারীর চ্যানেলের জন্য চ্যানেল বিভাগগুলির একটি তালিকা পুনরুদ্ধার করতে পারেন।
এপিআই এই নতুন পদ্ধতির জন্য বিশেষভাবে সমর্থন করে এমন ত্রুটি বার্তাগুলি বর্ণনা করার জন্য ত্রুটি ডকুমেন্টেশনগুলিও আপডেট করা হয়েছে।
video
রিসোর্সেরfileDetails
অবজেক্টের সংজ্ঞাটি আপডেট করা হয়েছে যে ভিডিওরprocessingDetails.fileDetailsAvailability
ফাইলেডেটেলস্যাভিলিটি সম্পত্তিটিরavailable
মান থাকলে সেই অবজেক্টটি কেবল তখনই ফিরে আসবে।একইভাবে,
video
রিসোর্সেরsuggestions
অবজেক্টের সংজ্ঞাটি আপডেট করা হয়েছে যেavailable
processingDetails.tagSuggestionsAvailability
processingDetails.editorSuggestionsAvailability
videos.insert
জন্য ডকুমেন্টেশন.ইনসার্ট এবংvideos.update
পদ্ধতিগুলি আপডেট করা হয়েছে যে এই পদ্ধতিগুলি কল করার সময়status.publishAt
সম্পত্তি সেট করা যেতে পারে তা প্রতিফলিত করার জন্য আপডেট করা হয়েছে।channel
রিসোর্সেরinvideoPromotion
অবজেক্টের সংজ্ঞাটি ব্যাখ্যা করার জন্য আপডেট করা হয়েছে যে বস্তুটি কেবল চ্যানেলের মালিক দ্বারা পুনরুদ্ধার করা যেতে পারে।videos.rate
জন্য প্যারামিটার তালিকা.রেট পদ্ধতির প্রতিফলন করার জন্য আপডেট করা হয়েছে যে পদ্ধতিটি আসলেonBehalfOfContentOwner
প্যারামিটারটিকে সমর্থন করে না। এটিvideos.rate
হিসাবে একটি ডকুমেন্টেশন ত্রুটি ছিল Ret রেট অনুরোধগুলি যা এই প্যারামিটারটি500
ত্রুটি দেয়।
মার্চ 31, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
video
রিসোর্সের নতুনstatus.publishAt
সম্পত্তি আপনাকে কোনও ব্যক্তিগত ভিডিও প্রকাশিত হওয়ার সময় নির্ধারিত হওয়ার তারিখ এবং সময় নির্দিষ্ট করতে দেয়। এই সম্পত্তিটি কেবল তখনই সেট করা যেতে পারে যদি ভিডিওর গোপনীয়তার স্থিতিprivate
থাকে এবং ভিডিওটি কখনও প্রকাশিত হয় না। এই নতুন সম্পত্তি অবমূল্যায়ন নীতি সাপেক্ষে নয় ।
13 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
এপিআই এখন
channel
রিসোর্সের জন্যcontentOwnerDetails
অংশগুলি সমর্থন করে। নতুন অংশে চ্যানেল ডেটা রয়েছে যা চ্যানেলের সাথে সংযুক্ত ইউটিউব অংশীদারদের জন্য প্রাসঙ্গিক, চ্যানেলের সাথে যুক্ত সামগ্রীর মালিকের আইডি এবং সামগ্রীর মালিক এবং চ্যানেলটি সংযুক্ত থাকাকালীন তারিখ এবং সময় সহ। নোট করুন যে এই নতুন অংশটি অবমূল্যায়ন নীতি সাপেক্ষে নয় ।ডকুমেন্টেশন এখন নিম্নলিখিত বৈশিষ্ট্যগুলির জন্য সর্বাধিক সমর্থিত চরিত্রের দৈর্ঘ্য তালিকাভুক্ত করে:
সম্পদ সম্পত্তি সর্বোচ্চ দৈর্ঘ্য channel
invideoPromotion.items[].customMessage
40টি অক্ষর video
snippet.title
100টি অক্ষর video
snippet.description
5000 বাইট video
snippet.tags
500 অক্ষর। নোট করুন যে সম্পত্তির মানটি একটি তালিকা এবং তালিকার আইটেমগুলির মধ্যে কমা সীমাটির দিকে গণনা করে। channel
রিসোর্সেরbrandingSettings.watch.featuredPlaylistId
সম্পত্তিটি অবমূল্যায়ন করা হয়েছে। আপনি যদি এর মান নির্ধারণের চেষ্টা করেন তবে এপিআই একটি ত্রুটি ফিরিয়ে দেবে।নিম্নলিখিত
video
রিসোর্স বৈশিষ্ট্যগুলি কোনও ভিডিও সন্নিবেশ বা আপডেট করার সময় সেট করা যেতে পারে এমন মানগুলির তালিকায় যুক্ত করা হয়েছে:ত্রুটি ডকুমেন্টেশন এখন প্রতিটি ত্রুটি প্রকারের জন্য HTTP প্রতিক্রিয়া কোড নির্দিষ্ট করে।
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
invalidCriteria
channels.list
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদি অনুরোধটি ফিল্টার পরামিতিগুলি নির্দিষ্ট করে যা একে অপরের সাথে একত্রে ব্যবহার করা যায় না।badRequest (400)
channelTitleUpdateForbidden
channels.update
পদ্ধতি এই ত্রুটিটি ফিরিয়ে দেয় যদি আপনি কোনও চ্যানেলেরbrandingSettings
অংশ আপডেট করার চেষ্টা করেন এবংbrandingSettings.channel.title
সম্পত্তিটির মান পরিবর্তন করেন। (নোট করুন যে আপনি সম্পত্তি বাদ দিলে এপিআই ত্রুটিটি ফেরত দেয় না))badRequest (400)
invalidRecentlyUploadedBy
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদিinvideoPromotion.items[].id.recentlyUploadedBy
সম্পত্তি একটি অবৈধ চ্যানেল আইডি নির্দিষ্ট করে।badRequest (400)
invalidTimingOffset
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদিinvideoPromotion
অংশটি একটি অবৈধ সময় অফসেট নির্দিষ্ট করে।badRequest (400)
tooManyPromotedItems
channels.update
পদ্ধতিটি যদিinvideoPromotion
অংশটি প্রচারিত আইটেমগুলির অনুমোদিত সংখ্যার চেয়ে বেশি নির্দিষ্ট করে তবে এই ত্রুটিটি ফেরত দেয়।forbidden (403)
promotedVideoNotAllowed
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদিinvideoPromotion.items[].id.videoId
সম্পত্তি একটি ভিডিও আইডি নির্দিষ্ট করে যা হয় খুঁজে পাওয়া যায় না বা প্রচারিত আইটেম হিসাবে ব্যবহার করা যায় না।forbidden (403)
websiteLinkNotAllowed
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদিinvideoPromotion.items[].id.websiteUrl
সম্পত্তি একটি ইউআরএল নির্দিষ্ট করে যা অনুমোদিত নয়।required (400)
requiredTimingType
channels.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয় যদি কোনও অনুরোধটি ইউটিউব কখন প্রচারিত আইটেম প্রদর্শন করা উচিত তার জন্য ডিফল্ট সময় সেটিংস নির্দিষ্ট না করে।required (400)
requiredTiming
channels.update
পদ্ধতিটি অবশ্যই একটিinvideoPromotion.items[].timing
অবজেক্ট।required (400)
requiredWebsiteUrl
channels.update
পদ্ধতিটি অবশ্যই প্রতিটি প্রচারিত আইটেমের জন্য একটিinvideoPromotion.items[].id.websiteUrl
badRequest (400)
invalidPublishAt
videos.insert
পদ্ধতিটি যদি অনুরোধ মেটাডেটা কোনও অবৈধ নির্ধারিত প্রকাশের সময় নির্দিষ্ট করে তবে এই ত্রুটিটি ফেরত দেয়।
4 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব ডেটা এপিআই, ভি 3 এখন ইউটিউব এপিআইএস পরিষেবার শর্তাদি বর্ণিত অবমূল্যায়ন নীতি সাপেক্ষে। নোট করুন যে পৃষ্ঠাগুলি যে এপিআইগুলিকে তালিকাভুক্ত করে যা অবমূল্যায়ন নীতি সাপেক্ষে নির্দিষ্টভাবে কিছু ভি 3 এপিআই কার্যকারিতা নীতি সাপেক্ষে থেকে বাদ দেয়।
5 ডিসেম্বর, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
অনুসন্ধানের অনুরোধ জমা দেওয়ার সময় আপনাকে ঠিক একটি ফিল্টার প্যারামিটারের জন্য কোনও মান নির্দিষ্ট করার দরকার নেই তা সঠিকভাবে প্রতিফলিত করার জন্য
search.list
পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে। বরং আপনি শূন্য ফিল্টার প্যারামিটারগুলির জন্য বা একটি ফিল্টার প্যারামিটারের জন্য একটি মান সেট করতে পারেন।search.list
জন্য সংজ্ঞাগুলি.লিস্ট পদ্ধতির প্যারামিটারগুলি আপডেট করা হয়েছে যে আপনি যদি নিম্নলিখিত যে কোনও পরামিতিগুলির জন্য একটি মানও নির্দিষ্ট করে থাকেন তবে আপনাকে অবশ্যইvideo
type
প্যারামিটারের মান সেট করতে হবে তা নোট করার জন্য আপডেট করা হয়েছে:-
eventType
-
videoCaption
-
videoCategoryId
-
videoDefinition
-
videoDimension
-
videoDuration
-
videoEmbeddable
-
videoLicense
-
videoSyndicated
-
videoType
-
আপলোড করা চ্যানেল ব্যানার চিত্রগুলির সর্বনিম্ন আকারটি 1152px দ্বারা 2048px এ হ্রাস করা হয়েছে। (পূর্বে, ন্যূনতম আকারটি 1192px দ্বারা 2120px ছিল।) এছাড়াও, নোট করুন যে
channel
রিসোর্স ডকুমেন্টেশন এপিআই থেকে পরিবেশন করা সমস্ত ব্যানার চিত্রগুলির সর্বাধিক আকার নির্দিষ্ট করে। উদাহরণস্বরূপ, টেলিভিশন অ্যাপ্লিকেশনগুলির জন্যbrandingSettings.image.bannerTvImageUrl
চিত্রের সর্বাধিক আকার 1192px দ্বারা 2120px হয়, তবে আসল চিত্রটি 1152px দ্বারা 2048px হতে পারে। ইউটিউব সহায়তা কেন্দ্র বিভিন্ন ধরণের ডিভাইসে প্রদর্শনের জন্য চ্যানেল আর্টকে অনুকূলকরণের জন্য অতিরিক্ত গাইডেন্স সরবরাহ করে।নিম্নলিখিত তথ্যগুলি প্রতিফলিত করতে বেশ কয়েকটি
channel
রিসোর্স সম্পত্তি সংজ্ঞা আপডেট করা হয়েছে:-
brandingSettings.channel.description
সম্পত্তিটির মানটির সর্বাধিক দৈর্ঘ্য 1000 অক্ষর রয়েছে। -
brandingSettings.channel.featuredChannelsTitle
সম্পত্তিটির সর্বোচ্চ 30 টি অক্ষর রয়েছে। -
brandingSettings.channel.featuredChannelsUrls[]
সম্পত্তি এখন 100 টি চ্যানেল তালিকাভুক্ত করতে পারে। -
brandingSettings.channel.unsubscribedTrailer
সম্পত্তি মান, যদি সেট করা হয় তবে অবশ্যই চ্যানেলের মালিকের মালিকানাধীন একটি পাবলিক বা তালিকাভুক্ত ভিডিওর ইউটিউব ভিডিও আইডি নির্দিষ্ট করতে হবে।
-
channels.update
পদ্ধতি এখনinvideoPromotion.items[].promotedByContentOwner
এই সম্পত্তিটি প্রচারের সময় সামগ্রীর মালিকের নাম প্রদর্শিত হবে কিনা তা নির্দেশ করে। এটি কেবল তখনই সেট করা যেতে পারে যদি এপিআই অনুরোধ যা সম্পত্তির মান নির্ধারণ করে তা কন্টেন্টের মালিকের পক্ষেonBehalfOfContentOwner
মালিকের প্যারামিটার ব্যবহার করে তৈরি করা হয়।playlistItems.list
এবংplaylistItems.insert
পদ্ধতিগুলি এখনonBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত।contentDetails.contentRating.acbRating
সম্পত্তি এখন চলচ্চিত্রের জন্য অস্ট্রেলিয়ান শ্রেণিবদ্ধকরণ বোর্ড (এসিবি) থেকে বা অস্ট্রেলিয়ান যোগাযোগ ও মিডিয়া কর্তৃপক্ষের (এসিএমএ) থেকে শিশুদের টেলিভিশন প্রোগ্রামিংয়ের জন্য একটি রেটিং নির্দিষ্ট করতে পারে।নতুন
contentDetails.contentRating.catvRating
এবংcontentDetails.contentRating.catvfrRating
বৈশিষ্ট্যগুলি কানাডিয়ান টিভি শ্রেণিবদ্ধকরণ সিস্টেমের অধীনে প্রাপ্ত একটি ভিডিও এবং ফরাসি ভাষার রেজি ডু সিনেমা রেটিং সিস্টেমের অধীনে যে রেটিংগুলি যথাক্রমে কোয়েবেকে ব্যবহৃত হয় তা চিহ্নিত করে।videoCategory
রিসোর্সের নতুনsnippet.assignable
সম্পত্তিটি নির্দেশ করে যে আপডেট হওয়া ভিডিওগুলি বা নতুন আপলোড করা ভিডিওগুলি সেই ভিডিও বিভাগের সাথে যুক্ত হতে পারে কিনা।নিম্নলিখিত পদ্ধতির জন্য কোড নমুনা যুক্ত করা হয়েছে:
-
activities.insert
(গো) -
channelBanners.insert
(পাইথন) -
channels.update
(পাইথন) -
playlistItems.list
(গো) -
search.list
(গো) -
thumbnails.set
(জাভা) -
videos.insert
(গো)
-
অক্টোবর 24, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
এপিআইতে সরাসরি সম্প্রচারিত সামগ্রীগুলি সন্ধান এবং বৈশিষ্ট্যযুক্ত করতে সহায়তা করার জন্য ডিজাইন করা দুটি অতিরিক্ত বৈশিষ্ট্য অন্তর্ভুক্ত রয়েছে:
অনুসন্ধান ফলাফলগুলিতে নতুন
snippet.liveBroadcastContent
সম্পত্তিটি নির্দেশ করে যে কোনও ভিডিও বা চ্যানেল রিসোর্সে সরাসরি সম্প্রচারিত সামগ্রী রয়েছে কিনা। বৈধ সম্পত্তি মানupcoming
,active
এবংnone
।video
রিসোর্সের নতুনsnippet.liveBroadcastContent
কনটেন্ট সম্পত্তিটি ভিডিওটি আসন্ন বা সক্রিয় লাইভ সম্প্রচার কিনা তা নির্দেশ করে। নীচের তালিকাটি সম্পত্তির সম্ভাব্য মানগুলি ব্যাখ্যা করে:-
upcoming
- ভিডিওটি একটি লাইভ সম্প্রচার যা এখনও শুরু হয়নি। -
active
- ভিডিওটি একটি চলমান লাইভ সম্প্রচার। -
none
- ভিডিওটি আসন্ন বা সক্রিয় লাইভ সম্প্রচার নয়। এটি সম্পূর্ণ সম্প্রচারের জন্য সম্পত্তি মান হবে যা ইউটিউবে এখনও দেখা যায়।
-
video
রিসোর্সের নতুনliveStreamingDetails
সম্পত্তিটি এমন একটি বস্তু যা একটি লাইভ ভিডিও সম্প্রচার সম্পর্কে মেটাডেটা ধারণ করে। এই মেটাডেটা পুনরুদ্ধার করতে,part
প্যারামিটার মানটির সংস্থানগুলির অংশগুলির তালিকায়liveStreamingDetails
অন্তর্ভুক্ত করুন। মেটাডেটাতে নিম্নলিখিত নতুন বৈশিষ্ট্যগুলি অন্তর্ভুক্ত রয়েছে:-
liveStreamingDetails.actualStartTime
- সম্প্রচারটি আসলে শুরু হয়েছিল। (সম্প্রচারের অবস্থাactive
হয়ে গেলে এই মানটি উপস্থিত থাকবে)) -
liveStreamingDetails.actualEndTime
- সম্প্রচারটি আসলে শেষ হয়েছিল। (সম্প্রচার শেষ হয়ে গেলে এই মানটি উপস্থিত থাকবে)) -
liveStreamingDetails.scheduledStartTime
- সম্প্রচারটি যে সময়টি শুরু হওয়ার সময় নির্ধারিত হয়েছে। -
liveStreamingDetails.scheduledEndTime
- সম্প্রচারটি যে সময়টি শেষ হওয়ার কথা রয়েছে। যদি সম্পত্তির মানটি খালি থাকে বা সম্পত্তি উপস্থিত না থাকে তবে সম্প্রচারটি অনির্দিষ্টকালের জন্য চলার কথা রয়েছে। -
liveStreamingDetails.concurrentViewers
- লাইভ সম্প্রচার দেখছেন এমন লোকের সংখ্যা।
এই মেটাডেটা পুনরুদ্ধার করতে
videos.update
videos.list
কল করার সময়part
প্যারামিটার মানটিতেliveStreamingDetails
অন্তর্ভুক্ত করুনvideos.insert
-
নোট করুন যে লাইভ ব্রডকাস্ট সামগ্রী সনাক্তকরণের জন্য আরও দুটি বৈশিষ্ট্য 1 অক্টোবর, 2013 এ প্রকাশিত হয়েছিল -
search.list
পদ্ধতিরeventType
প্যারামিটার এবং অনুসন্ধানের ফলাফলেরsnippet.liveBroadcastContent
কনটেন্ট সম্পত্তি।videos.insert
পদ্ধতিটি এখনnotifySubscribers
প্যারামিটারকে সমর্থন করে, যা ইউটিউবকে ভিডিওর চ্যানেলে সাবস্ক্রাইব করা ব্যবহারকারীদের কাছে নতুন ভিডিও সম্পর্কে একটি বিজ্ঞপ্তি প্রেরণ করা উচিত কিনা তা নির্দেশ করে। প্যারামিটারের ডিফল্ট মানটিTrue
, যা ইঙ্গিত করে যে গ্রাহকরা নতুন আপলোড করা ভিডিও সম্পর্কে অবহিত করা হবে। তবে, চ্যানেলের মালিক যিনি অনেকগুলি ভিডিও আপলোড করছেন তিনি চ্যানেলের গ্রাহকদের কাছে প্রতিটি নতুন ভিডিও সম্পর্কে একটি বিজ্ঞপ্তি প্রেরণ এড়াতেFalse
মান সেট করতে পছন্দ করতে পারেন।channels.update
কল করার সময় সংশোধন করা যেতে পারে এমন বৈশিষ্ট্যগুলির তালিকা.পুটেট পদ্ধতিটিinvideoPromotion.items[].customMessage
invideoPromotion.items[].websiteUrl
তদতিরিক্ত, তালিকাটি পরিবর্তনযোগ্যbrandingSettings
বৈশিষ্ট্যগুলি সনাক্ত করতে পরিবর্তন করা হয়েছে। এইbrandingSettings
বৈশিষ্ট্যগুলি ইতিমধ্যে সংশোধনযোগ্য ছিল, সুতরাং ডকুমেন্টেশন পরিবর্তনটি এপিআইয়ের বিদ্যমান কার্যকারিতাতে কোনও পরিবর্তন প্রতিফলিত করে না।playlists.insert
,playlists.update
এবংplaylists.delete
পদ্ধতিগুলি এখনonBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত।playlists.insert
পদ্ধতিটি এখনonBehalfOfContentOwnerChannel
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত।video
TV-14
contentDetails.contentRating.tvpgRating
pg14
snippet.liveBroadcastContent
সম্পত্তি, যা অনুসন্ধানের ফলাফলের অংশ, এর সংজ্ঞা সংশোধন করা হয়েছে যেlive
একটি বৈধ সম্পত্তি মান, তবেactive
কোনও বৈধ সম্পত্তি মান নয়।video
রিসোর্সেরcontentDetails.contentRating.mibacRating
সম্পত্তি এখন দুটি অতিরিক্ত রেটিং সমর্থন করে:-
mibacVap
(ভিএপি) - বাচ্চাদের সাথে একজন প্রাপ্তবয়স্কদের সাথে থাকতে হবে। -
mibacVm6
(ভিএম 6) - 6 এবং তার বেশি সীমাবদ্ধ। -
mibacVm12
(ভিএম 12) - 12 বা তার বেশি সীমাবদ্ধ।
-
channel
রিসোর্সের নতুনinvideoPromotion.items[].promotedByContentOwner
সম্পত্তিটি নির্দেশ করে যে প্রচারটি প্রদর্শন করার সময় সামগ্রীর মালিকের নাম প্রদর্শিত হবে কিনা। এই ক্ষেত্রটি কেবল তখনই সেট করা যেতে পারে যদি এপিআই অনুরোধটি সেট করে যে মানটি সেট করে সামগ্রী মালিকের পক্ষে করা হচ্ছে। আরও তথ্যের জন্যonBehalfOfContentOwner
প্যারামিটারটি দেখুন।
1 অক্টোবর, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সের নতুনauditDetails
অবজেক্টে চ্যানেল ডেটা রয়েছে যা কোনও মাল্টিচ্যানেল নেটওয়ার্ক (এমসিএন) কোনও নির্দিষ্ট চ্যানেল গ্রহণ বা প্রত্যাখ্যান করবে কিনা তা নির্ধারণের সময় মূল্যায়ন করবে। নোট করুন যে যে কোনও এপিআই অনুরোধ যা এই সংস্থান অংশটি পুনরুদ্ধার করে তা অবশ্যই একটি অনুমোদনের টোকেন সরবরাহ করতে হবে যাতেhttps://www.googleapis.com/auth/youtubepartner-channel-audit
স্কোপ রয়েছে। এছাড়াও, এমসিএন যখন চ্যানেলটি গ্রহণ বা প্রত্যাখ্যান করার সিদ্ধান্ত নেয় বা টোকেন জারি করার তারিখের দুই সপ্তাহের মধ্যে যখন সিদ্ধান্ত নেয় তখন সেই সুযোগটি ব্যবহার করে এমন কোনও টোকেন অবশ্যই বাতিল করা উচিত।channel
রিসোর্সেরinvideoPromotion.items[].id.type
সম্পত্তি এখনrecentUpload
একটি মান সমর্থন করে, যা ইঙ্গিত দেয় যে প্রচারিত আইটেমটি একটি নির্দিষ্ট চ্যানেল থেকে সর্বাধিক আপলোড করা ভিডিও।ডিফল্টরূপে, চ্যানেলটি একই রকমের জন্য যা ইন-ভিডিও প্রচারের ডেটা সেট করা আছে। তবে, আপনি সেই চ্যানেলের জন্য চ্যানেল আইডিতে নতুন
invideoPromotion.items[].id.recentlyUploadedBy
channel
রিসোর্সে তিনটি নতুন বৈশিষ্ট্য রয়েছে -brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
আইমেজুরল,brandingSettings.image.bannerTvHighImageUrl
- যা চ্যানেল পেজগুলিতে চ্যানেল পেজগুলিতে প্রদর্শিত ব্যানার চিত্রগুলির জন্য ইউআরএলগুলি নির্দিষ্ট করে।অনুসন্ধান ফলাফলগুলিতে নতুন
snippet.liveBroadcastContent
সম্পত্তিটি নির্দেশ করে যে কোনও ভিডিও বা চ্যানেল রিসোর্সে সরাসরি সম্প্রচারিত সামগ্রী রয়েছে কিনা। বৈধ সম্পত্তি মানupcoming
,active
এবংnone
।- একটি
video
রিসোর্সের জন্য,upcoming
একটি মান ইঙ্গিত দেয় যে ভিডিওটি একটি লাইভ সম্প্রচার যা এখনও শুরু হয়নি, যখনactive
একটি মান ইঙ্গিত দেয় যে ভিডিওটি একটি চলমান লাইভ সম্প্রচার। - একটি
channel
রিসোর্সের জন্য,upcoming
একটি মান ইঙ্গিত দেয় যে চ্যানেলের একটি নির্ধারিত সম্প্রচার রয়েছে যা এখনও শুরু হয়নি, যখনacive
একটি মান ইঙ্গিত দেয় যে চ্যানেলটির একটি চলমান লাইভ সম্প্রচার রয়েছে।
- একটি
watermark
রিসোর্সে,targetChannelId
সম্পত্তিটি কোনও বস্তু থেকে একটি স্ট্রিংয়ে পরিবর্তিত হয়েছে। চ্যানেলের ইউটিউব চ্যানেল আইডি নির্দিষ্ট করে এমন একটি শিশু সম্পত্তি রাখার পরিবর্তে ওয়াটারমার্ক চিত্রটি লিঙ্ক করে,targetChannelId
সম্পত্তিটি এখন সেই মানটি নির্দিষ্ট করে। তদনুসারে, রিসোর্সেরtargetChannelId.value
সম্পত্তি সরানো হয়েছে।thumbnails.set
পদ্ধতিটি এখনonBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত।search.list
পদ্ধতিটি এখনeventType
প্যারামিটারটিকে সমর্থন করে, যা কেবল সক্রিয়, আসন্ন বা সমাপ্ত সম্প্রচারিত ইভেন্টগুলি ফিরে আসতে অনুসন্ধানকে সীমাবদ্ধ করে।নতুন
contentDetails.contentRating.mibacRating
সম্পত্তিটি ইতালির মন্ত্রী দেই বেনি ই ডেলি অ্যাটিভিটা কালচারালি ই ডেল তুরিসমোর কাছ থেকে প্রাপ্ত একটি ভিডিও রেটিং চিহ্নিত করে।এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest
invalidImage
thumbnails.set
পদ্ধতি সরবরাহ করা চিত্রের সামগ্রীটি যদি অবৈধ থাকে তবে এই ত্রুটিটি ফেরত দেয়।forbidden
videoRatingDisabled
videos.rate
পদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যদি ভিডিওটির মালিক যে রেট করা হচ্ছে তার মালিককে সেই ভিডিওর জন্য অক্ষম রেটিং রয়েছে।
আগস্ট 27, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
watermark
রিসোর্স একটি চিত্র চিহ্নিত করে যা একটি নির্দিষ্ট চ্যানেলের ভিডিওগুলির প্লেব্যাকগুলির সময় প্রদর্শিত হয়। আপনি এমন একটি লক্ষ্য চ্যানেলও নির্দিষ্ট করতে পারেন যেখানে চিত্রটি লিঙ্ক করবে সেই সাথে টাইমিং বিশদগুলি যা ভিডিও প্লেব্যাকগুলির সময় ওয়াটারমার্কটি কখন প্রদর্শিত হয় এবং এটি দৃশ্যমান সময়ের দৈর্ঘ্যের দৈর্ঘ্য নির্ধারণ করে।watermarks.set
পদ্ধতি একটি চ্যানেলের ওয়াটারমার্ক চিত্র আপলোড এবং সেট করে।watermarks.unset
পদ্ধতি একটি চ্যানেলের ওয়াটারমার্ক চিত্র মুছে দেয়।ত্রুটি ডকুমেন্টেশন ত্রুটি বার্তাগুলি বর্ণনা করে যা এপিআই বিশেষত
watermarks.set
এবংwatermarks.unset
পদ্ধতিগুলির জন্য সমর্থন করে।channel
রিসোর্সের নতুনstatistics.hiddenSubscriberCount
H যেমন, চ্যানেলের গ্রাহক গণনা প্রকাশ্যে দৃশ্যমান হলে সম্পত্তির মানটিfalse
।playlists.list
পদ্ধতিটি এখনonBehalfOfContentOwner
এবংonBehalfOfContentOwnerChannel
প্যারামিটারগুলিকে সমর্থন করে। উভয় পরামিতি ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য সমর্থিত।videos.list
পদ্ধতিটি এখনregionCode
প্যারামিটারকে সমর্থন করে, যা সামগ্রী অঞ্চলটিকে চিহ্নিত করে যার জন্য একটি চার্ট পুনরুদ্ধার করা উচিত। এই প্যারামিটারটি কেবলchart
প্যারামিটারের সাথে একত্রে ব্যবহার করা যেতে পারে। প্যারামিটার মানটি একটি আইএসও 3166-1 আলফা -2 দেশ কোড।error documentation
নিম্নলিখিত নতুন সাধারণ অনুরোধ ত্রুটি বর্ণনা করে, যা একাধিক এপিআই পদ্ধতির জন্য ঘটতে পারে:ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা forbidden
insufficientPermissions
অনুরোধের জন্য প্রদত্ত OAuth 2.0 টোকেনের সাথে যুক্ত স্কোপগুলি অনুরোধ করা ডেটা অ্যাক্সেস করার জন্য অপর্যাপ্ত।
আগস্ট 15, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channel
রিসোর্সেরinvideoPromotion
অবজেক্টটিতে নিম্নলিখিত নতুন এবং আপডেট হওয়া বৈশিষ্ট্য রয়েছে:এপিআই এখন প্রচারিত আইটেম হিসাবে কোনও ওয়েবসাইট নির্দিষ্ট করার ক্ষমতা সমর্থন করে। এটি করার জন্য,
invideoPromotion.items[].id.type
সম্পত্তি মানwebsite
সেট করুন এবং ইউআরএল নির্দিষ্ট করতে নতুনinvideoPromotion.items[].id.websiteUrl
প্রচারের জন্য প্রদর্শনের জন্য একটি কাস্টম বার্তা সংজ্ঞায়িত করতেinvideoPromotion.items[].customMessage
লিঙ্কগুলি সম্পর্কিত ওয়েবসাইট, বণিক সাইট বা সামাজিক নেটওয়ার্কিং সাইটগুলিতে হতে পারে। আপনার সামগ্রীর জন্য লিঙ্কগুলি সক্ষম করার বিষয়ে আরও তথ্যের জন্য সম্পর্কিত ওয়েবসাইট এবং বণিক সাইটগুলির জন্য ইউটিউব সহায়তা কেন্দ্রের নির্দেশাবলী দেখুন।
প্রচারমূলক লিঙ্কগুলি যুক্ত করে আপনি সম্মত হন যে এই লিঙ্কগুলি অননুমোদিত সাইটগুলিতে ট্র্যাফিক পুনর্নির্দেশ করতে ব্যবহৃত হবে না এবং এই লিঙ্কগুলি ইউটিউবের অ্যাডওয়ার্ডস নীতি , ইউটিউব বিজ্ঞাপন নীতি , ইউটিউব সম্প্রদায়ের নির্দেশিকা এবং ইউটিউব পরিষেবার শর্তাদি মেনে চলবে।
ভিডিও প্লেব্যাক চলাকালীন প্রচারিত আইটেমগুলি প্রদর্শনের জন্য টাইমিং সেটিংস সম্পর্কিত বৈশিষ্ট্যগুলি পুনর্গঠন করা হয়েছে:
invideoPromotion.timing
অবজেক্টটিinvideoPromotion.items[].timing
সরানো হয়েছে। এই অবজেক্টটি এখন আপনাকেinvideoPromotion.items[]
তালিকায় প্রতিটি প্রচারিত আইটেমের জন্য টাইমিং ডেটা কাস্টমাইজ করতে সক্ষম করে।নতুন
invideoPromotion.defaultTiming
অবজেক্টটি আপনার প্রচারের জন্য ডিফল্ট সময় সেটিংস নির্দিষ্ট করে। এই সেটিংস সংজ্ঞায়িত করে যখন কোনও প্রচারিত আইটেম আপনার চ্যানেলের কোনও ভিডিওর প্লেব্যাকের সময় প্রদর্শিত হবে। আপনিinvideoPromotion.items[].timing
অবজেক্ট ব্যবহার করে প্রদত্ত যে কোনও প্রচারিত আইটেমের জন্য ডিফল্ট সময়কে ওভাররাইড করতে পারেন।নতুন
invideoPromotion.items[].timing.durationMs
সম্পত্তি মিলিসেকেন্ডে সময়ের পরিমাণ নির্দিষ্ট করে, যে প্রচারটি প্রদর্শন করা উচিত। 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
This update contains the following changes:
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
This update contains the following changes:
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. Use thesubscriptions.list
method and itsmySubscribers
parameter to retrieve a list of subscribers to the authenticated user's channel.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
This update contains the following changes:
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. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.
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
This update contains the following changes:
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
This update contains the following changes:
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
This update contains the following changes:
YouTube আর পরীক্ষামূলক API বৈশিষ্ট্য এবং পরিষেবাগুলি সনাক্ত করে না৷ পরিবর্তে, আমরা এখন YouTube APIগুলির একটি তালিকা প্রদান করি যেগুলি অবচয় নীতির অধীন ৷
8 মে, 2013
This update contains the following changes:
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
This update contains the following changes:
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
This update contains the following changes:
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.দেশ রেটিং সিস্টেম সম্পত্তি মার্কিন যুক্তরাষ্ট্র আমেরিকার মোশন পিকচার অ্যাসোসিয়েশন (MPAA) contentDetails.contentRating.mpaaRating
মার্কিন যুক্তরাষ্ট্র টিভি অভিভাবকীয় নির্দেশিকা contentDetails.contentRating.tvpgRating
অস্ট্রেলিয়া অস্ট্রেলিয়ান ক্লাসিফিকেশন বোর্ড (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
গ্রেট ব্রিটেন ব্রিটিশ বোর্ড অফ ফিল্ম ক্লাসিফিকেশন (বিবিএফসি) 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
নিউজিল্যান্ড Office of Film and Literature Classification 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
This update contains the following changes:
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.
The
onBehalfOfContentOwner
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. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.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
This update contains the following changes:
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
This update contains the following changes:
The new error page lists errors that the API can return. পৃষ্ঠাটিতে সাধারণ ত্রুটি রয়েছে, যা একাধিক ভিন্ন API পদ্ধতির পাশাপাশি পদ্ধতি-নির্দিষ্ট ত্রুটির জন্য ঘটতে পারে।
16 জানুয়ারী, 2013
This update contains the following changes:
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
ডিগ্রীতে অক্ষাংশ। video
recordingDetails.location.longitude
double
ডিগ্রীতে দ্রাঘিমাংশ। 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.বেশ কিছু API পদ্ধতি নতুন ত্রুটি প্রকার সমর্থন করে। নীচের টেবিলটি পদ্ধতি এবং নতুন সমর্থিত ত্রুটিগুলি সনাক্ত করে:
পদ্ধতি ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা 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.