API شناسه محتوای YouTube - سابقه بازبینی

توجه: YouTube Content ID API برای استفاده شرکای محتوای YouTube در نظر گرفته شده است و برای همه توسعه دهندگان یا همه کاربران YouTube قابل دسترسی نیست. اگر API شناسه محتوای YouTube را به‌عنوان یکی از سرویس‌های فهرست شده در Google API Console نمی‌بینید، برای کسب اطلاعات بیشتر درباره YouTube Partner Program به مرکز راهنمایی YouTube مراجعه کنید.

این صفحه تغییرات API و به‌روزرسانی‌های اسناد YouTube Content ID را فهرست می‌کند.

26 مارس 2025

از 31 مارس 2025، YouTube نحوه شمارش بازدیدهای Shorts را تغییر خواهد داد. در گذشته، برای Shorts، یک نمایش پس از پخش Short برای تعداد معینی از ثانیه شمارش می شد. اکنون، تعداد دفعاتی که Short شما شروع به پخش یا پخش مجدد می‌کند، تعداد بازدیدها را می‌شمارند، بدون نیاز به حداقل زمان تماشا. بیشتر بدانید

طبق این تغییر، تا 30 ژوئن 2025، Content ID API به روش‌های زیر به‌روزرسانی می‌شود:

• claimSearch.list.sort سفارشات مرتب سازی خود را به روز می کند:
  • DAILY_ENGAGED_VIEWS برای تعداد بازدیدهای روزانه بر اساس روش شمارش بازدیدهای قبلی اضافه خواهد شد.
  • LIFETIME_ENGAGED_VIEWS بر اساس روش شمارش بازدیدهای قبلی به تعداد بازدیدهای مادام العمر اضافه می شود.
• assetSearch.list.sort سفارشات مرتب سازی خود را به روز می کند:
  • DAILY_ENGAGED_VIEWS برای تعداد بازدیدهای روزانه بر اساس روش شمارش بازدیدهای قبلی اضافه خواهد شد.

طبق این تغییر، تا 30 سپتامبر 2025، Content ID API به روش‌های زیر به‌روزرسانی می‌شود:

• ترتیب مرتب سازی assetSearch.list.sort VIEWS منسوخ خواهد شد.
• سفارش مرتب سازی claimSearch.list.sort VIEW_COUNT منسوخ خواهد شد.
• claimSearch.claimSnippet.videoViews به روز می شود تا روش تعداد بازدیدهای به روز شده را برای بازدیدهای Shorts منعکس کند.
• claimSearch.claimSnippet.engagedViews برای تعداد بازدیدها بر اساس روش شمارش بازدید قبلی اضافه خواهد شد.

14 ژانویه 2025

فیلد autoGeneratedBreaks[] منبع videoAdvertisingOption به روز شده است زیرا اکنون اجازه می دهیم ad_breaks و autoGeneratedBreaks همزمان ارائه شوند. اگر autoGeneratedBreaks روی ویدیویی با adBreaks تعریف شده روی true تنظیم شده باشد، سیستم‌های ما مکان‌هایی را برای نمایش آگهی‌ها علاوه بر جایگاه‌های تبلیغاتی که به صورت دستی قرار داده‌اید شناسایی می‌کنند. برای جزئیات بیشتر به مقاله پشتیبانی مراجعه کنید.

10 نوامبر 2023

فیلد adFormats[] منبع videoAdvertisingOption به‌روزرسانی شده است تا third_party تنها مقدار معتبر آن فیلد باشد. قالب‌های تبلیغات زیر دیگر پشتیبانی نمی‌شوند: instream_trueview ، instream_standard ، display ، preroll ، postroll . برای جزئیات بیشتر به مقاله پشتیبانی مراجعه کنید.

1 ژوئن 2023

توجه: این یک اعلامیه منسوخ شدن است.

این به روز رسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روش های موجود

  • قسمت breakPosition[] منبع videoAdvertisingOption به عنوان منسوخ علامت گذاری شده است و در سال 2024 حذف خواهد شد.
    روش های videoAdvertisingOptions.update و videoAdvertisingOptions.patch قبلاً این فیلد را نادیده می گیرند.
  • قسمت منسوخ شده adBreaks[].slot[] منبع videoAdvertisingOption حذف شده است.
  • category منسوخ منبع asset و فیلدهای showCustomId حذف شده است.
  • فیلد timeStatusLastModified منبع claim جدید، زمان آخرین تغییر ادعا را گزارش می‌کند.
  • پارامتر isVideoShortsEligible روش جدید claimSearch.list را می توان برای فیلتر کردن ویدیوهای ادعا شده بر اساس واجد شرایط بودن YouTube Shorts استفاده کرد.

• منابع و روش های جدید

  • اکنون API از فهرست کردن منابع YouTube Music پشتیبانی می‌کند:
    • منابع musicRelease می توان با روش musicReleases.list فهرست کرد.
    • منابع musicTrack می توان با روش musicTracks.list فهرست کرد.
    • منابع musicChangeRequest می توان با روش musicChangeRequests.list فهرست کرد.

20 دسامبر 2022

تعریف پارامتر پرس و جو ownershipRestriction روش assetSearch.list به روز شده است تا روشن شود که اگر مقدار آن پارامتر none باشد، مقدار پارامتر فراداده metadataSearchFields نیز باید حداقل از یک فیلتر ID استفاده کند. این تغییر مستندات نشان دهنده تغییر در رفتار API نیست.

9 نوامبر 2022

اسناد مربوط به روش‌های asset.get و asset.list به‌روزرسانی شده است تا مشخص شود که چگونه چندین مقدار پشتیبانی می‌شوند:

• fetchMatchPolicy ( دریافت ، لیست )
• fetchMetadata ( دریافت ، لیست )
• fetchOwnership ( دریافت ، فهرست )

28 سپتامبر 2022

اطلاعات مربوط به مجوز به asset resource اضافه شده است.

18 جولای 2022

اسناد مربوط به inactiveReasons روش claimSearch.list به‌روزرسانی شده است تا بهبودهایی را برای سازگاری با YouTube Studio منعکس کند:

• استودیو قبلاً پشتیبانی از 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 API اشاره کنند. پیوندهای از پیش تولید شده برای PHP به روز شد.

3 مه 2022

پارامتر status متد claimSearch.list اکنون از فیلترهای بیشتری بر اساس جزئیات ادعای احتمالی پشتیبانی می کند.

2 مه 2022

مستندات پاسخ روش assetSearch.list به‌روزرسانی شده است تا بهبودهایی را برای سازگاری با AIP-158 منعکس کند:

• توضیحات pageInfo.totalResults به صراحت اشاره می کند که ارزش یک تخمین است و نه مقدار واقعی
• فیلدهای pageInfo.resultsPerPage و pageInfo.startIndex حذف شده‌اند

25 آوریل 2022

مستندات منبع assetLabels.list به‌روزرسانی شده است تا معنای پارامترهای درخواست labelPrefix و q را روشن کند و صفحه‌بندی پشتیبانی درخواست/پاسخ را مستند کند.

8 دسامبر 2021

مستندات منبع claimSearch.list به‌روزرسانی شده است تا دو مورد استفاده‌ای را که این روش پوشش می‌دهد به درستی منعکس کند:

• جستجو بر اساس شناسه (دارایی، مرجع یا ویدیو) یا رشته درخواست
• جستجو بر اساس تاریخ ایجاد ادعا، تاریخ اصلاح، یا وضعیت

هر مورد استفاده از مجموعه متفاوتی از پارامترهای پرس و جو پشتیبانی می کند. مستندات روش claimSearch.list برای توضیح اینکه کدام پارامترها برای هر مورد استفاده پشتیبانی می شوند، به روز شده است.

