এই পৃষ্ঠাটি YouTube ডেটা API (v3) পরিবর্তন এবং ডকুমেন্টেশন আপডেটগুলি তালিকাভুক্ত করে৷ এই চেঞ্জলগে সাবস্ক্রাইব করুন । 
10 জুলাই, 2025
21 জুলাই, 2025 থেকে, YouTube video.list পদ্ধতির mostPopular চার্ট দ্বারা ফেরত দেওয়া সামগ্রীগুলিকে সামঞ্জস্য করবে৷ অতীতে, mostPopular চার্ট এখন ট্রেন্ডিং তালিকায় থাকা ভিডিওগুলিকে প্রতিফলিত করেছিল৷ এখন, mostPopular চার্টে ট্রেন্ডিং মিউজিক, মুভি এবং গেমিং চার্ট থেকে ভিডিওগুলি দেখানো হবে৷ এই API পরিবর্তনটি YouTube-এর প্রবণতা পৃষ্ঠার অবচয়নের সাথে মিলিত হয়েছে৷
26 মার্চ, 2025
31 মার্চ, 2025 থেকে, YouTube কীভাবে Shorts-এর ভিউ গণনা করা হবে তা পরিবর্তন করবে। অতীতে, Shorts-এর জন্য, একটি নির্দিষ্ট সংখ্যক সেকেন্ডের জন্য Short খেলার পরে একটি ভিউ গণনা করা হত। এখন, দেখার সংখ্যা গণনা করা হবে যতবার আপনার Short প্লে হতে শুরু করবে বা রিপ্লে করবে, কোন ন্যূনতম দেখার সময়ের প্রয়োজন নেই। আরও জানুন
31 মার্চ, 2025 থেকে, Data API-এর নিম্নলিখিত ক্ষেত্রগুলি এই পরিবর্তন অনুসারে Shorts-এর ভিউ কাউন্ট ফিরিয়ে দেবে:
-
channels.statistics.viewCount -
videos.statistics.viewCount
অক্টোবর 30, 2024
API এখন বাস্তবসম্মত পরিবর্তিত বা সিন্থেটিক ( A/S ) বিষয়বস্তু ধারণ করে এমন ভিডিও শনাক্ত করার ক্ষমতা সমর্থন করে। A/S বিষয়বস্তু সম্পর্কিত YouTube নীতি সম্পর্কে আরও জানুন।
A/S বিষয়বস্তুর উদাহরণগুলির মধ্যে এমন ভিডিও অন্তর্ভুক্ত রয়েছে যা:
- একজন প্রকৃত ব্যক্তিকে এমন কিছু বলতে বা করতে দেখান যা তিনি আসলে বলেননি বা করেননি
- একটি বাস্তব ঘটনা বা স্থানের ফুটেজ পরিবর্তন করুন
- বাস্তবে ঘটেনি এমন একটি বাস্তবসম্মত দৃশ্য তৈরি করুন
একটি ভিডিওতে A/S সামগ্রী রয়েছে কিনা তা নির্দেশ করতে, status.containsSyntheticMedia বৈশিষ্ট্য সেট করুন৷ videos.insert বা videos.update পদ্ধতিতে কল করার সময় এই সম্পত্তি সেট করা যেতে পারে। সেট করা থাকলে, video রিসোর্সে সম্পত্তি ফেরত দেওয়া হয়।
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 থেকে ব্যক্তিগত করা হবে। এর মানে হল যে যদি API অনুরোধটি ভিডিওর মালিকের দ্বারা প্রমাণীকৃত হয় তাহলে ভিডিওগুলিকে শুধুমাত্র videos.list শেষ পয়েন্ট থেকে একটি API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে।
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 প্রকল্পগুলি একটি কমপ্লায়েন্স অডিটে ব্যর্থ হয়েছে (বা একটি কোটা ইউনিট বৃদ্ধি অস্বীকার করা হয়েছে) তারা এই ফর্মটি পূরণ করতে এবং জমা দিতে পারেন৷
- কন্ট্রোল ফর্মের পরিবর্তন : ডেভেলপারদের, বা যে কোনও পক্ষ একজন ডেভেলপারের হয়ে 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ত্রুটি সমর্থন করে৷ ত্রুটিটি ঘটে যখন একটি অনুরোধ এমন একটি অপারেশন করার চেষ্টা করে যা একটি নির্দিষ্ট প্লেলিস্টের জন্য অনুমোদিত নয়৷ উদাহরণস্বরূপ, একজন ব্যবহারকারী তাদের আপলোড করা ভিডিও প্লেলিস্ট থেকে একটি ভিডিও মুছতে পারে না বা প্লেলিস্ট নিজেই মুছে ফেলতে পারে না।সব ক্ষেত্রে, এই ত্রুটিটি একটি
400HTTP প্রতিক্রিয়া কোড (খারাপ অনুরোধ) প্রদান করে।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.videoPublishedAtV রিসোর্সটিতে ইতিমধ্যেsnippet.publishedAtসম্পত্তি, যা আইটেমটি প্লেলিস্টে যুক্ত করার সময়টি চিহ্নিত করে। -
channelরিসোর্সের মতো,videoরিসোর্সটি এখনtopicDetails.topicCategories[]সম্পত্তি, এতে উইকিপিডিয়া ইউআরএলগুলির একটি তালিকা রয়েছে যা ভিডিওর সামগ্রী বর্ণনা করে।videoসংস্থানগুলির জন্য, ইউআরএলগুলি রিসোর্সেরtopicDetails.relevantTopicIds[]ফিরে আসা বিষয়গুলির সাথে সম্পর্কিত। -
videoরিসোর্সের নতুনcontentDetails.contentRating.mpaatRatingসম্পত্তিটি মোশন পিকচার অ্যাসোসিয়েশন অফ আমেরিকার একটি চলচ্চিত্রের ট্রেলার বা পূর্বরূপকে যে রেটিং দিয়েছে তা চিহ্নিত করে।
27 ফেব্রুয়ারি, 2017
মূলত 11 আগস্ট, 2016 এ ঘোষিত হিসাবে, ইউটিউব টপিক আইডির সমর্থিত তালিকাটি একটি সংশোধিত তালিকায় স্যুইচ করেছে। সমর্থিত টপিক আইডিগুলির সম্পূর্ণ তালিকা 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 এ প্রথম ঘোষিত হিসাবে, ফ্রিবেস এবং ফ্রিবেস এপিআই এর অবমূল্যায়নের জন্য টপিক আইডি সম্পর্কিত বেশ কয়েকটি পরিবর্তন প্রয়োজন। টপিক আইডিগুলি
channelএবংvideoসংস্থানগুলির সাথে সম্পর্কিত বিষয়গুলি সনাক্ত করে এবং আপনি কোনও নির্দিষ্ট বিষয়ের সাথে সম্পর্কিত চ্যানেল বা ভিডিওগুলি খুঁজে পেতেtopicIdঅনুসন্ধান প্যারামিটারটিও ব্যবহার করতে পারেন।10 ফেব্রুয়ারী, 2017 এ, ইউটিউব এতদূর ফিরে আসা আইডিগুলির আরও বেশি দানাদার সেটের পরিবর্তে বিষয় আইডির একটি ছোট সেট ফিরিয়ে দেওয়া শুরু করবে। তদতিরিক্ত, নোট করুন যে চ্যানেল এবং ভিডিওগুলি কোনও বিষয়ের সাথে যুক্ত হওয়ার গ্যারান্টিযুক্ত নয়, যা বর্তমান এপিআই আচরণের সাথে সামঞ্জস্যপূর্ণ।
যাতে আপনি এই পরিবর্তনগুলির জন্য আপনার এপিআই ক্লায়েন্টদের প্রস্তুত করতে পারেন, নিম্নলিখিত এপিআই প্যারামিটারগুলির সংজ্ঞাগুলি এবং বৈশিষ্ট্যগুলির সংজ্ঞাগুলি সেই সময়ের পরে সমর্থিত বিষয়গুলির আইডিগুলি তালিকাভুক্ত করতে আপডেট করা হয়েছে। নোট করুন যে বিভাগগুলির তালিকা সমস্ত বৈশিষ্ট্যের জন্য একই।
-
channelরিসোর্সেরtopicDetails.topicIds[]সম্পত্তি। -
videoরিসোর্সেরtopicDetails.relevantTopicIds[]সম্পত্তি। -
search.listপদ্ধতিরtopicIdপ্যারামিটার।
-
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
নিম্নলিখিত বৈশিষ্ট্যগুলি হ্রাস করা হচ্ছে:
-
channelরিসোর্সেরtopicDetails.topicIds[]সম্পত্তি। এই সম্পত্তি 10 নভেম্বর, 2017 পর্যন্ত সমর্থিত হবে। -
videoরিসোর্সেরtopicDetails.relevantTopicIds[]সম্পত্তি। এই সম্পত্তি 10 নভেম্বর, 2017 পর্যন্ত সমর্থিত হবে। -
videoরিসোর্সেরtopicDetails.topicIds[]সম্পত্তি। এই সম্পত্তিটিতে 10 ফেব্রুয়ারী, 2017topicDetails.relevantTopicIds[]পরে মান থাকবে না
-
যেহেতু ফ্রিবেস ইতিমধ্যে অবমূল্যায়ন করা হয়েছে, তাই ফ্রিবেস টপিকস গাইডের সাথে অনুসন্ধানটি ডকুমেন্টেশন থেকে সরানো হয়েছে। এই গাইডটি কোডের নমুনাগুলি সরবরাহ করেছে যাতে কোনও অ্যাপ্লিকেশন কীভাবে ফ্রিবেস এপিআইয়ের সাথে কাজ করবে তা দেখানোর জন্য।
তদ্ব্যতীত, বিষয় আইডি সম্পর্কিত বেশ কয়েকটি কোড নমুনা অনুসন্ধান থেকে সরানো হয়েছে
search.listপদ্ধতির ডকুমেন্টেশন।
নভেম্বর 2, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পত্তি এবং পরামিতি
videoরিসোর্সে বেশ কয়েকটি নতুন সম্পত্তি রয়েছে:player.embedHtmlসম্পত্তিটিতে একটি<iframe>ট্যাগ রয়েছে যা আপনি ভিডিওটি বাজানো কোনও খেলোয়াড়কে এম্বেড করতে ব্যবহার করতে পারেন। নতুনplayer.embedHeightএবংplayer.embedWidthবৈশিষ্ট্যগুলি এম্বেড থাকা প্লেয়ারের মাত্রাগুলি সনাক্ত করে। এই বৈশিষ্ট্যগুলি কেবল তখনই ফিরে আসে যদি এপিআই অনুরোধটি কমপক্ষেmaxHeightবাmaxWidthপ্যারামিটারগুলির মধ্যে একটির জন্য একটি মান নির্দিষ্ট করে। এই দুটি নতুন পরামিতি পরে এই সংশোধন ইতিহাস এন্ট্রিতে ব্যাখ্যা করা হয়েছে।নতুন
hasCustomThumbnailসম্পত্তিটি নির্দেশ করে যে ভিডিও আপলোডার ভিডিওটির জন্য একটি কাস্টম থাম্বনেইল চিত্র সরবরাহ করেছে কিনা। নোট করুন যে এই সম্পত্তিটি কেবল ভিডিও আপলোডারের কাছে দৃশ্যমান।নতুন
fpbRatingReasons[]ভিডিওটি তার এফপিবি (দক্ষিণ আফ্রিকা) রেটিং পেয়েছে এমন কারণগুলি চিহ্নিত করে।নতুন
mcstRatingভিয়েতনামে ভিডিওটি প্রাপ্ত রেটিংটি চিহ্নিত করে।
videos.listপদ্ধতি দুটি নতুন পরামিতি,maxHeightএবংmaxWidthসমর্থন করে।videoসংস্থানগুলিতেplayerঅংশটি পুনরুদ্ধার করার সময় আপনি প্যারামিটার বা উভয় পরামিতি ব্যবহার করতে পারেন।ডিফল্টরূপে,
player.embedHtmlফিরে<iframe>এর উচ্চতা embedhtml সম্পত্তি 360px। প্রস্থটি ভিডিওর দিক অনুপাতের সাথে মেলে সামঞ্জস্য করে, যার ফলে এম্বেড থাকা প্লেয়ারের ভিডিও ফ্রেমিং কালো বার নেই তা নিশ্চিত করে। সুতরাং, উদাহরণস্বরূপ, যদি কোনও ভিডিওর দিক অনুপাত 16: 9 হয় তবে প্লেয়ারের প্রস্থটি 640px হবে।নতুন পরামিতিগুলির সাহায্যে আপনি নির্দিষ্ট করতে পারেন যে ডিফল্ট মাত্রার পরিবর্তে এম্বেড কোডটি আপনার অ্যাপ্লিকেশন বিন্যাসের জন্য উপযুক্ত একটি উচ্চতা এবং/অথবা প্রস্থ ব্যবহার করা উচিত। এম্বেড থাকা প্লেয়ারের ভিডিওটি ফ্রেমিং করা কালো বার নেই তা নিশ্চিত করার জন্য এপিআই সার্ভারটি প্লেয়ারের মাত্রা যথাযথভাবে স্কেল করে। নোট করুন যে উভয় পরামিতি এম্বেড থাকা প্লেয়ারের সর্বাধিক মাত্রা নির্দিষ্ট করে। সুতরাং, যদি উভয় পরামিতি নির্দিষ্ট করা থাকে তবে একটি মাত্রা এখনও সেই মাত্রার জন্য অনুমোদিত সর্বাধিক পরিমাণের চেয়ে ছোট হতে পারে।
উদাহরণস্বরূপ, ধরুন কোনও ভিডিওতে 16: 9 দিক অনুপাত রয়েছে। সুতরাং,
player.embedHtmlট্যাগটিতেmaxHeightবাmaxWidthপ্যারামিটার সেট না থাকলে একটি 640x360 প্লেয়ার থাকবে।- যদি
maxHeightপ্যারামিটারটি720এ সেট করা থাকে এবংmaxWidthপ্যারামিটারটি সেট না করা থাকে তবে এপিআই একটি 1280x720 প্লেয়ার ফিরিয়ে দেবে। - যদি
maxWidthপ্যারামিটারটি960এ সেট করা থাকে এবংmaxHeightপ্যারামিটারটি সেট না করা থাকে তবে এপিআই একটি 960x540 প্লেয়ার ফিরিয়ে দেবে। - যদি
maxWidthপ্যারামিটারটি960এ সেট করা থাকে এবংmaxHeightপ্যারামিটারটি450এ সেট করা থাকে তবে এপিআই একটি 800x450 প্লেয়ার ফিরিয়ে দেবে।
নতুন
player.embedHeightএবংplayer.embedWidthবৈশিষ্ট্যগুলি, যা উপরে বর্ণিত হয়েছে, প্লেয়ারের মাত্রাগুলি চিহ্নিত করুন।- যদি
বিদ্যমান পদ্ধতি, বৈশিষ্ট্য এবং পরামিতিগুলির আপডেট
channelSectionরিসোর্স বিবরণটি নোট করার জন্য আপডেট করা হয়েছে যে একটি চ্যানেল লক্ষ্য নির্ধারণের ডেটা সেট না করে সর্বাধিক 10 টি তাক তৈরি করতে পারে এবং লক্ষ্যযুক্ত ডেটা সহ সর্বোচ্চ 100 টি তাক তৈরি করতে পারে।তদতিরিক্ত,
channelSectionরিসোর্সেরtargetingসম্পত্তিটি কেবলমাত্র এপিআই ব্যবহার করে সেট করা যেতে পারে তা প্রতিফলিত করার জন্য আপডেট করা হয়েছে। চ্যানেল বিভাগটি ইউটিউব ওয়েবসাইটে ব্যবহারকারী ইন্টারফেস ব্যবহার করে সংশোধন করা হলে টার্গেটিং বিকল্পগুলি মুছে ফেলা হয়।i18nLanguageরিসোর্সেরsnippet.nameসম্পত্তিটির সংজ্ঞাটি সংশোধন করা হয়েছে যে মানটি কোনও ভাষার নাম উপস্থাপন করে কারণ এটিi18nLanguage.listপদ্ধতিরhlপ্যারামিটার দ্বারা নির্দিষ্ট ভাষায় লেখা আছে।playlistItemরিসোর্সেরcontentDetails.noteনোট সম্পত্তিটি আপডেট করা হয়েছে যে সম্পত্তিটির মান সর্বাধিক দৈর্ঘ্য 280 অক্ষর।playlistItemরিসোর্সেরcontentDetails.startAtএবংcontentDetails.endAtবৈশিষ্ট্যগুলি হ্রাস করা হয়েছে। এই ক্ষেত্রগুলি যদিplaylistItems.insertবাplaylistItems.updateআইটেমগুলিতে সেট করা থাকে তবে সেগুলি উপেক্ষা করা হয় upplaylistItems.deleteএবংplaylistItems.updateপদ্ধতিগুলি এখনonBehalfOfContentOwnerপ্যারামিটারকে সমর্থন করে, যা ইতিমধ্যে অন্যান্য বেশ কয়েকটি পদ্ধতির জন্য ইতিমধ্যে সমর্থিত। সেই পদ্ধতিটি ব্যবহার করে এমন অনুরোধগুলিও একটি টোকেন দিয়ে অনুমোদিত হওয়া দরকার যাhttps://www.googleapis.com/auth/youtubepartnerস্কোপে অ্যাক্সেস সরবরাহ করে।প্যারামিটারের মানগুলি অন্তর্ভুক্ত রয়েছে তা নির্দেশ করার জন্য
search.listপদ্ধতিরpublishedBeforeএবংpublishedAfterপ্যারামিটারগুলি উভয়ই আপডেট করা হয়েছে। সুতরাং, উদাহরণস্বরূপ, যদিpublishedBeforeপ্যারামিটারটি সেট করা থাকে তবে এপিআই নির্দিষ্ট সময়ে বা নির্দিষ্ট সময়ে তৈরি করা সংস্থানগুলি ফেরত দেয়।videogrfilmK15contentDetails.contentRating.grfilmRatinggrfilmK12grfilmK18videos.insertপদ্ধতির বিবরণটি আপডেট করা হয়েছে যে আপলোড করা ভিডিওগুলির জন্য সর্বাধিক ফাইলের আকার 64 জিবি থেকে 128 গিগাবাইটে বেড়েছে।
নতুন এবং আপডেট ত্রুটি
API নিম্নলিখিত নতুন ত্রুটি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা forbidden (403)homeParameterDeprecatedactivities.listপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে এটি ব্যবহারকারীর হোম পৃষ্ঠার ক্রিয়াকলাপের ডেটা এই এপিআইয়ের মাধ্যমে উপলভ্য নয় তা নির্দেশ করে। আপনি যদি অননুমোদিত অনুরোধেhomeপ্যারামিটারটিtrueসেট করেন তবে এই ত্রুটিটি ঘটতে পারে।invalidValue (400)invalidContentDetailsplaylistItems.insertপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে অনুরোধেcontentDetailsঅবজেক্টটি অবৈধ। এই ত্রুটিটি হওয়ার একটি কারণ হ'লcontentDetails.noteনোট ক্ষেত্রটি 280 অক্ষরের চেয়ে দীর্ঘ।forbidden (403)watchHistoryNotAccessibleplaylistItems.listপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে অনুরোধটি "দেখুন ইতিহাস" প্লেলিস্ট আইটেমগুলি পুনরুদ্ধার করার চেষ্টা করেছিল, তবে সেগুলি এপিআই ব্যবহার করে পুনরুদ্ধার করা যায় না।forbidden (403)watchLaterNotAccessibleplaylistItems.listপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে অনুরোধটি "পরে দেখুন" প্লেলিস্ট আইটেমগুলি পুনরুদ্ধার করার চেষ্টা করেছিল, তবে সেগুলি এপিআই ব্যবহার করে পুনরুদ্ধার করা যায় না।badRequest (400)uploadLimitExceededvideos.insertপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে চ্যানেলটি এটি আপলোড করতে পারে এমন ভিডিওগুলির সংখ্যা ছাড়িয়ে গেছে তা নির্দেশ করে।forbidden (403)forbiddenEmbedSettingvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে এপিআই অনুরোধটি ভিডিওর জন্য একটি অবৈধ এম্বেড সেটিং সেট করার চেষ্টা করে। নোট করুন যে কিছু চ্যানেলের লাইভ স্ট্রিমের জন্য এম্বেড থাকা খেলোয়াড়দের অফার করার অনুমতি নাও থাকতে পারে। আরও তথ্যের জন্য ইউটিউব সহায়তা কেন্দ্র দেখুন।playlistItems.insertপদ্ধতি আর কোনও ত্রুটি ফেরত না যদি আপনি কোনও প্লেলিস্টে কোনও সদৃশ ভিডিও sert োকান। এই ত্রুটিটি আগে কিছু প্লেলিস্টের জন্য যেমন প্রিয় ভিডিওগুলির মতো ঘটেছিল, যা নকলকে অনুমতি দেয় না তবে তারা আর সমর্থিত হয় না। সাধারণভাবে, প্লেলিস্টগুলি সদৃশ ভিডিওগুলিকে অনুমতি দেয়।
অন্যান্য আপডেট
15
WLসেপ্টেম্বর, 2016 এর পুনর্বিবেচনার ইতিহাস এন্ট্রিটি স্পষ্টHLজন্য আপডেট করা হয়েছে যে, যখনইchannelরিসোর্সেরcontentDetails.relatedPlaylists.watchHistorycontentDetails.relatedPlaylists.watchLaterপ্লেএলিস্টস। তদুপরি, এই বৈশিষ্ট্যগুলি কেবল তখনই অন্তর্ভুক্ত থাকে যদি কোনও অনুমোদিত ব্যবহারকারী ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে।
15 সেপ্টেম্বর, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
১১ ই আগস্ট, ২০১ 2016, রিভিশন হিস্ট্রি আপডেটে বিষয়বস্তু আইডি সম্পর্কিত বেশ কয়েকটি পরিবর্তন নিয়ে আলোচনা করা হয়েছে, যার মধ্যে সমর্থিত বিষয় আইডিগুলির সেটটি ফেব্রুয়ারী 10, 2017 পর্যন্ত পরিবর্তিত হবে including
নিম্নলিখিত পরিবর্তনগুলি এখন কার্যকর। এই পরিবর্তনগুলির বিজ্ঞপ্তি 11 আগস্ট, 2016 এ পুনর্বিবেচনা ইতিহাস আপডেটে দেওয়া হয়েছিল:
যদি
activities.listপদ্ধতিটিhomeপ্যারামিটারের সাথেtrueসেট করা হয় তবে এপিআই প্রতিক্রিয়াতে এখন লগ-আউট ইউটিউব ব্যবহারকারী হোম পৃষ্ঠায় যা দেখবে তার অনুরূপ আইটেম রয়েছে।এটি একটি সামান্য পরিবর্তন যা 11 আগস্ট, 2016 -এ সংশোধন ইতিহাস আপডেটে বর্ণিত আচরণের চেয়ে আরও ভাল ব্যবহারকারীর অভিজ্ঞতা সরবরাহ করার উদ্দেশ্যে। এই আপডেটটি জানিয়েছে যে
homeপ্যারামিটার ব্যবহার করে অনুরোধগুলি একটি খালি তালিকা ফিরিয়ে দেবে।channelরিসোর্সেরcontentDetails.relatedPlaylists.watchHistoryWLcontentDetails.relatedPlaylists.watchLaterHLস্পষ্টতই, এই বৈশিষ্ট্যগুলি কেবল ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধারকারী কোনও অনুমোদিত ব্যবহারকারীর কাছে দৃশ্যমান। বৈশিষ্ট্যগুলিতে সর্বদা
HLএবংWLমানগুলি থাকে, এমনকি কোনও অনুমোদিত ব্যবহারকারী ব্যবহারকারীর নিজস্ব চ্যানেল সম্পর্কে ডেটা পুনরুদ্ধার করে। সুতরাং, ঘড়ির ইতিহাস এবং ঘড়ি পরে প্লেলিস্ট আইডিএস এপিআইয়ের মাধ্যমে পুনরুদ্ধার করা যায় না।এছাড়াও, একটি চ্যানেলের ঘড়ির ইতিহাসের জন্য প্লেলিস্ট বিশদ (
playlists.list) বা প্লেলিস্ট আইটেমগুলি (playlistItems.list) পুনরুদ্ধার করার অনুরোধ বা পরে প্লেলিস্ট এখন খালি তালিকাগুলি ফিরে আসে। এই আচরণটি নতুন মান,HLএবংWLপাশাপাশি কোনও ঘড়ির ইতিহাস বা পরে প্লেলিস্ট আইডিগুলির জন্য সত্য যা আপনার এপিআই ক্লায়েন্ট ইতিমধ্যে সংরক্ষণ করে থাকতে পারে।
videoরিসোর্সেরfileDetails.recordingLocationঅবজেক্ট এবং এর শিশু সম্পত্তিগুলি আর ফেরত দেওয়া হয় না। পূর্বে, এই ডেটা (প্যারেন্টfileDetailsঅবজেক্টের মতো) কেবল কোনও ভিডিওর মালিক দ্বারা পুনরুদ্ধার করা যেতে পারে।
11 আগস্ট, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
সদ্য প্রকাশিত YouTube API পরিষেবার পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), যা YouTube ইঞ্জিনিয়ারিং এবং ডেভেলপারস ব্লগে বিশদভাবে আলোচনা করা হয়েছে, বর্তমান পরিষেবার শর্তাবলীতে আপডেটের একটি সমৃদ্ধ সেট প্রদান করে৷ আপডেট করা শর্তাদি ছাড়াও, যা 10 ফেব্রুয়ারী, 2017 থেকে কার্যকর হবে, এই আপডেটে অনেকগুলি সমর্থনকারী নথি অন্তর্ভুক্ত রয়েছে যা বিকাশকারীদের অনুসরণ করা আবশ্যক নীতিগুলি ব্যাখ্যা করতে সহায়তা করে৷
নতুন নথির সম্পূর্ণ সেট আপডেট করা শর্তাবলীর পুনর্বিবেচনার ইতিহাসে বর্ণনা করা হয়েছে। উপরন্তু, আপডেট করা শর্তাবলী বা সেই সমর্থনকারী নথিগুলিতে ভবিষ্যতের পরিবর্তনগুলিও সেই সংশোধন ইতিহাসে ব্যাখ্যা করা হবে। আপনি সেই নথির একটি লিঙ্ক থেকে সেই পুনর্বিবেচনার ইতিহাসে একটি RSS ফিড তালিকা পরিবর্তনের সদস্যতা নিতে পারেন।
ফ্রিবেসের অবমূল্যায়ন এবং ফ্রিবেস এপিআই টপিক আইডির সাথে সম্পর্কিত বেশ কয়েকটি পরিবর্তন ঘটায়। টপিক আইডিগুলি নিম্নলিখিত এপিআই সংস্থান এবং পদ্ধতিতে ব্যবহৃত হয়:
-
channelরিসোর্সেরtopicDetailsঅংশটি চ্যানেলের সাথে সম্পর্কিত বিষয়গুলি চিহ্নিত করে। -
videoরিসোর্সেরtopicDetailsঅংশটি ভিডিওর সাথে সম্পর্কিত বিষয়গুলি সনাক্ত করে। -
search.listপদ্ধতিরtopicIdপ্যারামিটার আপনাকে কোনও নির্দিষ্ট বিষয়ের সাথে সম্পর্কিত ভিডিও বা চ্যানেলগুলির জন্য অনুসন্ধান করতে দেয়।
এই বৈশিষ্ট্যগুলিতে পরিবর্তনগুলি হ'ল:
10 ফেব্রুয়ারী, 2017 পর্যন্ত, ইউটিউব এতদূর ফিরে আসা আইডিগুলির আরও বেশি দানাদার সেটের পরিবর্তে বিষয় আইডির একটি ছোট সেট ফিরিয়ে দেওয়া শুরু করবে। সমর্থিত বিষয়ের সেটটি স্পোর্টস বা বাস্কেটবলের মতো উচ্চ-স্তরের শ্রেণিবদ্ধকরণগুলি সনাক্ত করবে, তবে উদাহরণস্বরূপ, তারা নির্দিষ্ট দল বা খেলোয়াড়দের সনাক্ত করবে না। আমরা সমর্থিত বিষয়ের সেটটি ঘোষণা করব যাতে আপনার এই পরিবর্তনের জন্য আপনার আবেদন প্রস্তুত করার সময় থাকে।
আপনি ইতিমধ্যে পুনরুদ্ধার করেছেন যে কোনও ফ্রিবেজ টপিক আইডিগুলি 10 ফেব্রুয়ারী, 2017 পর্যন্ত সামগ্রী অনুসন্ধান করতে ব্যবহার করা যেতে পারে However তবে, সেই সময়ের পরে, আপনি পূর্ববর্তী আইটেমটিতে চিহ্নিত বিষয়গুলির ছোট সেটগুলি কেবলমাত্র বিষয় দ্বারা অনুসন্ধান ফলাফলগুলি পুনরুদ্ধার করতে ব্যবহার করতে সক্ষম হবেন।
10 ফেব্রুয়ারী, 2017 এর পরে, আপনি যদি সমর্থিত টপিক আইডির ছোট সেটে নেই এমন কোনও বিষয় আইডি ব্যবহার করে ফলাফলগুলি অনুসন্ধান করার চেষ্টা করেন তবে এপিআই একটি খালি ফলাফল সেটটি ফিরিয়ে দেবে।
-
বেশ কয়েকটি এপিআই ক্ষেত্র এবং পরামিতিগুলি 12 সেপ্টেম্বর, 2016 কার্যকরভাবে হ্রাস করা হচ্ছে:
activities.listপদ্ধতিরhomeপ্যারামিটারটি কোনও অনুমোদিত ব্যবহারকারীকে সেই ব্যবহারকারীর জন্য ইউটিউব হোম পৃষ্ঠায় প্রদর্শিত ক্রিয়াকলাপ ফিডটি পুনরুদ্ধার করতে সক্ষম করে। 12 সেপ্টেম্বর, 2016 এর পরে এই প্যারামিটারটি ব্যবহার করে এমন অনুরোধগুলি একটি খালি তালিকা ফিরিয়ে দেবে।channelরিসোর্সেরcontentDetails.relatedPlaylists.watchHistorycontentDetails.relatedPlaylists.watchLater12 ই সেপ্টেম্বর, 2016 এর পরে,contentDetails.relatedPlaylists.watchHistoryHLএবংcontentDetails.relatedPlaylists.watchLaterএকটি মান প্রদান করবেWLসম্পর্কিত প্লেএলিস্টস।চ্যানেলের ঘড়ির ইতিহাসের জন্য প্লেলিস্ট বিশদ (
playlists.list) পুনরুদ্ধার করার অনুরোধগুলি বা পরে প্লেলিস্টটি 12 সেপ্টেম্বর, 2016 এর পরে একটি খালি তালিকা ফিরিয়ে দেবে those প্লেলিস্ট আইটেমগুলি পুনরুদ্ধার করার অনুরোধগুলি (playlistItems.list) এর মধ্যে যে কোনও একটিতেও সেই সময়ের পরে একটি খালি তালিকা ফিরে আসবে। এটি নতুন মান,HLএবংWLপাশাপাশি সত্য যে কোনও ঘড়ির ইতিহাস বা পরে প্লেলিস্ট আইডিগুলির জন্য আপনার এপিআই ক্লায়েন্ট ইতিমধ্যে সংরক্ষণ করে থাকতে পারে।videoরিসোর্সেরfileDetails.recordingLocationRe রিকর্ডিংলোকেশন অবজেক্ট বা এর কোনও শিশু সম্পত্তি আর 12 সেপ্টেম্বর, 2016fileDetailsপরে আর ফেরত দেওয়া হবে না This
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
নতুন ডেটা এপিআই কোড স্নিপেটস সরঞ্জাম সাধারণ ইউটিউব ডেটা এপিআই ব্যবহারের ক্ষেত্রে সংক্ষিপ্ত কোড স্নিপেট সরবরাহ করে। কোড স্নিপেটগুলি বর্তমানে অ্যাপস স্ক্রিপ্ট, জিও, জাভাস্ক্রিপ্ট, পিএইচপি, পাইথন এবং রুবিতে সমস্ত পঠন-কেবলমাত্র এপিআই পদ্ধতির জন্য উপলব্ধ।
প্রতিটি পদ্ধতির জন্য, সরঞ্জামটি এক বা একাধিক ব্যবহারের ক্ষেত্রে কোডের নমুনাগুলি দেখায়। উদাহরণস্বরূপ, এটি অনুসন্ধানের জন্য পাঁচটি কোড স্নিপেট সরবরাহ করে search.list পদ্ধতি:
- কীওয়ার্ড দ্বারা ভিডিও তালিকাভুক্ত করুন
- অবস্থান অনুসারে ভিডিও তালিকাভুক্ত করুন
- লাইভ ইভেন্টগুলি তালিকা করুন
- অনুমোদিত ব্যবহারকারীর ভিডিওগুলি অনুসন্ধান করুন
- সম্পর্কিত ভিডিও তালিকা
প্রতিটি ব্যবহারের ক্ষেত্রে, সরঞ্জামটি এপিআই অনুরোধে ব্যবহৃত পরামিতিগুলি প্রদর্শন করে। আপনি প্যারামিটার মানগুলি সংশোধন করতে পারেন, সেক্ষেত্রে সরঞ্জামটি আপনার সরবরাহিত প্যারামিটার মানগুলি প্রতিফলিত করতে কোড স্নিপেটগুলি আপডেট করে।
অবশেষে, সরঞ্জামটি প্রতিটি অনুরোধের এপিআই প্রতিক্রিয়া প্রদর্শন করে। আপনি যদি অনুরোধের পরামিতিগুলি সংশোধন করে থাকেন তবে এপিআই প্রতিক্রিয়াটি আপনার সরবরাহিত প্যারামিটার মানগুলির উপর ভিত্তি করে। নোট করুন যে এপিআই প্রতিক্রিয়াগুলি প্রদর্শনের জন্য আপনার পক্ষ থেকে অনুরোধ জমা দেওয়ার জন্য আপনাকে সরঞ্জামটি অনুমোদিত করতে হবে।
এপ্রিল 28, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
videoরিসোর্সের নতুনcontentDetails.projectionসম্পত্তি ভিডিওর প্রক্ষেপণ বিন্যাস নির্দিষ্ট করে। বৈধ সম্পত্তি মান360এবংrectangular।videoরিসোর্সেরrecordingDetails.locationএবংfileDetails.recordingLocationবৈশিষ্ট্য উভয়ই দুটি বৈশিষ্ট্যের মধ্যে পার্থক্য ব্যাখ্যা করার জন্য আপডেট করা হয়েছে:-
recordingDetails.locationসম্পত্তিটি ভিডিওটির সাথে ভিডিওটির সাথে যুক্ত হতে চায় এমন অবস্থানটি সনাক্ত করে। এই অবস্থানটি সম্পাদনাযোগ্য, পাবলিক ভিডিওগুলিতে অনুসন্ধানযোগ্য এবং এটি ব্যবহারকারীদের কাছে পাবলিক ভিডিওগুলির জন্য প্রদর্শিত হতে পারে। -
fileDetails.recordingLocationসম্পত্তি মান অপরিবর্তনীয় এবং মূল, আপলোড করা ভিডিও ফাইলের সাথে সম্পর্কিত অবস্থানটি উপস্থাপন করে। মানটি কেবল ভিডিও মালিকের কাছে দৃশ্যমান।
-
channelরিসোর্সেরcontentDetails.relatedPlaylists.favoritesসংজ্ঞাটি সম্পর্কিত। সম্পর্কিত সম্পর্কিত প্লেলিস্টস.পোরাইটস সম্পত্তিটি আপডেট করা হয়েছে যে সম্পত্তি মানটিতে একটি প্লেলিস্ট আইডি থাকতে পারে যা একটি খালি প্লেলিস্টকে বোঝায় এবং এটি আনা যায় না। এটি প্রিয় ভিডিওগুলির কার্যকারিতা ইতিমধ্যে অবমূল্যায়ন করা হয়েছে এই কারণে। নোট করুন যে এই সম্পত্তিটি এপিআই অবমূল্যায়ন নীতি সাপেক্ষে নয় ।ineligibleAccountত্রুটির সংজ্ঞাটি, যাcomments.insertদ্বারা ফিরিয়েcommentThreads.updatecommentThreads.insertপারেcomments.update
এপ্রিল 20, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
channels.updatelocalizationspartগিগার বিকাশকারীর কনসোলের লিঙ্কে গেটার শুরু গাইডের কোটা ব্যবহার বিভাগটি আপডেট করা হয়েছে, যেখানে আপনি আপনার আসল কোটা এবং কোটা ব্যবহার দেখতে পারেন।
16 মার্চ, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
channelBannerরিসোর্স ডকুমেন্টেশনটি আপডেট করা হয়েছে যে আপলোড করা চ্যানেল ব্যানার চিত্রের জন্য প্রস্তাবিত আকারটি 1440px দ্বারা 2560px হয়। সর্বনিম্ন আকার (2048px দ্বারা 1152px) পরিবর্তন হয়নি।channelরিসোর্সের নতুনsnippet.customUrlসম্পত্তি চ্যানেলের সাথে সম্পর্কিত কাস্টম ইউআরএল সনাক্ত করে। (সমস্ত চ্যানেলের কাস্টম ইউআরএল নেই)) ইউটিউব সহায়তা কেন্দ্রটি কাস্টম ইউআরএল পাওয়ার পাশাপাশি ইউআরএল কীভাবে সেট আপ করতে হবে তার যোগ্যতার প্রয়োজনীয়তাগুলি ব্যাখ্যা করে।channelরিসোর্সেরbrandingSettings.watchobtএকটি
search.listএপিআই প্রতিক্রিয়া.লিস্ট অনুরোধে এখন একটিregionCodeসম্পত্তি রয়েছে। সম্পত্তিটি অঞ্চল কোডটি সনাক্ত করে যা অনুসন্ধান প্রশ্নের জন্য ব্যবহৃত হয়েছিল। অঞ্চল কোডটি এপিআইকে নির্দিষ্ট দেশের জন্য অনুসন্ধানের ফলাফলগুলি ফিরিয়ে দেওয়ার নির্দেশ দেয়।সম্পত্তির মানটি একটি দ্বি-অক্ষরের আইএসও কান্ট্রি কোড যা অঞ্চলটিকে চিহ্নিত করে।
i18nRegions.listপদ্ধতি সমর্থিত অঞ্চলগুলির একটি তালিকা প্রদান করে। ডিফল্ট মানUSহয়। যদি কোনও সমর্থিত অঞ্চল নির্দিষ্ট করা থাকে তবে ইউটিউব এখনও ক্যোয়ারীটি পরিচালনা করতে ডিফল্ট মানের পরিবর্তে অন্য অঞ্চল নির্বাচন করতে পারে।videoAbuseReportReasonরিসোর্সেরsnippet.labelএবংsnippet.secondaryReasons[].labelবৈশিষ্ট্যগুলি আপডেট করা হয়েছে যে বৈশিষ্ট্যগুলিতে অপব্যবহারের প্রতিবেদনের কারণে স্থানীয় লেবেল পাঠ্য রয়েছে।তদতিরিক্ত,
videoAbuseReportReasons.listপদ্ধতি এখনhlপ্যারামিটারকে সমর্থন করে, যা এপিআই প্রতিক্রিয়াতে লেবেল পাঠ্যের জন্য ব্যবহার করা উচিত এমন ভাষাটি নির্দিষ্ট করে। ডিফল্ট প্যারামিটার মানen_US।videoরিসোর্সের নতুনcontentDetails.contentRating.ecbmctRatingএছাড়াও, অন্যান্য রেটিং সিস্টেমগুলির জন্য এপিআই বৈশিষ্ট্যগুলি নিম্নলিখিত নতুন সম্পত্তি মানগুলিকে সমর্থন করে:
-
contentDetails.contentRating.fpbRating(দক্ষিণ আফ্রিকা)
রেটিং: 10; সম্পত্তি মান:fpb10 -
contentDetails.contentRating.moctwRating(তাইওয়ান)
রেটিং: আর -12; সম্পত্তি মান:moctwR12 -
contentDetails.contentRating.moctwRating(তাইওয়ান)
রেটিং: আর -15; সম্পত্তি মান:moctwR15
-
videoরিসোর্সেরliveStreamingDetails.activeLiveChatIdসম্পত্তিটিতে ভিডিওর সাথে যুক্ত সক্রিয় লাইভ চ্যাটের আইডি রয়েছে। সম্পত্তি মান কেবল তখনই উপস্থিত থাকে যখন ভিডিওটি একটি বর্তমান লাইভ সম্প্রচার যা লাইভ চ্যাট সক্ষম করেছে। সম্প্রচার শেষ হওয়ার পরে এবং লাইভ চ্যাট শেষ হওয়ার পরে, সম্পত্তিটি আর ভিডিওর জন্য আর ফিরে আসে না।videoরিসোর্সেরstatus.rejectionReasonরিজেকশনআরসন সম্পত্তি নতুন সম্পত্তি মানlegalসমর্থন করে।
API নিম্নলিখিত নতুন ত্রুটি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequest (400)notEditablechannelSections.insert,channelSections.updatechannelSections.deletebadRequest (400)styleRequiredchannelSections.insertchannelSections.updatechannelSectionsnippet.stylebadRequest (400)typeRequiredchannelSections.insertchannelSections.updatechannelSectionsnippet.typebadRequest (400)processingFailurecommentThreads.listপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে এপিআই সার্ভারটি সফলভাবে অনুরোধটি প্রক্রিয়া করতে ব্যর্থ হয়েছিল তা নির্দেশ করে। যদিও এটি একটি ক্ষণস্থায়ী ত্রুটি হতে পারে তবে এটি সাধারণত ইঙ্গিত দেয় যে অনুরোধটির ইনপুটটি অবৈধ। এটি বৈধ কিনা তা নিশ্চিত করার জন্য অনুরোধের বডিটিতেcommentThreadরিসোর্সের কাঠামোটি পরীক্ষা করুন।forbidden (403)commentsDisabledcommentThreads.listপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যেvideoIdপ্যারামিটার দ্বারা চিহ্নিত ভিডিওটি মন্তব্যগুলি অক্ষম করেছে।badRequest (400)commentTextTooLongcommentThreads.insertপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে মন্তব্য করা হয়েছে যেcommentসংস্থানটি serted োকানো হচ্ছে তাsnippet.topLevelComment.snippet.textOriginalসম্পত্তিটিতে অনেকগুলি অক্ষর রয়েছে।invalidValue (400)videoAlreadyInAnotherSeriesPlaylistplaylistItems.insertপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে আপনি প্লেলিস্টে যে ভিডিওটি যুক্ত করার চেষ্টা করছেন তা ইতিমধ্যে অন্য সিরিজের প্লেলিস্টে রয়েছে তা নির্দেশ করে। সিরিজ প্লেলিস্ট সম্পর্কে আরও তথ্যের জন্য ইউটিউব সহায়তা কেন্দ্র দেখুন।badRequest (400)subscriptionForbiddensubscriptions.insertপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে আপনি আপনার সর্বাধিক সংখ্যক সাবস্ক্রিপশনে পৌঁছেছেন বা আপনি সাম্প্রতিক অনেক সাবস্ক্রিপশন তৈরি করেছেন তা নির্দেশ করে। পরবর্তী ক্ষেত্রে, আপনি কয়েক ঘন্টা পরে অনুরোধটি আবার চেষ্টা করতে পারেন।badRequest (400)invalidCategoryIdvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে আপলোড করাvideoরিসোর্সেsnippet.categoryIdসম্পত্তিটি একটি অবৈধ বিভাগের আইডি নির্দিষ্ট করেছে তা নির্দেশ করে। সমর্থিত বিভাগগুলি পুনরুদ্ধার করতেvideoCategories.listপদ্ধতিটি ব্যবহার করুন।badRequest (400)invalidDescriptionvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে আপলোড করাvideoরিসোর্সেsnippet.descriptionসম্পত্তিটি একটি অবৈধ মান নির্দিষ্ট করে।badRequest (400)invalidPublishAtvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে আপলোড করাvideoরিসোর্সেstatus.publishAtসম্পত্তিটি একটি অবৈধ নির্ধারিত প্রকাশের সময় নির্দিষ্ট করে।badRequest (400)invalidRecordingDetailsvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে আপলোড করাvideoরিসোর্সেrecordingDetailsঅবজেক্টটি অবৈধ রেকর্ডিংয়ের বিশদ নির্দিষ্ট করে তা নির্দেশ করে।badRequest (400)invalidTagsvideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যাতে আপলোড করাvideoরিসোর্সেsnippet.tagsসম্পত্তি একটি অবৈধ মান নির্দিষ্ট করে।badRequest (400)invalidTitlevideos.updateপদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যে আপলোড করাvideoরিসোর্সেsnippet.titleসম্পত্তিটি একটি অবৈধ বা খালি ভিডিও শিরোনাম নির্দিষ্ট করে।badRequest (400)invalidVideoMetadatavideos.updateপদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যাতে অনুরোধ মেটাডেটা অবৈধ। এই ত্রুটিটি ঘটে যদি অনুরোধটি কোনওvideoরিসোর্সেরsnippetঅংশ আপডেট করে তবেsnippet.titleএবংsnippet.categoryIdবৈশিষ্ট্য উভয়ের জন্য কোনও মান নির্ধারণ করে না।
ডিসেম্বর 18, 2015
ইউরোপীয় ইউনিয়নের (ইইউ) আইনের প্রয়োজন হয় যে নির্দিষ্ট কিছু প্রকাশ অবশ্যই দিতে হবে এবং EU-এর শেষ ব্যবহারকারীদের কাছ থেকে সম্মতি নিতে হবে। তাই, ইউরোপীয় ইউনিয়নের শেষ ব্যবহারকারীদের জন্য, আপনাকে অবশ্যই EU ব্যবহারকারীর সম্মতি নীতি মেনে চলতে হবে। আমরা আমাদের YouTube API পরিষেবার শর্তাবলীতে এই প্রয়োজনীয়তার একটি বিজ্ঞপ্তি যুক্ত করেছি৷
নভেম্বর 19, 2015
এপিআই এখন snippet.title এবং snippet.description জন্য স্থানীয় পাঠ্যের জন্য স্থানীয় পাঠ্য সেট এবং পুনরুদ্ধার করার ক্ষমতা সমর্থন করে Play playlist এবং video রিসোর্সগুলির ডেসক্রিপশন বৈশিষ্ট্য, channelSection রিসোর্সের snippet.title সম্পত্তি এবং channel রিসোর্সের snippet.description সম্পত্তি।
স্থানীয় শিরোনাম এবং বিবরণ সেট করা
সেই সংস্থানটির জন্য
insertবাupdateপদ্ধতিতে কল করার সময় আপনি কোনও সংস্থার জন্য স্থানীয় মান নির্ধারণ করতে পারেন। একটি সংস্থার জন্য স্থানীয় মান নির্ধারণ করতে, নিম্নলিখিত উভয়ই করুন:নিশ্চিত করুন যে রিসোর্সের
snippet.defaultLanguageসম্পত্তির জন্য একটি মান সেট করা আছে। এই সম্পত্তিটি রিসোর্সেরsnippet.titleএবংsnippet.descriptionবৈশিষ্ট্যগুলির ভাষা চিহ্নিত করে। এর মান কোনও সমর্থিত অ্যাপ্লিকেশন ভাষা বা অন্যান্য অন্যান্য আইএসও 639-1: 2002 ভাষা কোড হতে পারে। উদাহরণস্বরূপ, আপনি যদি কোনও ভিডিও আপলোড করেন যার একটি ইংরেজি শিরোনাম এবং বিবরণ রয়েছে তবে আপনিsnippet.defaultLanguageসম্পত্তিটিenসেট করবেন।channelরিসোর্সগুলি আপডেট করার জন্য দ্রষ্টব্য: একটিchannelরিসোর্সের জন্যsnippet.defaultLanguageসম্পত্তি সেট করতে, আপনাকে আসলেbrandingSettings.channel.defaultLanguageসম্পত্তি আপডেট করতে হবে।আপনি আপডেট করছেন এমন সংস্থানটিতে
localizationsঅবজেক্ট যুক্ত করুন। প্রতিটি অবজেক্ট কী হ'ল একটি স্ট্রিং যা কোনও অ্যাপ্লিকেশন ভাষা বা আইএসও 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", } } }
গুরুত্বপূর্ণ: মনে রাখবেন যে আপনি যখন কোনও সংস্থার জন্য স্থানীয় ডেটা আপডেট করেন, তখন আপনার এপিআই অনুরোধে অবশ্যই ডেটাগুলির বিদ্যমান স্থানীয় সংস্করণগুলির সমস্ত অন্তর্ভুক্ত থাকতে হবে। উদাহরণস্বরূপ, আপনি যদি উপরের উদাহরণে ভিডিওতে পর্তুগিজ ডেটা যুক্ত করার জন্য পরবর্তী অনুরোধটি প্রেরণ করেন তবে অনুরোধটি জার্মান, স্প্যানিশ এবং পর্তুগিজদের জন্য স্থানীয় ডেটা অন্তর্ভুক্ত করতে হবে।
স্থানীয় মান পুনরুদ্ধার করা
এপিআই একটি সংস্থার জন্য স্থানীয় মানগুলি পুনরুদ্ধার করার দুটি উপায় সমর্থন করে:
playlists.listchannels.listhlপ্যারামিটারvideos.listchannelSections.listL যদি স্থানীয়করণের সংস্থানগুলির বিশদটি সেই ভাষায় উপলভ্য থাকে তবে রিসোর্সেরsnippet.localizedঅবজেক্টটিতে স্থানীয় মানগুলি থাকবে। তবে, যদি স্থানীয়করণের বিশদগুলি উপলভ্য না হয় তবেsnippet.localizedঅবজেক্টটিতে রিসোর্সের ডিফল্ট ভাষায় সংস্থান বিশদ থাকবে।উদাহরণস্বরূপ, ধরুন একটি
videos.listঅনুরোধ স্থানীয় জার্মান এবং স্প্যানিশ ডেটা সহ উপরে বর্ণিত ভিডিওর জন্য ডেটা পুনরুদ্ধার করা হয়েছে। যদিhlপ্যারামিটারটিdeসেট করা থাকে তবে সংস্থানটিতে নিম্নলিখিত ডেটা থাকবে:{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }তবে, যদি
hlপ্যারামিটারটিfr-তে সেট করা থাকে তবেsnippet.localizedঅবজেক্টটিতে ইংরেজি শিরোনাম এবং বিবরণ থাকতে পারে কারণ ইংরেজি হ'ল সংস্থানটির জন্য ডিফল্ট ভাষা এবং স্থানীয়ভাবে ফরাসি বিবরণগুলি উপলভ্য নয়।গুরুত্বপূর্ণ:hlপ্যারামিটার কেবলমাত্র এমন মানগুলিকে সমর্থন করে যা ইউটিউব ওয়েবসাইট সমর্থন করে এমন অ্যাপ্লিকেশন ভাষাগুলি সনাক্ত করে। স্থানীয়ভাবে পাঠ্য অন্যান্য ভাষার জন্য উপলব্ধ কিনা তা নির্ধারণের জন্য, স্থানীয় পাঠ্যটি বিদ্যমান কিনা তা নির্ধারণের জন্য আপনাকে সংস্থান এবং ফিল্টারটির জন্যlocalizationsঅংশটি পুনরুদ্ধার করতে হবে।
উদাহরণস্বরূপ, স্থানীয়করণ পাঠ্য অ্যাপাল্যাচিয়ান ইংরেজিতে উপলব্ধ কিনা তা নির্ধারণ করতে আপনাকে স্থানীয়করণের সম্পূর্ণ তালিকাটি পুনরুদ্ধার করতে হবে।কোনও সংস্থান পুনরুদ্ধার করার সময়, সেই সংস্থানটির জন্য স্থানীয় সমস্ত বিবরণ পুনরুদ্ধার করতে
partপ্যারামিটার মানটিতেlocalizationsঅন্তর্ভুক্ত করুন। আপনি যদি এমন কোনও ভাষার জন্য স্থানীয় ডেটা পুনরুদ্ধার করছেন যা বর্তমান ইউটিউব অ্যাপ্লিকেশন ভাষা নয়, তবে আপনাকে সমস্ত স্থানীয়করণ পুনরুদ্ধার করতে এই পদ্ধতির ব্যবহার করতে হবে এবং তারপরে কাঙ্ক্ষিত স্থানীয় ডেটা বিদ্যমান কিনা তা নির্ধারণ করতে ফিল্টার করতে হবে।
স্থানীয় পাঠ্য মান সম্পর্কিত ত্রুটিগুলি
এপিআই স্থানীয় পাঠ্য মানগুলির জন্য নিম্নলিখিত নতুন ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequest (400)defaultLanguageNotSetErrorএই ত্রুটিটি ইঙ্গিত দেয় যে একটি অনুরোধ যা কোনও সংস্থার জন্য localizationsঅবজেক্টটি সন্নিবেশ করায় বা আপডেট করার চেষ্টা করে তা ব্যর্থ হচ্ছে কারণsnippet.defaultLanguageসম্পত্তি সেই সংস্থানটির জন্য সেট করা হয়নি।channels.update,channelSections.insert,channelSections.update,playlists.insert,playlists.update,videos.insertএবংvideos.updateপদ্ধতিগুলি এই ত্রুটিটিকে সমর্থন করে।badRequest (400)localizationValidationErrorএই ত্রুটিটি ইঙ্গিত দেয় যে কোনও রিসোর্সের localizationsঅবজেক্টের অন্যতম মান বৈধতা দিতে ব্যর্থ হয়েছিল। উদাহরণস্বরূপ, যদি অবজেক্টটিতে একটি অবৈধ ভাষার কোড থাকে তবে এই ত্রুটিটি ঘটতে পারে।channels.updateplaylists.updatechannelSections.insert,playlists.insertchannelSections.update
নভেম্বর 4, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
search.listপদ্ধতিরorderপ্যারামিটারটি নোট করার জন্য আপডেট করা হয়েছে যে আপনি যদিviewCountদ্বারা সরাসরি সম্প্রচার বাছাই করেন তবে সম্প্রচারের ফলাফলগুলি সম্প্রচারের সমকালীন দর্শকদের সংখ্যা দ্বারা বাছাই করা হয় যখন সম্প্রচারগুলি এখনও চলছে।search.listপদ্ধতিরrelatedToVideoIdপ্যারামিটারটি নোট করার জন্য আপডেট করা হয়েছে যে প্যারামিটারটি সেট করা থাকলে, কেবলমাত্র অন্যান্য সমর্থিত প্যারামিটারগুলিpart,maxResults,pageToken,regionCode,relevanceLanguage,safeSearch,type(যা অবশ্যইvideoসেট করা উচিত) এবংfields। এই আপডেটটি এপিআই আচরণের পরিবর্তনকে প্রতিফলিত করে না।videoরিসোর্সেরsnippet.publishedAtসংজ্ঞাটি upbulishishedat সম্পত্তিটি আপডেট করা হয়েছে যে সম্পত্তিটির মান, যা ভিডিওটি প্রকাশিত হওয়ার তারিখ এবং সময় নির্দিষ্ট করে, ভিডিওটি আপলোড করার সময়টির চেয়ে আলাদা হতে পারে। For example, if a video is uploaded as a private video and then made public at a later time, the property value specifies the time that the video was made public. The updated definition also explains how the value is populated for private and unlisted videos.This change does not reflect a change in API behavior.
The definition of the
videoresource'sstatus.publishAtproperty has been updated to note:- If you set this property's value when calling the
videos.updatemethod, you must also set thestatus.privacyStatusproperty value toprivateeven if the video is already private. - If the request schedules a video to be published at some time in the past, it is published right away. As such, the effect of setting the
status.publishAtproperty to a past date and time is the same as of changing the video'sprivacyStatusfromprivatetopublic.
- If you set this property's value when calling the
The
videoresource'scontentDetails.contentRating.cncRatingproperty specifies the video's rating from France's Commission de classification cinematographique. This property replaces thecontentDetails.contentRating.fmocRatingproperty, which is now deprecated.The definition of the
channelresource'sbrandingSettings.channel.keywordshas been updated to correctly reflect that the property value contains a space-separated list of strings and not a comma-separated list, as previously documented. This update does not reflect a change in API behavior.The documentation for the
thumbnails.setmethod has been updated to accurately reflect that the body of the request contains the thumbnail image that you are uploading and associating with a video. The request body does not contain athumbnailresource. Previously, the documentation said that you should not provide a request body when calling this method. This update does not reflect a change in API behavior.The description of the
activityresource has been updated to reflect the fact that theactivities.listmethod does not currently include resources related to new video comments. The resource'ssnippet.typeandcontentDetails.commenthave been updated as well.
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটি বিবরণ activities.insertHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ invalidMetadataবর্ণনা The kindproperty does not match the type of ID provided.commentThreads.updatecomments.insertcomments.updateHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ commentTextTooLongবর্ণনা The commentresource that is being inserted or updated contains too many characters in thesnippet.topLevelComment.snippet.textOriginalproperty.playlistItems.insertplaylistItems.updateHTTP প্রতিক্রিয়া কোড forbidden (403)কারণ playlistItemsNotAccessibleবর্ণনা The request is not properly authorized to insert, update, or delete the specified playlist item. playlists.deleteplaylists.insertplaylists.updateHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ playlistForbiddenবর্ণনা This operation is forbidden or the request is not properly authorized. search.listHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ invalidLocationবর্ণনা The locationand/orlocationRadiusparameter value was formatted incorrectly.search.listHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ invalidRelevanceLanguageবর্ণনা The relevanceLanguageparameter value was formatted incorrectly.subscriptions.insertHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ subscriptionForbiddenবর্ণনা This error occurs when any of the following are true: - The subscription that you are trying to create already exists
- You have already reached your maximum number of subscriptions
- You are trying to subscribe to your own channel, which is not supported.
- You have created too many subscriptions recently and need to wait a few hours before retrying the request.
videos.updateHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ invalidDefaultBroadcastPrivacySettingবর্ণনা The request attempts to set an invalid privacy setting for the default broadcast.
আগস্ট 28, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
The
videoresource'sstatistics.favoriteCountproperty has been deprecated.In accordance with our deprecation policy, this property will continue to be included in
videoresources for at least one year after this announcement. However, the property value is now always set to0.
আগস্ট 7, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
The definition of the
videoresource'ssnippet.tags[]property has been updated to provide more information about how the API server calculates the length of the property's value. Note that this update does not reflect a change in the API's behavior.Specifically, the definition now explains that if a tag contains a space, the API server handles the tag value as though it were wrapped in quotation marks, and the quotation marks count toward the character limit. So, for the purposes of character limits, the tag Foo-Baz contains seven characters, but the tag Foo Baz contains nine characters.
The
commentThreads.insertmethod no longer supports theshareOnGooglePlusparameter, which previously indicated whether a comment and replies to that comment should also be posted to the author's Google+ profile. If a request submits the parameter, the API server ignores the parameter but otherwise handles the request.
18 জুন, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
The
commentThreads.listmethod's neworderparameter specifies the order in which the API response should list comment threads. Threads can be ordered by time or relevance. The default behavior is to order them by time.The
videoresource's newsnippet.defaultAudioLanguageproperty specifies the language spoken in the video's default audio track.The definition of the
videoresource'scontentDetails.licensedContentproperty has been updated to clarify that the content must have been originally uploaded to a channel linked to a YouTube content partner and then claimed by that partner. This does not represent a change in actual API behavior.The
captions.delete,captions.download,captions.insert,captions.list, andcaptions.updatemethods now support theonBehalfOfContentOwnerparameter, which is already supported for several other methods. Requests that use that method also need to be authorized with a token that provides access to thehttps://www.googleapis.com/auth/youtubepartnerscope.
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটি বিবরণ videos.rateHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ emailNotVerifiedবর্ণনা The user must verify her email address prior to rating the video. videos.rateHTTP প্রতিক্রিয়া কোড badRequest (400)কারণ videoPurchaseRequiredবর্ণনা Rental videos can only be rated by users who rented them. The
subscriptions.deleteandsubscriptions.insertmethods no longer support theaccountClosedandaccountSuspendederrors.
এপ্রিল 27, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
The new
videoAbuseReportReasonresource contains information about a reason that a video would be flagged for containing abusive content. ThevideoAbuseReportReasons.listmethod lets you retrieve a list of all of the reasons why videos might be flagged.The new
videos.reportAbusemethod provides a way to actually flag a video that contains abusive content. The body of the request contains a JSON object that specifies the video being flagged as well as the reason that the video is deemed to contain abusive content. Valid reasons can be obtained from thevideoAbuseReportReason.listmethod described above.The migration guide has also been updated with an example for reporting an abusive video. With this change, the v3 API now supports all of the v2 API features that it is scheduled to support. These features are also all explained in the migration guide.
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
The
search.listmethod's newforDeveloperfilter parameter restricts a search to only retrieve videos uploaded via the developer's application or website. TheforDeveloperparameter can be used in conjunction with optional search parameters like theqparameter.For this feature, each uploaded video is automatically tagged with the project number that is associated with the developer's application in the Google Developers Console .
When a search request subsequently sets the
forDeveloperparameter totrue, the API server uses the request's authorization credentials to identify the developer. Therefore, a developer can restrict results to videos uploaded through the developer's own app or website but not to videos uploaded through other apps or sites.The new feature offers functionality that is similar, albeit not identical, to the developer tags functionality that the v2 API supported.
The
channelresource's newsnippet.countryproperty lets channel owners associate their channels with a particular country.Note: To set the
snippet.countryproperty for achannelresource, you actually need to update thebrandingSettings.channel.countryproperty.The API now supports targeting for
channelSectionresources. Channel section targeting provides a way to restrict visibility of a content section to users that match particular criteria.The API exposes three targeting options. A user must meet all of the targeting settings for a channel section to be visible.
targeting.languages[]: A list of YouTube application languages . Users who have chosen one of those languages can see the corresponding channel section.targeting.regions[]: A list of YouTube preferred content regions . The channel section is visible to users that have selected one of those regions as well as users for whom one of those regions is automatically selected.targeting.countries[]: A list of countries where the channel section is visible. Each value in the list is an ISO 3166-1 alpha-2 country code .
The definition of the
videoresource'scontentDetails.durationproperty has been corrected to reflect that the value can reflect hours, days, and so forth.The documentation for the
channelSections.delete,playlistItems.delete,playlists.delete,subscriptions.delete, andvideos.deletemethod has been corrected to reflect that, when successful, those methods all return an HTTP204response code (No Content).
নতুন এবং আপডেট ত্রুটি
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequest (400)targetInvalidCountryThe channelSections.insertandchannelSections.updatemethods return this error if the insertedchannelSectionresource contained an invalid value for thetargeting.countries[]property.badRequest (400)targetInvalidLanguageThe channelSections.insertandchannelSections.updatemethods return this error if the insertedchannelSectionresource contained an invalid value for thetargeting.languages[]property.badRequest (400)targetInvalidRegionThe channelSections.insertandchannelSections.updatemethods return this error if the insertedchannelSectionresource contained an invalid value for thetargeting.regions[]property.badRequest (400)operationNotSupportedThe comments.insertmethod returns this error if the API user is not able to insert a comment in reply to the top-level comment identified by thesnippet.parentIdproperty. In acommentThreadresource, thesnippet.canReplyproperty indicates whether the current viewer can reply to the thread.badRequest (400)invalidChannelIdThe search.listmethod returns this error if thechannelIdparameter in the request specified an invalid channel ID.badRequest (400)subscriptionForbiddenThe subscriptions.insertmethod returns this error if the API user tries to subscribe to the user's own channel.The
captions.updatemethod no longer supports theinvalidMetadataandvideoNotFounderrors.
16 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The migration guide has been updated to explain how to migrate applications still using comments functionality from the v2 API.
The guide also calls out several commenting features that the v2 API did not support but that are supported in the v3 API . এর মধ্যে রয়েছে:
- Retrieving comments about a channel
- Retrieving all comment threads related to a channel, which means that the API response can contain comments about the channel or any of its videos.
- Updating the text of a comment
- Marking a comment as spam
- Setting a comment's moderation status
The Subscribing to push notifications guide has been updated to reflect the fact that notifications are only pushed to the Google PubSubHubBub hub and not also to the Superfeedr hub as previously indicated.
9 এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API's new
commentThreadandcommentresources let you retrieve, insert, update, delete, and moderate comments.A
commentThreadresource contains information about a YouTube comment thread, which comprises a top-level comment and replies, if any exist, to that comment. AcommentThreadresource can represent comments about either a video or a channel.The top-level comment and the replies are actually
commentresources that are nested inside thecommentThreadresource. It is important to note that thecommentThreadresource does not necessarily contain all replies to a comment, and you need to use thecomments.listmethod if you want to retrieve all replies for a particular comment. In addition, some comments do not have replies.The API supports the following methods for
commentThreadresources:-
commentThreads.list– Retrieve a list of comment threads. Use this method to retrieve comments associated with a particular video or channel. -
commentThreads.insert– Create a new top-level comment. (Use thecomments.insertmethod to reply to an existing comment.) -
commentThreads.update– Modify a top-level comment.
-
একটি
commentসংস্থান একটি একক YouTube মন্তব্য সম্পর্কে তথ্য ধারণ করে৷ Acommentresource can represent a comment about either a video or a channel. In addition, the comment could be a top-level comment or a reply to a top-level comment.The API supports the following methods for
commentresources:-
comments.list– Retrieve a list of comment. Use this method to retrieve all of the replies to a particular comment. -
comments.insert– Create a reply to an existing comment. -
comments.update– Modify a comment. -
comments.markAsSpam– Flag one or more comments as spam. -
comments.setModerationStatus– Set the moderation status of one or more comments. For example, clear a comment for public display or reject a comment as unfit for display. The API request must be authorized by the owner of the channel or video associated with the comments.. -
comments.delete– Delete a comment.
-
Note that the API's new
https://www.googleapis.com/auth/youtube.force-sslscope, described in the revision history for April 2, 2015 , is required for calls to thecomments.insert,comments.update,comments.markAsSpam,comments.setModerationStatus,comments.delete,commentThreads.insert, andcommentThreads.updatemethods.The new Subscribing to push notifications guide explains the API's new support for push notifications via PubSubHubBub , a server-to-server publish/subscribe protocol for Web-accessible resources. Your PubSubHubBub callback server can receive Atom feed notifications when a channel does any of the following activities:
- uploads a video
- updates a video's title
- updates a video's description
The migration guide has also been updated to note the new support for push notifications. However, since the v2 API supported numerous other types of push notifications that are not supported in the v3 API, the mention of PubSubHubBub support is still listed in the Deprecated section of that guide.
The API's new
https://www.googleapis.com/auth/youtube.force-sslscope is now a valid scope for any API method that previously supported thehttps://www.googleapis.com/auth/youtubescope.এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequest (400)invalidRatingThe videos.ratemethod returns this error if the request contained an unexpected value for theratingparameter.The
subscriptions.insertmethod no longer supports thesubscriptionLimitExceedederror, which previously indicated that the subscriber identified with the request had exceeded the subscription rate limit.
2শে এপ্রিল, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
captionsresource represents a YouTube caption track. A caption track is associated with exactly one YouTube video.The API supports methods to list , insert , update , download , and delete caption tracks.
The migration guide has also been updated to explain how to migrate applications still using captions functionality in the v2 API.
The API's new
https://www.googleapis.com/auth/youtube.force-sslscope requires communication with the API server to happen over an SSL connection.This new scope grants the same access as the
https://www.googleapis.com/auth/youtubescope. And, in fact, those two scopes are functionally identical because the YouTube API server is only available via an HTTPS endpoint. As a result, even though thehttps://www.googleapis.com/auth/youtubescope does not require an SSL connection, there is actually no other way to make an API request.The new scope is required for calls to the all of the
captionresource's methods.
11 মার্চ, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The YouTube Data API (v3) migration guide contains a new tab, named New in the v3 API , that lists features that the v3 API does support and that the v2 API did not support. The same features were previously and are still listed in other tabs in the guide. For example, the new feature explaining how to update a channel's in-video promotional campaign data is also listed under the Channels (profiles) tab.
The YouTube Data API (v3) migration guide has been updated to note that the v3 API will support the following v2 API feature:
The YouTube Data API (v3) migration guide has been updated to note that the following v2 API features will not be supported in the v3 API:
Retrieve video recommendations – The v3 API does not retrieve a list that only contains videos recommended for the current API user. However, you can use the v3 API to find recommended videos by calling the
activities.listmethod and setting thehomeparameter value totrue.In the API response, a resource corresponds to a recommended video if the
snippet.typeproperty's value isrecommendation. In that case, thecontentDetails.recommendation.reasonandcontentDetails.recommendation.seedResourceIdproperties will contain information about why the video was recommended. Note that there is no guarantee that the response will contain any particular number of recommended videos.Retrieve new subscription videos – The v3 API does not retrieve a list that only contains videos that have recently been uploaded to channels that the API user subscribes to. However, you can use the v3 API to find new subscription videos by calling the
activities.listmethod and setting thehomeparameter value totrue.In the API response, a resource corresponds to a new subscription video if the
snippet.typeproperty's value isupload. Note that there is no guarantee that the response will contain any particular number of new subscription videos.Push notifications for feed updates – The v2 API supported push notifications, using either the Simple Update Protocol (SUP) or PubSubHubbub , to monitor user activity feeds for YouTube users. Notifications were provided for new channel subscriptions and when videos were rated, shared, marked as favorites, commented on, or uploaded.
The v3 API will support push notifications using the PubSubHubbub protocol , but the notifications will only cover video uploads and updates to video titles or video descriptions.
Channel location – The v2 API used the
<yt:location>tag to identify the user's location as entered in the channel's YouTube public profile. While some developers used this field to associate a channel with a particular country, the field's data could not consistently be used for that purpose.Set or retrieve developer tags – The v2 API supported the ability to associate keywords, or developer tags, with a video at the time that the video was uploaded. Developer tags would not be displayed to YouTube users, but video owners could retrieve videos that matched a specific developer tag.
The v3 API will provide a similar, but not identical, feature. Specifically, a developer will be able to search for videos uploaded by the developer's own application. For this feature, each uploaded video is automatically tagged with the project number that is associated with the developer's application in the Google Developers Console . The developer then uses the same project number to search for videos.
List videos by publication date, viewcount, or rating – In the v2 API, the
orderbyparameter let you sort videos in a playlist by position, duration, publication date, title, and several other values. In the v3 API, playlist items are typically sorted by position in ascending order and other sorting options are not available.কিছু ব্যতিক্রম আছে। A new upload, favorite video, liked video, or recently watched video is automatically added as the first item (
snippet.position=0) for the following types of playlists. So, each of these lists is effectively sorted in order of newest to oldest item based on the times that items were added to the list.- user uploads
- favorite videos
- liked videos
- ইতিহাস দেখুন
Note, however, that a new item added to the "Watch later" playlist is added as the last item in that list, so that list is effectively sorted from oldest to newest item.
Batch processing – The v3 API supports one of the batch processing use cases that the v2 API had supported. The v3 API's
channels.list,channelSections.list,guideCategories.list,playlistItems.list,playlists.list,subscriptions.list,videoCategories.list, andvideos.listmethods all support anidparameter, which can be used to specify a comma-delimited list of IDs (video IDs, channel IDs, etc.). Using those methods, you can retrieve a list of multiple resources with a single request.
With these changes, the guide now identifies all functionality that was supported in the old (v2) API that will be deprecated in the current API version (v3).
4 মার্চ, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelSections.deleteandchannelSections.updatemethods now support theonBehalfOfContentOwnerparameter, which is already supported for several other methods.The following properties and their child properties have been deprecated:
-
brandingSettings.image.backgroundImageUrl -
brandingSettings.image.largeBrandedBannerImageImapScript -
brandingSettings.image.largeBrandedBannerImageUrl -
brandingSettings.image.smallBrandedBannerImageImapScript -
brandingSettings.image.smallBrandedBannerImageUrl
Note: None of these properties had been subject to the API Deprecation Policy.
-
The
videoresource's newcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasonsproperty identifies the reasons that explain why the video received its DJCQT (Brazil) rating.এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা notFound (404)channelNotFoundThe channels.updatemethod returns this error if the request'sidparameter specifies a channel that cannot be found.badRequest (400)manualSortRequiredinvalidValueThe playlistItems.insertandplaylistItems.updatemethods return this error if the request attempts to set the playlist item's position, but the playlist does not use manual sorting. For example, playlist items might be sorted by date or popularity. You can address this error by removing thesnippet.positionelement from the resource sent in the request body. If you want the playlist item to have a specific position in the list, you need to first update the playlist's ordering setting to Manual . THis setting can be adjusted in the YouTube Video Manager .forbidden (403)channelClosedThe playlists.listmethod returns this error if the request'schannelIdparameter specifies a channel that has been closed.forbidden (403)channelSuspendedThe playlists.listmethod returns this error if the request'schannelIdparameter specifies a channel that has been suspended.forbidden (403)playlistForbiddenThe playlists.listmethod returns this error if the request'sidparameter does not support the request or the request is not properly authorized.notFound (404)channelNotFoundThe playlists.listmethod returns this error if the request'schannelIdparameter specifies a channel that cannot be found.notFound (404)playlistNotFoundThe playlists.listmethod returns this error if the request'sidparameter specifies a playlist that cannot be found.notFound (404)videoNotFoundThe videos.listmethod returns this error if the request'sidparameter specifies a video that cannot be found.badRequest (400)invalidRatingThe videos.ratemethod returns this error if the request contains an unexpected value for theratingparameter.
মার্চ 2, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
search.listmethod now supports therelevanceLanguageparameter, which lets you request results that are most relevant to a particular language.The YouTube Data API (v3) migration guide has also been updated to explain how to use this new parameter. The parameter addresses a feature gap that previously existed between the current API version (v3) and the previous version (v2), which has already been deprecated.
The YouTube Data API (v3) migration guide has also been updated to indicate the deprecation of the special feeds and metadata fields that the v2 API provided for describing movies, trailers, television shows, television seasons, and television episodes.
14 জানুয়ারী, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The YouTube Data API (v3) migration guide has been updated to explain how to use the v3 API to upload videos using JavaScript. (See the Upload a video section for details.) This functionality is comparable to the browser-based uploading functionality that the v2 API supports. Note that this change to the migration guide does not reflect an actual API change but rather the availability of new sample code for uploading videos with client-side JavaScript.
Given the support for uploading videos with the JavaScript client library and CORS, the migration guide no longer lists browser-based uploading as a feature that may be deprecated in the v3 API.
The documentation for the
videos.insertmethod has been updated to include the new JavaScript code sample described above. The list of JavaScript code samples for the YouTube Data API (v3) has also been updated.
11 নভেম্বর, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The quota cost for a call to the
search.listmethod has changed to 100 units.Important: In many cases, you can use other API methods to retrieve information at a lower quota cost. For example, consider these two ways of finding videos uploaded to the GoogleDevelopers channel.
Quota cost: 100 units
Call the
search.listmethod and search forGoogleDevelopers.Quota cost: 6 units
Call the
channels.listmethod to find the right channel ID. Set theforUsernameparameter toGoogleDevelopersand thepartparameter tocontentDetails. In the API response, thecontentDetails.relatedPlaylists.uploadsproperty specifies the playlist ID for the channel's uploaded videos.Then call the
playlistItems.listmethod and set theplaylistIdparameter to the captured ID and thepartparameter tosnippet.
অক্টোবর 8, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelresource contains two new properties:The
status.longUploadsStatusproperty indicates whether the channel is eligible to upload videos that are more than 15 minutes long. This property is only returned if the channel owner authorized the API request. Valid property values are:-
allowed– The channel can upload videos more than 15 minutes long. -
eligible– The channel is eligible to upload videos more than 15 minutes long but must first enable the feature. -
disallowed– The channel is not able or eligible to upload videos more than 15 minutes long.
See the property definition for more information about these values. The YouTube Help Center also provides more detailed information about this feature.
-
The
invideoPromotion.useSmartTimingproperty indicates whether the channel's promotional campaign uses "smart timing." This feature attempts to show promotions at a point in the video when they are more likely to be clicked and less likely to disrupt the viewing experience. This feature also picks up a single promotion to show on each video.
The definitions of the
videoresource'ssnippet.titleandsnippet.categoryIdproperties have both been updated to clarify the way that API handles calls to thevideos.updatemethod. If you call that method to update thesnippetpart of avideoresource, you must set a value for both of those properties.If you try to update the
snippetpart of avideoresource and do not set a value for both of those properties, the API returns aninvalidRequesterror. That error's description has also been updated.The
videoresource'scontentDetails.contentRating.oflcRatingproperty, which identifies a video's rating from New Zealand's Office of Film and Literature Classification, now supports two new ratings:oflcRp13andoflcRp16. These correspond to theRP13andRP16ratings, respectively.The
channelBanners.insertmethod now supports the following error:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestbannerAlbumFullThe channel owner's YouTube Channel Art album has too many images. The channel owner should go to http://photos.google.com , navigate to the albums page, and remove some from images from that album.
সেপ্টেম্বর 12, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The quota cost for a call to the
search.listmethod has changed from 1 unit to 2 units in addition to the cost of the specified resource parts .
August 13, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
subscriptions.insertmethod now supports the following error:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestsubscriptionLimitExceededThe subscriber identified with the request has exceeded the subscription rate limit. More subscriptions can be attempted in a few hours.
12 আগস্ট, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
A new guide, titled Migrating Your Application to YouTube Data API (v3) , explains how to use the YouTube Data API (v3) to perform functionality available in the YouTube Data API (v2). The older API was officially deprecated as of March 4, 2014. The guide intends to help you migrate applications still using the v2 API to the most recent API version.
8ই জুলাই, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
playlists.insertmethod now supports the following error:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestmaxPlaylistExceededThis error occurs if a playlist cannot be created because the channel already has the maximum number of playlists allowed.
জুন 18, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The description of each API method has been updated to include the quota cost incurred by a call to that method. Similarly, the definitions of
partparameters have been updated to specify the quota cost of each part that can be retrieved in an API call. For example, a call to thesubscriptions.insertmethod has a quota cost of approximately 50 units. Thesubscriptionresource also contains three parts (snippet,contentDetails, andsubscriberSnippet), and each of those has a cost of two units.Please remember that quota costs can change without warning.
The
videoresource now supports 43 new content rating systems, which identify the ratings that videos received from various national rating agencies. The newly supported rating systems are from Argentina , Austria , Belgium , Bulgaria , Chile ( television ), Chile ( film ), Czech Republic , Colombia , Denmark , Egypt , Estonia , Finland , France , Greece , Hong Kong , Iceland , Indonesia , Ireland , Israel , Italy , Kenya , Latvia , Luxembourg , Malaysia , Maldives , Malta , Netherlands , Nigeria , Norway , Peru , Philippines , Portugal , Romania , Singapore , Slovakia , South Africa , Sweden , Switzerland , Taiwan , Thailand , and Venezuela .
28 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
search.listmethod now supports thelocationandlocationRadiusparameters, which let you search for videos associated with a geographic location. A request must specify a value for both parameters to retrieve results based on location, and the API will return an error if a request includes only one of the two parameters.The
locationparameter specifies the latitude/longitude coordinates at the center of the circular geographic area.The
locationRadiusparameter specifies the maximum distance that the location associated with a video can be from the center of the area for the video to still be included in search results.
13 মে, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelresource'sinvideoPromotion.items[]property has been updated to note that you can typically only set one promoted item for your channel. If you try to insert too many promoted items, the API will return atooManyPromotedItemserror, which has an HTTP400status code.The
channelSectionresource now can contain information about a few new types of featured content. ThechannelSectionresource'ssnippet.typeproperty now supports the following values:-
postedPlaylists- playlists that the channel's owner posted to the channel's activity feed -
postedVideos- videos that the channel's owner posted to the channel's activity feed -
subscriptions- channels that the channel owner has subscribed to
-
The
videoresource's newcontentDetails.contentRating.ifcoRatingproperty identifies the rating that a video received from the Irish Film Classification Office.The definition of the
watermarkresource'sposition.cornerPositionproperty has been updated to note that the watermark always appear in the upper right corner of the player.The definition of the
qparameter for thesearch.listmethod has been updated to note that the query term can use the Boolean NOT (-) operator to exclude videos associated with a particular search term. The value can also use the Boolean OR (|) operator to find videos associated with one of several search terms.The definition of the
pageInfo.totalResultsproperty that is returned in an API response to asearch.listcall has been updated to note that the value is an approximation and may not represent an exact value. In addition, the maximum value is 1,000,000. You should not use this value to create pagination links. Instead, use thenextPageTokenandprevPageTokenproperty values to determine whether to show pagination links.The
watermarks.setandwatermarks.unsetmethods have been updated to reflect that the API returns an HTTP204response code for successful requests to those methods.
মে 2, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
i18nLanguageresource identifies an application language that the YouTube website supports. The application language can also be referred to as a UI language. For the YouTube website, an application language could be automatically selected based on Google Account settings, browser language, or IP location, and a user could also manually select the desired UI language from the YouTube site footer.The API supports a method to list supported application languages. Supported languages can be used as the value of the
hlparameter when calling API methods likevideoCategories.listandguideCategories.list.The new
i18nRegionresource identifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale. For the YouTube website, a content region could be automatically selected based on heuristics like the YouTube domain or the user's IP location, and a user could also manually select the desired content region from the YouTube site footer.The API supports a method to list supported content regions. Supported region codes can be used as the value of the
regionCodeparameter when calling API methods likesearch.list,videos.list,activities.list, andvideoCategories.list.
এপ্রিল 7, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
channelSectionresource contains information about a set of videos that a channel has chosen to feature. For example, a section could feature a channel's latest uploads, most popular uploads, or videos from one or more playlists.The API supports methods to list , insert , update , or delete channel sections. You can retrieve a list of channel sections for the authenticated user's channel, by specifying a particular channel ID, or by specifying a list of unique channel section IDs.
The error documentation has also been updated to describe the error messages that the API supports specifically for these new methods.
The definition of the
videoresource'sfileDetailsobject has been updated to explain that that object will only be returned if the video'sprocessingDetails.fileDetailsAvailabilityproperty has a value ofavailable.Similarly, the definition of the
videoresource'ssuggestionsobject has been updated to explain that that object will only be returned if the video'sprocessingDetails.tagSuggestionsAvailabilityproperty or itsprocessingDetails.editorSuggestionsAvailabilityproperty has a value ofavailable.The documentation for the
videos.insertandvideos.updatemethods has been updated to reflect that thestatus.publishAtproperty can be set when calling those methods.The definition of the
channelresource'sinvideoPromotionobject has been updated to explain that the object can only be retrieved by the channel's owner.The parameter list for the
videos.ratemethod has been updated to reflect that that method does not actually support theonBehalfOfContentOwnerparameter. This was a documentation error asvideos.raterequests that set this parameter return a500error.
মার্চ 31, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
videoresource's newstatus.publishAtproperty lets you specify the date and time when a private video is scheduled to be published. This property can only be set if the video's privacy status isprivateand the video has never been published. This new property is not subject to the deprecation policy .
13 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API now supports the
contentOwnerDetailspart forchannelresources. The new part contains channel data that is relevant for YouTube partners linked with the channel, including the ID of the content owner linked to the channel and the date and time when the content owner and channel were linked. Note that this new part is not subject to the deprecation policy .The documentation now lists the maximum supported character length for the following properties:
সম্পদ সম্পত্তি সর্বোচ্চ দৈর্ঘ্য channelinvideoPromotion.items[].customMessage40টি অক্ষর videosnippet.title100টি অক্ষর videosnippet.description5000 bytes videosnippet.tags500 characters. Note that the property value is a list and that commas between items in the list count toward the limit. The
channelresource'sbrandingSettings.watch.featuredPlaylistIdproperty has been deprecated. The API will return an error if you attempt to set its value.The following
videoresource properties have been added to the list of values that can be set when inserting or updating a video:ত্রুটি ডকুমেন্টেশন এখন প্রতিটি ত্রুটির ধরণের জন্য এইচটিটিপি প্রতিক্রিয়া কোড নির্দিষ্ট করে।
এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequest (400)invalidCriteriaThe channels.listmethod returns this error if the request specifies filter parameters that cannot be used in conjunction with each other.badRequest (400)channelTitleUpdateForbiddenThe channels.updatemethod returns this error if you attempt to update a channel'sbrandingSettingspart and change the value of thebrandingSettings.channel.titleproperty. (Note that the API does not return the error if you omit the property.)badRequest (400)invalidRecentlyUploadedByThe channels.updatemethod returns this error if theinvideoPromotion.items[].id.recentlyUploadedByproperty specifies an invalid channel ID.badRequest (400)invalidTimingOffsetThe channels.updatemethod returns this error if theinvideoPromotionpart specifies an invalid timing offset.badRequest (400)tooManyPromotedItemsThe channels.updatemethod returns this error if theinvideoPromotionpart specifies more than the allowed number of promoted items.forbidden (403)promotedVideoNotAllowedThe channels.updatemethod returns this error if theinvideoPromotion.items[].id.videoIdproperty specifies a video ID that either cannot be found or cannot be used as a promoted item.forbidden (403)websiteLinkNotAllowedThe channels.updatemethod returns this error if theinvideoPromotion.items[].id.websiteUrlproperty specifies a URL that is not allowed.required (400)requiredTimingTypeThe channels.updatemethod returns this error if a request does not specify default timing settings for when YouTube should display a promoted item.required (400)requiredTimingThe channels.updatemethod must specify aninvideoPromotion.items[].timingobject for each promoted item.required (400)requiredWebsiteUrlThe channels.updatemethod must specify aninvideoPromotion.items[].id.websiteUrlproperty for each promoted item.badRequest (400)invalidPublishAtThe videos.insertmethod returns this error if the request metadata specifies an invalid scheduled publishing time.
4 মার্চ, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The YouTube Data API, v3 is now subject to the Deprecation Policy described in the YouTube APIs Terms of Service . Note that the page that lists the APIs that are subject to the deprecation policy specifically excludes some v3 API functionality from being subject to the policy.
5 ডিসেম্বর, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
search.listmethod's documentation has been updated to properly reflect that you do not need to specify a value for exactly one filter parameter when submitting a search request. Rather, you can set a value for zero filter parameters or for one filter parameter.The definitions for the
search.listmethod's parameters have been updated to note that you must set thetypeparameter's value tovideoif you also specify a value for any of the following parameters:-
eventType -
videoCaption -
videoCategoryId -
videoDefinition -
videoDimension -
videoDuration -
videoEmbeddable -
videoLicense -
videoSyndicated -
videoType
-
The minimum size of uploaded channel banner images has been reduced to 2048px by 1152px. (Previously, the minimum size was 2120px by 1192px.) In addition, note that the
channelresource documentation specifies the maximum sizes of all of the banner images served from the API. For example, the maximum size of thebrandingSettings.image.bannerTvImageUrlimage for television applications is 2120px by 1192px, but the actual image may be 2048px by 1152px. The YouTube Help Center provides additional guidance for optimizing channel art for display on different types of devices.Several
channelresource property definitions have been updated to reflect the following information:- The
brandingSettings.channel.descriptionproperty's value has a maximum length of 1000 characters. - The
brandingSettings.channel.featuredChannelsTitleproperty has a maximum length of 30 characters. - The
brandingSettings.channel.featuredChannelsUrls[]property can now list up to 100 channels. - The
brandingSettings.channel.unsubscribedTrailerproperty value, if set, must specify the YouTube video ID of a public or unlisted video that is owned by the channel owner.
- The
The
channels.updatemethod now supports updates to theinvideoPromotion.items[].promotedByContentOwnerproperty. That property indicates whether the content owner's name will be shown when displaying the promotion. It can only be set if the API request that sets the property value is being made on the content owner's behalf using theonBehalfOfContentOwnerparameter.The
playlistItems.listandplaylistItems.insertmethods now support theonBehalfOfContentOwnerparameter, which is already supported for several other methods.The
contentDetails.contentRating.acbRatingproperty can now specify a rating from either the Australian Classification Board (ACB) for movies or from the Australian Communications and Media Authority (ACMA) for children's television programming.The new
contentDetails.contentRating.catvRatingandcontentDetails.contentRating.catvfrRatingproperties identify the ratings that a video received under the Canadian TV Classification System and the French-language Régie du cinéma rating system, which is used in Québec, respectively.The
videoCategoryresource's newsnippet.assignableproperty indicates whether updated videos or newly uploaded videos can be associated with that video category.Code samples have been added for the following methods:
-
activities.insert(Go) -
channelBanners.insert(Python) -
channels.update(Python) -
playlistItems.list(Go) -
search.list(Go) -
thumbnails.set(Java) -
videos.insert(Go)
-
অক্টোবর 24, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API includes two additional features designed to help find and feature live broadcast content:
The new
snippet.liveBroadcastContentproperty in search results indicates whether a video or channel resource has live broadcast content. Valid property values areupcoming,active, andnone.The
videoresource's newsnippet.liveBroadcastContentproperty indicates whether the video is an upcoming or active live broadcast. The list below explains the property's possible values:-
upcoming– The video is a live broadcast that has not yet started. -
active– The video is an ongoing live broadcast. -
none– The video is not an upcoming or active live broadcast. This will be the property value for completed broadcasts that are still viewable on YouTube.
-
The
videoresource's newliveStreamingDetailsproperty is an object that contains metadata about a live video broadcast. To retrieve this metadata, includeliveStreamingDetailsin thepartparameter value's list of resource parts. The metadata includes the following new properties:-
liveStreamingDetails.actualStartTime– The time that the broadcast actually started. (This value will be present once the broadcast's state isactive.) -
liveStreamingDetails.actualEndTime– The time that the broadcast actually ended. (This value will be present once the broadcast is over.) -
liveStreamingDetails.scheduledStartTime– The time that the broadcast is scheduled to begin. -
liveStreamingDetails.scheduledEndTime– The time that the broadcast is scheduled to end. If the property value is empty or the property is not present, then the broadcast is scheduled to go on indefinitely. -
liveStreamingDetails.concurrentViewers– The number of people watching the live broadcast.
To retrieve this metadata, include
liveStreamingDetailsin thepartparameter value when calling thevideos.list,videos.insert, orvideos.updatemethod.-
Note that two other features for identifying live broadcast content were released on October 1, 2013 – the
search.listmethod'seventTypeparameter and the search result'ssnippet.liveBroadcastContentproperty.The
videos.insertmethod now supports thenotifySubscribersparameter, which indicates whether YouTube should send a notification about the new video to users who subscribe to the video's channel. The parameter's default value isTrue, which indicates that subscribers will be notified of newly uploaded videos. However, a channel owner who is uploading many videos might prefer to set the value toFalseto avoid sending a notification about each new video to the channel's subscribers.The list of properties that can be modified when calling the
channels.updatemethod has been updated to include theinvideoPromotion.items[].customMessageandinvideoPromotion.items[].websiteUrlproperties. In addition, the list has been modified to identify thebrandingSettingsproperties that are modifiable. ThesebrandingSettingsproperties were already modifiable, so the documentation change does not reflect a change to the API's existing functionality.The
playlists.insert,playlists.update, andplaylists.deletemethods now support theonBehalfOfContentOwnerparameter, which is already supported for several other methods.The
playlists.insertmethod now supports theonBehalfOfContentOwnerChannelparameter, which is already supported for several other methods.The
videoresource'scontentDetails.contentRating.tvpgRatingproperty now supports a value ofpg14, which corresponds to aTV-14rating.The definition of the
snippet.liveBroadcastContentproperty, which is part of search results, has been corrected to reflect thatliveis a valid property value, butactiveis not a valid property value.The
videoresource'scontentDetails.contentRating.mibacRatingproperty now supports two additional ratings:-
mibacVap(VAP) – Children should be accompanied by an adult. -
mibacVm6(VM6) – Restricted to 6 and over. -
mibacVm12(VM12) – Restricted to 12 and over.
-
The
channelresource's newinvideoPromotion.items[].promotedByContentOwnerproperty indicates whether the content owner's name will be shown when displaying the promotion. This field can only be set if the API request that sets the value is being made on the content owner's behalf. See theonBehalfOfContentOwnerparameter for more information.
1 অক্টোবর, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelresource's newauditDetailsobject contains channel data that a multichannel network (MCN) would evaluate while determining whether to accept or reject a particular channel. Note that any API request that retrieves this resource part must provide an authorization token that contains thehttps://www.googleapis.com/auth/youtubepartner-channel-auditscope. In addition, any token that uses that scope must be revoked when the MCN decides to accept or reject the channel or within two weeks of the date that the token was issued.The
channelresource'sinvideoPromotion.items[].id.typeproperty now supports a value ofrecentUpload, which indicates that the promoted item is the most recently uploaded video from a specified channel.By default, the channel is the same as the one for which the in-video promotion data is set. However, you can promote the most recently uploaded video from another channel by setting the value of the new
invideoPromotion.items[].id.recentlyUploadedByproperty to the channel ID for that channel.The
channelresource contains three new properties –brandingSettings.image.bannerTvLowImageUrl,brandingSettings.image.bannerTvMediumImageUrl,brandingSettings.image.bannerTvHighImageUrl– that specify the URLs for the banner images that display on channel pages in television applications.The new
snippet.liveBroadcastContentproperty in search results indicates whether a video or channel resource has live broadcast content. Valid property values areupcoming,active, andnone.- For a
videoresource, a value ofupcomingindicates that the video is a live broadcast that has not yet started, while a value ofactiveindicates that the video is an ongoing live broadcast. - For a
channelresource, a value ofupcomingindicates that the channel has a scheduled broadcast that has not yet started, while a value ofaciveindicates that the channel has an ongoing live broadcast.
- For a
In the
watermarkresource, thetargetChannelIdproperty has changed from an object to a string. Instead of containing a child property that specifies the YouTube channel ID of the channel that the watermark image links to, thetargetChannelIdproperty now specifies that value itself. Accordingly, the resource'stargetChannelId.valueproperty has been removed.The
thumbnails.setmethod now supports theonBehalfOfContentOwnerparameter, which is already supported for several other methods.The
search.listmethod now supports theeventTypeparameter, which restricts a search to only return either active, upcoming, or completed broadcast events.The new
contentDetails.contentRating.mibacRatingproperty identifies the rating that a video received from Italy's Ministero dei Beni e delle Attivita Culturali e del Turismo.এপিআই এখন নিম্নলিখিত ত্রুটিগুলি সমর্থন করে:
ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestinvalidImageThe thumbnails.setmethod returns this error if the provided image content is invalid.forbiddenvideoRatingDisabledThe videos.ratemethod returns this error if the owner of the video that is being rated has disabled ratings for that video.
আগস্ট 27, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
watermarkresource identifies an image that displays during playbacks of a specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears during video playbacks and the length of time it is visible.The
watermarks.setmethod uploads and sets a channel's watermark image. Thewatermarks.unsetmethod deletes a channel's watermark image.The error documentation describes the error messages that the API supports specifically for the
watermarks.setandwatermarks.unsetmethods.The
channelresource's newstatistics.hiddenSubscriberCountproperty contains a boolean value that indicates whether the channel's number of subscribers is hidden. As such, the property's value isfalseif the channel's subscriber count is publicly visible.The
playlists.listmethod now supports theonBehalfOfContentOwnerandonBehalfOfContentOwnerChannelparameters. Both parameters are already supported for several other methods.The
videos.listmethod now supports theregionCodeparameter, which identifies the content region for which a chart should be retrieved. This parameter can only be used in conjunction with thechartparameter. প্যারামিটার মান হল একটি ISO 3166-1 আলফা-2 দেশের কোড।The
error documentationdescribes the following new common request error, which could occur for multiple API methods:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা forbiddeninsufficientPermissionsThe scopes associated with the OAuth 2.0 token provided for the request are insufficient for accessing the requested data.
আগস্ট 15, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelresource'sinvideoPromotionobject has the following new and updated properties:The API now supports the ability to specify a website as a promoted item. To do so, set the
invideoPromotion.items[].id.typeproperty value towebsiteand use the newinvideoPromotion.items[].id.websiteUrlproperty to specify the URL. Also use the newinvideoPromotion.items[].customMessageproperty to define a custom message to display for the promotion.Links can be to associated websites, merchant sites, or social networking sites. See the YouTube Help Center instructions for associated websites and merchant sites for more information about enabling links for your content.
By adding promotional links, you agree that those links will not be used to redirect traffic to unauthorized sites and that those links will comply with YouTube's AdWords policies , YouTube ad policies , YouTube Community Guidelines and YouTube Terms of Service .
The properties related to the timing settings for displaying promoted items during video playback have been restructured:
The
invideoPromotion.timingobject has been moved toinvideoPromotion.items[].timing. This object now enables you to customize the timing data for each promoted item in theinvideoPromotion.items[]list.The new
invideoPromotion.defaultTimingobject specifies default timing settings for your promotion. Those settings define when a promoted item will display during playback of one of your channel's videos. You can override the default timing for any given promoted item using theinvideoPromotion.items[].timingobject.The new
invideoPromotion.items[].timing.durationMsproperty specifies the amount of time, in milliseconds, that the promotion should display. TheinvideoPromotion.defaultTimingobject also contains adurationMsfield that specifies the default amount of time that the promoted item will display.
The
invideoPromotion.items[].typeandinvideoPromotion.items[].videoIdproperties both have been moved into theinvideoPromotion.items[].idobject.
The
subscriptions.listmethod now supports theonBehalfOfContentOwnerandonBehalfOfContentOwnerChannelparameters. Both parameters are already supported for several other methods.In the API response to a
thumbnails.setrequest, thekindproperty value has changed fromyoutube#thumbnailListResponsetoyoutube#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.insertmethod was also removed since the functionality it demonstrated is now handled by thevideos.ratemethod.-
The
error documentationdescribes the following new request context error, which could occur for any API method that supports theminerequest parameter:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestinvalidMineThe mineparameter cannot be used in requests where the authenticated user is a YouTube partner. You should either remove themineparameter, authenticate as a YouTube user by removing theonBehalfOfContentOwnerparameter, or act as one of the partner's channels by providing theonBehalfOfContentOwnerChannelparameter if available for the called method.
8 আগস্ট, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The Getting Started with the YouTube Data API guide's Quota Usage section has been updated to reflect a change in the quota cost of a video upload from approximately 16000 units to approximately 1600 units.
জুলাই 30, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
In a
channelBannerresource, the value of thekindproperty's value has changed fromyoutube#channelBannerInsertResponsetoyoutube#channelBannerResource. This resource is returned in response to achannelBanners.insertrequest.The
channelresource's newbrandingSettings.channel.profileColorproperty 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
subscriptionresource's newcontentDetails.activityTypeproperty identifies the types of activities that the subscriber will be notified about. Valid property values areallanduploads.The
videos.listmethod supports new parameters for retrieving a chart of the most popular videos on YouTube:- The
chartparameter identifies the chart that you want to retrieve. Currently, the only supported value ismostPopular. Note that thechartparameter is a filter parameter, which means it cannot be used in the same request as other filter parameters (idandmyRating). - The
videoCategoryIdparameter identifies the video category for which the chart should be retrieved. This parameter can only be used in conjunction with thechartparameter. By default, charts are not restricted to a particular category.
- The
The
videoresource'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
videoresource'srecordingDetails.location.elevationproperty has been renamed torecordingDetails.location.altitude, and itsfileDetails.recordingLocation.location.elevationproperty has been renamed tofileDetails.recordingLocation.location.altitude.The
videoresource'scontentDetails.contentRatingobject 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
videoresource's newcontentDetails.contentRating.ytRatingproperty identifies age-restricted content. The property value will beytAgeRestrictedif 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.listmethod'smySubscribersparameter has been deprecated. Use thesubscriptions.listmethod and itsmySubscribersparameter to retrieve a list of subscribers to the authenticated user's channel.The
channelBanners.insert,channels.update,videos.getRating, andvideos.ratemethods all now support theonBehalfOfContentOwnerparameter. That parameter indicates that the authenticated user is acting on behalf of the content owner specified in the parameter value.The
channels.updatemethod's documentation has been updated to reflect the fact that that method can be used to update thechannelresource'sbrandingSettingsobject and its child properties. The documentation also now lists the updated list of properties that you can set for thechannelresource'sinvideoPromotionobject.The
error documentationdescribes the following new errors:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা forbiddenaccountDelegationForbiddenThis 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. forbiddenauthenticatedUserAccountClosedThis 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. forbiddenauthenticatedUserAccountSuspendedThis 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. forbiddenauthenticatedUserNotChannelThis 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 onBehalfOfContentOwnerparameter, you should also set theonBehalfOfContentOwnerChannelparameter.forbiddencmsUserAccountNotFoundThis error is not specific to a particular API method. The CMS user is not allowed to act on behalf of the specified content owner. notFoundcontentOwnerAccountNotFoundThis error is not specific to a particular API method. The specified content owner account was not found. badRequestinvalidPartThis error is not specific to a particular API method. The request's partparameter specifies parts that cannot be written at the same time.badRequestvideoChartNotFoundThe videos.listmethod returns this error when the request specifies an unsupported or unavailable video chart.notFoundvideoNotFoundThe videos.updatemethod returns this error to indicate that the video you are trying to update cannot be found. Check the value of theidproperty in the request body to ensure it is correct.
জুন 10, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channels.listmethod's newforUsernameparameter enables you to retrieve information about a channel by specifying its YouTube username.The
activities.listmethod now supports theregionCodeparameter, 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.tagsproperty. 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.insertorplaylists.updatemethods.The
onBehalfOfContentOwnerparameter, which was previously supported for thechannels.listandsearch.listmethods, is now also supported for thevideos.insert,videos.update, andvideos.deletemethods. Note that when this parameter is used in a call to thevideos.insertmethod, the request must also specify a value for the newonBehalfOfContentOwnerChannelparameter, which identifies the channel to which the video will be added. The channel must be linked to the content owner that theonBehalfOfContentOwnerparameter 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 documentationdescribes the following new errors:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা forbiddeninsufficientCapabilitiesThis 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 onBehalfOfContentOwnerparameter, which is supported for several API methods.unauthorizedauthorizationRequiredThe activities.listmethod returns this error when the request uses thehomeparameter but is not properly authorized.In the
channelsresource, theinvideoPromotion.channelIdproperty has been removed because the channel ID is already specified using the resource'sidproperty.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
defaultuser or that rely on the notion that every YouTube channel has a unique username, which is no longer the case.
22 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
channelBanners.insertmethod enables you to upload a banner image that can subsequently be set as the banner image for a channel using thechannelresource's newbrandingSettings.image.bannerExternalUrlproperty.The documentation for the
channels.updatemethod has been updated to list the properties that can be modified when calling the method.The
videoresource documentation no longer listsunspecifiedas a valid property value for thesuggestions.processingErrors[],suggestions.processingHints[],suggestions.processingWarnings[], andsuggestions.editorSuggestions[]properties.The
videos.listmethod'smaxResultsparameter now has a default value of5.The
error documentationnow lists errors for thechannelBanners.insertandsubscriptions.listmethods. It also lists several new errors for thechannels.updatemethod.
14 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Standalone pages now list code samples for Java , .NET , PHP , and Ruby .
The page that lists Python code samples now includes examples for adding a subscription, creating a playlist, and updating a video.
10 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
ইউটিউব আর পরীক্ষামূলক এপিআই বৈশিষ্ট্য এবং পরিষেবাগুলি সনাক্ত করে না। পরিবর্তে, আমরা এখন ইউটিউব এপিআইগুলির একটি তালিকা সরবরাহ করি যা অবমূল্যায়ন নীতি সাপেক্ষে ।
8 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Channel resources now support the
inVideoPromotionobject, 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
invideoPromotionin thepartparameter value in achannels.listrequest.The new
channels.updatemethod can be used to update a channel's in-video promotional campaign data. Note that the method only supports updates to theinvideoPromotionpart of thechannelresource and does not yet support updates to other parts of that resource.
2 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Channel resources now support the
status.isLinkedproperty, 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
subscriberSnippetpart. That object encapsulates contains snippet data for the subscriber's channel.The API now supports the
videos.getRatingmethod, which retrieves the ratings that the authenticated user gave to a list of one or more videos.The
videos.listmethod's newmyRatingparameter enables you to retrieve a list of videos that the authenticated user rated with alikeordislikerating.The
myRatingparameter and theidparameter are both now considered filter parameters, which means that an API request must specify exactly one of the parameters. (Previously, theidparameter was a required parameter for this method.)The method returns a
forbiddenerror for requests that attempt to retrieve video rating information but are not properly authorized to do so.With the introduction of the
myRatingparameter, thevideos.listmethod has also been updated to support pagination. Note, however, that paging parameters are only supported for requests using themyRatingparameter. (Paging parameters and information are not supported for requests that use theidparameter.)The
maxResultsparameter specifies the maximum number of videos that the API can return in the result set, and thepageTokenparameter identifies a specific page in the result set that you want to retrieve.The
youtube#videoListResponseresource, which is returned in response to avideos.listrequest, now contains thepageInfoobject, which contains details like the total number of results and the number of results included in the current result set. Theyoutube#videoListResponseresource can also includenextPageTokenandprevPageTokenproperties, each of which provides a token that could be used to retrieve a specific page in the result set.
The
videos.insertmethod supports the following new parameters:-
autoLevels– Set this parameter value totrueto instruct YouTube to automatically enhance the video's lighting and color. -
stabilize– Set this parameter value totrueto instruct YouTube to adjust the video by removing shakiness resulting from camera motions.
-
The
channelTitleproperty has been added to thesnippetfor 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.listmethod's newmySubscribersparameter 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
mySubscribersparameter currently supported for thechannels.listmethod. That parameter will be deprecated.In a
videoresource, the property valueunspecifiedis no longer a possible value for any of the following properties:API requests that contain an unexpected parameter now return a
badRequesterror, and the reported reason for the error isunexpectedParameter.The error that the
playlistItems.insertmethod returns when the playlist already contains the maximum number of allowed items has been updated. The error is now reported as aforbiddenerror, and the error reason isplaylistContainsMaximumNumberOfVideos.
এপ্রিল 19, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new
videos.ratemethod lets a user set alikeordislikerating 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.ratemethod call.Thumbnail images are now identified in the API documentation as a separate resource , and the new
thumbnails.setmethod 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.setmethod 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
channelresource's newbrandingSettingspart identifies settings, text, and images for the channel's channel page and video watch pages.The
playlistItemresource contains the following new properties:The new
statusobject encapsulates status information about the playlist item, and thestatus.privacyStatusproperty identifies the playlist item's privacy status.
The
videoresource contains the following new properties:The
status.publicStatsViewableproperty 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.insertorvideos.updatemethod.The
contentDetails.contentRatingobject 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.দেশ রেটিং সিস্টেম সম্পত্তি United StatesMotion Picture Association of America (MPAA) contentDetails.contentRating.mpaaRatingUnited Statesটিভি অভিভাবকীয় নির্দেশিকা contentDetails.contentRating.tvpgRatingAustraliaAustralian Classification Board (ACB) contentDetails.contentRating.acbRatingBrazilDepartamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRatingCanadaCanadian Home Video Rating System (CHVRS) contentDetails.contentRating.chvrsRatingFranceCentre national du cinéma et de l'image animée (French Ministry of Culture) contentDetails.contentRating.fmocRatingGermanyFreiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRatingGreat BritainBritish Board of Film Classification (BBFC) contentDetails.contentRating.bbfcRatingIndiaCentral Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRatingJapan映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRatingKorea영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRatingMexicoGeneral Directorate of Radio, Television and Cinematography (RTC) contentDetails.contentRating.rtcRatingNew ZealandOffice of Film and Literature Classification contentDetails.contentRating.oflcRatingRussiaNational Film Registry of the Russian Federation contentDetails.contentRating.russiaRatingSpainInstituto de la Cinematografía y de las Artes Audiovisuales (ICAA)contentDetails.contentRating.icaaRating
The
playlistItems.updatemethod's documentation has been updated to reflect the fact that thesnippet.resourceIdproperty must be specified in the resource sent as the request body.The
search.listmethod now supports the following functionality:The new
forMineparameter restricts a search to only retrieve the authenticated user's videos.The
orderparameter now supports the ability to sort results alphabetically by title (order=title) or by video count in descending order (order=videoCount).The new
safeSearchparameter indicates whether search results should include restricted content.
The
videos.insertmethod supports several new errors, which are listed in the table below:ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা badRequestinvalidCategoryIdThe snippet.categoryIdproperty specifies an invalid category ID. Use thevideoCategories.listmethod to retrieve supported categories.badRequestinvalidRecordingDetailsThe metadataspecifies invalid recording details.badRequestinvalidVideoGameRatingThe request metadata specifies an invalid video game rating. badRequestinvalidVideoMetadataThe request metadata is invalid. The
onBehalfOfContentOwnerparameter has been removed from the list of supported parameters for thevideos.updateandvideos.deletemethods.
12 মার্চ, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The
channelTitleproperty has been added to thesnippetfor the following resources:The
search.listmethod supports the following new parameters:The
channelTypeparameter lets you restrict a search for channels to retrieve all channels or to retrieve only shows.The
videoTypeparameter 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
videoresource'srecordingDetailspart 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.updatemethod now returns aninvalidSnippeterror, 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
onBehalfOfContentOwnerparameter 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.updatemethods all support this parameter.The
managedByMeparameter, which is supported by thechannels.listmethod, instructs the API to return all channels owned by the content owner that theonBehalfOfContentOwnerparameter specifies.The
forContentOwnerparameter, which is supported by thesearch.listmethod, instructs the API to restrict search results to only include resources that are owned by the content owner that theonBehalfOfContentOwnerparameter specifies.
25 ফেব্রুয়ারি, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The API supports several new parts and properties for
videoresources:The new
fileDetails,processingDetails, andsuggestionsparts 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
videoresource documentation defines all of the properties that each part contains.The
fileDetailsobject 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
processingProgressobject 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
suggestionsobject contains suggestions that identify opportunities to improve the video quality or the metadata for the uploaded video.
The
contentDetailspart 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
statuspart 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 arecreativeCommonandyoutube.
-
The definition of the
partparameter has been updated for thevideos.list,videos.insert, andvideos.updatemethods to list the newly added parts described above as well as therecordingDetailspart, which had been inadvertently omitted.The
channelresource's newcontentDetails.googlePlusUserIdproperty 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, andvideoresources.The
playlistItems.listnow supports thevideoIdparameter, which can be used in conjunction with theplaylistIdparameter to only retrieve the playlist item that represents the specified video.The API returns a
notFounderror if the video that the parameter identifies cannot be found in the playlist.The error documentation describes a new
forbiddenerror, which indicates that a request is not properly authorized for the requested action.The
channelresource'ssnippet.channelIdproperty has been removed. The resource'sidproperty provides the same value.
January 30, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
The new error page lists errors that the API can return. The page includes general errors, which might occur for multiple different API methods, as well as method-specific errors.
16 জানুয়ারী, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
Code samples are now available for the methods and languages shown in the list below:
-
activities.insert– Java -
playlistItems.insert– Python -
playlistItems.list– Java, JavaScript, PHP, Python, Ruby -
playlists.insert– Java, JavaScript, Python -
search.list– Java, JavaScript, Python, Ruby -
videos.insert– Java
-
An
activityresource can now report achannelItemaction, 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.listparameters have been updated:- The
qparameter is no longer designated as a filter, which means .... - The
relatedToVideoparameter has been renamedrelatedToVideoId. - The
publishedparameter has been replaced with two new parameters,publishedAfterandpublishedBefore, which are described below.
- The
The
search.listmethod supports the following new parameters:পরামিতি নাম মান বর্ণনা channelIdstringReturn resources created by the specified channel. publishedAfterdatetimeReturn resources created after the specified time. publishedBeforedatetimeReturn resources created before the specified time. regionCodestringReturn resources for the specified country. videoCategoryIdstringFilter video search results to only include videos associated with the specified video category . videoEmbeddablestringFilter video search results to only include videos that can be played in an embedded player on a web page. Set the parameter value to trueto only retrieve embeddable videos.videoSyndicatedstringFilter video search results to only include videos that can be played outside of YouTube.com. Set the parameter value to trueto only retrieve syndicated videos.Several API resources support new properties. The table below identifies the resources and their new properties:
সম্পদ সম্পত্তির নাম মান বর্ণনা activitycontentDetails.playlistItem.playlistItemIdstringThe playlist item ID that YouTube assigned to uniquely identify the item in the playlist. activitycontentDetails.channelItemobjectAn object that contains information about a resource that was added to a channel. This property is only present if the snippet.typeischannelItem.activitycontentDetails.channelItem.resourceIdobjectAn object that identifies the resource that was added to the channel. Like other resourceIdproperties, it contains akindproperty 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.channelstatusobjectThis object encapsulates information about the channel's privacy status. channelstatus.privacyStatusstringThe channel's privacy status. Valid values are privateandpublic.playlistcontentDetailsobjectThis object contains metadata about the playlist's content. playlistcontentDetails.itemCountunsigned integerThe number of videos in the playlist. playlistplayerobjectThis object contains information that you would use to play the playlist in an embedded player. playlistplayer.embedHtmlstringAn <iframe>tag that embeds a video player that plays the playlist.videorecordingDetailsobjectThis object encapsulates information that identifies or describes the place and time that the video was recorded. videorecordingDetails.locationobjectThis object contains geolocation information associated with the video. videorecordingDetails.location.latitudedoubleডিগ্রীতে অক্ষাংশ। videorecordingDetails.location.longitudedoubleডিগ্রীতে দ্রাঘিমাংশ। videorecordingDetails.location.elevationdoubleAltitude above the Earth, in meters. videorecordingDetails.locationDescriptionstringA text description of the location where the video was recorded. videorecordingDetails.recordingDatedatetimeThe 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.insertRequired properties: -
snippet.description
-
snippet.description -
contentDetails.bulletin.resourceId
playlists.updateRequired properties: -
id
playlistItems.updateRequired properties: -
id
videos.updateRequired properties: -
id
-
The API no longer reports a
playlistAlreadyExistserror if you try to create or update a playlist that would have the same title as a playlist that already exists in the same channel.Several API methods support new error types. The table below identifies the method and the newly supported errors:
পদ্ধতি ত্রুটির ধরন ত্রুটি বিশদ বর্ণনা guideCategories.listnotFoundnotFoundThe guide category identified by the idparameter cannot be found. Use the guideCategories.list method to retrieve a list of valid values.playlistItems.deleteforbiddenplaylistItemsNotAccessibleThe request is not properly authorized to delete the specified playlist item. videoCategories.listnotFoundvideoCategoryNotFoundThe video category identified by the idparameter cannot be found. Use the videoCategories.list method to retrieve a list of valid values.