দ্রষ্টব্য: YouTube বিষয়বস্তু আইডি API YouTube সামগ্রী অংশীদারদের দ্বারা ব্যবহারের উদ্দেশ্যে এবং সমস্ত বিকাশকারী বা সমস্ত YouTube ব্যবহারকারীদের কাছে অ্যাক্সেসযোগ্য নয়৷ আপনি যদি YouTube Content ID API-কে Google API কনসোলে তালিকাভুক্ত পরিষেবাগুলির মধ্যে একটি হিসাবে দেখতে না পান তবে YouTube পার্টনার প্রোগ্রাম সম্পর্কে আরও জানতে YouTube সহায়তা কেন্দ্র দেখুন৷
এই পৃষ্ঠাটি YouTube Content ID API পরিবর্তন এবং ডকুমেন্টেশন আপডেটগুলি তালিকাভুক্ত করে৷
10 নভেম্বর, 2023
videoAdvertisingOption
রিসোর্সের adFormats[]
ক্ষেত্রটি আপডেট করা হয়েছে যাতে third_party_ads
সেই ক্ষেত্রের জন্য একমাত্র বৈধ মান। নিম্নলিখিত বিজ্ঞাপন ফর্ম্যাটগুলি আর সমর্থিত নয়: instream_trueview
, instream_standard
, display
, preroll
, postroll
. আরো বিস্তারিত জানার জন্য সমর্থন নিবন্ধ দেখুন.
জুন 1, 2023
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
-
videoAdvertisingOption
রিসোর্সেরbreakPosition[]
ক্ষেত্রটিকে অবচয় হিসেবে চিহ্নিত করা হয়েছে এবং 2024 সালে সরিয়ে দেওয়া হবে।
videoAdvertisingOptions.update
এবংvideoAdvertisingOptions.patch
পদ্ধতিগুলি ইতিমধ্যেই ক্ষেত্রটিকে উপেক্ষা করে৷ -
videoAdvertisingOption
রিসোর্সের অপ্রচলিতadBreaks[].slot[]
ক্ষেত্রটি সরানো হয়েছে। -
asset
সম্পদের অপ্রচলিতcategory
এবংshowCustomId
ক্ষেত্রগুলি সরানো হয়েছে৷ - নতুন
claim
সংস্থানেরtimeStatusLastModified
ফিল্ডটি দাবি করে শেষবার কোন সময় পরিবর্তন করা হয়েছিল। - নতুন
claimSearch.list
পদ্ধতিরisVideoShortsEligible
প্যারামিটারটি দাবি করা ভিডিওগুলিকে তাদের YouTube Shorts যোগ্যতা অনুসারে ফিল্টার করতে ব্যবহার করা যেতে পারে।
-
নতুন সম্পদ এবং পদ্ধতি
- API এখন YouTube সঙ্গীত সংস্থান তালিকা সমর্থন করে:
-
musicReleases.list
পদ্ধতিতেmusicRelease
সংস্থান তালিকাভুক্ত করা যেতে পারে। -
musicTrack
সম্পদগুলিmusicTracks.list
পদ্ধতিতে তালিকাভুক্ত করা যেতে পারে। -
musicChangeRequest
সম্পদগুলিmusicChangeRequests.list
পদ্ধতির সাথে তালিকাভুক্ত করা যেতে পারে।
-
- API এখন YouTube সঙ্গীত সংস্থান তালিকা সমর্থন করে:
20 ডিসেম্বর, 2022
assetSearch.list
পদ্ধতির ownershipRestriction
ক্যোয়ারী প্যারামিটারের সংজ্ঞাটি পরিষ্কার করার জন্য আপডেট করা হয়েছে যে যদি সেই প্যারামিটারের মানটি none
হয় তবে metadataSearchFields
প্যারামিটার মানটিকেও অন্তত একটি আইডি ফিল্টার ব্যবহার করতে হবে৷ এই ডকুমেন্টেশন পরিবর্তন API আচরণের পরিবর্তন প্রতিফলিত করে না।
9 নভেম্বর, 2022
asset.get
এবং asset.list
পদ্ধতির জন্য ডকুমেন্টেশন আপডেট করা হয়েছে কিভাবে একাধিক মান সমর্থিত হয় তা স্পষ্ট করার জন্য:
28 সেপ্টেম্বর, 2022
লাইসেন্সযোগ্যতার তথ্য asset resource
যোগ করা হয়েছে।
18 জুলাই, 2022
YouTube স্টুডিওর সাথে সামঞ্জস্যের জন্য উন্নতি প্রতিফলিত করার জন্য claimSearch.list
পদ্ধতির inactiveReasons
জন্য ডকুমেন্টেশন আপডেট করা হয়েছে:
- স্টুডিও আগে
Audio Swap
এবংSong Erase
জন্য সমর্থন সরিয়ে দিয়েছে। সংশ্লিষ্ট API মানগুলি,audio_removed
এবংsong_erased
, নিঃশব্দে উপেক্ষা করা হয়েছিল এবং এখন নথিভুক্ত করা হয়েছে৷ -
channel_whitelisted
এর পরিবর্তেchannel_allowlisted
করা হয়েছে। পূর্ববর্তী মানটি আর নথিভুক্ত নয় কিন্তু এখনও সমর্থিত। -
closed_disabled_monetization
,closed_manually
,closed_no_adsense
,closed_own_video_match
,reference_removed
,replaced
, এবংvideo_modified
এখন সমর্থিত।
14 জুন, 2022
assetSearch
রিসোর্স ডকুমেন্টেশন দুটি নতুন বৈশিষ্ট্য প্রতিফলিত করার জন্য আপডেট করা হয়েছে: isrcs[]
এবং iswcs[]
। নতুন isrcs[]
এবং iswcs[]
প্রপার্টি মানগুলির প্রতিটিতে স্ট্রিং মানগুলির একটি অ্যারে থাকে যার প্রতিটি মানের সাথে একটি ISRC বা ISWC নির্দিষ্ট করে, যথাযত, যা অনুসন্ধান ফলাফল দ্বারা চিহ্নিত সম্পদের মানচিত্র করে৷
নতুন বৈশিষ্ট্যগুলি isrc
এবং iswc
বৈশিষ্ট্যগুলির উপর সুপারিশ করা হয়েছে যা ইতিমধ্যেই assetSearch
সংস্থানগুলিতে অন্তর্ভুক্ত করা হয়েছে কারণ নতুন বৈশিষ্ট্যগুলি আরও সঠিক ডেটা সরবরাহ করে৷ যেখানে নতুন বৈশিষ্ট্যগুলি সম্ভাব্যভাবে স্ট্রিং মানগুলির একটি অ্যারে তালিকাভুক্ত করে, সেখানে isrc
এবং iswc
বৈশিষ্ট্য প্রতিটি অনুসন্ধান ফলাফলের সাথে যুক্ত শুধুমাত্র একটি ISRC বা ISWC কোড সনাক্ত করে।
12 মে, 2022
ক্লায়েন্ট লাইব্রেরির লিঙ্কগুলিকে স্ট্যান্ডার্ড Google APIs ক্লায়েন্ট লাইব্রেরির দিকে নির্দেশ করার জন্য আপডেট করা হয়েছিল। PHP-এর জন্য পূর্ব-উত্পাদিত বাইন্ডিং আপডেট করা হয়েছে।
3 মে, 2022
claimSearch.list
পদ্ধতির status
প্যারামিটার এখন সম্ভাব্য দাবির বিবরণের উপর ভিত্তি করে আরও ফিল্টার সমর্থন করে।
2 মে, 2022
AIP-158- এর সাথে সামঞ্জস্যের জন্য উন্নতি প্রতিফলিত করতে assetSearch.list
পদ্ধতির প্রতিক্রিয়ার জন্য ডকুমেন্টেশন আপডেট করা হয়েছে:
-
pageInfo.totalResults
এর বিবরণ স্পষ্টভাবে উল্লেখ করে যে মানটি একটি অনুমান এবং প্রকৃত মান নয় - ক্ষেত্র
pageInfo.resultsPerPage
এবংpageInfo.startIndex
সরানো হয়েছে
25 এপ্রিল, 2022
assetLabels.list
রিসোর্সের জন্য ডকুমেন্টেশন আপডেট করা হয়েছে labelPrefix
এবং q
অনুরোধের পরামিতিগুলির অর্থ স্পষ্ট করার জন্য, এবং অনুরোধ/প্রতিক্রিয়া সমর্থন পৃষ্ঠায় নথিভুক্ত করার জন্য।
8 ডিসেম্বর, 2021
এই পদ্ধতিটি কভার করে এমন দুটি ব্যবহারের ক্ষেত্রে সঠিকভাবে প্রতিফলিত করার জন্য claimSearch.list
রিসোর্সের ডকুমেন্টেশন আপডেট করা হয়েছে:
- আইডি (সম্পদ, রেফারেন্স বা ভিডিও) বা ক্যোয়ারী স্ট্রিং দ্বারা অনুসন্ধান করুন
- দাবি তৈরির তারিখ, পরিবর্তনের তারিখ বা স্থিতি দ্বারা অনুসন্ধান করুন
প্রতিটি ব্যবহারের ক্ষেত্রে আলাদা আলাদা ক্যোয়ারী প্যারামিটার সমর্থন করে। প্রতিটি ব্যবহারের ক্ষেত্রে কোন প্যারামিটার সমর্থিত তা ব্যাখ্যা করার জন্য claimSearch.list
পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে।
17 নভেম্বর, 2021
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:
-
claims.update
পদ্ধতিটি এখন একটি নিষ্ক্রিয় বা সম্ভাব্য দাবির স্থিতিactive
তে আপডেট করার ক্ষমতা সমর্থন করে।claim
সম্পদেরstatus
সম্পত্তির সংজ্ঞা আরো বিশদ প্রদান করে। -
claim
এবংclaimSearch
সংস্থানগুলির ডকুমেন্টেশন নতুনstudioInfo
অবজেক্টের সংযোজন প্রতিফলিত করার জন্য আপডেট করা হয়েছে, যাতে দাবি সম্পর্কিত YouTube স্টুডিও পৃষ্ঠাগুলির লিঙ্ক রয়েছে৷ -
claimSearch.list
পদ্ধতিরorigin
প্যারামিটারের জন্য সমর্থিত মানগুলির তালিকা পরিবর্তিত হয়েছে। প্যারামিটারটি এখন চারটি অতিরিক্ত মান সমর্থন করে:batchTool
,inProductShorts
,melodyMatch
, এবংyouTubeAdmin
। উপরন্তু,dropboxUpload
এবংwebUpload
মান আর সমর্থিত নয়।
26 ফেব্রুয়ারি, 2021
claimSearch.list
পদ্ধতির videoId
প্যারামিটারের জন্য ডকুমেন্টেশন আপডেট করা হয়েছে লক্ষ্য করার জন্য যে প্যারামিটার মান এখন সর্বাধিক 10টি কমা-বিভাজিত ভিডিও আইডি গ্রহণ করে৷ API একটি badRequest
ত্রুটি ফিরিয়ে দেবে — 400
HTTP প্রতিক্রিয়া কোড — যদি মানটিতে 10টির বেশি ভিডিও আইডি থাকে।
ডিসেম্বর 6, 2018
দ্রষ্টব্য: এটি একটি অবমূল্যায়ন ঘোষণা।
API ডকুমেন্টেশন আপডেট করা হয়েছে contentOwnerAdvertisingOptions
রিসোর্স এবং এর পদ্ধতির রেফারেন্স মুছে ফেলার জন্য। এই পদ্ধতিগুলি খুব কম ব্যবহার করা হয়েছিল, এবং এপিআই ব্যবহারকারীরা যারা এগুলি ব্যবহার করেছিল তাদের এই ঘোষণার আগে আলাদাভাবে যোগাযোগ করা হয়েছিল।
21 মার্চ, 2018
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
metadataMine.artist
প্রপার্টিটি এখন অবশ্যই সেট করা আবশ্যক যখন আপনি একটি মিউজিক ভিডিও বা সাউন্ড রেকর্ডিং সম্পদ সন্নিবেশ , আপডেট বা প্যাচ করবেন । এপিআই এখন একটি ত্রুটি ফেরত দেয় যদি সম্পত্তিটি ঐ সম্পদ প্রকারের জন্য সেট করা না থাকে। এছাড়াও, মনে রাখবেন যেmetadataMine.artist
সম্পত্তি শুধুমাত্র সঙ্গীত ভিডিও এবং সাউন্ড রেকর্ডিং শিল্পীদের জন্য সমর্থিত।
জুলাই 24, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
package
রিসোর্স ওয়েব, SFTP বা অন্য ডেলিভারি মেকানিজমের মাধ্যমে বিতরণ করা ফাইলগুলির একটি গ্রুপকে প্রতিনিধিত্ব করে। এপিআই এই সম্পদের জন্য দুটি পদ্ধতি সমর্থন করে:-
package.insert
পদ্ধতিটি একটি মেটাডেটা-শুধুমাত্র প্যাকেজ যাচাই করে এবং আপলোড করে যাতে ঠিক একটি মেটাডেটা ফাইল থাকে। -
package.get
পদ্ধতি পূর্বে আপলোড করা প্যাকেজ সম্পর্কে তথ্য পুনরুদ্ধার করে।
-
validator.validate
পদ্ধতির জন্য,uploaderName
প্রপার্টির সংজ্ঞা আপডেট করা হয়েছে লক্ষ্য করার জন্য যে মানটি ডেটা আপলোডকারী সামগ্রী অংশীদারকে সনাক্ত করে না বরংweb-google
বাyt-google
এর মতো একটি মান যা নির্দিষ্ট আপলোডার অ্যাকাউন্টটিকে সনাক্ত করে যা বিষয়বস্তুর মালিক ব্যবহার করছেন।reference
রিসোর্সেরstatus
প্রোপার্টি আরduplicate_on_hold
মান ব্যবহার করে না যে একটি রেফারেন্স অন্য রেফারেন্সের ডুপ্লিকেট। পরিবর্তে, যদি একটি রেফারেন্স একটি সদৃশ হয়, তাহলেstatus
সম্পত্তির মান এখনinactive
হিসাবে সেট করা হয়েছে, এবংstatusReason
সম্পত্তির মান হলREASON_DUPLICATE_FOR_OWNERS
।যাইহোক, আগের মতো, রেফারেন্সটি সদৃশ হলেই রিসোর্সের
duplicateLeader
প্রপার্টি পপুলেট করা হয়। যদি এটি সেট করা হয়, তাহলে সেই সম্পত্তির মান ডুপ্লিকেট রেফারেন্স সনাক্ত করে।
এপ্রিল 17, 2017
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
assetShare
সম্পদ যা শুধুমাত্র রচনা সম্পদের সাথে প্রাসঙ্গিক, একটি সম্পদ সম্পদের দুটি উপস্থাপনার মধ্যে একটি সম্পর্ক চিহ্নিত করে এই উপস্থাপনাগুলি একটি নতুন প্রকাশনা ডেটা মডেলকে প্রতিফলিত করে যা আরও স্বচ্ছতা প্রদানের জন্য ডিজাইন করা হয়েছে এবং কীভাবে আপনার অধিকারগুলি সাউন্ড রেকর্ডিং সম্পদের সাথে যুক্ত তা নিয়ন্ত্রণ করে৷নতুন মডেলে, প্রতিটি শব্দ রেকর্ডিং মানচিত্র ঠিক একটি, অনন্য সম্পদ, যাকে একটি রচনা দৃশ্য বলা হয়। সেই সম্পদের মেটাডেটা তথ্যের ক্যানোনিকাল সেটকে প্রতিনিধিত্ব করে যা YouTube প্রদত্ত রেকর্ডিংয়ের সাথে যুক্ত রচনা অধিকার সম্পর্কে প্রদর্শন করে এবং এটি একাধিক ডেটা প্রদানকারীর কাছ থেকে তথ্য সংশ্লেষ করতে পারে।
উপরন্তু, রচনার প্রতিটি মালিকের নিজস্ব কম্পোজিশন শেয়ার সম্পদ রয়েছে। কম্পোজিশন শেয়ার সেই তথ্য উপস্থাপন করে যা একটি নির্দিষ্ট প্রকাশক একটি রচনা সম্পদের জন্য প্রদান করে। কম্পোজিশন শেয়ার অনেক সাউন্ড রেকর্ডিংয়ের সাথে যুক্ত হতে পারে।
assetShare
রিসোর্স একটি কম্পোজিশন ভিউ এবং কম্পোজিশন শেয়ারের মধ্যে সম্পর্ক চিহ্নিত করে। নতুনassetShares.list
পদ্ধতি আপনাকে নিম্নলিখিতগুলির যেকোনো একটি করতে দেয়:- একটি কম্পোজিশন ভিউয়ের আইডি প্রদান করুন এবং অনুরূপ কম্পোজিশন শেয়ারটি পুনরুদ্ধার করুন যা অংশীদারের মালিকানাধীন অনুরোধটি অনুমোদন করে, যদি এই ধরনের একটি শেয়ার বিদ্যমান থাকে।
- বিষয়বস্তু অংশীদারের মালিকানাধীন একটি কম্পোজিশন শেয়ারের আইডি প্রদান করুন এবং সেই শেয়ারটি লিঙ্ক করা হয়েছে এমন সমস্ত কম্পোজিশন ভিউগুলির একটি তালিকা পুনরুদ্ধার করুন৷
নতুন ম্যানেজিং কম্পোজিশন অ্যাসেট গাইড ব্যাখ্যা করে যে কীভাবে বিভিন্ন এপিআই পদ্ধতি অনুরোধগুলি পরিচালনা করে সেই পদ্ধতিতে জমা দেওয়া সম্পদ আইডিগুলি কম্পোজিশন ভিউ বা কম্পোজিশন শেয়ার শনাক্ত করে কিনা তার উপর নির্ভর করে।
contentOwnerAdvertisingOptions
রিসোর্সের নতুনclaimedVideoOptions.autoGeneratedBreaks
প্রপার্টি নির্দেশ করে যে YouTube স্বয়ংক্রিয়ভাবে দাবি করা ভিডিওগুলিতে বিজ্ঞাপন বিরতি তৈরি করবে যা 10 মিনিটের বেশি দীর্ঘ। যদিও সম্পত্তিটি 10 মিনিটের বেশি দীর্ঘ সামগ্রীর মালিকের ভিডিওগুলিকে প্রভাবিত করে, যদি একটি ভিডিওতে একাধিক দাবি থাকে, প্রথম অংশীদার যে ভিডিওটি দাবি করে সেই ভিডিওটির সাথে সম্পর্কিত এই সম্পত্তির জন্য ডিফল্ট আচরণ সেট করে৷
11 আগস্ট, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
সদ্য প্রকাশিত YouTube API পরিষেবার পরিষেবার শর্তাবলী ("আপডেট করা শর্তাবলী"), যা YouTube ইঞ্জিনিয়ারিং এবং ডেভেলপারস ব্লগে বিশদভাবে আলোচনা করা হয়েছে, বর্তমান পরিষেবার শর্তাবলীতে আপডেটের একটি সমৃদ্ধ সেট প্রদান করে৷ আপডেট করা শর্তাদি ছাড়াও, যা 10 ফেব্রুয়ারী, 2017 থেকে কার্যকর হবে, এই আপডেটে অনেকগুলি সমর্থনকারী নথি অন্তর্ভুক্ত রয়েছে যা বিকাশকারীদের অনুসরণ করা আবশ্যক নীতিগুলি ব্যাখ্যা করতে সহায়তা করে৷
নতুন নথির সম্পূর্ণ সেট আপডেট করা শর্তাবলীর পুনর্বিবেচনার ইতিহাসে বর্ণনা করা হয়েছে। উপরন্তু, আপডেট করা শর্তাবলী বা সেই সমর্থনকারী নথিগুলিতে ভবিষ্যতের পরিবর্তনগুলিও সেই সংশোধন ইতিহাসে ব্যাখ্যা করা হবে। আপনি সেই নথির একটি লিঙ্ক থেকে সেই পুনর্বিবেচনার ইতিহাসে একটি RSS ফিড তালিকা পরিবর্তনের সদস্যতা নিতে পারেন।
31 মে, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
validator.validate
পদ্ধতি আপনাকে একটি মেটাডেটা ফাইলে যাচাইকরণের ত্রুটি রয়েছে কিনা তা নির্ধারণ করতে দেয় যা YouTube কে এটিকে সফলভাবে প্রক্রিয়া করতে বাধা দেবে৷ ফাইলটিতে ত্রুটি থাকলে, API প্রতিক্রিয়ারerrors
বৈশিষ্ট্যে যাচাইকরণ ত্রুটিগুলির একটি তালিকা থাকে, প্রতিটি ত্রুটির তীব্রতা, কারণ এবং অবস্থান সনাক্ত করে।
নতুন এবং আপডেট ত্রুটি
assets.patch
এবংassets.update
পদ্ধতিগুলি এখন নিম্নলিখিত ত্রুটিটিকে সমর্থন করে৷ একটি অনুস্মারক হিসাবে, একটি পদ্ধতি একাধিক ত্রুটি সমর্থন করতে পারে যেগুলির একই ত্রুটির ধরন রয়েছে৷ প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা সম্ভাব্য ত্রুটির সম্পূর্ণ তালিকার জন্য ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।ত্রুটি invalidValue (400)
parameters.assetId
অনুরোধ ব্যর্থ হয়েছে কারণ আপডেট করা সম্পদ অন্য সম্পদের সাথে মার্জ করা হয়েছে। সেই সম্পদের আইডি ব্যবহার করে অনুরোধটি পুনরায় জমা দিন, যা ত্রুটি বার্তায়,assetId
প্যারামিটারের মান হিসাবে ফেরত দেওয়া হয়।
28 মার্চ, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
claim
সংস্থানের নতুনmatchInfo.matchSegments[]
সম্পত্তিতে একটি তালিকা রয়েছে যেখানে প্রতিটি আইটেম দাবি করা ভিডিওর একটি অংশ বর্ণনা করে যা রেফারেন্স ভিডিওর অংশের সাথে মেলে। একটি দাবি একাধিক ম্যাচ সেগমেন্ট থাকতে পারে। উদাহরণস্বরূপ, যদি একটি আপলোড করা ভিডিওর অডিও এবং ভিডিও বিষয়বস্তু একটি রেফারেন্স ভিডিওর সাথে মেলে, তাহলে দুটি মিল সেগমেন্ট থাকবে। একটি সেগমেন্ট অডিও ম্যাচ বর্ণনা করবে এবং অন্যটি ভিডিও ম্যাচ বর্ণনা করবে।প্রতিটি ম্যাচ সেগমেন্টের জন্য, API মিলে যাওয়া সামগ্রীর সময়কাল এবং প্রকার (অডিও বা ভিডিও) প্রদান করে। এপিআই সেই সময় অফসেটগুলিও শনাক্ত করে যেখানে প্রতিটি ম্যাচ সেগমেন্ট দাবি করা ভিডিও এবং রেফারেন্স ভিডিও উভয়ের মধ্যে শুরু হয় এবং শেষ হয়।
contentOwnerAdvertisingOptions
সম্পদেরclaimedVideoOptions.newVideoDefaults[]
সম্পত্তির মান এখন আপডেট করা যেতে পারে যখন আপনিcontentOwnerAdvertisingOptions.patch
বাcontentOwnerAdvertisingOptions.update
পদ্ধতিতে কল করেন।contentOwnerAdvertisingOptions
রিসোর্সের শুধুমাত্র-পঠন-allowedOptions.autoGeneratedBreaks
প্রপার্টি বাতিল করা হয়েছে।
নতুন এবং আপডেট ত্রুটি
API-এর
claims.update
পদ্ধতি এখন নিম্নলিখিত ত্রুটিটিকে সমর্থন করে৷ একটি অনুস্মারক হিসাবে, একটি পদ্ধতি একাধিক ত্রুটি সমর্থন করতে পারে যেগুলির একই ত্রুটির ধরন রয়েছে৷ প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা সম্ভাব্য ত্রুটির সম্পূর্ণ তালিকার জন্য ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।ত্রুটি badRequest (400)
alreadyClaimed
দাবিটি অন্য বিদ্যমান দাবির সদৃশ এবং আপডেট করা যাবে না।assets.list
পদ্ধতিটি মাঝে মাঝে টাইম আউট হয়ে যায় এবং একটি500
HTTP প্রতিক্রিয়া কোড (Internal Server Error
) প্রদান করে, বিশেষত যখন অনুরোধটি অনেক সম্পদের জন্য ডেটা পুনরুদ্ধার করে এবংfetchMatchPolicy
প্যারামিটারের মানeffective
হয়। যদি আপনারassets.list
অনুরোধ একাধিক সম্পদ আইডি নির্দিষ্ট করে এবং একটি500
ত্রুটি প্রদান করে, তাহলে একটি একক সম্পদ বা অল্প সংখ্যক সম্পদের জন্য অনুরোধটি পুনরায় জমা দেওয়ার চেষ্টা করুন।references.insert
ত্রুটি ডকুমেন্টেশন আপডেট করা হয়েছে নোট করার জন্য যে যদি অনুরোধটি একটি দূষিত রেফারেন্স ফাইল আপলোড করে, তাহলে রেফারেন্স নিজেই প্রক্রিয়া না হওয়া পর্যন্ত সেই সমস্যাটি চিহ্নিত করা যাবে না। সুতরাং, এমনকি যদিreferences.insert
অনুরোধ একটি সফল প্রতিক্রিয়া প্রদান করে, রেফারেন্সটি সফলভাবে প্রক্রিয়া করা নাও হতে পারে। আমরা সুপারিশ করি যে, একটি রেফারেন্স সন্নিবেশ করার পরে, আপনি রেফারেন্সটি প্রত্যাশিত হিসাবে সক্রিয় হয়েছে তা নিশ্চিত করতেreferences.list
পদ্ধতি ব্যবহার করে পোল করুন৷
ফেব্রুয়ারী 3, 2016
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
API এখন পণ্য তালিকা বিজ্ঞাপন সমর্থন করে. পণ্য তালিকা বিজ্ঞাপনগুলি এমন পণ্যগুলিকে হাইলাইট করে যা ভিডিওর সামগ্রীর সাথে সম্পর্কিত বা বৈশিষ্ট্যযুক্ত। এই বিজ্ঞাপনগুলি স্পনসরড কার্ড যা ভিডিও চলাকালীন প্রদর্শিত হয়৷ বিজ্ঞাপন সিস্টেম দ্বারা কার্ড স্বয়ংক্রিয়ভাবে যোগ করা হয়. দর্শকরা কয়েক সেকেন্ডের জন্য কার্ডের জন্য একটি টিজার দেখেন এবং ভিডিওর কার্ডগুলি ব্রাউজ করতে ভিডিওর উপরের ডানদিকের কোণায় আইকনে ক্লিক করতে পারেন৷
এই পরিবর্তনের ফলে,
product_listing
এখন নিম্নলিখিত বৈশিষ্ট্যের মানগুলিতে অন্তর্ভুক্ত করা যেতে পারে:রিসোর্স/এপিআই পদ্ধতি সম্পত্তি contentOwnerAdvertisingOptions
allowedOptions.licAdFormats[]
contentOwnerAdvertisingOptions
allowedOptions.ugcAdFormats[]
contentOwnerAdvertisingOptions
claimedVideoOptions.newVideoDefaults[]
videoAdvertisingOptions
adFormats[]
videoAdvertisingOptions.getEnabledAds
countriesRestriction[].adFormats[]
assetSearch.list
পদ্ধতির নতুনcreatedBefore
এবংcreatedAfter
এপিআইকে নির্দেশ দেয় শুধুমাত্র একটি নির্দিষ্ট তারিখের আগে এবং/বা পরে তৈরি করা সম্পদ ফেরত দিতে।একটি
assetSearch.list
অনুরোধের API প্রতিক্রিয়াতে,type
প্রপার্টি এখনart_track_video
মান সমর্থন করে। YouTube সহায়তা কেন্দ্র আর্ট ট্র্যাক ভিডিও সম্পর্কে আরও তথ্য প্রদান করে৷claimSearch.list
পদ্ধতি নিম্নলিখিত নতুন প্যারামিটার সমর্থন করে:পরামিতি referenceId
এই ফিল্টার প্যারামিটারটি রেফারেন্সের YouTube রেফারেন্স আইডি নির্দিষ্ট করে যার জন্য আপনি দাবি পুনরুদ্ধার করছেন। inactiveReasons
এই ঐচ্ছিক প্যারামিটারটি আপনাকে API প্রতিক্রিয়াকে শুধুমাত্র নিষ্ক্রিয় দাবিগুলিকে অন্তর্ভুক্ত করার জন্য সীমাবদ্ধ করতে দেয় কেন দাবিগুলি নিষ্ক্রিয় হয়েছে তা নির্দিষ্ট কারণের ভিত্তিতে। প্যারামিটার সংজ্ঞাটি নিষ্ক্রিয় দাবিগুলির প্রকারগুলি তালিকাভুক্ত করে যার জন্য আপনি অনুসন্ধান করতে পারেন৷ partnerUploaded
এই ঐচ্ছিক বুলিয়ান প্যারামিটার আপনাকে নির্দিষ্ট করতে দেয় যে API প্রতিক্রিয়াতে শুধুমাত্র অংশীদার-আপলোড করা বা অ-অংশীদার-আপলোড করা দাবি অন্তর্ভুক্ত করা উচিত। reference
রিসোর্সের নতুনreferences#origination
অবজেক্টে এমন তথ্য রয়েছে যা রেফারেন্সের উৎস বর্ণনা করে।references.insert
পদ্ধতিটি এখন YouTube-এর gfp_gen সফ্টওয়্যার ব্যবহার করে তৈরি রেফারেন্স আপলোড করার ক্ষমতা সমর্থন করে। আপনি যদি একটি পূর্ব-উত্পাদিত আঙ্গুলের ছাপ প্রদান করেন, আপলোড করাreference
রিসোর্সেfpDirect
সম্পত্তি মানtrue
সেট করুন।মনে রাখবেন যে এই পরিবর্তনের সাথে, যদি আপনি একটি রেফারেন্স আপলোড করার সময়
fpDirect
বৈশিষ্ট্য সেট করার চেষ্টা করেন তবে API আর একটি ত্রুটি ফেরত দেয় না।
নতুন এবং আপডেট ত্রুটি
ডকুমেন্টেশন এখন
whitelist
রিসোর্সের পদ্ধতি দ্বারা প্রত্যাবর্তিত ত্রুটিগুলি তালিকাভুক্ত করে।এছাড়াও, নিম্নলিখিত সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি সনাক্ত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে। আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
ত্রুটি badRequest (400)
inappropriateCampaignTarget
প্রচারাভিযান কিছু ব্যবহারকারীর জন্য অনুপযুক্ত হতে পারে এমন একটি ভিডিও দেখানোর চেষ্টা করলেcampaigns.insert
এবংcampaigns.update
পদ্ধতিগুলি এই ত্রুটি ফিরিয়ে দেয়৷ ত্রুটিটি সমাধান করতে, অনুগ্রহ করে বৈশিষ্ট্যের জন্য বিভিন্ন সামগ্রী চয়ন করুন৷badRequest (400)
canNotCreatePartnerUploadedClaim OnCompositionOrSoundRecordingAssets
claims.insert
পদ্ধতিটি এই ত্রুটিটি ফিরিয়ে দেয় যদি আপনি একটি কম্পোজিশন বা সাউন্ড রেকর্ডিং সম্পদের সাথে অংশীদার-আপলোড করা দাবি তৈরি করার চেষ্টা করেন।badRequest (400)
existingSoundRecordingOrMusicVideoClaim
claims.insert
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যদি নির্দিষ্ট ভিডিওতে রেকর্ড করা সঙ্গীতের জন্য একটি দাবি ইতিমধ্যেই বিদ্যমান থাকে। এপিআই-এর মাধ্যমে সরাসরি রচনার দাবি যোগ করা যাবে না।badRequest (400)
asset_id
যদি অনুরোধটি একটি ফাইলের মাধ্যমে একটি রেফারেন্স তৈরি করার চেষ্টা করে তবে অনুরোধটি একটি সম্পদ আইডি নির্দিষ্ট না করে তাহলেreferences.insert
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয়৷badRequest (400)
canNotBeActivated
references.update
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যদি রেফারেন্সটি সক্রিয় করা না যায়, সম্ভবত রেফারেন্সের স্থিতি বা মালিকানা শর্তের কারণে।badRequest (400)
videoNotClaimed
videoAdvertisingOptions.get
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয় যদি আপনি যে ভিডিওটির জন্য আপনি বিজ্ঞাপনের বিকল্পগুলি পুনরুদ্ধার করার চেষ্টা করছেন সেটি দাবি না করে থাকেন, যার ফলে অনুরোধ করা তথ্য আপনার কাছে অনুপলব্ধ হয়৷
ডিসেম্বর 18, 2015
ইউরোপীয় ইউনিয়নের (ইইউ) আইনের প্রয়োজন হয় যে নির্দিষ্ট কিছু প্রকাশ অবশ্যই দিতে হবে এবং EU-এর শেষ ব্যবহারকারীদের কাছ থেকে সম্মতি নিতে হবে। তাই, ইউরোপীয় ইউনিয়নের শেষ ব্যবহারকারীদের জন্য, আপনাকে অবশ্যই EU ব্যবহারকারীর সম্মতি নীতি মেনে চলতে হবে। আমরা আমাদের YouTube API পরিষেবার শর্তাবলীতে এই প্রয়োজনীয়তার একটি বিজ্ঞপ্তি যুক্ত করেছি৷
এপ্রিল 21, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন
campaign
সংস্থানটি একটি নির্দিষ্ট বিষয়বস্তুর মালিকের প্রচারাভিযানের প্রতিনিধিত্ব করে, যা দাবি করা, ব্যবহারকারী-আপলোড করা ভিডিওগুলিতে বিষয়বস্তু প্রচার করতে বিষয়বস্তুর মালিককে টীকা ব্যবহার করতে দেয়৷ উদাহরণ স্বরূপ, একজন বিষয়বস্তুর মালিক একটি প্রচারাভিযান তৈরি করতে পারে যা একটি মুভির দেখার পৃষ্ঠায় লিঙ্ক যুক্ত করে যে কোন দাবি করা, ব্যবহারকারীর আপলোড করা ভিডিওগুলির জন্য যে মুভির দৃশ্য রয়েছে৷API
campaign
সংস্থানগুলিget
,list
,insert
,update
,patch
এবংdelete
পদ্ধতিগুলিকে সমর্থন করে৷API নতুন
campaigns.get
,campaigns.insert
,campaigns.update
, এবংcampaigns.delete
পদ্ধতির জন্য বেশ কিছু নতুন ত্রুটি সমর্থন করে৷
মার্চ 30, 2015
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
assetSearch.list
পদ্ধতির নতুনisrcs
প্যারামিটার আপনাকে 50 টি পর্যন্ত ISRC-এর একটি তালিকা নির্দিষ্ট করতে দেয়। API প্রতিক্রিয়া সেই ISRC এর সাথে সম্পর্কিত সম্পদ অন্তর্ভুক্ত করবে।claimHistory
রিসোর্সেরevent[].reason
প্রপার্টি নিম্নলিখিত নতুন মান সমর্থন করে। প্রতিটি কারণ ব্যাখ্যা করে কেন দাবির সাথে সম্পর্কিত একটি নির্দিষ্ট ঘটনা ঘটেছে:- বন্ধ_অডিও_দাবি_অন_ভিজুয়াল_রেফারেন্স
- বন্ধ_অংশীদার_বর্জন
- বন্ধ_রেফারেন্স_দ্বন্দ্ব
claimSearch.list
পদ্ধতির নতুনsort
প্যারামিটারটি নির্দিষ্ট করে যে পদ্ধতিটি API প্রতিক্রিয়াতে সংস্থানগুলি অর্ডার করতে ব্যবহার করা হবে৷ ডিফল্টরূপে, রিভার্স কালানুক্রমিক ক্রমানুসারে (নতুন থেকে প্রাচীনতম) রিসোর্সগুলি তৈরি করা তারিখের উপর ভিত্তি করে সাজানো হয়। আপনি দাবি করা বিষয়বস্তুর জন্য সর্বোচ্চ থেকে সর্বনিম্ন ভিউ পর্যন্ত রিসোর্স বাছাই করতে পারেন।মনে রাখবেন যে
claimSearch.list
অনুরোধটি যদিstatus
পরামিতি মানকেappealed
,disputed
,pending
,potential
, বাroutedForReview
তে সেট করে, তাহলে দাবি পর্যালোচনার মেয়াদ শেষ হওয়ার সময় অনুসারে ফলাফলগুলি সাজানো হয়৷ownership.update
এবংownership.patch
পদ্ধতিগুলি এখন সঠিকভাবে সমস্ত বৈশিষ্ট্য তালিকাভুক্ত করে যা এই পদ্ধতিগুলিতে কল করার সময় আপডেট করা যেতে পারে। এই পরিবর্তনটি API ডকুমেন্টেশনে একটি সংশোধনের প্রতিনিধিত্ব করে এবং API কার্যকারিতার পরিবর্তনকে চিহ্নিত করে না।assets.get
এবংassets.list
পদ্ধতিরfetchMatchPolicy
প্যারামিটার এখন একটি সমর্থিত মান হিসাবেeffective
তালিকাভুক্ত। মানটি API সার্ভারকে সেই মিল নীতি পুনরুদ্ধার করার নির্দেশ দেয় যা YouTube সম্পদের জন্য প্রয়োগ করে।assets.list
,claims.list
,contentOwners.list
,policies.list
,publishers.list
, এবংreferences.list
পদ্ধতিগুলির জন্যid
প্যারামিটারগুলি এখন মনে রাখবেন যে তাদের প্যারামিটারের মানগুলিতে সর্বাধিক 50টি কমা দ্বারা পৃথক করা আইডি থাকতে পারে৷
নতুন এবং আপডেট ত্রুটি
নীচের সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি চিহ্নিত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে।
আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
tooManyIsrcs
যদি isrcs
প্যারামিটার 50 টির বেশি ISRC নির্দিষ্ট করে তাহলেassetSearch.list
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।badRequest (400)
videoIsPrivate
আপনি একটি ব্যক্তিগত ভিডিও দাবি করার চেষ্টা করলে claims.insert
পদ্ধতিটি এই ত্রুটি ফিরিয়ে দেয়৷ আপনি শুধুমাত্র একটি ভিডিও দাবি করতে পারেন যদি তার গোপনীয়তার স্থিতিpublic
বাunlisted
হয়৷notModified (304)
blockOutsideOwnershipUnchanged
দাবিতে blockOutsideOwnership
পতাকা সফলভাবে পরিবর্তন না হলেclaims.update
পদ্ধতিটি এই ত্রুটিটি ফেরত দেয়। এই ত্রুটি ঘটতে পারে কেন বিভিন্ন কারণ আছে. একটি সাধারণ উদাহরণ হল কারণ দাবি করা ভিডিওতে নির্দিষ্ট পরিবর্তনের কোনো প্রভাব নেই।
নভেম্বর 7, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
claimSearch.list
পদ্ধতিরstatus
প্যারামিটার এখনroutedForReview
এর মান সমর্থন করে। এই মানটি ফলাফলগুলিকে এমন দাবিতে সীমাবদ্ধ করে যেগুলির জন্য একটি সম্পদের মিল নীতিতে একটি নিয়মের উপর ভিত্তি করে ম্যানুয়াল পর্যালোচনা প্রয়োজন৷claimHistory
রিসোর্সেরevent[].reason
প্রপার্টি নিম্নলিখিত নতুন মান সমর্থন করে। প্রতিটি কারণ ব্যাখ্যা করে কেন দাবির সাথে সম্পর্কিত একটি নির্দিষ্ট ঘটনা ঘটেছে:- বন্ধ_অবৈধ_রেফারেন্স_সেগমেন্ট
- বন্ধ_নোডসেন্স
- সাসপেন্ডেড_মনিটাইজেশন_অন_চ্যানেল
- video_content_modified
claim
সংস্থানেরorigin.source
সম্পত্তি, যা একটি দাবির উত্স সনাক্ত করে, এখন মানmelodyMatch
সমর্থন করে। একটি মেলোডি ম্যাচ দাবি ইঙ্গিত করে যে দাবি করা ভিডিওটি একটি রেফারেন্স সহ একটি মিউজিক্যাল কম্পোজিশন শেয়ার করেছে।references.insert
পদ্ধতির ডকুমেন্টেশনটি সঠিকভাবে প্রতিফলিত করার জন্য আপডেট করা হয়েছে যে API সেই পদ্ধতির জন্য দুটি ভিন্ন এন্ডপয়েন্ট ব্যবহার করে। এটি API কার্যকারিতার পরিবর্তনের প্রতিনিধিত্ব করে না, বরং বিদ্যমান ডকুমেন্টেশনের সংশোধন।যদি অনুরোধটি একটি নতুন রেফারেন্স ফাইল আপলোড করে, সঠিক শেষ পয়েন্ট হল:
POST https://www.googleapis.com/upload/youtube/partner/v1/references
রেফারেন্স কন্টেন্ট হিসেবে দাবি করা ভিডিও ব্যবহার করে যদি অনুরোধ একটি রেফারেন্স তৈরি করে, তাহলে সঠিক শেষ পয়েন্ট হল:
POST https://www.googleapis.com/youtube/partner/v1/references
নতুন এবং আপডেট ত্রুটি
নীচের সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি চিহ্নিত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে।
আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা badRequest (400)
invalidLabelName
assets.insert
,assets.update
, এবংassetLabels.insert
পদ্ধতিগুলি এই ত্রুটি ফিরিয়ে দেয় যদি একটি সম্পদ লেবেলের নাম অবৈধ হয়৷ লেবেলের নাম অবশ্যই দুই থেকে ৩০ অক্ষরের মধ্যে হতে হবে। এগুলিতে কোণীয় বন্ধনী, কমা, কোলন, অ্যাম্পারস্যান্ড বা উল্লম্ব পাইপ অক্ষর (|) নাও থাকতে পারে।badRequest (400)
ownerHaveMaximumNumberOfLabels
assets.insert
,assets.update
, এবংassetLabels.insert
পদ্ধতিগুলি এই ত্রুটিটি ফেরত দেয় যদি কোনও বিষয়বস্তুর মালিক ইতিমধ্যে 2500টি অনন্য সম্পদ লেবেল সংজ্ঞায়িত করে থাকে, যা বর্তমানে অনুমোদিত সর্বাধিক সংখ্যা৷badRequest (400)
tooManyLabelsOnOneAsset
assets.insert
এবংassets.update
পদ্ধতিগুলি এই ত্রুটিটি ফেরত দেয় যদি একটি সম্পদ ইতিমধ্যে 30টি সম্পদ লেবেলের সাথে যুক্ত থাকে, যা বর্তমানে অনুমোদিত সর্বাধিক সংখ্যা।badRequest (400)
channelMonetizationSuspended
claims.insert
এবংclaims.update
পদ্ধতিগুলি এই ত্রুটি ফিরিয়ে দেয় যদি কোনও ভিডিওর চ্যানেল অংশীদার দাবির জন্য স্থগিত করা হয়৷badRequest (400)
channelNotActive
কোনো ভিডিওর চ্যানেল সক্রিয় না থাকলে claims.update
পদ্ধতি এই ত্রুটিটি ফেরত দেয়।assets.insert
এবংassets.update
পদ্ধতিগুলি আর কিছু সম্পদের জন্য একটিbadRequest
ত্রুটি ফেরত দেয় না যদি অনুরোধের বডিতেmetadataMine.contentType
প্রপার্টি না থাকে।
23 সেপ্টেম্বর, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিষয়বস্তুর মালিক আইডি পরিবর্তন
9 জুলাই, 2014 তারিখে পুনর্বিবেচনার ইতিহাসে ঘোষিত সামগ্রী মালিক আইডি পরিবর্তনগুলি কার্যকর হয়েছে৷ এই পরিবর্তনের ফলস্বরূপ, API এখন প্রমাণীকৃত ব্যবহারকারী বা API-এর মাধ্যমে পরিচালিত কোনো সম্পদের সাথে সংশ্লিষ্ট বিষয়বস্তুর মালিককে শনাক্ত করতে একটি তৈরি করা, অনন্য আইডি প্রদান করে। পূর্বে, API আইডি হিসাবে একটি মানব-পঠনযোগ্য নাম ফেরত দিয়েছিল, যেমন "qrs_network।"
এই পরিবর্তনটি নিম্নলিখিত API কার্যকারিতাকে প্রভাবিত করে এবং সম্ভবত সেই অংশীদারদের প্রভাবিত করবে যাদের তাদের অ্যাপ্লিকেশনগুলিতে হার্ড-কোডযুক্ত অংশীদার কোড রয়েছে৷
- API এখন রিসোর্স প্রপার্টির মান হিসাবে নতুন আইডি ফেরত দেয় যা আগে অংশীদার কোড ফেরত দিয়েছিল, যেমন
contentOwner
রিসোর্সেরid
প্রপার্টি। - API-এর সমস্ত পদ্ধতি
onBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা সামগ্রীর মালিককে চিহ্নিত করে যার পক্ষ থেকে API অনুরোধ করা হচ্ছে৷ পরিবর্তনের পর, প্যারামিটারটি পার্টনার কোডের পরিবর্তে নতুন আইডিতে সেট করা উচিত। কোড ব্রেকেজ প্রতিরোধ করার জন্য, প্যারামিটার একটি ট্রানজিশন সময়কালে উভয় মান গ্রহণ করবে। - পরিবর্তনের পর,
contentOwners.list
পদ্ধতিরcontentOwnerId
প্যারামিটারে অংশীদার কোডের পরিবর্তে নতুন আইডি উল্লেখ করা উচিত।
- API এখন রিসোর্স প্রপার্টির মান হিসাবে নতুন আইডি ফেরত দেয় যা আগে অংশীদার কোড ফেরত দিয়েছিল, যেমন
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
assetSearch.list
পদ্ধতির নতুনmetadataSearchFields
প্যারামিটার আপনাকে সম্পদের মেটাডেটা ক্ষেত্রগুলি নির্দিষ্ট করতে দেয় যেগুলি আপনি অনুসন্ধান করতে চান সেইসাথে আপনি সেই ক্ষেত্রগুলিতে যে মানগুলি অনুসন্ধান করতে চান তা নির্দিষ্ট করতে দেয়৷ পরামিতি মান হল ক্ষেত্র এবং মান জোড়ার একটি কমা দ্বারা পৃথক করা তালিকা; একটি জোড়ার মধ্যে, ক্ষেত্র এবং মান একটি কোলন দ্বারা পৃথক করা হয়।claim
সংস্থানের নতুনappliedPolicy
বস্তুটি সেই নীতি নির্দিষ্ট করে যা YouTube আসলে দাবির জন্য প্রযোজ্য। বস্তুর মান একটিpolicy
সম্পদ. সেই সংস্থানটিতে সেই দেশগুলির জন্য নীতি সংক্রান্ত তথ্য রয়েছে যেখানে অনুরোধ জমা দেওয়া সামগ্রীর মালিক দাবিকৃত সম্পদের মালিক৷কন্টেন্ট মালিক দুটি উপায়ে সংজ্ঞায়িত নীতি থেকে প্রয়োগ করা নীতি আলাদা হতে পারে:
এটি অন্যান্য মালিকদের দ্বারা সেট করা নীতিগুলির জন্য দায়ী যারা API অনুরোধ জমা দেওয়া বিষয়বস্তুর মালিকের মতো একই অঞ্চলে দাবি করা সম্পদের আংশিক মালিকানা রয়েছে৷
এটি YouTube প্রশাসনিক নীতিগুলির জন্য দায়ী যা সেই অঞ্চলগুলিতে প্রযোজ্য যেখানে বিষয়বস্তুর মালিক দাবিকৃত সম্পদের মালিক৷
claimHistory
রিসোর্সের নতুনuploaderChannelId
প্রপার্টি সেই চ্যানেলের চ্যানেল আইডি চিহ্নিত করে যেখানে দাবি করা ভিডিও আপলোড করা হয়েছে।
সেপ্টেম্বর 8, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
assetLabel
রিসোর্স একটি টেক্সট লেবেল চিহ্নিত করে যা একটি সম্পদে বরাদ্দ করা যেতে পারে। সম্পদ লেবেল আপনাকে কাস্টম বিভাগে সম্পদ স্থাপন করতে দেয়, এটি আপনার সম্পদ লাইব্রেরি সংগঠিত করা সহজ করে তোলে। আপনি তাদের লেবেলগুলির উপর ভিত্তি করে সম্পদগুলির জন্য অনুসন্ধান করতে পারেন, যা ব্যবহারের ক্ষেত্রেও সহজ করতে পারে যার জন্য আপনাকে সম্পদের নির্দিষ্ট গ্রুপ আপডেট করতে হবে।-
assetLabels.list
পদ্ধতি আপনাকে সামগ্রীর মালিকের লেবেলের একটি তালিকা পুনরুদ্ধার করতে দেয়৷ -
assetLabels.insert
পদ্ধতি আপনাকে একটি নতুন সম্পদ লেবেল তৈরি করতে দেয়। এছাড়াও আপনিassets.update
পদ্ধতিতে কল করে এবং একটি সম্পদের জন্য লেবেল আপডেট করে নতুন লেবেল তৈরি করতে পারেন। API সার্ভার স্বয়ংক্রিয়ভাবে পূর্বে অনির্ধারিত কোনো লেবেলের জন্য একটি নতুনassetLabel
সংস্থান তৈরি করবে।
-
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
asset
সম্পদেরlabel[]
প্রপার্টি আপডেট করা হয়েছে নোট করার জন্য যে আপনি সম্পদের লেবেল আপডেট করতেassets.update
পদ্ধতিতে কল করতে পারেন। যাইহোক,assets.insert
পদ্ধতিতে কল করার সময় আপনি কোনো সম্পদের লেবেল সেট করতে পারবেন না।সম্পদের লেবেল ব্যবহার করার নতুন নির্দেশিকা ব্যাখ্যা করে যে কীভাবে সম্পদের লেবেল তৈরি এবং পুনরুদ্ধার করা যায় সেইসাথে কীভাবে কোনও সম্পদের লেবেল আপডেট করা যায় বা নির্দিষ্ট লেবেলের সাথে সম্পর্কিত সম্পদ অনুসন্ধান করা যায়।
নতুন এবং আপডেট ত্রুটি
API নতুন
assetLabels.list
এবংassetLabels.insert
পদ্ধতির জন্য বেশ কিছু নতুন ত্রুটি সমর্থন করে।
9 জুলাই, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিষয়বস্তুর মালিক আইডি পরিবর্তন
ঐতিহাসিকভাবে, API একটি মানব-পঠনযোগ্য অংশীদার কোড ব্যবহার করেছে, যেমন "qrs_network", প্রমাণীকৃত ব্যবহারকারী বা API-এর মাধ্যমে পরিচালিত কোনো সম্পদের সাথে সংশ্লিষ্ট বিষয়বস্তুর মালিককে অনন্যভাবে সনাক্ত করতে। Q3 2014 এ, API এর পরিবর্তে সামগ্রীর মালিকদের সনাক্ত করতে একটি অনন্য 22-অক্ষরের ID ব্যবহার করবে। পরিবর্তনটি নিম্নলিখিত API কার্যকারিতাকে প্রভাবিত করে এবং সম্ভবত সেই অংশীদারদের প্রভাবিত করবে যাদের তাদের অ্যাপ্লিকেশনগুলিতে হার্ড-কোডযুক্ত অংশীদার কোড রয়েছে৷
- এপিআই 22-অক্ষরের আইডি রিসোর্স বৈশিষ্ট্যের মান হিসাবে ফিরিয়ে দেবে যা পূর্বে অংশীদার কোড ফেরত দিয়েছিল, যেমন
contentOwner
সম্পদেরid
সম্পত্তি। - API-এর সমস্ত পদ্ধতি
onBehalfOfContentOwner
প্যারামিটারকে সমর্থন করে, যা সামগ্রীর মালিককে চিহ্নিত করে যার পক্ষ থেকে API অনুরোধ করা হচ্ছে৷ পরিবর্তনের পর, প্যারামিটারটিকে পার্টনার কোডের পরিবর্তে 22-অক্ষরের আইডিতে সেট করা উচিত। কোড ব্রেকেজ প্রতিরোধ করার জন্য, প্যারামিটার একটি ট্রানজিশন সময়কালে উভয় মান গ্রহণ করবে। - পরিবর্তনের পরে,
contentOwners.list
পদ্ধতিরcontentOwnerId
প্যারামিটারে অংশীদার কোডের পরিবর্তে 22-অক্ষরের ID উল্লেখ করা উচিত।
- এপিআই 22-অক্ষরের আইডি রিসোর্স বৈশিষ্ট্যের মান হিসাবে ফিরিয়ে দেবে যা পূর্বে অংশীদার কোড ফেরত দিয়েছিল, যেমন
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
একটি
asset
সম্পদ এখনlabel
সম্পত্তি সমর্থন করে, যা সম্পদের সাথে সম্পর্কিত সম্পদ লেবেলের একটি তালিকা নির্দিষ্ট করে। আপনি একাধিক সম্পদে তাদের গোষ্ঠীবদ্ধ করতে একটি লেবেল প্রয়োগ করতে পারেন। আপনি লেবেলগুলিকে সার্চ ফিল্টার হিসাবে ব্যবহার করতে পারেন বাল্ক আপডেটগুলি সম্পাদন করতে, প্রতিবেদনগুলি ডাউনলোড করতে বা YouTube Analytics ফিল্টার করতে৷assetSearch.list
পদ্ধতি এখন নিম্নলিখিত ঐচ্ছিক পরামিতি সমর্থন করে:-
labels
: শুধুমাত্র নির্দিষ্ট লেবেলের সাথে সম্পর্কিত সম্পদ অন্তর্ভুক্ত করার জন্য ফলাফল সীমাবদ্ধ করে। ডিফল্টরূপে, API সমস্ত নির্দিষ্ট লেবেলের সাথে মেলে এমন সম্পদ প্রদান করে। যাইহোক, আপনি API-কে নির্দিষ্ট লেবেলের সাথে মেলে এমন সম্পদ ফেরত দেওয়ার নির্দেশ দিতেincludeAnyProvidedLabel
প্যারামিটার ব্যবহার করতে পারেন। -
includeAnyProvidedLabel
:labels
প্যারামিটারের সাথে একত্রে ব্যবহার করা হয়, এই প্যারামিটারটি API রিটার্ন সম্পদকে নির্দেশ করে যাlabels
প্যারামিটার মানের নির্দিষ্ট লেবেলের সাথে সম্পর্কিত।
-
একটি
claimHistory
সম্পদে এখন নিম্নলিখিত নতুন বৈশিষ্ট্য রয়েছে:-
event[].source.userEmail
প্রপার্টি সেই ব্যবহারকারীর ইমেল ঠিকানা প্রদান করে যে ইভেন্টটি শুরু করেছে। -
event[].typeDetails.disputeNotes
প্রপার্টিতে একটিdispute_create
ইভেন্টের জন্য বিরোধ নোট রয়েছে।
-
claimSearch.list
পদ্ধতি এখন নিম্নলিখিত ঐচ্ছিক পরামিতি সমর্থন করে:-
createdAfter
: শুধুমাত্র নির্দিষ্ট তারিখের পরে তৈরি করা দাবিগুলি অন্তর্ভুক্ত করার জন্য ফলাফলগুলিকে সীমাবদ্ধ করে৷ -
createdBefore
: ফলাফলগুলিকে শুধুমাত্র নির্দিষ্ট তারিখের আগে তৈরি করা দাবিগুলিকে অন্তর্ভুক্ত করতে সীমাবদ্ধ করে৷ -
includeThirdPartyClaims
:videoId
প্যারামিটারের সাথে ব্যবহার করা হয়, এই প্যারামিটারটি API ফলাফলে তৃতীয় পক্ষের দাবিগুলি অন্তর্ভুক্ত করতে হবে কিনা তা নির্দেশ করে।
-
আরো বিস্তারিত ত্রুটি তথ্য
ত্রুটি ডকুমেন্টেশন এখন প্রতিটি ত্রুটি প্রকারের জন্য HTTP প্রতিক্রিয়া কোড নির্দিষ্ট করে।
নতুন এবং আপডেট ত্রুটি
নীচের সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি চিহ্নিত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে। উদাহরণস্বরূপ, যদি আপনি একটি প্রয়োজনীয় মেটাডেটা ক্ষেত্র অনুপস্থিত একটি
asset
সংস্থান সন্নিবেশ করার চেষ্টা করেন তবে একটিrequired
ত্রুটি ফেরত দেওয়া হয়৷ প্রকৃতপক্ষে, একাধিক প্রয়োজনীয় মেটাডেটা ক্ষেত্র থাকতে পারে, যার প্রত্যেকটি সামান্য ভিন্ন বার্তা সহ একটি ত্রুটি ফিরিয়ে দেবে।আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
পদ্ধতি ত্রুটি assetSearch.list
-
invalidValue
- API শো বা সিজন সম্পদ অনুসন্ধান করার ক্ষমতা সমর্থন করে না।type
প্যারামিটারের মান একটি সমর্থিত মান পরিবর্তন করুন।
assets.insert
-
conflict
- একই শনাক্তকারীর সাথে অনেকগুলি সম্পদ (যেমন কাস্টম আইডি, ISRC, ইত্যাদি) ইতিমধ্যেই বিদ্যমান। -
conflict
- নির্দিষ্ট সম্পদের অনেক কপি ইতিমধ্যেই বিদ্যমান। -
invalidValue
- API কলকারী ব্যবহারকারীর নির্দিষ্ট ধরনের সম্পদ তৈরি করার অনুমতি নেই।
assets.patch
assets.update
-
badRequest
- API আপনার চেষ্টা করা সম্পদের ধরন রূপান্তর সমর্থন করে না।
claimSearch.list
-
badRequest
-includeThirdPartyClaims
প্যারামিটার শুধুমাত্রvideoId
ফিল্টারের সাথে ব্যবহার করা যেতে পারে।
ownership.patch
ownership.update
-
badRequest
- আপনি একটি আর্ট ট্র্যাক সম্পদের মালিকানা আপডেট করতে পারবেন না৷
references.patch
references.update
-
badRequest
- আপনি যে অপারেশনের চেষ্টা করছেন তার জন্য রেফারেন্সটি একটি অবৈধ অবস্থায় রয়েছে।
-
ফেব্রুয়ারী 3, 2014
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
একটি
claimSearch
সংস্থান এখন নিম্নলিখিত নতুন বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করে:-
origin
বস্তুতে এমন তথ্য রয়েছে যা দাবি করার পদ্ধতি বর্ণনা করে। -
thirdPartyClaim
প্রপার্টিতে একটি বুলিয়ান মান রয়েছে যা নির্দেশ করে যে দাবিটি অনুসন্ধান সম্পাদনকারী ব্যবহারকারীর সাথে যুক্ত একটি ছাড়া অন্য কোন বিষয়বস্তুর মালিকের দ্বারা করা হয়েছে কিনা।
-
claimSearch.list
পদ্ধতি এখন নিম্নলিখিত ঐচ্ছিক পরামিতি সমর্থন করে:-
contentType
: শুধুমাত্র অডিও-শুধু দাবি, শুধুমাত্র-ভিডিও দাবি বা অডিওভিজ্যুয়াল দাবি অন্তর্ভুক্ত করতে ফলাফল সীমাবদ্ধ করে। -
origin
: এক বা একাধিক দাবির উত্স নির্দিষ্ট করে, যেমনdescriptiveSearch
বাvideoMatch
, যার জন্য আপনি দাবিগুলি খুঁজে পেতে চান৷ -
status
: শুধুমাত্র নির্দিষ্ট স্থিতি আছে এমন দাবি অন্তর্ভুক্ত করতে ফলাফল সীমাবদ্ধ করে।
-
claim
সংস্থানেরstatus
সম্পত্তি এখন নিম্নলিখিত অতিরিক্ত মানগুলিকে সমর্থন করে:appealed
,disputed
,potential
,takedown
, এবংunknown
৷claim
সংস্থানের নতুনblockOutsideOwnership
সম্পত্তি নির্দেশ করে যে দাবি করা ভিডিওটি এমন অঞ্চলগুলিতে ব্লক করা উচিত যেখানে এটি স্পষ্টভাবে মালিকানাধীন নয়৷ ডিফল্টরূপে, একটি দাবি করা ভিডিও এখনও সেই দেশগুলিতে দেখা যাবে যেখানে দাবির সাথে সম্পর্কিত সম্পদের জন্য মালিকানা ডেটা সংজ্ঞায়িত করা হয়নি৷contentOwnerAdvertisingOption
রিসোর্সের নতুনallowedOptions.autoGeneratedBreaks
প্রপার্টি নির্দেশ করে যে অংশীদার মিডরোল, ইন-স্ট্রীম বিজ্ঞাপনগুলি YouTube দ্বারা স্বয়ংক্রিয়ভাবে নির্ধারিত বিরতির সময়ে দেখাতে পারে কিনা।contentOwners.list
পদ্ধতিটি এখন একটি অনুমোদন টোকেনের সাথে কল করা যেতে পারে যাhttps://www.googleapis.com/auth/youtubepartner-content-owner-readonly
স্কোপ নির্দিষ্ট করে৷policy
রিসোর্সের নতুনtimeUpdated
প্রপার্টি সেই সময় নির্দিষ্ট করে যখন পলিসিটি শেষবার আপডেট করা হয়েছিল।policies.list
পদ্ধতিটি এখন একটি ঐচ্ছিকsort
পরামিতি সমর্থন করে, যা নির্দিষ্ট করতে ব্যবহার করা যেতে পারে যে ফলাফলগুলি শেষবার আপডেট করার সময় ঊর্ধ্বমুখী বা অবরোহ ক্রমে সাজানো উচিত।referenceConflict
রিসোর্সের নতুনexpiryTime
প্রপার্টি সেই সময়টি নির্দিষ্ট করে যখন রেফারেন্স দ্বন্দ্বের পর্যালোচনার সময়সীমা শেষ হবে, যার ফলে দ্বন্দ্বের মেয়াদ শেষ হবে।videoAdvertisingOption
রিসোর্সের নতুনautoGeneratedBreaks
প্রপার্টি নির্দেশ করে যে ভিডিওটি মিডরোল দেখানো উচিত কিনা, বিরতির সময়ে ইন-স্ট্রীম বিজ্ঞাপন YouTube দ্বারা স্বয়ংক্রিয়ভাবে নির্ধারিত হয়।
নতুন এবং আপডেট ত্রুটি
নীচের সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি চিহ্নিত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে। উদাহরণস্বরূপ, যদি আপনি একটি প্রয়োজনীয় মেটাডেটা ক্ষেত্র অনুপস্থিত একটি
asset
সংস্থান সন্নিবেশ করার চেষ্টা করেন তবে একটিrequired
ত্রুটি ফেরত দেওয়া হয়৷ প্রকৃতপক্ষে, একাধিক প্রয়োজনীয় মেটাডেটা ক্ষেত্র থাকতে পারে, যার প্রত্যেকটি সামান্য ভিন্ন বার্তা সহ একটি ত্রুটি ফিরিয়ে দেবে।আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
পদ্ধতি ত্রুটি assets.insert
assets.update
-
badRequest
- API আর্ট ট্র্যাক সম্পদে লেখার ক্রিয়াকলাপ সমর্থন করে না।
claimSearch.list
-
invalidValue
- অনুরোধেpageToken
প্যারামিটারটি একটি অবৈধ পৃষ্ঠা টোকেন নির্দিষ্ট করে।
claims.insert
-
badRequest
– আপনি যে দাবিটি তৈরি করার চেষ্টা করছেন সেটি অবৈধ কারণ ভিডিওটির চ্যানেল সক্রিয় নয়৷ -
badRequest
– আপনি যে ভিডিওটি দাবি করার চেষ্টা করছেন সেটি টেকডাউন নীতি থেকে মুক্ত। অনুসন্ধানের জন্য, অনুগ্রহ করে [email protected]এ যোগাযোগ করুন -
badRequest
- আপনার অনুরোধ প্রক্রিয়া করা যাবে না কারণ আপনি নির্দিষ্ট ভিডিওতে তৃতীয় পক্ষের দাবি তৈরি করতে পারবেন না। -
conflict
- YouTube অনুরোধ করা দাবি তৈরি করতে পারে না কারণ ভিডিওটি একটি সরানোর নোটিশের বিরুদ্ধে দাঁড়িয়েছে৷ -
conflict
- YouTube অনুরোধ করা দাবি তৈরি করতে পারে না কারণ ভিডিওটির একটি সক্রিয় টেকডাউন দাবি রয়েছে৷
references.insert
-
badRequest
- আপনি যে দাবি করা ভিডিওটি ব্যবহার করার চেষ্টা করছেন সেটি মুছে ফেলা বা প্রত্যাখ্যান করা হয়েছে, অথবা এর প্রক্রিয়াকরণ ব্যর্থ হয়েছে৷
-
contentOwnerNotProvided
এবংinternalError
ত্রুটি ত্রুটিগুলি, যা একটি নির্দিষ্ট API পদ্ধতির জন্য নির্দিষ্ট নয়, প্রতিটি পদ্ধতির পৃষ্ঠায় আর তালিকাভুক্ত নয়৷ তাদের বিবরণ এখনও API এর ত্রুটি ডকুমেন্টেশনের সাধারণ ত্রুটি বিভাগে পাওয়া যেতে পারে।
সেপ্টেম্বর 12, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
referenceConflict
রিসোর্স দুটি রেফারেন্স ফাইলের মধ্যে একটি দ্বন্দ্ব চিহ্নিত করে এবং দ্বন্দ্ব চিহ্নিত করার সময় সেই ফাইলগুলির মধ্যে বিদ্যমান মিলগুলির তালিকা করে৷referenceConflicts.list
পদ্ধতি আপনাকে অনুমোদিত বিষয়বস্তুর মালিকের সাথে সম্পর্কিত অমীমাংসিত রেফারেন্স দ্বন্দ্বগুলির একটি তালিকা পুনরুদ্ধার করতে দেয়৷referenceConflicts.get
পদ্ধতি আপনাকে একটি রেফারেন্স দ্বন্দ্ব পুনরুদ্ধার করতে সক্ষম করে তার অনন্য রেফারেন্স দ্বন্দ্ব আইডি নির্দিষ্ট করে।
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
API এখন একটি সম্পদের জন্য কার্যকর মিল নীতি পুনরুদ্ধার করার ক্ষমতা সমর্থন করে। এই পরিবর্তনটি 16 জুলাই, 2013 সালে প্রকাশিত পরিবর্তনগুলির সমান্তরাল, যার মধ্যে একটি সম্পদের জন্য মেটাডেটা এবং মালিকানা ডেটার ক্যানোনিকাল সেট পুনরুদ্ধার করার জন্য সমর্থন অন্তর্ভুক্ত ছিল৷
একটি সম্পদের জন্য কার্যকর মিল নীতি পুনরুদ্ধার করতে,
assets.get
বাassets.list
পদ্ধতিতে কল করার সময়fetchMatchPolicy
প্যারামিটার মানটিকেeffective
হিসাবে সেট করুন৷ API প্রতিক্রিয়াতে, প্রতিটি ফেরতasset
সম্পদেরmatchPolicyEffective
অবজেক্টে সেই সম্পদের জন্য কার্যকর মিল নীতি থাকে।asset
সম্পদের নতুনownershipConflicts
বস্তুতে সম্পদের মালিকানা দ্বন্দ্ব সম্পর্কে তথ্য রয়েছে। বস্তুর গঠন একটিownership
সম্পদের কাঠামোর অনুরূপ, যা প্রতিটি ভিন্ন ধরনের অধিকারকে চিহ্নিত করে যা একজন সম্পদের মালিক ধারণ করতে পারে। (বেশিরভাগ সম্পদের প্রকারের জন্য, মালিকদের কেবল সাধারণ সম্পদের মালিকানা থাকতে পারে, কিন্তু রচনা সম্পদের জন্য, মালিকরা তাদের কার্যক্ষমতা অধিকার, সিঙ্ক্রোনাইজেশন অধিকার, বা যান্ত্রিক অধিকারের মালিকানাকে আইটেমাইজ করতে পারে।)একইভাবে,
ownershipConflicts
বস্তুতে পৃথক তালিকা রয়েছে যা সাধারণ মালিকানা অধিকার, কর্মক্ষমতা অধিকার, সিঙ্ক্রোনাইজেশন অধিকার এবং যান্ত্রিক অধিকারগুলির জন্য দ্বন্দ্ব চিহ্নিত করে। প্রতিটি বিরোধের জন্য, ডেটা সেই অঞ্চলগুলিকে চিহ্নিত করে যেখানে বিবাদ ঘটে, মালিকরা যারা বিবাদমান মালিকানা ডেটা প্রদান করেছেন এবং প্রতিটি বিবাদমান মালিকের মালিকানা দাবি করে এমন সম্পদের শতাংশ।assets.get
এবংassets.get
পদ্ধতিগুলি এখন নতুনfetchOwnershipConflicts
প্যারামিটার সমর্থন করে৷ পরামিতিটির একটি বুলিয়ান মান রয়েছে যা নির্দেশ করে যে API অনুরোধটি API প্রতিক্রিয়ায় সম্পদের জন্য মালিকানা দ্বন্দ্ব পুনরুদ্ধার করবে কিনা। ডিফল্ট মানfalse
, যার অর্থ হল মালিকানা বিরোধ ফেরত দেওয়া হয় না৷YouTube অনুসন্ধান করে এমন মেটাডেটা ক্ষেত্র সনাক্ত করতে
assetSearch.list
পদ্ধতিরq
প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে।একটি
references.insert
পদ্ধতির জন্য অনুরোধের বডির ডকুমেন্টেশন এখন নির্দেশ করে যে আপনাকে অবশ্যইcontentType
সম্পত্তির মান সেট করতে হবে। এই পরিবর্তনটি প্রকৃত API কার্যকারিতা সঠিকভাবে প্রতিফলিত করার জন্য ডকুমেন্টেশন আপডেট করে কিন্তু API কার্যকারিতার পরিবর্তনের প্রতিনিধিত্ব করে না।
নতুন এবং আপডেট ত্রুটি
API একটি নতুন
forbidden
ত্রুটি সমর্থন করে, যা একটি নির্দিষ্ট পদ্ধতির জন্য নির্দিষ্ট নয়, যা নির্দেশ করে যে অনুরোধকৃত অপারেশনটি একটি পরিষেবা অ্যাকাউন্ট দ্বারা অনুমোদিত হতে পারে না।assets.insert
পদ্ধতিটি এখন মেটাডেটা ত্রুটিগুলিকেmetadataMine
metadata
বৈশিষ্ট্যে ঘটছে বলে চিহ্নিত করে, যা 16 জুলাই, 2013-এ API আপডেটের সময় অবচয় করা হয়েছিল।ত্রুটি পৃষ্ঠাটি আপডেট করা হয়েছে যাতে
update
এবংpatch
পদ্ধতি সমর্থন করে এমন প্রতিটি সংস্থানের জন্য, পৃষ্ঠাটিতে একটি টেবিল রয়েছে যা সেই দুটি পদ্ধতি দ্বারা প্রত্যাবর্তিত ত্রুটিগুলি তালিকাভুক্ত করে৷ পূর্বে, পৃষ্ঠাটি প্রতিটি পদ্ধতির জন্য পৃথকভাবে ত্রুটিগুলি তালিকাভুক্ত করেছিল, যদিও তালিকাগুলি সর্বদা একই ছিল।
জুলাই 16, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন সম্পদ এবং পদ্ধতি
নতুন
claimHistory.get
পদ্ধতি আপনাকে একটি নির্দিষ্ট দাবি সম্পর্কে তথ্য সনাক্ত করতে এবং পুনরুদ্ধার করতে দেয়। ফিরে আসাclaimHistory
সম্পদে দাবির সাথে সম্পর্কিত ইভেন্টগুলির একটি তালিকা রয়েছে, যেমন দাবি তৈরি করা, আপডেট করা, বিতর্কিত বা বন্ধ করা।নতুন
claimSearch.list
পদ্ধতি আপনাকে দাবিগুলি অনুসন্ধান করতে দেয় যা নিম্নলিখিত মানদণ্ডগুলির যেকোনো একটি বা সমস্ত পূরণ করে:- দাবিগুলি একটি নির্দিষ্ট সম্পদের সাথে যুক্ত।
- দাবিগুলি একটি নির্দিষ্ট ভিডিওর সাথে যুক্ত৷
- দাবিগুলি অনুরোধে প্রদত্ত একটি ক্যোয়ারী স্ট্রিংয়ের সাথে মেলে৷
API প্রতিক্রিয়ার প্রতিটি
claimSnippet
সংস্থান একটি দাবি সম্পর্কে বিশদ বিবরণ ধারণ করে, সেই দাবির অনন্য দাবি আইডি, তার স্থিতি, এর ধরন (audio
,video
, বাaudiovisual
), এবং দাবির সাথে সম্পর্কিত সম্পদ এবং ভিডিও। রিসোর্সটি দাবি করা ভিডিও এবং দাবি করা ভিডিওর শিরোনামের জন্য দেখার সংখ্যাও নির্দিষ্ট করে৷
বিদ্যমান সম্পদ এবং পদ্ধতির আপডেট
ডকুমেন্টেশন এখন বৈশিষ্ট্যগুলির জন্য সমর্থিত মানগুলি তালিকাভুক্ত করে যেগুলির গণনা করা মানগুলির একটি সেট রয়েছে। এই ধরনের বৈশিষ্ট্যের মধ্যে
asset
সম্পদেরtype
সম্পত্তি এবংclaim
সম্পদেরstatus
সম্পত্তি অন্তর্ভুক্ত।assets.get
এবংassets.list
পদ্ধতির জন্য, API এখনfetchMetadata
এবংfetchOwnership
অনুরোধ প্যারামিটারের জন্য কমা-বিচ্ছিন্ন মান সমর্থন করে, যা আপনাকে মেটাডেটা বা মালিকানা ডেটার একাধিক সেট পুনরুদ্ধার করতে সক্ষম করে।নীচের তালিকাটি
asset
সম্পদের কাঠামোর সাথে সম্পর্কিত পরিবর্তনগুলি ব্যাখ্যা করে এবং সেইসাথে এপিআই পদ্ধতিতে সেই পরিবর্তনগুলির প্রভাবগুলি ব্যাখ্যা করে যা ,list
,insert
,update
, বাpatch
asset
সংস্থানগুলিget
৷metadata
অবজেক্ট অবলোচিত হয়েছে এবংmetadataMine
এবংmetadataEffective
অবজেক্ট দ্বারা প্রতিস্থাপিত হয়েছে। নতুন অবজেক্টগুলি একটিasset
সংস্থানকে কন্টেন্ট মালিকের দ্বারা সরবরাহ করা মেটাডেটার সেট উভয়ই অন্তর্ভুক্ত করার অনুমতি দেয় যা API অনুরোধ করে সেইসাথে মেটাডেটার ক্যানোনিকাল সেট যা YouTube নির্ধারণ করেছে সম্পদের জন্য মেটাডেটার সবচেয়ে সঠিক, সম্পূর্ণ সেট।একইভাবে,
ownership
বস্তুটিownershipMine
এবংownershipEffective
বস্তুর সাথে প্রতিস্থাপিত হয়েছে।matchPolicy
অবজেক্টটিmatchPolicyMine
অবজেক্টের সাথে প্রতিস্থাপিত হয়েছে। (এপিআই বর্তমানে একটি সম্পদের জন্য কার্যকর ম্যাচ নীতি পুনরুদ্ধার করার ক্ষমতা সমর্থন করে না।)
দ্রষ্টব্য: পশ্চাৎপদ সামঞ্জস্য নিশ্চিত করতে, যদি শুধুমাত্র একটি মেটাডেটা সংস্করণ, মালিকানা ডেটার একটি সেট, বা একটি মিল নীতির জন্য একটি সম্পদের জন্য অনুরোধ করা হয়, তাহলে API প্রতিক্রিয়া অবনমন বস্তুর পাশাপাশি নতুন সমর্থিত অবজেক্ট অন্তর্ভুক্ত করবে। উদাহরণস্বরূপ, যদি একটি অনুরোধ
fetchMetadata
পরামিতিmine
তে সেট করে, API প্রতিক্রিয়াতে একটিmetadata
অবজেক্ট এবং একটিmetadataMine
অবজেক্ট থাকবে, উভয়েই একই ডেটা থাকবে। (fetchMetadata=mine
সেট করার ক্ষমতা বৈশিষ্ট্য আপডেটের আগে সমর্থিত ছিল যা আপনাকে একাধিক মেটাডেটা সংস্করণ পুনরুদ্ধার করতে সক্ষম করে।)
যাইহোক, যদিfetchMetadata
প্যারামিটারটিmine,effective
, API প্রতিক্রিয়াতেmetadataMine
এবংmetadataEffective
অবজেক্ট থাকবে, কিন্তু এতেmetadata
অবজেক্ট থাকবে না। (fetchMetadata=mine,effective
সেট করার ক্ষমতা এই বৈশিষ্ট্য আপডেটের আগে সমর্থিত ছিল না, তাই পশ্চাদগামী সামঞ্জস্যের জন্যmetadata
বস্তু ফেরত দেওয়ার প্রয়োজন নেই।) একই নীতিfetchOwnership
এবংfetchMatchPolicy
প্যারামিটারের ক্ষেত্রেও প্রযোজ্য।
একইভাবে, পশ্চাদগামী সামঞ্জস্যের জন্য, একটিasset
সম্পদinsert
,update
বাpatch
অনুরোধের মধ্যেmetadataMine
অবজেক্ট বাmetadata
অবজেক্ট অন্তর্ভুক্ত থাকতে পারে। একই নীতি একটিasset
সম্পদের মালিকানা ডেটা বা ম্যাচ নীতি সেট করার ক্ষেত্রে প্রযোজ্য।claims.list
পদ্ধতিরassetId
,q
, এবংvideoId
পরামিতিগুলি বাতিল করা হয়েছে৷ এই মানদণ্ডগুলির যেকোনো একটি ব্যবহার করে দাবিগুলি অনুসন্ধান করতে, claimSearch.list পদ্ধতিটি ব্যবহার করুন, যা এই সমস্ত প্যারামিটারগুলিকে সমর্থন করে৷একটি
ownership
সম্পদে,general[].ratio
,performance[].ratio
,synchronization[].ratio
, এবংmechanical[].ratio
বৈশিষ্ট্যের মানগুলির এখনinteger
পরিবর্তেdouble
বিষয়বস্তু বিন্যাস রয়েছে।policy
সম্পদেরrules[].action
প্রপার্টি এখন সেই সম্পত্তির বৈধ মান তালিকাভুক্ত করে:block
,monetize
,takedown
, এবংtrack
। যাইহোক, মনে রাখবেন যে আপনি একটি দাবিতে টেকডাউন নীতি প্রয়োগ করতে API ব্যবহার করতে পারবেন না।আপনার CMS অ্যাকাউন্টের সাথে লিঙ্ক করা একটি YouTube চ্যানেলে আপলোড করা একটি বিদ্যমান YouTube ভিডিওর সাথে একটি সম্পদ সংযুক্ত করে রেফারেন্সটি তৈরি করা হলে
reference
রিসোর্সের নতুনclaimId
সম্পত্তি উপস্থিত থাকে। সেক্ষেত্রে, এই ফিল্ডে দাবির আইডি থাকে যা সম্পদ এবং ভিডিওর মধ্যকার সম্পর্ককে উপস্থাপন করে।reference
রিসোর্সের নতুনexcludedIntervals[]
প্রপার্টি রেফারেন্স চলাকালীন সময়ের ব্যবধানের একটি তালিকা নির্দিষ্ট করে যা রেফারেন্স মেলানোর চেষ্টা করার সময় YouTube-এর উপেক্ষা করা উচিত। প্রতিটি ব্যবধান ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা একটি শুরু এবং শেষ সময় নির্দিষ্ট করে৷API এর আর
reference
রিসোর্সেstatus
প্রপার্টি সেট করার প্রয়োজন নেই যাreferences.update
বাreferences.patch
রিকোয়েস্টের বডিতে পাঠানো হয়।videoAdvertisingOptions.getEnabledAds
পদ্ধতির জন্য API প্রতিক্রিয়া বিন্যাস সঠিকভাবে বর্ণনা করতে ডকুমেন্টেশন সংশোধন করা হয়েছে। প্রতিক্রিয়া, যা একটিyoutubePartner#videoAdvertisingOptionGetEnabledAds
সম্পদ, এতে নিম্নলিখিত তথ্য রয়েছে:id
– সেটিংসের সাথে যুক্ত দাবি করা ভিডিওটিকে অনন্যভাবে সনাক্ত করতে YouTube ব্যবহার করে আইডি।adBreaks
- বস্তুর একটি তালিকা যেখানে প্রতিটি বস্তুতে ভিডিও প্লেব্যাকের আগে, চলাকালীন বা পরে বিজ্ঞাপনগুলি চালানোর অনুমতি দেওয়া হলে একটি বিন্দু সম্পর্কে তথ্য থাকে৷ প্রতিটি বস্তু বিজ্ঞাপন বিরতির অন্যান্য বৈশিষ্ট্যগুলিও নির্দিষ্ট করতে পারে, যেমন বিরতির সময় ঘটে যাওয়া বিজ্ঞাপন স্লট এবং প্রতিটি স্লটের সময় চালানোর অনুমতি দেওয়া বিজ্ঞাপনের প্রকারগুলি।adsOnEmbeds
– একটি বুলিয়ান ক্ষেত্র যা নির্দেশ করে যে ভিডিওটি এমবেডেড প্লেয়ারে চালানো হলে YouTube বিজ্ঞাপন দেখাতে পারে কিনা।countriesRestriction
- বস্তুর একটি তালিকা যেখানে প্রতিটি বস্তু অঞ্চলগুলির একটি তালিকা এবং সেই অঞ্চলগুলিতে ভিডিও প্লেব্যাকের সময় ব্যবহৃত বিজ্ঞাপন ফর্ম্যাটগুলিকে চিহ্নিত করে৷
নতুন এবং আপডেট ত্রুটি
নীচের সারণীটি API সমর্থন করে এমন নতুন ত্রুটিগুলি এবং প্রতিটি ত্রুটি ফিরিয়ে দিতে পারে এমন পদ্ধতিগুলি চিহ্নিত করে৷ এটি পরিবর্তিত ত্রুটিগুলিও চিহ্নিত করে৷ মনে রাখবেন যে একটি পদ্ধতি একই ত্রুটির ধরন সহ একাধিক ত্রুটি ফেরত দিতে পারে। উদাহরণস্বরূপ, যদি আপনি একটি প্রয়োজনীয় মেটাডেটা ক্ষেত্র অনুপস্থিত একটি
asset
সংস্থান সন্নিবেশ করার চেষ্টা করেন তবে একটিrequired
ত্রুটি ফেরত দেওয়া হয়৷ প্রকৃতপক্ষে, একাধিক প্রয়োজনীয় মেটাডেটা ক্ষেত্র থাকতে পারে, যার প্রত্যেকটি সামান্য ভিন্ন বার্তা সহ একটি ত্রুটি ফিরিয়ে দেবে।আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
পদ্ধতি ত্রুটি assets.insert
assets.update
assets.patch
-
invalidValue
এবংrequired
ত্রুটিগুলি পূর্বেmetadata
অবজেক্টের চাইল্ড বৈশিষ্ট্যের সাথে যুক্ত এখনmetadataMine
অবজেক্টের একই চাইল্ড বৈশিষ্ট্যের সাথে যুক্ত।
claimHistory.get
-
notFound
- যে দাবির জন্য আপনি ইতিহাস পুনরুদ্ধার করার চেষ্টা করছেন সেটি খুঁজে পাওয়া যাবে না। -
required
- অনুরোধটিclaimId
প্যারামিটারের জন্য একটি মান নির্দিষ্ট করে না।
claimSearch.list
claims.list
-
badRequest
- অনুরোধটি অবৈধ মানদণ্ড নির্দিষ্ট করে। সর্বাধিক, নিম্নলিখিত ফিল্টার পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করা যেতে পারে:q
,assetId
,videoId
।
claims.insert
-
badRequest
– আপনি যে দাবিটি তৈরি করার চেষ্টা করছেন সেটি অবৈধ কারণ অনুরোধ করা বিষয়বস্তুর মালিক দাবির সাথে যুক্ত সম্পদের মালিক নন। -
badRequest
– আপনি যে বিষয়বস্তুর মালিকের হয়ে কাজ করছেন তার কাছে নির্দিষ্ট পদক্ষেপের সাথে নীতি তৈরি করার অনুমতি নেই৷ -
invalidValue
– আপনি যে বিষয়বস্তুর মালিকের পক্ষে কাজ করছেন তার API-এর মাধ্যমে ব্যবহারকারী-আপলোড করা ভিডিও দাবি করার অনুমতি নেই।
contentOwners.list
-
badRequest
- অনুরোধটি অবৈধ মানদণ্ড নির্দিষ্ট করে। সঠিকভাবে নিম্নলিখিত ফিল্টার পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করা আবশ্যক:fetchMine
,id
. (আগে, ত্রুটিটি ফিল্টার প্যারামিটারের একটি ভিন্ন সেট তালিকাভুক্ত করেছিল –has_conflicts_with
,restrict_to_user
,name_prefix
, এবংid
।)
ownership.update
ownership.patch
-
badRequest
- একটি অনুরোধ যা একটি রচনা সম্পদের মালিকানা ডেটা আপডেট করে তার জন্য দানাদার মালিকানা ডেটা নির্দিষ্ট করতে হবে &ndahs;mechanical
,performance
,synchronization
, এবং/অথবাlyric
অধিকার -general
মালিকানার অধিকারের পরিবর্তে৷lyric
অধিকারের ধরন নতুনভাবে সমর্থিত।
policies.insert
policies.update
policies.patch
-
invalidValue
- অনুরোধটিতে একটি অবৈধ নীতির নিয়ম রয়েছে কারণ API একটিtakedown
অ্যাকশন নির্দিষ্ট করে এমন নীতি তৈরি বা পরিবর্তন সমর্থন করে না। এই ত্রুটিটি, যাinvalidPolicyTakedownAction
এর একটি কারণ রিপোর্ট করে, অবহেলিতinvalidPolicyConditionalTakedown
ত্রুটিকে প্রতিস্থাপন করে৷
references.insert
-
badRequest
- অনুরোধটি অবশ্যই একটি মিডিয়া ফাইল পাঠাতে হবে বাclaimId
অনুরোধ প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে। যাইহোক, একটি অনুরোধ একটি মিডিয়া ফাইল পাঠাতে পারে না এবংclaimId
অনুরোধ প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে পারে না। -
badRequest
- একই বিষয়বস্তুর জন্য একটি রেফারেন্স ইতিমধ্যেই একই YouTube ভিডিওতে একটি ভিন্ন দাবি থেকে তৈরি করা হয়েছে৷ -
badRequest
- API একটি রেফারেন্স তৈরি করার সময়fpDirect
সম্পত্তির জন্য একটি মান সেট করার ক্ষমতা সমর্থন করে না। -
internalError
- আপলোড করা মিডিয়া ফাইলের সাথে একটি সমস্যা আছে। -
invalidValue
–contentType
,assetId
, বাclaimId
অনুরোধ প্যারামিটারের মানটি অবৈধ৷ ত্রুটিটি অবৈধ মান চিহ্নিত করে৷ -
notFound
- আপনার নির্দিষ্ট করা সম্পদ বা দাবি পাওয়া যাবে না। অনুগ্রহ করে আপনার অনুরোধেassetId
এবংclaimId
প্যারামিটার মান পরীক্ষা করুন। -
required
- অনুরোধটি অবশ্যইcontentType
প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
references.insert
references.update
references.patch
-
invalidValue
- রেফারেন্সের জন্য নির্দিষ্টexcludedIntervals
বৈধ নয়৷ উল্লেখ্য যে একটি রেফারেন্স নিষ্ক্রিয় করার সময় আপনি বর্জন ব্যবধান নির্দিষ্ট করতে পারবেন না।
-
10 মে, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
YouTube আর পরীক্ষামূলক API বৈশিষ্ট্য এবং পরিষেবাগুলি সনাক্ত করে না৷ পরিবর্তে, আমরা এখন YouTube APIগুলির একটি তালিকা প্রদান করি যেগুলি অবচয় নীতির অধীন ৷
এপ্রিল 8, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
API-এর নাম পরিবর্তন করে YouTube Content ID API করা হয়েছে।
assetMatchPolicy
রিসোর্সে বেশ কিছু বৈশিষ্ট্য পরিবর্তিত হয়েছে:-
kind
সম্পত্তির মানyoutubePartner#policy
থেকেyoutubePartner#assetMatchPolicy
এ পরিবর্তিত হয়েছে। - নতুন
policyId
বৈশিষ্ট্যে একটি মান রয়েছে যা একটি সংরক্ষিত নীতি সম্পদকে অনন্যভাবে সনাক্ত করে। -
rules[].subaction
প্রপার্টির মান এখন স্ট্রিংয়ের পরিবর্তে স্ট্রিংয়ের একটি তালিকা। -
rules[].conditions.contentMatchType
প্রপার্টি মান এখন স্ট্রিংয়ের পরিবর্তে স্ট্রিংয়ের একটি তালিকা। -
id
,name
এবংdescription
বৈশিষ্ট্যগুলি সরানো হয়েছে৷
-
assetMatchPolicy.update
পদ্ধতির ডকুমেন্টেশন আপডেট করা হয়েছে এই সত্যটি প্রতিফলিত করার জন্য যে আপনি পদ্ধতিতে কল করার সময়policyId
সম্পত্তি বাrules[]
অবজেক্টের জন্য মান সেট করতে পারেন।claims
সংস্থান এখন বেশ কয়েকটি নতুন বৈশিষ্ট্য সমর্থন করে:সম্পত্তির নাম মান বর্ণনা timeCreated
datetime
যে তারিখ এবং সময় দাবি করা হয়েছিল। matchInfo
object
matchInfo
অবজেক্টে মিলিত বিষয়বস্তু সম্পর্কে তথ্য রয়েছে যা দাবি তৈরি করেছে। এই তথ্যটি শুধুমাত্র একটিclaim
সংস্থানে অন্তর্ভুক্ত করা হয় যদি দাবিটি স্বয়ংক্রিয়ভাবে তৈরি হয় কারণ একটি আপলোড করা ভিডিও একটি বিদ্যমান রেফারেন্স ফাইলের সাথে মিলে যায়।matchInfo. referenceId
string
ইউনিক আইডি যেটি ইউটিউব ব্যবহার করে রেফারেন্স reference
সনাক্ত করতে যেটি মিল তৈরি করেছে।matchInfo. longestMatch
object
longestMatch
অবজেক্টে রেফারেন্স এবং আপলোড করা ভিডিওর মধ্যে সবচেয়ে দীর্ঘতম মিল সম্পর্কে তথ্য রয়েছে।matchInfo.longestMatch. durationSecs
unsigned long
ম্যাচের সময়কাল, সেকেন্ডে। matchInfo.longestMatch. userVideoOffset
unsigned long
ম্যাচ শুরু হওয়ার সময় অফসেট, আপলোড করা ভিডিওর শুরু থেকে সেকেন্ডে পরিমাপ করা হয়। matchInfo.longestMatch. referenceOffset
unsigned long
ম্যাচ শুরু হওয়ার সময় অফসেট, রেফারেন্সের শুরু থেকে সেকেন্ডে পরিমাপ করা হয়। matchInfo. totalMatch
object
totalMatch
অবজেক্টে আপলোড করা ভিডিওর মোট পরিমাণ সম্পর্কে তথ্য রয়েছে যা রেফারেন্সের সাথে মেলে এবং রেফারেন্সের মোট পরিমাণ সম্পর্কে যা আপলোড করা ভিডিওর সাথে মেলে। এই মানগুলি আলাদা হতে পারে যদি আপলোড করা ভিডিও বা রেফারেন্সে মিলে যাওয়া বিষয়বস্তু লুপে চলে। উদাহরণস্বরূপ, যদি একটি আপলোড করা ভিডিওতে একটি রেফারেন্স থেকে 10-সেকেন্ডের একটি ক্লিপ অন্তর্ভুক্ত থাকে, কিন্তু ক্লিপটি ছয়বার পুনরাবৃত্তি হয়, তাহলে আপলোড করা ভিডিওতে মোট মিলে যাওয়া বিষয়বস্তু 60 সেকেন্ডের, কিন্তু রেফারেন্সে মোট মিলে যাওয়া সামগ্রী মাত্র 10 সেকেন্ডের। .matchInfo.totalMatch. userVideoDurationSecs
unsigned long
রেফারেন্সের সাথে মেলে আপলোড করা ভিডিওর সামগ্রীর মোট দৈর্ঘ্য, সেকেন্ডে। matchInfo.totalMatch. referenceDurationSecs
unsigned long
আপলোড করা ভিডিওর সাথে মেলে রেফারেন্স সামগ্রীর মোট দৈর্ঘ্য, সেকেন্ডে। origin
object
origin
বস্তুতে এমন তথ্য থাকে যা দাবির উৎস বর্ণনা করে।origin. source
string
দাবির উৎস। claims
সংস্থানেরpolicy
সম্পত্তি আপডেট করা হয়েছে নোট করার জন্য যে মানটি অডিও অদলবদল দাবির জন্য আপডেট করা যাবে না।metadataHistory
সম্পদেরtimeProvidedMs
সম্পত্তির নাম পরিবর্তন করে timeProvided করা হয়েছে।ownershipHistory
সম্পদেরtimeProvidedMs
সম্পত্তির নাম পরিবর্তন করে timeProvided করা হয়েছে।ownershipHistory.list
পদ্ধতির সংজ্ঞা আপডেট করা হয়েছে লক্ষ্য করার জন্য যে পদ্ধতিটি শুধুমাত্র প্রতিটি বিষয়বস্তুর মালিকের জন্য সবচেয়ে সাম্প্রতিক মালিকানা ডেটা পুনরুদ্ধার করে। যাইহোক, যদি বিষয়বস্তুর মালিক একাধিক ডেটা উৎসের (API, বিষয়বস্তু ফিড, ইত্যাদি) মাধ্যমে মালিকানার ডেটা জমা দিয়ে থাকেন, তাহলে তালিকায় প্রতিটি বিষয়বস্তুর মালিক এবং ডেটা উত্সের জন্য সাম্প্রতিকতম ডেটা থাকবে৷policy
সম্পদে বেশ কিছু বৈশিষ্ট্য পরিবর্তিত হয়েছে:-
rule
সম্পত্তির নাম পরিবর্তন করে নিয়ম করা হয়েছে। -
rules[].subaction
প্রপার্টির মান এখন স্ট্রিংয়ের পরিবর্তে স্ট্রিংয়ের একটি তালিকা। -
rules[].conditions.contentMatchType
প্রপার্টি মান এখন স্ট্রিংয়ের পরিবর্তে স্ট্রিংয়ের একটি তালিকা।
-
policies.insert
এবংpolicies.update
পদ্ধতিগুলির জন্য ডকুমেন্টেশন আপডেট করা হয়েছে এই সত্যটি প্রতিফলিত করার জন্য যে আপনি সেই পদ্ধতিগুলিকে কল করার সময়rules[]
অবজেক্টের জন্য মান সেট করতে পারেন।বেশ কিছু API পদ্ধতি নতুন ত্রুটি প্রকার সমর্থন করে। নীচের সারণী পদ্ধতিটি সনাক্ত করে এবং নতুন সমর্থিত ত্রুটিগুলির প্রকারগুলিকে সংক্ষেপে চিহ্নিত করে৷ অনেক ক্ষেত্রে, প্রদত্ত ধরণের জন্য একাধিক ত্রুটি থাকতে পারে। উদাহরণস্বরূপ, যদি আপনি একটি প্রয়োজনীয় মেটাডেটা ক্ষেত্র অনুপস্থিত একটি
asset
সংস্থান সন্নিবেশ করার চেষ্টা করেন তবে একটিrequired
ত্রুটি ফেরত দেওয়া হয়৷ প্রকৃতপক্ষে, একাধিক প্রয়োজনীয় মেটাডেটা ক্ষেত্র থাকতে পারে, যার প্রত্যেকটি সামান্য ভিন্ন বার্তা সহ একটি ত্রুটি ফিরিয়ে দেবে।আরও তথ্যের জন্য প্রতিটি পদ্ধতির ত্রুটির ডকুমেন্টেশন বা ত্রুটি পৃষ্ঠায় অনুগ্রহ করে পড়ুন।
পদ্ধতি ত্রুটি assets.insert
-
invalidValue
- একটি সম্পদ মেটাডেটা ক্ষেত্রে একটি অবৈধ মান রয়েছে। -
required
- একটি প্রয়োজনীয় সম্পদ মেটাডেটা ক্ষেত্র অনুপস্থিত।
assets.update
assets.patch
-
forbidden
- আপডেট করা সম্পদটি আপডেটটি সম্পূর্ণ করার চেষ্টাকারী অংশীদারের মালিকানাধীন নয়। -
invalidValue
- একটি সম্পদ মেটাডেটা ক্ষেত্রে একটি অবৈধ মান রয়েছে। -
notFound
- সম্পদটি একটি সিজন সম্পদ বা শো সম্পদের সাথে যুক্ত করা হচ্ছে যা খুঁজে পাওয়া যায় না। -
required
- একটি প্রয়োজনীয় সম্পদ মেটাডেটা ক্ষেত্র অনুপস্থিত।
claims.insert
-
badRequest
- অনুরোধটি একটি ভিডিও দাবি করার চেষ্টা করে, কিন্তু দাবিটি অনুমোদিত নয়৷
ownership.update
ownership.patch
-
badRequest
- অনুরোধটি একটি অঞ্চলের মধ্যে 100 শতাংশের বেশি মোট মালিকানা সংজ্ঞায়িত করে।
policies.insert
policies.patch
policies.update
-
conflictingPolicyRules
- নীতিতে পরস্পরবিরোধী নীতি বিধি রয়েছে।
-
নতুন ত্রুটি পৃষ্ঠাটি ত্রুটিগুলি তালিকাভুক্ত করে যা API ফেরত দিতে পারে৷ পৃষ্ঠাটিতে সাধারণ ত্রুটি রয়েছে, যা একাধিক ভিন্ন API পদ্ধতির পাশাপাশি পদ্ধতি-নির্দিষ্ট ত্রুটির জন্য ঘটতে পারে।
18 জানুয়ারী, 2013
এই আপডেটে নিম্নলিখিত পরিবর্তনগুলি রয়েছে:
নতুন নথিভুক্ত
videoAdvertisingOptions.getEnabledAds
পদ্ধতি আপনাকে নির্দিষ্ট অংশীদার- বা ব্যবহারকারীর আপলোড করা ভিডিওর জন্য অনুমোদিত বিজ্ঞাপনের প্রকারের বিবরণ পুনরুদ্ধার করতে দেয়৷assetSearch.list
পদ্ধতিরownershipRestriction
প্যারামিটারের সংজ্ঞাটি নোট করার জন্য আপডেট করা হয়েছে যে ডিফল্ট প্যারামিটার মানটিmine
, যা নির্দেশ করে যে API শুধুমাত্র বর্তমান ব্যবহারকারীর মালিকানাধীন সম্পদ পুনরুদ্ধার করবে।assets.list
পদ্ধতির ডকুমেন্টেশন নিম্নলিখিত পরিবর্তনগুলি প্রতিফলিত করে:id
প্যারামিটার এখন প্রয়োজন।নতুন সমর্থিত
fetchMatchPolicy
প্যারামিটার আপনাকে নির্দেশ করতে দেয় যে API অনুরোধটি আপনার সম্পত্তির জন্য সেট করা ম্যাচ নীতিটি পুনরুদ্ধার করা উচিত কিনা।নতুন সমর্থিত
fetchOwnership
প্যারামিটার আপনাকে নির্দেশ করতে দেয় যে API অনুরোধটি সম্পদের মালিকানা ডেটাও পুনরুদ্ধার করবে কিনা।এপিআই ফেরত দেওয়া সম্পদের তালিকায় আর পেজিনেশন ডেটা থাকে না। ফলস্বরূপ,
nextPageToken
প্রপার্টি এবংpageInfo
অবজেক্ট উভয়ই API প্রতিক্রিয়া থেকে সরানো হয়েছে।pageInfo
অবজেক্টটিতেtotalResults
,resultsPerPage
, এবংstartIndex
বৈশিষ্ট্য রয়েছে।
claims
সংস্থান ডকুমেন্টেশন আপডেট করা হয়েছে নোট করার জন্য যে দাবি তৈরি করার সময় আপনাকে অবশ্যই একটি নীতি নির্দিষ্ট করতে হবে। (যদি একটি সন্নিবেশিত দাবি একটি নীতি নির্দিষ্ট না করে তবে YouTube বর্তমানে আপনার ডিফল্ট ব্যবহারের নীতি প্রয়োগ করে না, যদিও ডকুমেন্টেশন পূর্বে ইঙ্গিত করেছে যে এটি ঘটেছে।)policy
সম্পদেরhasUnpublishedDraft
প্রপার্টি অবচয় করা হয়েছে।policies.list
পদ্ধতির নতুন সমর্থিতid
প্যারামিটার আপনাকে সেভ করা নীতিগুলি সনাক্ত করতে দেয় যা API অনুরোধটি পুনরুদ্ধার করা উচিত। শুধুমাত্র বর্তমানে প্রমাণীকৃত বিষয়বস্তুর মালিকের নীতিগুলি পুনরুদ্ধার করা যেতে পারে৷references.patch
এবংreferences.update
পদ্ধতি উভয়ের জন্যreleaseClaims
প্যারামিটারের সংজ্ঞা আপডেট করা হয়েছে নোট করার জন্য যে প্যারামিটারটি তখনই কাজ করে যখন দাবির স্থিতিinactive
তে আপডেট করা হচ্ছে। সেক্ষেত্রে, আপনি রেফারেন্স দ্বারা উত্পাদিত সমস্ত মিল দাবি প্রকাশ করার জন্যreleaseClaims
প্যারামিটারের মানটিকেtrue
হিসাবে সেট করতে পারেন।references.patch
এবংreferences.update
পদ্ধতি উভয়ই আপডেট করা হয়েছে নোট করার জন্য যে এই ক্রিয়াকলাপগুলির মধ্যে একটি সম্পাদন করার সময় আপনাকে অবশ্যই রেফারেন্সের স্থিতি নির্দিষ্ট করতে হবে।বেশ কিছু API পদ্ধতি নতুন ত্রুটি প্রকার সমর্থন করে। নীচের টেবিলটি পদ্ধতি এবং নতুন সমর্থিত ত্রুটিগুলি সনাক্ত করে:
পদ্ধতি ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা guideCategories.list
notFound
Unavailable
যে সম্পদের জন্য আপনি ম্যাচ নীতি পুনরুদ্ধার করার চেষ্টা করছেন সেটি খুঁজে পাওয়া যাবে না। claims.get
notFound
Unavailable
দাবি যে আপনি পুনরুদ্ধার করার চেষ্টা করছেন খুঁজে পাওয়া যাবে না. ownership.patch
invalidValue
Unavailable
আপনার দেওয়া মালিকানা ডেটাতে একটি অবৈধ মান রয়েছে৷ ownership.update
invalidValue
Unavailable
আপনার দেওয়া মালিকানা ডেটাতে একটি অবৈধ মান রয়েছে৷