17 نوامبر 2021

این به روز رسانی شامل تغییرات زیر است:

• اکنون روش claims.update از قابلیت به‌روزرسانی وضعیت ادعای غیرفعال یا بالقوه به active پشتیبانی می‌کند. تعریف ویژگی status منبع claim جزئیات بیشتری را ارائه می دهد.
• اسناد مربوط به claim و منابع claimSearch به‌روزرسانی شده است تا نشان دهنده اضافه شدن شی studioInfo جدید باشد که حاوی پیوندهایی به صفحات استودیوی YouTube مرتبط با ادعا است.
• لیست مقادیر پشتیبانی شده برای پارامتر origin متد claimSearch.list تغییر کرده است. این پارامتر اکنون از چهار مقدار اضافی پشتیبانی می کند: batchTool ، inProductShorts ، melodyMatch ، و youTubeAdmin . علاوه بر این، مقادیر dropboxUpload و webUpload دیگر پشتیبانی نمی‌شوند.

26 فوریه 2021

مستندات پارامتر videoId در روش claimSearch.list به‌روزرسانی شده است تا توجه داشته باشید که مقدار پارامتر اکنون حداکثر 10 شناسه ویدیویی جدا شده با کاما را می‌پذیرد. اگر مقدار دارای بیش از 10 شناسه ویدیو باشد، API یک خطای badRequest - 400 کد پاسخ HTTP - برمی‌گرداند.

6 دسامبر 2018

توجه: این یک اعلامیه منسوخ شدن است.

اسناد API برای حذف ارجاع به منبع contentOwnerAdvertisingOptions و روش های آن به روز شده است. این روش‌ها بسیار کم استفاده می‌شدند و کاربران API که از آن‌ها استفاده می‌کردند، قبل از این اعلامیه به‌طور جداگانه با آنها تماس گرفته شد.

21 مارس 2018

این به روز رسانی شامل تغییرات زیر است:

• ویژگی metadataMine.artist اکنون باید هر زمانی که یک موزیک ویدیو یا دارایی ضبط صدا را وارد می‌کنید ، به‌روزرسانی می‌کنید یا وصله می‌کنید تنظیم شود. اگر ویژگی برای آن نوع منابع تنظیم نشده باشد، اکنون API یک خطا برمی‌گرداند. علاوه بر این، توجه داشته باشید که ویژگی metadataMine.artist فقط برای هنرمندان موسیقی ویدیو و ضبط صدا پشتیبانی می شود.

24 جولای 2017

این به روز رسانی شامل تغییرات زیر است:

• منبع package جدید گروهی از فایل‌ها را نشان می‌دهد که از طریق وب، SFTP یا مکانیزم تحویل دیگر تحویل داده می‌شوند. API از دو روش برای این منبع پشتیبانی می کند:

  • روش package.insert یک بسته فقط متادیتا که دقیقاً حاوی یک فایل فراداده است را تأیید و بارگذاری می‌کند.
  • متد package.get اطلاعات مربوط به یک بسته آپلود شده قبلی را بازیابی می کند.

• برای روش validator.validate ، تعریف ویژگی uploaderName به‌روزرسانی شده است تا توجه داشته باشیم که این مقدار شریک محتوایی را که داده‌ها را بارگذاری می‌کند شناسایی نمی‌کند، بلکه مقداری مانند web-google یا yt-google را نشان می‌دهد که حساب آپلودکننده خاصی را که مالک محتوا استفاده می‌کند، شناسایی می‌کند.

• ویژگی status منبع reference از مقدار duplicate_on_hold برای نشان دادن اینکه یک مرجع تکراری از مرجع دیگر است استفاده نمی کند. در عوض، اگر یک مرجع تکراری باشد، مقدار ویژگی status اکنون روی inactive تنظیم شده است و مقدار ویژگی statusReason REASON_DUPLICATE_FOR_OWNERS است.

  با این حال، مانند قبل، ویژگی duplicateLeader منبع فقط در صورتی پر می شود که مرجع تکراری باشد. اگر تنظیم شود، مقدار آن ویژگی مرجع تکراری را مشخص می کند.

17 آوریل 2017

این به روز رسانی شامل تغییرات زیر است:

• منبع assetShare جدید که فقط مربوط به دارایی های ترکیب است، رابطه بین دو نمایش یک منبع دارایی را مشخص می کند. این نمایش‌ها منعکس‌کننده مدل داده‌های انتشار جدیدی هستند که برای ارائه شفافیت و کنترل بیشتر بر نحوه ارتباط حقوق شما با دارایی‌های ضبط صدا طراحی شده است.

  در مدل جدید، هر ضبط صوت دقیقاً به یک دارایی منحصربه‌فرد نقشه می‌دهد که به آن نمای ترکیبی می‌گویند. فراداده آن دارایی مجموعه متعارف اطلاعاتی را نشان می‌دهد که YouTube درباره حقوق ترکیب مرتبط با یک ضبط معین نمایش می‌دهد و ممکن است اطلاعاتی را از چندین ارائه‌دهنده داده ترکیب کند.

  علاوه بر این، هر صاحب ترکیب دارایی سهام ترکیب خود را دارد. سهم ترکیب نشان دهنده اطلاعاتی است که یک ناشر خاص برای دارایی ترکیب ارائه کرده است. سهم آهنگسازی را می توان با بسیاری از صداهای ضبط شده مرتبط دانست.

  منبع assetShare رابطه بین نمای ترکیب و سهم ترکیب را مشخص می کند. روش جدید assetShares.list به شما امکان می دهد یکی از موارد زیر را انجام دهید:

  • شناسه نمای ترکیبی را ارائه دهید و در صورت وجود چنین سهمی، سهم ترکیب مربوطه را که متعلق به شریک مجاز درخواست است، بازیابی کنید.
  • شناسه اشتراک‌گذاری ترکیب متعلق به شریک محتوا را ارائه کنید و فهرستی از همه نماهای ترکیبی که آن اشتراک به آن‌ها پیوند دارد، بازیابی کنید.

• راهنمای جدید مدیریت دارایی‌های ترکیب توضیح می‌دهد که چگونه روش‌های مختلف API بسته به اینکه شناسه‌های دارایی ارسال شده به آن روش‌ها نماهای ترکیب یا اشتراک‌های ترکیب را شناسایی می‌کنند، درخواست‌ها را رسیدگی می‌کنند.

• ویژگی جدید claimedVideoOptions.autoGeneratedBreaks منبع contentOwnerAdvertisingOptions نشان می دهد که آیا YouTube باید به طور خودکار در ویدیوهای ادعا شده بیش از 10 دقیقه وقفه های تبلیغاتی ایجاد کند یا خیر. در حالی که این ویژگی بر همه ویدیوهای مالک محتوا که بیش از 10 دقیقه طول می‌کشند تأثیر می‌گذارد، اگر ویدیویی چندین ادعا داشته باشد، اولین شریکی که یک ویدیو را ادعا می‌کند رفتار پیش‌فرض این ویژگی را در رابطه با آن ویدیو تنظیم می‌کند.

11 آگوست 2016

این به روز رسانی شامل تغییرات زیر است:

