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

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

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

10 نوامبر 2023

قسمت adFormats[] منبع videoAdvertisingOption به‌روزرسانی شده است به طوری که third_party_ads تنها مقدار معتبر برای آن فیلد باشد. قالب‌های تبلیغات زیر دیگر پشتیبانی نمی‌شوند: 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 یا contentOwnerAdvertisingOptions.update ، مقدار ویژگی contentOwnerAdvertisingOptions.patch 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 نمی‌توانید برچسب‌های دارایی را تنظیم کنید.

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

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

  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 حاوی یک مقدار Boolean است که نشان می‌دهد آیا این ادعا توسط مالک محتوایی غیر از مالک مرتبط با کاربری که جستجو را انجام می‌دهد مطرح شده است یا خیر.

  • اکنون روش 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 منبع policy زمان آخرین به روز رسانی خط مشی را مشخص می کند.

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

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

  • ویژگی autoGeneratedBreaks جدید منبع videoAdvertisingOption نشان می دهد که آیا ویدیو باید تبلیغات میان دوره ای و در جریان را در زمان های استراحت به طور خودکار توسط 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، شی matchPolicyEffective در هر منبع asset برگشتی حاوی خط مشی مطابقت مؤثر برای آن دارایی است.

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

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

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

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

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

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

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

  • روش assets.insert اکنون خطاهای ابرداده را به‌صورتی که در ویژگی‌های شی metadataMine رخ می‌دهد، شناسایی می‌کند تا در شی metadata ، که از به‌روزرسانی API در ۱۶ ژوئیه ۲۰۱۳ منسوخ شده بود.

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

16 جولای 2013

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

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

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

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

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

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

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

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

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

    فهرست زیر تغییرات متناظر در ساختار منبع asset و همچنین تأثیرات آن تغییرات بر روش‌های API را توضیح می‌دهد که منابع asset را get ، list ، insert ، update یا 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 قبل از به‌روزرسانی این ویژگی پشتیبانی نمی‌شد، بنابراین نیازی به بازگرداندن آبجکت metadata برای سازگاری با عقب نیست.) همین اصل برای پارامترهای fetchOwnership و fetchMatchPolicy نیز صدق می‌کند.
    
    به طور مشابه، برای سازگاری به عقب، درخواست برای insert ، update یا patch یک منبع asset می‌تواند شامل شی metadataMine یا شی فوق metadata باشد. همین اصل برای تنظیم داده های مالکیت منبع asset یا خط مشی مطابقت اعمال می شود.

  • پارامترهای assetId ، q ، و videoId روش claims.list منسوخ شده‌اند. برای جستجوی ادعاها با استفاده از هر یک از این معیارها، از روش pretendSearch.list استفاده کنید که از همه آن پارامترها پشتیبانی می کند.

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

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

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

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

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

  • اسناد برای توصیف مناسب قالب پاسخ API برای روش videoAdvertisingOptions.getEnabledAds تصحیح شده است. پاسخ، که یک منبع 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 آزمایشی را شناسایی نمی‌کند. در عوض، اکنون فهرستی از APIهای YouTube را ارائه می‌کنیم که مشمول خط‌مشی منسوخ شدن هستند .

8 آوریل 2013

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

• API به API Content ID YouTube تغییر نام داده است.

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

  • مقدار ویژگی kind از youtubePartner#policy به youtubePartner#assetMatchPolicy تغییر کرده است.
  • ویژگی new 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 به‌روزرسانی شده است تا توجه داشته باشید که مقدار را نمی‌توان برای ادعای تعویض صوتی به‌روزرسانی کرد.

• ویژگی timeProvidedMs منبع metadataHistory به timeProvided تغییر نام داده است.

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

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

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

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

  • پارامتر fetchMatchPolicy که به تازگی پشتیبانی می‌شود به شما امکان می‌دهد مشخص کنید که آیا درخواست API باید خط‌مشی مطابقتی را که برای دارایی تنظیم کرده‌اید بازیابی کند یا خیر.

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

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

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

• ویژگی hasUnpublishedDraft منبع policy منسوخ شده است.

• پارامتر 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	داده‌های مالکیتی که ارائه کرده‌اید حاوی یک مقدار نامعتبر است.