• شرایط خدمات سرویس YouTube API تازه منتشر شده ("شرایط به روز شده")، که به طور مفصل در وبلاگ مهندسی و توسعه دهندگان YouTube مورد بحث قرار گرفته است، مجموعه ای غنی از به روز رسانی ها را برای شرایط خدمات فعلی ارائه می دهد. علاوه بر شرایط به‌روزرسانی شده که از 10 فوریه 2017 اجرایی می‌شود، این به‌روزرسانی شامل چندین سند پشتیبانی برای کمک به توضیح خط‌مشی‌هایی است که توسعه‌دهندگان باید دنبال کنند.

  مجموعه کامل اسناد جدید در تاریخچه بازنگری برای شرایط به روز شده توضیح داده شده است. علاوه بر این، تغییرات آتی در شرایط به‌روزرسانی شده یا اسناد پشتیبان نیز در آن تاریخچه بازبینی توضیح داده خواهد شد. می‌توانید مشترک فید RSS شوید که تغییرات آن تاریخچه بازبینی را از پیوندی در آن سند فهرست می‌کند.

31 مه 2016

این به روز رسانی شامل تغییرات زیر است:

• منابع و روش های جدید

  • روش جدید validator.validate اگر فایل حاوی خطا باشد، ویژگی errors پاسخ API حاوی فهرستی از خطاهای اعتبارسنجی است که شدت، علت و محل هر خطا را مشخص می کند.

• خطاهای جدید و به روز شده

  • اکنون روش‌های assets.patch و assets.update از خطای زیر پشتیبانی می‌کنند. به عنوان یادآوری، یک روش می تواند چندین خطا را که نوع خطای یکسانی دارند پشتیبانی کند. لطفاً برای لیست کامل خطاهای احتمالی به مستندات خطا برای هر روش یا به صفحه خطاها مراجعه کنید.

    خطاها
    invalidValue (400)	parameters.assetId درخواست انجام نشد زیرا دارایی در حال به روز رسانی با دارایی دیگری ادغام شده است. درخواست را با استفاده از شناسه آن دارایی که در پیام خطا به عنوان مقدار پارامتر assetId برگردانده می شود، دوباره ارسال کنید.

28 مارس 2016

این به روز رسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روش های موجود

  • ویژگی جدید matchInfo.matchSegments[] منبع claim حاوی لیستی است که در آن هر مورد بخشی از ویدیوی ادعا شده را توصیف می کند که با بخشی از ویدیوی مرجع مطابقت دارد. یک ادعا می‌تواند چندین بخش مطابقت داشته باشد. برای مثال، اگر محتوای صوتی و تصویری یک ویدیوی آپلود شده با ویدیوی مرجع مطابقت داشته باشد، دو بخش مطابقت وجود دارد. یک بخش تطابق صوتی را توصیف می کند و قسمت دیگر مسابقه ویدیویی را توصیف می کند.

    برای هر بخش مطابقت، API مدت زمان و نوع (صوتی یا ویدیویی) محتوای منطبق را برمی‌گرداند. API همچنین زمان شروع و پایان هر بخش مسابقه را در ویدیوی ادعا شده و ویدیوی مرجع شناسایی می کند.

  • با فراخوانی روش‌های contentOwnerAdvertisingOptions.patch یا contentOwnerAdvertisingOptions.update ، مقدار ویژگی claimedVideoOptions.newVideoDefaults[] منبع contentOwnerAdvertisingOptions اکنون می‌تواند به‌روزرسانی شود.

  • خاصیت فقط خواندنی allowedOptions.autoGeneratedBreaks منبع contentOwnerAdvertisingOptions منسوخ شده است.

• خطاهای جدید و به روز شده

  • روش claims.update API اکنون از خطای زیر پشتیبانی می کند. به عنوان یادآوری، یک روش می تواند چندین خطا را که نوع خطای یکسانی دارند پشتیبانی کند. لطفاً برای لیست کامل خطاهای احتمالی به مستندات خطا برای هر روش یا به صفحه خطاها مراجعه کنید.

    خطاها
    badRequest (400)	alreadyClaimed این ادعا تکراری از یک ادعای موجود دیگر است و نمی توان آن را به روز کرد.

  • روش assets.list گهگاه از بین می رود و کد پاسخ HTTP 500 ( Internal Server Error ) را برمی گرداند، به ویژه زمانی که درخواست داده های بسیاری از دارایی ها را بازیابی می کند و مقدار پارامتر fetchMatchPolicy effective است. اگر درخواست assets.list شما چندین شناسه دارایی را مشخص می‌کند و یک خطای 500 را برمی‌گرداند، درخواست را برای یک دارایی یا تعداد کمتری از دارایی‌ها دوباره ارسال کنید.

  • مستندات خطای references.insert به‌روزرسانی شده است تا توجه داشته باشید که اگر درخواست یک فایل مرجع خراب بارگذاری کند، این مشکل تا زمانی که خود مرجع پردازش نشود شناسایی نمی‌شود. بنابراین، حتی اگر درخواست references.insert یک پاسخ موفقیت آمیز برگرداند، ممکن است مرجع با موفقیت پردازش نشود. توصیه می کنیم پس از درج یک مرجع، با استفاده از روش references.list نظرسنجی کنید تا تأیید کنید که مرجع همانطور که انتظار می رود فعال شده است.

3 فوریه 2016

این به روز رسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روش های موجود

  • API اکنون از تبلیغات لیست محصولات پشتیبانی می کند. آگهی‌های فهرست محصولات، محصولاتی را که به محتوای ویدیو مرتبط هستند یا در آن نشان داده می‌شوند، برجسته می‌کنند. این تبلیغات کارت های حمایت شده هستند که در طول ویدیو نمایش داده می شوند. کارت ها به صورت خودکار توسط سیستم تبلیغاتی اضافه می شوند. بینندگان برای چند ثانیه یک تیزر برای کارت می بینند و همچنین می توانند روی نماد در گوشه سمت راست بالای ویدیو کلیک کنند تا کارت های ویدیو را مرور کنند.

    در نتیجه این تغییر، product_listing اکنون می تواند در مقادیر ویژگی های زیر گنجانده شود:

    روش منبع/API	اموال
    contentOwnerAdvertisingOptions	allowedOptions.licAdFormats[]
    contentOwnerAdvertisingOptions	allowedOptions.ugcAdFormats[]
    contentOwnerAdvertisingOptions	claimedVideoOptions.newVideoDefaults[]
    videoAdvertisingOptions	adFormats[]
    videoAdvertisingOptions.getEnabledAds	countriesRestriction[].adFormats[]

  • روش جدید createdBefore و createdAfter روش assetSearch.list به API دستور می‌دهد فقط دارایی‌های ایجاد شده قبل و/یا بعد از یک تاریخ خاص را برگرداند.

  • در پاسخ API به درخواست assetSearch.list ، ویژگی type اکنون از مقدار art_track_video پشتیبانی می‌کند. مرکز راهنمایی YouTube اطلاعات بیشتری درباره ویدیوهای آهنگ هنری ارائه می دهد.

  • متد claimSearch.list از پارامترهای جدید زیر پشتیبانی می کند:

    پارامترها
    referenceId	این پارامتر فیلتر، شناسه مرجع YouTube مرجعی را که برای آن ادعاها را بازیابی می کنید، مشخص می کند.
    inactiveReasons	این پارامتر اختیاری به شما امکان می‌دهد پاسخ API را محدود کنید تا فقط ادعاهای غیرفعال را براساس دلایل مشخص شده غیرفعال شدن ادعاها شامل شود. تعریف پارامتر انواع ادعاهای غیرفعال را فهرست می کند که می توانید برای آنها جستجو کنید.
    partnerUploaded	این پارامتر بولی اختیاری به شما امکان می دهد مشخص کنید که پاسخ API فقط شامل ادعاهای بارگذاری شده توسط شریک یا غیر شریک باشد.

  • شی منابع reference جدید منبع references#origination حاوی اطلاعاتی است که منبع مرجع را توصیف می کند.

  • روش references.insert اکنون از توانایی آپلود مراجع تولید شده با استفاده از نرم افزار gfp_gen YouTube پشتیبانی می کند. اگر یک اثر انگشت از پیش تولید شده ارائه می کنید، مقدار ویژگی fpDirect را در منبع reference آپلود شده روی true تنظیم کنید.

    توجه داشته باشید که با این تغییر، اگر بخواهید ویژگی fpDirect را هنگام آپلود یک مرجع تنظیم کنید، API دیگر خطایی را برنمی‌گرداند.

• خطاهای جدید و به روز شده

  اکنون اسناد، خطاهایی را فهرست می‌کند که با روش‌های منبع whitelist بازگردانده شده‌اند.

  علاوه بر این، جدول زیر خطاهای جدیدی را که API پشتیبانی می کند و روش هایی که می توانند هر خطا را برگردانند، شناسایی می کند. توجه داشته باشید که یک روش ممکن است چندین خطا را که نوع خطای یکسانی دارند برگرداند. لطفاً برای اطلاعات بیشتر به مستندات خطا برای هر روش یا به صفحه خطاها مراجعه کنید.

  خطاها
  badRequest (400)	inappropriateCampaignTarget اگر کمپین سعی کند ویدیویی را نمایش دهد که ممکن است برای برخی از کاربران نامناسب باشد، روش‌های campaigns.insert و campaigns.update این خطا را برمی‌گردانند. برای رفع خطا، لطفاً محتوای متفاوتی را برای مشخص کردن انتخاب کنید.
  badRequest (400)	canNotCreatePartnerUploadedClaim OnCompositionOrSoundRecordingAssets اگر بخواهید یک ادعای بارگذاری شده توسط شریک با دارایی آهنگسازی یا ضبط صدا ایجاد کنید، روش claims.insert این خطا را برمی‌گرداند.
  badRequest (400)	existingSoundRecordingOrMusicVideoClaim اگر ادعایی از قبل برای موسیقی ضبط شده در ویدیوی مشخص شده وجود داشته باشد، روش claims.insert این خطا را برمی‌گرداند. ادعاهای ترکیب مستقیم را نمی توان از طریق API اضافه کرد.
  badRequest (400)	asset_id متد references.insert این خطا را برمی‌گرداند اگر درخواست تلاش برای ایجاد یک مرجع از طریق یک فایل باشد اما درخواست دارایی را مشخص نکرده باشد.
  badRequest (400)	canNotBeActivated روش references.update این خطا را برمی گرداند اگر مرجع نتواند فعال شود، احتمالاً به دلیل وضعیت مرجع یا شرایط مالکیت.
  badRequest (400)	videoNotClaimed روش videoAdvertisingOptions.get اگر ویدیویی را که می‌خواهید گزینه‌های تبلیغاتی را برای آن بازیابی کنید ادعا نکرده‌اید، این خطا را برمی‌گرداند و در نتیجه اطلاعات درخواستی را در دسترس شما قرار نمی‌دهد.

18 دسامبر 2015

قوانین اتحادیه اروپا (EU) ایجاب می کند که افشای مشخصی باید به کاربران نهایی در اتحادیه اروپا داده شود و از آنها رضایت گرفته شود. بنابراین، برای کاربران نهایی در اتحادیه اروپا، باید از سیاست رضایت کاربر اتحادیه اروپا پیروی کنید. ما در شرایط خدمات YouTube API خود اطلاعیه ای درباره این الزام اضافه کرده ایم.

21 آوریل 2015

این به روز رسانی شامل تغییرات زیر است:

• منبع campaign جدید نشان‌دهنده یک کمپین مالک محتوای خاص است که به مالک محتوا اجازه می‌دهد از حاشیه‌نویسی برای تبلیغ محتوا در ویدیوهای ادعا شده و بارگذاری‌شده توسط کاربر استفاده کند. به عنوان مثال، یک مالک محتوا می‌تواند کمپینی ایجاد کند که پیوندهایی را به صفحه تماشای فیلم برای هر ویدیوی ادعا شده و آپلود شده توسط کاربر که حاوی صحنه‌هایی از آن فیلم است، اضافه کند.

  API از روش هایی برای get ، list ، insert ، update ، patch و delete منابع campaign پشتیبانی می کند.

• API از چندین خطای جدید برای روش‌های جدید campaigns.get ، campaigns.insert ، campaigns.update و campaigns.delete پشتیبانی می‌کند.

30 مارس 2015

این به روز رسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روش های موجود

  • پارامتر جدید isrcs روش assetSearch.list به شما امکان می‌دهد فهرستی از حداکثر ۵۰ ISRC را مشخص کنید. پاسخ API شامل دارایی های مرتبط با آن ISRC ها خواهد بود.

  • event[].reason منبع claimHistory از مقادیر جدید زیر پشتیبانی می‌کند. هر دلیل توضیح می دهد که چرا یک رویداد خاص مربوط به ادعا رخ داده است:

    • reference_audio_claim_on_visual_reference
    • بسته_شریک_استخراج
    • درگیری_مرجع_بسته

  • پارامتر sort جدید متد claimSearch.list روشی را مشخص می‌کند که برای سفارش منابع در پاسخ API استفاده می‌شود. به‌طور پیش‌فرض، منابع به ترتیب زمانی معکوس (از جدیدترین به قدیمی‌ترین) بر اساس تاریخ ایجادشان مرتب می‌شوند. همچنین می توانید منابع را از بیشترین به کمترین تعداد بازدید برای محتوای ادعا شده مرتب کنید.

    توجه داشته باشید که اگر درخواست claimSearch.list مقدار پارامتر status را نیز بر روی appealed ، disputed ، pending ، potential یا routedForReview تنظیم کند، نتایج بر اساس زمان انقضای دوره بررسی ادعا مرتب می‌شوند.

  • اکنون متدهای ownership.update و ownership.patch به درستی تمام خصوصیاتی را که می توان هنگام فراخوانی این متدها به روز کرد فهرست می کند. این تغییر نشان دهنده اصلاحی در اسناد API است و تغییری در عملکرد API را مشخص نمی کند.

  • پارامترهای fetchMatchPolicy برای روش‌های assets.get و assets.list اکنون به‌عنوان یک مقدار پشتیبانی شده effective فهرست می‌شوند. این مقدار به سرور API دستور می دهد تا خط مشی مطابقتی را که YouTube برای دارایی اعمال می کند، بازیابی کند.

  • پارامترهای id برای روش‌های assets.list ، claims.list ، contentOwners.list ، policies.list ، publishers.list و references.list همگی به این نکته توجه دارند که مقادیر پارامتر آنها حداکثر می‌تواند حاوی 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

این به روز رسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روش های موجود

  • پارامتر status متد claimSearch.list اکنون از مقدار routedForReview پشتیبانی می کند. این مقدار نتایج را محدود به ادعاهایی می‌کند که بر اساس قاعده‌ای در خط‌مشی تطبیق دارایی نیاز به بررسی دستی دارند.

  • event[].reason منبع claimHistory از مقادیر جدید زیر پشتیبانی می‌کند. هر دلیل توضیح می دهد که چرا یک رویداد خاص مربوط به ادعا رخ داده است:

    • بسته_نامعتبر_مرجع_بخش
    • closed_noadsense
    • suspended_monetization_on_channel
    • video_content_modified

  • ویژگی origin.source منبع claim ، که منبع ادعا را مشخص می کند، اکنون از مقدار 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 این خطا را برمی‌گردانند. نام برچسب ها باید بین دو تا 30 کاراکتر باشد. ممکن است شامل براکت‌های زاویه‌دار، کاما، دو نقطه، آمپرساند یا کاراکتر لوله عمودی (|) نباشد.
  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 این خطا را برمی‌گرداند.

• اگر منبع موجود در بدنه درخواست دارای ویژگی metadataMine.contentType نباشد، روش‌های assets.insert و assets.update دیگر خطای badRequest را برای برخی از دارایی‌ها برمی‌گردانند.

23 سپتامبر 2014

این به روز رسانی شامل تغییرات زیر است:

• شناسه مالک محتوا تغییر می کند

  تغییرات شناسه مالک محتوا که در تاریخچه بازبینی در 9 ژوئیه 2014 اعلام شده بود، اعمال شد. در نتیجه این تغییر، API اکنون یک شناسه تولید شده و منحصر به فرد را برای شناسایی مالک محتوای مرتبط با کاربر تأیید شده یا منبعی که از طریق API مدیریت می شود، برمی گرداند. پیش از این، API یک نام قابل خواندن برای انسان را به عنوان شناسه بازگرداند، مانند "qrs_network".

  این تغییر بر عملکرد API زیر تأثیر می‌گذارد و احتمالاً بر شرکای که کدهای شریک سخت‌کد شده در برنامه‌های خود دارند تأثیر می‌گذارد.

  • اکنون API شناسه جدید را به‌عنوان مقدار ویژگی‌های منبعی که قبلاً کد شریک را برمی‌گرداند، مانند ویژگی id منبع contentOwner ، برمی‌گرداند.
  • همه روش‌های API از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند، که مالک محتوا را مشخص می‌کند که درخواست API از طرف او انجام می‌شود. پس از تغییر، پارامتر باید به جای کد شریک روی شناسه جدید تنظیم شود. برای جلوگیری از شکست کد، پارامتر هر یک از مقادیر را در طول یک دوره انتقال می پذیرد.
  • پس از تغییر، پارامتر contentOwnerId روش contentOwners.list باید شناسه جدید را به جای کد شریک مشخص کند.

• به روز رسانی منابع و روش های موجود

  • پارامتر metadataSearchFields جدید روش assetSearch.list به شما امکان می دهد فیلدهای فراداده دارایی را که می خواهید جستجو کنید و همچنین مقادیری را که می خواهید در آن فیلدها جستجو کنید، مشخص کنید. مقدار پارامتر فهرستی از جفت‌های فیلد و مقدار است که با کاما از هم جدا شده‌اند. در یک جفت، فیلد و مقدار با یک دو نقطه از هم جدا می شوند.

  • شیء جدید appliedPolicy منبع claim ، خط‌مشی را مشخص می‌کند که YouTube واقعاً برای ادعا اعمال می‌کند. مقدار شی یک منبع policy است. این منبع حاوی اطلاعات خط‌مشی کشورهایی است که مالک محتوایی که درخواست را ارسال کرده است مالک دارایی ادعا شده است.

    خط‌مشی اعمال‌شده می‌تواند با خط‌مشی که مالک محتوا تعریف کرده است به دو صورت متفاوت باشد:

    1. این شامل خط‌مشی‌هایی است که توسط مالکان دیگری تنظیم شده است که مالکیت جزئی دارایی مورد ادعا را در برخی از مناطق مشابه مالک محتوایی که درخواست API را ارسال کرده است، دارند.

    2. این خط‌مشی‌های اداری YouTube را در بر می‌گیرد که در مناطقی اعمال می‌شود که مالک محتوا مالک دارایی مورد ادعا است.

  • ویژگی جدید uploaderChannelId منبع claimHistory شناسه کانال کانالی را که ویدیوی ادعا شده در آن آپلود شده است، شناسایی می کند.

8 سپتامبر 2014

این به روز رسانی شامل تغییرات زیر است:

• منابع و روش های جدید

  • منبع assetLabel جدید یک برچسب متنی را شناسایی می کند که می تواند به یک دارایی اختصاص داده شود. برچسب‌های دارایی به شما امکان می‌دهند دارایی‌ها را در دسته‌های سفارشی قرار دهید و سازماندهی کتابخانه دارایی‌تان را آسان‌تر می‌کند. می‌توانید دارایی‌ها را بر اساس برچسب‌های آن‌ها جستجو کنید، که می‌تواند موارد استفاده را که از شما می‌خواهد گروه‌های خاصی از دارایی‌ها را به‌روزرسانی کنید، ساده‌سازی کند.

    • روش assetLabels.list به شما امکان می دهد لیستی از برچسب های صاحب محتوا را بازیابی کنید.
    • متد assetLabels.insert به شما امکان می دهد یک برچسب دارایی جدید ایجاد کنید. همچنین می‌توانید با فراخوانی روش assets.update و به‌روزرسانی برچسب‌های یک دارایی، برچسب‌های جدیدی ایجاد کنید. سرور API به طور خودکار یک منبع assetLabel جدید برای هر برچسبی که قبلاً تعریف نشده بود ایجاد می کند.

• به روز رسانی منابع و روش های موجود

  • label[] منبع asset به‌روزرسانی شده است تا توجه داشته باشید که می‌توانید برای به‌روزرسانی برچسب‌های دارایی، روش assets.update را فراخوانی کنید. با این حال، هنگام فراخوانی روش assets.insert نمی‌توانید برچسب‌های دارایی را تنظیم کنید.

    راهنمای جدید Using Asset Labels نحوه ایجاد و بازیابی برچسب‌های دارایی و همچنین نحوه به‌روزرسانی برچسب‌های دارایی یا جستجوی دارایی‌های مرتبط با برچسب‌های خاص را توضیح می‌دهد.

• خطاهای جدید و به روز شده

  API از چندین خطای جدید برای متدهای assetLabels.list و assetLabels.insert جدید پشتیبانی می کند.

9 جولای 2014

این به روز رسانی شامل تغییرات زیر است:

• شناسه مالک محتوا تغییر می کند

  از لحاظ تاریخی، API از یک کد شریک قابل خواندن برای انسان، مانند "qrs_network" برای شناسایی منحصربه‌فرد مالک محتوای مرتبط با کاربر تأیید شده یا منبعی که از طریق API مدیریت می‌شود، استفاده کرده است. در سه ماهه سوم 2014، API به جای استفاده از شناسه منحصربه‌فرد 22 نویسه‌ای برای شناسایی صاحبان محتوا تغییر خواهد کرد. این تغییر عملکرد API زیر را تحت تأثیر قرار می دهد و احتمالاً بر شرکای که کدهای شریک سخت کدگذاری شده در برنامه های خود دارند تأثیر می گذارد.

  • API شناسه 22 نویسه‌ای را به‌عنوان مقدار ویژگی‌های منبعی که قبلاً کد شریک را برمی‌گرداند، مانند ویژگی id منبع contentOwner ، برمی‌گرداند.
  • همه روش‌های API از پارامتر onBehalfOfContentOwner پشتیبانی می‌کنند، که مالک محتوا را مشخص می‌کند که درخواست API از طرف او انجام می‌شود. پس از تغییر، پارامتر باید به جای کد شریک، روی شناسه ۲۲ کاراکتری تنظیم شود. برای جلوگیری از شکست کد، پارامتر هر یک از مقادیر را در طول یک دوره انتقال می پذیرد.
  • پس از تغییر، پارامتر contentOwnerId روش contentOwners.list باید شناسه 22 کاراکتری را به جای کد شریک مشخص کند.

• به روز رسانی منابع و روش های موجود

  • اکنون یک منبع asset از ویژگی label پشتیبانی می کند، که لیستی از برچسب های دارایی مرتبط با دارایی را مشخص می کند. می‌توانید برای گروه‌بندی چندین دارایی، یک برچسب اعمال کنید. می‌توانید از برچسب‌ها به‌عنوان فیلترهای جستجو برای انجام به‌روزرسانی‌های انبوه، بارگیری گزارش‌ها یا فیلتر کردن YouTube Analytics استفاده کنید.

  • روش assetSearch.list اکنون از پارامترهای اختیاری زیر پشتیبانی می کند:

    • labels : نتایج را محدود می‌کند تا فقط دارایی‌هایی باشد که با برچسب‌های مشخص‌شده مرتبط هستند. به طور پیش‌فرض، API دارایی‌هایی را برمی‌گرداند که با همه برچسب‌های مشخص‌شده مطابقت دارند. با این حال، می‌توانید از پارامتر includeAnyProvidedLabel برای دستور دادن به API برای بازگرداندن دارایی‌هایی که با هر یک از برچسب‌های مشخص شده مطابقت دارند، استفاده کنید.
    • 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

این به روزرسانی شامل تغییرات زیر است:

• به روز رسانی منابع و روشهای موجود

  • یک منبع asset اکنون می تواند یک type مقدار art_track_video داشته باشد.

  • یک منبع claimSearch اکنون شامل خواص جدید زیر است:

    • شیء origin حاوی اطلاعاتی است که شیوه ایجاد ادعا را توصیف می کند.
    • ویژگی thirdPartyClaim حاوی یک مقدار بولی است که نشان می دهد آیا این ادعا توسط یک صاحب محتوا غیر از آنچه در ارتباط با کاربر انجام جستجو انجام شده است ، انجام شده است.

  • روش claimSearch.list اکنون از پارامترهای اختیاری زیر پشتیبانی می کند:

    • contentType : نتایج را محدود می کند که فقط شامل ادعاهای فقط صوتی ، ادعاهای فقط فیلم یا ادعاهای سمعی و بصری است.
    • origin : یک یا چند اصل ادعای ، مانند descriptiveSearch یا videoMatch را مشخص می کند ، که می خواهید ادعاهایی پیدا کنید.
    • status : نتایج را محدود می کند که فقط شامل ادعاهایی است که وضعیت مشخصی دارند.

  • املاک status منابع claim اکنون از ارزش های اضافی زیر پشتیبانی می کند: appealed ، disputed ، potential ، takedown و unknown .

  • ویژگی جدید blockOutsideOwnership نشان می دهد که آیا ویدیوی claim شده باید در سرزمین هایی که صریحاً متعلق به آن نیست ، مسدود شود. به طور پیش فرض ، یک فیلم ادعا در کشورهایی که داده های مالکیت برای دارایی مرتبط با این ادعا تعریف نشده بود ، قابل مشاهده است.

  • ویژگی جدید allowedOptions.autoGeneratedBreaks منبع contentOwnerAdvertisingOption نشان می دهد که آیا شریک می تواند در مواقع استراحت به طور خودکار توسط YouTube تعیین کند ، تبلیغات در جریان را نشان دهد.

  • روش contentOwners.list اکنون می تواند با یک مجوز مجوز فراخوانی شود که https://www.googleapis.com/auth/youtubepartner-content-owner-readonly را مشخص می کند.

  • ملک جدید timeUpdated Resource policy ، زمان به روزرسانی این خط مشی را مشخص می کند.

  • روش policies.list اکنون از یک پارامتر sort اختیاری پشتیبانی می کند ، که می تواند برای مشخص کردن نتایج باید به ترتیب صعودی یا نزولی زمان آخرین به روزرسانی آنها طبقه بندی شود.

  • ملک جدید expiryTime referenceConflict Resource زمان پایان دوره بررسی درگیری مرجع را مشخص می کند و باعث انقضاء این درگیری می شود.

  • ویژگی جدید autoGeneratedBreaks Resource Resource videoAdvertisingOption نشان می دهد که آیا این فیلم باید تبلیغات Midroll را نشان دهد ، در زمان های استراحت به طور خودکار توسط YouTube تعیین می شود.

• خطاهای جدید و به روز شده

  جدول زیر خطاهای جدیدی را که API از آن پشتیبانی می کند و روشهایی که می تواند هر خطا را برگرداند ، مشخص می کند. توجه داشته باشید که یک روش ممکن است چندین خطای را که دارای همان نوع خطا هستند ، برگرداند. به عنوان مثال ، اگر سعی می کنید یک منبع asset را که یک قسمت ابرداده مورد نیاز را از دست داده است ، یک خطای required برگردانده شود. در حقیقت ، ممکن است بیش از یک قسمت ابرداده مورد نیاز وجود داشته باشد که هر یک از آنها خطایی را با یک پیام کمی متفاوت برمی گرداند.

  لطفاً برای اطلاعات بیشتر به اسناد خطا برای هر روش یا به صفحه خطاها مراجعه کنید.

  روش	خطاها
  assets.insert assets.update	badRequest - API از نوشتن عملیات در دارایی های آهنگ هنری پشتیبانی نمی کند.
  claimSearch.list	invalidValue - پارامتر pageToken در درخواست ، یک صفحه صفحه نامعتبر را مشخص می کند.
  claims.insert	badRequest - ادعایی که می خواهید ایجاد کنید نامعتبر است زیرا کانال ویدیو فعال نیست. badRequest - ویدئویی که می خواهید ادعا کنید از یک سیاست Takedown معاف است. برای پرس و جو ، لطفا با copyright@youtube.com تماس بگیرید badRequest درخواست شما نمی تواند پردازش شود زیرا شما نمی توانید ادعای شخص ثالث را در فیلم مشخص ایجاد کنید. conflict - YouTube نمی تواند ادعای درخواست شده را ایجاد کند زیرا این ویدئو با یک اعلامیه Takedown مخالفت کرده است. conflict - YouTube نمی تواند ادعای درخواست شده را ایجاد کند زیرا این ویدئو ادعای فعال Takedown را دارد.
  references.insert	badRequest - ویدیوی ادعا شده ای که می خواهید از آن استفاده کنید حذف یا رد شد ، یا پردازش آن شکست خورد.

• خطاهای contentOwnerNotProvided و internalError ، که مختص یک روش خاص API نیستند ، دیگر در هر صفحه روش ذکر نشده اند. توضیحات آنها هنوز هم در بخش خطاهای کلی مستندات خطای API یافت می شود.

12 سپتامبر 2013

این به روزرسانی شامل تغییرات زیر است:

• منابع و روشهای جدید

  • منبع جدید referenceConflict درگیری بین دو پرونده مرجع را مشخص می کند و در هنگام شناسایی درگیری ، مسابقات موجود بین این پرونده ها را لیست می کند. روش referenceConflicts.list به شما امکان می دهد لیستی از درگیری های مرجع حل نشده مرتبط با صاحب محتوای مجاز را بازیابی کنید. روش referenceConflicts.get شما را به شما امکان می دهد با مشخص کردن شناسه مرجع مرجع منحصر به فرد خود ، یک درگیری مرجع را بازیابی کنید.

  به روز رسانی منابع و روشهای موجود

  • API اکنون از توانایی بازیابی سیاست موثر مسابقه برای یک دارایی پشتیبانی می کند. این تغییر موازی با تغییراتی است که در تاریخ 16 ژوئیه 2013 منتشر شد ، که شامل پشتیبانی از بازیابی مجموعه متعارف ابرداده و داده های مالکیت برای یک دارایی بود.

    برای بازیابی خط مشی تطبیق مؤثر برای یک دارایی ، مقدار پارامتر fetchMatchPolicy را در هنگام فراخوانی assets.get یا assets.list effective کنید. در پاسخ API ، شیء matchPolicyEffective در هر منبع asset برگشتی حاوی سیاست تطبیق مؤثر برای آن دارایی است.

  • موضوع جدید ownershipConflicts منابع asset حاوی اطلاعاتی در مورد درگیری های مالکیت دارایی است. ساختار شیء شبیه به ساختار یک منبع ownership است ، که هر نوع حقوق مختلفی را که صاحب دارایی می تواند در اختیار داشته باشد ، مشخص می کند. (برای اکثر انواع دارایی ، صاحبان فقط می توانند مالکیت دارایی عمومی داشته باشند ، اما برای دارایی های ترکیب ، صاحبان می توانند مالکیت خود را از حقوق عملکرد ، حقوق هماهنگ سازی یا حقوق مکانیکی تعیین کنند.)

    به همین ترتیب ، Object ownershipConflicts شامل لیست های جداگانه ای است که تضاد را برای حقوق مالکیت عمومی ، حقوق عملکرد ، حقوق هماهنگ سازی و حقوق مکانیکی مشخص می کند. برای هر درگیری ، داده ها سرزمین هایی را که درگیری در آن رخ می دهد ، صاحبان داده های مالکیت متناقض و درصد دارایی که هر صاحب متضاد ادعا می کند ، مشخص می کند.

  • روش های assets.get و assets.get fetchOwnershipConflicts این پارامتر دارای یک مقدار بولی است که نشان می دهد درخواست API باید درگیری های مالکیت را برای دارایی های موجود در پاسخ API بازیابی کند. مقدار پیش فرض false است ، به این معنی که درگیری های مالکیت بازگردانده نمی شود.

  • تعریف پارامتر q assetSearch.list Method برای شناسایی زمینه های ابرداده ای که YouTube جستجو می کند به روز شده است.

  • مستندات بدنه درخواست برای references.insert اکنون نشان می دهد که شما باید مقدار خاصیت contentType را تنظیم کنید. این تغییر مستندات را به روز می کند تا به درستی عملکرد API واقعی را منعکس کند اما تغییر عملکرد API را نشان نمی دهد.

• خطاهای جدید و به روز شده

  • API از یک خطای forbidden جدید پشتیبانی می کند ، که مختص یک روش خاص نیست ، نشان می دهد که عملیات درخواست شده توسط یک حساب خدمات مجاز نیست.

  • روش assets.insert اکنون خطاهای ابرداده را به عنوان خاصیت در شیء metadataMine به جای شیء metadata ، که از بروزرسانی API در 16 ژوئیه 2013 کاهش یافته است ، مشخص می کند.

  • صفحه خطاها به روز شده است به گونه ای که برای هر منبعی که از روش های update و patch پشتیبانی می کند ، صفحه شامل یک جدول است که خطاهای برگشتی توسط آن دو روش را نشان می دهد. پیش از این ، این صفحه خطاهای مربوط به هر روش را به طور جداگانه ذکر می کرد ، اگرچه لیست ها همیشه یکسان بودند.

16 جولای 2013

این به روزرسانی شامل تغییرات زیر است:

• منابع و روشهای جدید

  • روش جدید claimHistory.get به شما امکان می دهد اطلاعات مربوط به یک ادعای خاص را شناسایی و بازیابی کنید. منبع بازگردانده شده claimHistory لیستی از رویدادهای مربوط به ادعا را شامل می شود ، مانند ادعایی که ایجاد می شود ، به روز می شود ، مورد اختلاف یا بسته قرار می گیرد.

  • روش جدید claimSearch.list به شما امکان می دهد تا ادعاهایی را که مطابق با همه یا همه معیارهای زیر است ، جستجو کنید:

    • ادعاها با یک دارایی خاص همراه است.
    • این ادعاها با یک فیلم خاص همراه است.
    • ادعاها با یک رشته پرس و جو ارائه شده در درخواست مطابقت دارد.

    هر منبع claimSnippet در پاسخ API حاوی جزئیاتی در مورد یک ادعا است ، از جمله شناسه ادعای منحصر به فرد ادعا ، وضعیت آن ، نوع آن ( audio ، video یا audiovisual ) و دارایی و ویدیوی مرتبط با این ادعا. این منبع همچنین تعداد دیدگاه های مربوط به ویدیوی ادعا شده و عنوان ویدیوی ادعا شده را مشخص می کند.

• به روز رسانی منابع و روشهای موجود

  • در حال حاضر این مستندات مقادیر پشتیبانی شده را برای خواصی که مجموعه ای از مقادیر ذکر شده دارند ، لیست می کند. این خصوصیات شامل asset type دارایی و خاصیت status منابع claim است.

  • برای assets.get و assets.list Methods ، API اکنون از مقادیر جدا شده از کاما برای پارامترهای درخواست fetchMetadata و fetchOwnership پشتیبانی می کند ، و شما را قادر می سازد تا چندین مجموعه از داده های ابرداده یا مالکیت را بازیابی کنید.

    لیست زیر تغییرات مربوط به ساختار منابع asset و همچنین تأثیر آن تغییرات بر روش های API را که get ، list ، insert ، update یا منابع asset patch توضیح می دهد.

    • شیء metadata کاهش یافته و توسط اشیاء metadataMine و metadataEffective جایگزین شده است. اشیاء جدید به یک منبع asset اجازه می دهند تا هر دو مجموعه ابرداده ارائه شده توسط صاحب محتوا را که درخواست API را تهیه می کند و همچنین مجموعه متعارف ابرداده ای که YouTube تعیین کرده است ، دقیق ترین و کامل ترین مجموعه ابرداده برای دارایی باشد.

    • به همین ترتیب ، شیء ownership با اشیاء ownershipMine و ownershipEffective جایگزین شده است.

    • شیء matchPolicy با شیء matchPolicyMine جایگزین شده است. (API در حال حاضر از توانایی بازیابی سیاست موثر مسابقه برای یک دارایی پشتیبانی نمی کند.)

    توجه: برای اطمینان از سازگاری به عقب ، اگر فقط یک نسخه ابرداده ، یک مجموعه از داده های مالکیت یا یک خط مشی مسابقه برای یک دارایی درخواست شود ، پاسخ API شامل شیء مستهلک شده و همچنین شیء تازه پشتیبانی شده است. به عنوان مثال ، اگر یک درخواست پارامتر fetchMetadata را به mine تنظیم کند ، پاسخ API حاوی یک شی metadata و یک شیء metadataMine است که هر دو دارای همان داده ها هستند. (امکان تنظیم fetchMetadata=mine قبل از بروزرسانی ویژگی پشتیبانی می شود و به شما امکان می دهد چندین نسخه ابرداده را بازیابی کنید.)
    
    با این حال ، اگر پارامتر fetchMetadata روی mine,effective ، پاسخ API حاوی اشیاء metadataMine و metadataEffective است ، اما حاوی یک شیء metadata نخواهد بود. (امکان تنظیم fetchMetadata=mine,effective fetchMatchPolicy نمی شود ، بنابراین نیازی به بازگشت شی metadata برای سازگاری به عقب نیست.) همین اصل همچنین در مورد پارامترهای fetchOwnership نیز صدق می کند.
    
    به طور مشابه ، برای سازگاری به عقب ، درخواستی برای insert ، update یا patch یک منبع asset می تواند شامل شیء metadataMine یا شیء metadata باشد. همین اصل در مورد تنظیم داده های مالکیت یک منبع asset یا خط مشی مطابقت اعمال می شود.

  • پارامترهای claims.list assetId q و videoId Method. برای جستجوی مطالبات با استفاده از هر یک از این معیارها ، از روش ContrySearch.List استفاده کنید ، که از تمام این پارامترها پشتیبانی می کند.

  • در یک منبع ownership ، مقادیر نسبت general[].ratio ، performance[].ratio double همگام integer synchronization[].ratio و mechanical[].ratio

  • تعریف قوانین منابع policy rules[].action در حال حاضر مقادیر معتبری را برای آن خاصیت ذکر کرده است: block ، monetize ، takedown و track . با این حال ، توجه داشته باشید که شما نمی توانید از API برای اعمال یک سیاست Takedown برای یک ادعا استفاده کنید.

  • در صورتی که مرجع با پیوند دارایی با یک ویدیوی موجود در یوتیوب موجود در یک کانال YouTube که به حساب CMS شما بارگذاری شده است claimId این منبع reference موجود است. در این حالت ، این زمینه حاوی شناسه ادعایی است که نشان دهنده ارتباط حاصل از دارایی و فیلم است.

  • ویژگی جدید حذف شده منبع reference excludedIntervals[] لیستی از فواصل زمانی را در طول مرجع مشخص می کند که YouTube هنگام تلاش برای مطابقت با مرجع باید از آن چشم پوشی کند. هر بازه زمان شروع و پایان را در ثانیه از شروع فیلم اندازه گیری می کند.

  • API دیگر نیازی به تنظیم وضعیت status در منبع reference ندارد که در بدنه references.update یا references.patch ارسال می شود.

  • این مستندات برای توصیف صحیح فرمت پاسخ API برای روش videoAdvertisingOptions.getEnabledAds اصلاح شده است. این پاسخ ، که یک منبع youtubePartner#videoAdvertisingOptionGetEnabledAds است ، حاوی اطلاعات زیر است:

    • id - شناسه ای که YouTube برای شناسایی منحصر به فرد ویدیوی ادعا شده مرتبط با تنظیمات از آن استفاده می کند.

    • adBreaks - لیستی از اشیاء که در آن هر شیء حاوی اطلاعاتی در مورد یک نکته قبل ، حین یا بعد از پخش ویدیو در هنگام اجرای تبلیغات است. هر شی همچنین ممکن است سایر ویژگی های شکست AD را مشخص کند ، مانند شکاف های AD که در طول استراحت و انواع تبلیغاتی که مجاز به اجرای آن در طول هر شکاف هستند ، مشخص شود.

    • 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 تجربی را مشخص نمی کند. در عوض ، ما اکنون لیستی از API های YouTube را ارائه می دهیم که مشمول سیاست استهلاک هستند .

8 آوریل 2013

این به روزرسانی شامل تغییرات زیر است:

• API به API محتوای YouTube تغییر نام داده است.

• چندین ویژگی در منبع 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	شناسه منحصر به فرد که YouTube برای شناسایی 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	منبع ادعا

• ویژگی policy موجود در منبع claims به روز شده است تا توجه داشته باشد که برای ادعای Audioswap نمی توان این مقدار را به روز کرد.

• دارایی timeProvidedMs منبع metadataHistory به زمان ارائه شده به Timevided تغییر یافته است.

• ownershipHistory timeProvidedMs Resource Resource به زمان ارائه شده است.

• تعریف روش ownershipHistory.list به روز شده است تا توجه داشته باشد که این روش فقط داده های جدید مالکیت را برای هر صاحب محتوا بازیابی می کند. اما اگر صاحب محتوا داده های مالکیت را از طریق چندین منبع داده (API ، فیدهای محتوا و غیره) ارسال کرده باشد ، این لیست شامل جدیدترین داده ها برای هر صاحب محتوا و منبع داده خواهد بود.

• چندین ویژگی در منبع policy تغییر کرده است:

  • دارایی rule به قوانین تغییر نام داده است.
  • rules[].subaction اکنون لیستی از رشته ها است نه یک رشته.
  • rules[].conditions.contentMatchType مقدار خاصیت اکنون لیستی از رشته ها است نه یک رشته.

• مستندات مربوط به policies.insert 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 به شما امکان می دهد جزئیات مربوط به انواع تبلیغاتی را که برای یک ویدیوی مشخص شده شریک یا کاربر بارگیری شده مجاز است ، بازیابی کنید.

• تعریف پارامتر ownershipRestriction assetSearch.list Method ، به روز شده است تا توجه داشته باشید که مقدار پارامتر پیش فرض mine است ، که نشان می دهد API فقط باید دارایی های متعلق به کاربر فعلی را بازیابی کند.

• مستندات روش assets.list تغییرات زیر را منعکس می کند:

  • پارامتر id اکنون مورد نیاز است.

  • پارامتر تازه پشتیبانی شده fetchMatchPolicy به شما امکان می دهد که آیا درخواست API نیز باید خط مشی مسابقه را که برای دارایی تعیین کرده اید ، بازیابی کنید.

  • پارامتر تازه پشتیبانی شده fetchOwnership به شما امکان می دهد که آیا درخواست API نیز باید داده های مالکیت را برای دارایی بازیابی کند یا خیر.

  • لیست دارایی هایی که API برمی گرداند دیگر حاوی داده های صفحه بندی نیست. در نتیجه ، ویژگی nextPageToken و شیء pageInfo هر دو از پاسخ API حذف شده اند. شیء pageInfo حاوی totalResults ، resultsPerPage و ویژگی های startIndex بود.

• مستندات منابع claims به روز شده است تا توجه داشته باشید که شما باید هنگام ایجاد یک ادعا ، یک خط مشی را مشخص کنید. (اگر یک ادعای درج شده خط مشی را مشخص نکند ، YouTube در حال حاضر خط مشی استفاده از پیش فرض شما را اعمال نمی کند ، اگرچه مستندات قبلاً نشان می داد که این اتفاق افتاده است.)

• املاک منتشر شده منابع policy hasUnpublishedDraft از بین رفته است.

• پارامتر id تازه پشتیبانی شده policies.list به شما امکان می دهد خط مشی های ذخیره شده را که درخواست API باید بازیابی کند ، شناسایی کنید. فقط خط مشی های متعلق به صاحب محتوای معتبر در حال حاضر قابل بازیابی است.

• تعریف پارامتر releaseClaims برای هر دو روش references.patch و references.update به روز شده است تا توجه داشته باشید که این پارامتر فقط زمانی کار می کند که وضعیت ادعا به صورت inactive به روز شود. در این حالت ، شما همچنین می توانید مقدار پارامتر releaseClaims را در true تنظیم کنید تا تمام ادعاهای مسابقه تولید شده توسط مرجع را منتشر کنید.

• روشهای references.patch و references.update هر دو به روز شده اند تا توجه داشته باشند که باید هنگام انجام هر یک از این عملیات وضعیت مرجع را مشخص کنید.

• چندین روش API از انواع خطای جدید پشتیبانی می کند. جدول زیر روش و خطاهای تازه پشتیبانی شده را مشخص می کند:

  روش	نوع خطا	جزئیات خطا	توضیحات
  guideCategories.list	notFound	Unavailable	دارایی که برای بازیابی خط مشی مسابقه برای آن پیدا نمی کنید.
  claims.get	notFound	Unavailable	این ادعا که شما در حال تلاش برای بازیابی هستید ، یافت نمی شود.
  ownership.patch	invalidValue	Unavailable	داده های مالکیت که ارائه کرده اید حاوی یک مقدار نامعتبر است.
  ownership.update	invalidValue	Unavailable	داده های مالکیت که ارائه کرده اید حاوی یک مقدار نامعتبر است.