واجهة برمجة تطبيقات Content ID في YouTube - سجلّ النُسخ السابقة

ملاحظة: تم تصميم واجهة برمجة التطبيقات YouTube Content ID API لاستخدامها من قِبل شركاء المحتوى في YouTube، ولا يمكن لجميع المطوّرين أو جميع مستخدمي YouTube الوصول إليها. إذا لم تظهر لك واجهة برمجة التطبيقات YouTube Content ID API كإحدى الخدمات المدرَجة في وحدة تحكّم Google API، يمكنك الانتقال إلى مركز مساعدة YouTube للاطّلاع على مزيد من المعلومات حول "برنامج شركاء YouTube".

تعرض هذه الصفحة التغييرات التي تم إجراؤها على واجهة برمجة التطبيقات YouTube Content ID API والتعديلات التي تم إجراؤها على المستندات.

26 آذار (مارس) 2025

اعتبارًا من 31 آذار (مارس) 2025، ستغيّر منصة YouTube طريقة احتساب عدد مشاهدات فيديوهات Shorts. في السابق، كان يتم احتساب المشاهدة في فيديوهات Shorts بعد تشغيل فيديو Shorts لعدد معيّن من الثواني. وسنحتسب المشاهدات حسب عدد مرات بدء تشغيل فيديو Shorts أو إعادة تشغيله، بدون فرض حدّ أدنى لوقت المشاهدة. مزيد من المعلومات

بحلول 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 محدّدًا على أنّه true في فيديو تم تحديد adBreaks له، ستحدد أنظمتنا مواضع عرض الإعلانات بالإضافة إلى مواضع الخانات الإعلانية التي تم وضعها يدويًا. اطّلِع على مقالة الدعم للحصول على مزيد من التفاصيل.

‏10 تشرين الثاني (نوفمبر) 2023

تم تعديل الحقل adFormats[] في مورد videoAdvertisingOption ليصبح third_party هو القيمة الصالحة الوحيدة لهذا الحقل. لم تعُد أشكال الإعلانات التالية متاحة: instream_trueview وinstream_standard وdisplay وpreroll وpostroll. يُرجى الاطّلاع على مقالة الدعم لمعرفة المزيد من التفاصيل.

‫1 حزيران (يونيو) 2023

ملاحظة: هذا إشعار بإيقاف ميزة نهائيًا.

يتضمّن هذا التحديث التغييرات التالية:

20 كانون الأول (ديسمبر) 2022

تم تعديل تعريف مَعلمة طلب البحث ownershipRestriction لطريقة assetSearch.list لتوضيح أنّه إذا كانت قيمة هذه المَعلمة هي none، يجب أن تستخدم قيمة المَعلمة metadataSearchFields أيضًا فلترًا واحدًا على الأقل للأرقام التعريفية. لا يشير هذا التغيير في المستندات إلى تغيير في سلوك واجهة برمجة التطبيقات.

9 تشرين الثاني (نوفمبر) 2022

تم تعديل مستندات الطريقتَين asset.get و asset.list لتوضيح كيفية السماح بقيم متعدّدة لكلّ من:

28 أيلول (سبتمبر) 2022

تمت إضافة معلومات حول إمكانية الترخيص إلى asset resource.

‫18 يوليو 2022

تم تعديل مستندات claimSearch.list inactiveReasons لعرض تحسينات تتوافق مع "استوديو YouTube":

  • سبق أن أزلنا من "استوديو YouTube" إمكانية استخدام Audio Swap وSong Erase. تم تجاهل قيم واجهة برمجة التطبيقات المقابلة، 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 لأنّ المواقع الجديدة تقدّم data أكثر دقة. في حين أنّ السمات الجديدة قد تُدرِج صفيفًا من القيم النصية، تحدِّد كل من السمتَين 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 معرّفات فيديو كحدّ أقصى مفصولة بفواصل. ستُظهر واجهة برمجة التطبيقات خطأ badRequest، وهو رمز استجابة HTTP‏ 400، إذا كانت القيمة تحتوي على أكثر من 10 أرقام تعريف فيديو.

6 كانون الأول (ديسمبر) 2018

ملاحظة: هذا إشعار بإيقاف ميزة نهائيًا.

تم تعديل مستندات واجهة برمجة التطبيقات لإزالة الإشارات إلى مورد contentOwnerAdvertisingOptions وطُرقه. لم يتم استخدام هذه الطرق إلا بشكل بسيط، وتم التواصل مع مستخدمي واجهة برمجة التطبيقات الذين استخدموها بشكل منفصل قبل هذا الإعلان.

21 آذار (مارس) 2018

يتضمّن هذا التحديث التغييرات التالية:

  • يجب الآن ضبط السمة metadataMine.artist في أي وقت عند إدراج مادة عرض فيديو موسيقي أو تسجيل صوتي أو تعديلها أو تصحيحها. تعرض واجهة برمجة التطبيقات الآن خطأ إذا لم يتم ضبط السمة لأنواع الموارد هذه. بالإضافة إلى ذلك، لا يمكن استخدام السمة metadataMine.artist إلا لصنّاع الفيديوهات الموسيقية والتسجيلات الصوتية.

24 تموز (يوليو) 2017

يتضمّن هذا التحديث التغييرات التالية:

  • يمثّل مورد package الجديد مجموعة من الملفات التي يتم تسليمها عبر الويب أو بروتوكول النقل الآمن للملفات (SFTP) أو آلية تسليم أخرى. تتيح واجهة برمجة التطبيقات طريقتَين لهذا المورد:

    • تُجري طريقة 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 تنفيذ أيٍّ ممّا يلي:

    • قدِّم معرّف عرض المقطوعة الموسيقية واسترِد حصة المقطوعة الموسيقية المقابلة التي يملكها الشريك الذي يفوّض الطلب، في حال توفّر هذه الحصة.
    • أدخِل معرّف حصة مقطوعة موسيقية يملكها شريك المحتوى واسترِد قائمة بكل مشاهدات المقطوعة الموسيقية المرتبطة بهذه الحصة.

  • يوضّح دليل إدارة مواد عرض المقطوعات الموسيقية الجديد كيفية معالجة طرق واجهة برمجة التطبيقات المختلفة للطلبات استنادًا إلى ما إذا كانت معرّفات مواد العرض التي تم إرسالها إلى هذه الطرق تحدّد مشاهدات المقطوعات الموسيقية أو حصصها.

  • تشير السمة claimedVideoOptions.autoGeneratedBreaks الجديدة لمصدر contentOwnerAdvertisingOptions إلى ما إذا كان على YouTube إنشاء فواصل إعلانية تلقائيًا في الفيديوهات التي تمّت المطالبة بملكيتها والتي تزيد مدّتها عن 10 دقائق. على الرغم من أنّ السمة تؤثر في كل فيديوهات مالك المحتوى التي تزيد مدتها عن 10 دقائق، إذا تم تقديم مطالبات متعدّدة بملكية فيديو، يحدّد الشريك الأول الذي يطالب بملكية الفيديو السلوك التلقائي لهذه السمة في ما يتعلّق بهذا الفيديو.

11 آب (أغسطس) 2016

يتضمّن هذا التحديث التغييرات التالية:

  • إنّ بنود الخدمة المنشورة حديثًا لخدمة YouTube API ("البنود المعدّلة") والتي تمت مناقشتها بالتفصيل في مدوّنة فريق YouTube الهندسي والمطوّرين، تتضمّن مجموعة كبيرة من التعديلات على بنود الخدمة الحالية. بالإضافة إلى الأحكام المعدَّلة التي ستصبح سارية المفعول اعتبارًا من 10 شباط (فبراير) 2017، يتضمّن هذا التعديل العديد من المستندات الداعمة للمساعدة في شرح السياسات التي يجب أن يتّبعها المطوّرون.

    يمكنك الاطّلاع على المجموعة الكاملة من المستندات الجديدة في سجلّ النُسخ السابقة للبنود المعدَّلة. بالإضافة إلى ذلك، سيتم أيضًا توضيح التغييرات المستقبلية على "البنود المعدّلة" أو على هذه المستندات الداعمة في سجلّ المراجعات هذا. يمكنك الاشتراك في خلاصة RSS تعرض التغييرات في سجلّ النُسخ السابقة من رابط في هذا المستند.

31 أيار (مايو) 2016

يتضمّن هذا التحديث التغييرات التالية:

  • مراجع وطُرق جديدة

    • تتيح لك الطريقة الجديدة validator.validate تحديد ما إذا كان ملف البيانات الوصفية يتضمّن أخطاء تحقّق تمنع YouTube من معالجته بنجاح. إذا كان الملف يحتوي على أخطاء، تحتوي السمة errors في استجابة واجهة برمجة التطبيقات على قائمة بأخطاء التحقّق التي تحدّد شدة كل خطأ وسببه وموقعه.

  • الأخطاء الجديدة والمحدّثة

    • تتيح الطريقتان assets.patch وassets.update الآن الخطأ التالي. تذكير: يمكن أن تتضمّن الطريقة أخطاء متعددة من النوع نفسه. يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على قائمة كاملة بالأخطاء المحتمَلة.

      الأخطاء
      invalidValue (400) parameters.assetId
      تعذّرت تلبية الطلب لأنّه تم دمج مادة العرض التي يتم تعديلها مع مادة عرض أخرى. أعِد إرسال الطلب باستخدام معرّف مادة العرض هذا، والذي يظهر في رسالة الخطأ، كقيمة للمَعلمة assetId.

28 آذار (مارس) 2016

يتضمّن هذا التحديث التغييرات التالية:

  • تعديلات على المراجع والأساليب الحالية

    • تحتوي السمة matchInfo.matchSegments[] الجديدة لمصدر claim على قائمة يصف كل عنصر فيها جزءًا من الفيديو الذي تمّت المطالبة بملكيته ويتطابق مع جزء من الفيديو المرجعي. يمكن أن تتضمّن المطالبة عدة مقاطع مطابقة. على سبيل المثال، إذا كان محتوى الصوت والفيديو في الفيديو المحمَّل يتطابق مع محتوى الفيديو المرجعي، سيكون هناك مقطعان متطابقان. سيصف أحد المقاطع تطابق الصوت والآخر تطابق الفيديو.

      لكلّ جزء مطابق، تعرض واجهة برمجة التطبيقات مدة المحتوى المطابق ونوعه (صوت أو فيديو). وتحدِّد واجهة برمجة التطبيقات أيضًا الفواصل الزمنية التي يبدأ وينتهي عندها كل مقطع مطابق في كلّ من الفيديو الذي تمّت المطالبة بملكيته والفيديو المرجعي.

    • يمكن الآن تعديل قيمة السمة claimedVideoOptions.newVideoDefaults[] لمورد contentOwnerAdvertisingOptions عند استدعاء الطريقتَين contentOwnerAdvertisingOptions.patch أو contentOwnerAdvertisingOptions.update.

    • تم إيقاف سمة allowedOptions.autoGeneratedBreaks للقراءة فقط في المرجع contentOwnerAdvertisingOptions نهائيًا.

  • الأخطاء الجديدة والمحدّثة

    • تتيح الآن طريقة claims.update في واجهة برمجة التطبيقات الخطأ التالي. تذكير: يمكن أن تتضمّن الطريقة أخطاء متعددة من النوع نفسه. يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على قائمة كاملة بالأخطاء المحتمَلة.

      الأخطاء
      badRequest (400) alreadyClaimed
      المطالبة هي نسخة مكرّرة من مطالبة حالية أخرى ولا يمكن تعديلها.

    • في بعض الأحيان، تنتهي مهلة الطريقة assets.list وتُعرِض رمز استجابة HTTP‏ 500 (Internal Server Error)، لا سيما عندما يسترجع الطلب بيانات عن العديد من مواد العرض وتكون قيمة المَعلمة fetchMatchPolicy هي effective. إذا كان طلب assets.list يحدّد أرقام تعريف مواد عرض متعددة ويعرض خطأ 500، حاوِل إعادة إرسال طلب مادة عرض واحدة أو عدد أقل من مواد العرض.

    • تم تعديل مستندات الخطأ references.insert للإشارة إلى أنّه إذا حمّل الطلب ملفًا مرجعيًا تالفًا، لن يتم رصد هذه المشكلة إلى أن تتم معالجة المرجع نفسه. وبالتالي، حتى إذا كان طلب references.insert يعرض استجابة ناجحة، قد لا تتم معالجة المرجع بنجاح. بعد إدراج مرجع، ننصحك بإجراء استطلاع باستخدام طريقة references.list لتأكيد تفعيل المرجع على النحو المتوقّع.

3 شباط (فبراير) 2016

يتضمّن هذا التحديث التغييرات التالية:

  • تعديلات على المراجع والأساليب الحالية

    • تتيح واجهة برمجة التطبيقات الآن إعلانات قائمة المنتجات. تسلّط إعلانات بيانات المنتجات الضوء على المنتجات ذات الصلة بمحتوى الفيديو أو المعروضة فيه. وهذه الإعلانات هي بطاقات دعائية يتم عرضها أثناء الفيديو. وتتم إضافة هذه البطاقات تلقائيًا بواسطة نظام الإعلانات. يشاهد المستخدمون جملة محفّزة للبطاقة لبضع ثوانٍ ويمكنهم أيضًا النقر على الرمز في الجزء العلوي الأيسر من الفيديو لتصفّح بطاقات الفيديو.

      نتيجةً لهذا التغيير، يمكن الآن تضمين product_listing في قيم السمات التالية:

      طريقة Resource/API الموقع
      contentOwnerAdvertisingOptions allowedOptions.licAdFormats[]
      contentOwnerAdvertisingOptions allowedOptions.ugcAdFormats[]
      contentOwnerAdvertisingOptions claimedVideoOptions.newVideoDefaults[]
      videoAdvertisingOptions adFormats[]
      videoAdvertisingOptions.getEnabledAds countriesRestriction[].adFormats[]

    • تطلب المَعلمتان createdBefore وcreatedAfter الجديدتان في طريقة assetSearch.list من واجهة برمجة التطبيقات عرض مواد العرض التي تم إنشاؤها قبل و/أو بعد تاريخ معيّن فقط.

    • في استجابة واجهة برمجة التطبيقات لطلب assetSearch.list، تتيح الآن السمة type القيمة art_track_video. يمكنك الانتقال إلى مركز مساعدة YouTube للاطّلاع على مزيد من المعلومات حول فيديوهات المقاطع الصوتية الفنية.

    • تتيح الطريقة claimSearch.list المَعلمات الجديدة التالية:

      المعلمات
      referenceId تحدّد مَعلمة الفلتر هذه معرّف المرجع في YouTube للمرجع الذي يتم استرداد المطالبات المرتبطة به.
      inactiveReasons تتيح لك هذه المَعلمة الاختيارية حصر استجابة واجهة برمجة التطبيقات على تضمين المطالبات غير النشطة فقط استنادًا إلى أسباب محدّدة ليصبح هذان النوعان من المطالبات غير نشطَين. يسرد تعريف المَعلمة أنواع المطالبات غير النشطة التي يمكنك البحث عنها.
      partnerUploaded تتيح لك هذه المَعلمة المنطقية الاختيارية تحديد أنّه يجب أن يتضمّن ردّ واجهة برمجة التطبيقات فقط المطالبات التي حمّلها الشريك أو التي لم يحمّلها الشريك.

    • يحتوي عنصر references#origination الجديد لمورد reference على معلومات تصف مصدر المرجع.

    • تتيح الآن طريقة references.insert إمكانية تحميل المراجع التي تم إنشاؤها باستخدام برنامج gfp_gen من YouTube. إذا قدّمت بصمة تم إنشاؤها مسبقًا، اضبط قيمة السمة fpDirect على true في مورد reference الذي تم تحميله.

      يُرجى العلم أنّه بعد إجراء هذا التغيير، لم تعُد واجهة برمجة التطبيقات تعرِض خطأً في حال محاولة ضبط السمة fpDirect عند تحميل مرجع.

  • الأخطاء الجديدة والمحدّثة

    تسرد المستندات الآن الأخطاء التي تعرضها طرق مورد whitelist.

    بالإضافة إلى ذلك، يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كل خطأ. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه. يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    الأخطاء
    badRequest (400) inappropriateCampaignTarget
    تُعرِض الطريقتان campaigns.insert وcampaigns.update هذا الخطأ إذا حاولت إحدى الحملات عرض فيديو قد يكون غير ملائم لبعض المستخدِمين. لحلّ هذا الخطأ، يُرجى اختيار محتوى مختلف لعرضه.
    badRequest (400) canNotCreatePartnerUploadedClaimOnCompositionOrSoundRecordingAssets
    تعرض الطريقة claims.insert هذا الخطأ إذا حاولت إنشاء مطالبة حمّلها الشريك باستخدام مادة عرض مقطوعة موسيقية أو تسجيل صوتي.
    badRequest (400) existingSoundRecordingOrMusicVideoClaim
    تعرض الطريقة claims.insert هذا الخطأ إذا كانت هناك مطالبة سبق أن تم تقديمها بشأن محتوى موسيقي مسجّل في الفيديو المحدّد. لا يمكن إضافة مطالبات مباشرة بالملكية للمقطوعات الموسيقية من خلال واجهة برمجة التطبيقات.
    badRequest (400) asset_id
    تعرض طريقة references.insert هذا الخطأ إذا حاول الطلب إنشاء مرجع من خلال ملف ولكنّه لم يحدّد معرّف مادة العرض.
    badRequest (400) canNotBeActivated
    تعرض الطريقة references.update هذا الخطأ إذا تعذّر تفعيل المرجع، ربما بسبب حالة المرجع أو شروط الملكية.
    badRequest (400) videoNotClaimed
    تُعرِض الطريقة videoAdvertisingOptions.get هذا الخطأ إذا لم تكن قد طالبت بملكية الفيديو الذي تحاول استرداد خيارات الإعلانات له، ما يجعل المعلومات المطلوبة غير متاحة لك.

18 كانون الأول (ديسمبر) 2015

تشترط قوانين الاتحاد الأوروبي تقديم بيانات إفصاح معيّنة للمستخدمين النهائيين في الاتحاد الأوروبي والحصول على موافقاتهم. لذلك، عليك الالتزام بسياسة موافقة المستخدم في الاتحاد الأوروبي للمستخدمين النهائيين في بلدان الاتحاد الأوروبي. أضفنا إشعارًا بهذا الشرط في بنود خدمة YouTube API.

21 نيسان (أبريل) 2015

يتضمّن هذا التحديث التغييرات التالية:

  • يمثّل المرجع الجديد campaign حملة خاصة بمالك المحتوى، ما يسمح لمالك المحتوى باستخدام التعليقات التوضيحية للترويج للمحتوى في الفيديوهات التي حمّلها المستخدمون والتي تمّت المطالبة بملكيتها. على سبيل المثال، يمكن لمالك محتوى إنشاء حملة تضيف روابط إلى صفحة مشاهدة فيلم معيّن لأي فيديوهات حمّلها مستخدمون وتضمّن مشاهد من هذا الفيلم وطالب نظام Content ID بملكيتها.

    تتيح واجهة برمجة التطبيقات طرقًا للوصول إلى موارد get وlist وinsert وupdate وpatch وdelete campaign.

  • تتيح واجهة برمجة التطبيقات العديد من الأخطاء الجديدة لطرق campaigns.get وcampaigns.insert وcampaigns.update وcampaigns.delete الجديدة.

30 آذار (مارس) 2015

يتضمّن هذا التحديث التغييرات التالية:

  • تعديلات على المراجع والأساليب الحالية

    • تتيح لك المَعلمة isrcs الجديدة في الطريقة assetSearch.list تحديد قائمة تضم ما يصل إلى 50 رقم ISRC. وسيتضمّن ردّ واجهة برمجة التطبيقات مواد العرض المرتبطة برموز ISRC هذه.

    • تتيح سمة event[].reason لمورد claimHistory القيم الجديدة التالية. يوضّح كل سبب سبب حدوث حدث معيّن مرتبط بالتقديم:

      • closed_audio_claim_on_visual_reference
      • closed_partner_exclusion
      • closed_reference_conflict

    • تحدِّد المَعلمة sort الجديدة لطريقة claimSearch.list الطريقة التي سيتم استخدامها لترتيب الموارد في استجابة واجهة برمجة التطبيقات. يتم ترتيب الموارد تلقائيًا بترتيب زمني عكسي (من الأحدث إلى الأقدم) استنادًا إلى تواريخ إنشائها. يمكنك أيضًا ترتيب المراجعات من الأعلى إلى الأقل عددًا من مرات مشاهدة المحتوى الذي تمّت المطالبة بملكيته.

      يُرجى العِلم أنّه إذا ضبط طلب claimSearch.list أيضًا قيمة المَعلمة status على appealed أو disputed أو pending أو potential أو routedForReview، سيتم ترتيب النتائج حسب وقت انتهاء صلاحية فترة مراجعة المطالبة.

    • تُدرِج الطريقتان ownership.update وownership.patch الآن بشكل صحيح جميع السمات التي يمكن تعديلها عند استدعاء هاتين الطريقتَين. يمثّل هذا التغيير تصحيحًا لمستندات واجهة برمجة التطبيقات ولا يحدّد تغييرًا في وظيفة واجهة برمجة التطبيقات.

    • تُدرِج مَعلمات fetchMatchPolicy لطُرق assets.get وassets.list الآن effective كقيمة متوافقة. تُوجّه القيمة خادم واجهة برمجة التطبيقات لاسترداد سياسة المطابقة التي تطبّقها YouTube على مادة العرض.

    • تشير الآن مَعلمات id لطرق assets.list وclaims.list وcontentOwners.list وpolicies.list وpublishers.list وreferences.list إلى أنّه يمكن أن تحتوي قيم مَعلماتها على 50 معرّفًا بحد أقصى مفصولة بفواصل.

  • الأخطاء الجديدة والمحدّثة

    يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كلّ خطأ. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه.

    يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    نوع الخطأ تفاصيل الخطأ الوصف
    badRequest (400) tooManyIsrcs تعرض طريقة assetSearch.list هذا الخطأ إذا كانت المَعلمة isrcs تحدّد أكثر من 50 رقم تعريف ISRC.
    badRequest (400) videoIsPrivate تعرِض الطريقة claims.insert هذا الخطأ إذا حاولت المطالبة بملكية فيديو خاص. لا يمكنك المطالبة بملكية فيديو إلا إذا كانت حالة خصوصيته public أو unlisted.
    notModified (304) blockOutsideOwnershipUnchanged تُرجع طريقة claims.update هذا الخطأ في حال عدم تعديل علامة blockOutsideOwnership في المطالبة بنجاح. هناك عدة أسباب لحدوث هذا الخطأ. ومن الأمثلة الشائعة على ذلك أنّ التعديل المحدّد ليس له أي تأثير في الفيديو الذي تمّت المطالبة بملكيته.

7 تشرين الثاني (نوفمبر) 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تعديلات على المراجع والأساليب الحالية

    • تتيح الآن المَعلمة status في الطريقة claimSearch.list استخدام القيمة routedForReview. تحدّ هذه القيمة النتائج على المطالبات التي تتطلّب مراجعة يدوية استنادًا إلى قاعدة في سياسة المطابقة الخاصة بأحد مواد العرض.

    • تتيح سمة event[].reason لمورد claimHistory القيم الجديدة التالية. يوضّح كل سبب سبب حدوث حدث معيّن مرتبط بالتقديم:

      • closed_invalid_reference_segment
      • closed_noadsense
      • suspended_monetization_on_channel
      • video_content_modified

    • إنّ سمة origin.source لمورد claim، التي تحدّد مصدر المطالبة، تتيح الآن استخدام القيمة melodyMatch. تشير المطالبة بمطابقة اللحن إلى أنّ الفيديو الذي تمّت المطالبة بملكيته يتضمّن مقطوعة موسيقية مطابقة لمرجع.

    • تم تعديل مستندات طريقة references.insert لتوضيح أنّ واجهة برمجة التطبيقات تستخدِم نقطتَي نهاية مختلفتَين لهذه الطريقة. لا يمثّل ذلك تغييرًا في وظيفة واجهة برمجة التطبيقات، بل هو تصحيح للمستندات الحالية.

      • إذا كان الطلب يتضمن تحميل ملف مرجعي جديد، تكون نقطة النهاية الصحيحة هي:

        POST https://www.googleapis.com/upload/youtube/partner/v1/references

      • إذا كان الطلب ينشئ مرجعًا باستخدام فيديو تمّت المطالبة بملكيته كمحتوى مرجعي، تكون نقطة النهاية الصحيحة هي:

        POST https://www.googleapis.com/youtube/partner/v1/references

  • الأخطاء الجديدة والمحدّثة

    يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كلّ خطأ. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه.

    يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    نوع الخطأ تفاصيل الخطأ الوصف
    badRequest (400) invalidLabelName تعرِض طُرق assets.insert وassets.update وassetLabels.insert هذا الخطأ إذا كان اسم تصنيف مادة العرض غير صالح. يجب أن يتراوح عدد أحرف أسماء التصنيفات بين حرفَين و30 حرفًا. ولا يجوز أن تحتوي على أقواس معقوفة أو فواصل أو نقطتَين أو علامة العطف أو الشرطة الرأسية (|).
    badRequest (400) ownerHaveMaximumNumberOfLabels تُعرِض الطرق assets.insert وassets.update وassetLabels.insert هذا الخطأ إذا سبق لمالك المحتوى تحديد 2,500 تصنيف فريد لمواد العرض، وهو الحد الأقصى المسموح به حاليًا.
    badRequest (400) tooManyLabelsOnOneAsset تُعرِض الطريقتان assets.insert وassets.update هذا الخطأ إذا كانت مادة العرض مرتبطة حاليًا بـ 30 تصنيفًا لمادة العرض، وهو الحد الأقصى المسموح به حاليًا.
    badRequest (400) channelMonetizationSuspended تؤدي الطريقتان claims.insert وclaims.update إلى ظهور هذا الخطأ إذا تم تعليق قناة الفيديو بسبب مطالبات الشركاء.
    badRequest (400) channelNotActive تعرض الطريقة claims.update هذا الخطأ إذا لم تكن قناة الفيديو نشطة.

  • لم تعُد الطريقتان assets.insert وassets.update تعرِضان خطأ badRequest لبعض مواد العرض إذا لم يتضمّن المورد في محتوى الطلب السمة metadataMine.contentType.

23 أيلول (سبتمبر) 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تغيير رقم تعريف مالك المحتوى

    بدأنا بتطبيق التغييرات التي أعلنّا عنها في سجلّ المراجعات بتاريخ 9 تموز (يوليو) 2014 على أرقام تعريف مالكي المحتوى. نتيجةً لهذا التغيير، تعرض واجهة برمجة التطبيقات الآن معرّفًا فريدًا تم إنشاؤه لتحديد مالك المحتوى المرتبط إما بالمستخدم الذي تمّت مصادقة هويته أو بمورد تتم إدارته من خلال واجهة برمجة التطبيقات. في السابق، كانت واجهة برمجة التطبيقات تعرض اسمًا سهل القراءة للمستخدمين كرقم تعريف، مثل "qrs_network".

    يؤثر هذا التغيير في وظيفة واجهة برمجة التطبيقات التالية، ومن المرجّح أن يؤثر في الشركاء الذين لديهم رموز شركاء مضمّنة في تطبيقاتهم.

    • تعرض واجهة برمجة التطبيقات الآن المعرّف الجديد كقيمة لسمات الموارد التي كانت تعرض سابقًا رمز الشريك، مثل سمة id لمورد contentOwner.
    • تتوافق جميع طُرق واجهة برمجة التطبيقات مع المَعلمة onBehalfOfContentOwner التي تحدِّد مالك المحتوى الذي يتم تقديم طلب واجهة برمجة التطبيقات نيابةً عنه. بعد إجراء التغيير، يجب ضبط المَعلمة على المعرّف الجديد بدلاً من "رمز الشريك". لمنع حدوث أخطاء في الرموز البرمجية، ستقبل المَعلمة أيّ قيمة خلال فترة انتقالية.
    • بعد إجراء التغيير، من المفترض أن تحدّد المَعلمة contentOwnerId في الطريقة contentOwners.list المعرّف الجديد بدلاً من رمز الشريك.

  • تعديلات على المراجع والأساليب الحالية

    • تتيح لك المَعلمة metadataSearchFields الجديدة لطريقة assetSearch.list تحديد حقول البيانات الوصفية للمادة التي تريد البحث فيها، بالإضافة إلى القيم التي تريد البحث عنها في هذه الحقول. قيمة المَعلمة هي قائمة مفصولة بفواصل من أزواج الحقول والقيم، ويتم فصل الحقل عن القيمة بنقطتَين في كل زوج.

    • يحدّد عنصر appliedPolicy الجديد لمورد claim السياسة التي تطبّقها YouTube فعليًا على المطالبة. قيمة العنصر هي مورد policy. يحتوي هذا المرجع على معلومات حول السياسات في البلدان التي يملك فيها مالك المحتوى الذي أرسل الطلب مادة العرض التي تمّت المطالبة بملكيتها.

      يمكن أن تختلف السياسة المطبّقة عن السياسة التي حدّدها مالك المحتوى بطريقتَين:

      1. ويراعي هذا الإجراء السياسات التي وضعها مالكو آخرون يملكون ملكية جزئية لمادة العرض التي تمّت المطالبة بملكيتها في بعض المناطق نفسها التي يملك فيها مالك المحتوى الذي أرسل طلب واجهة برمجة التطبيقات ملكية المحتوى.

      2. ويراعي هذا الإجراء السياسات الإدارية في YouTube التي تسري في المناطق التي يملك فيها مالك المحتوى مادة العرض التي تمّت المطالبة بملكيتها.

    • تحدّد السمة uploaderChannelId الجديدة لمصدر claimHistory معرّف القناة التي تم تحميل الفيديو الذي تمّت المطالبة بملكيته إليها.

8 أيلول (سبتمبر) 2014

يتضمّن هذا التحديث التغييرات التالية:

  • مراجع وطُرق جديدة

    • يحدِّد المورد الجديد assetLabel تصنيفًا نصيًا يمكن تعيينه إلى مادة عرض. تتيح لك تصنيفات مواد العرض وضع مواد العرض في فئات مخصّصة، ما يسهّل تنظيم مكتبة مواد العرض. ويمكنك البحث عن مواد العرض بحسب تصنيفاتها، مما يساعد أيضًا في تبسيط حالات الاستخدام التي تتطلب منك تحديث مجموعات معينة من مواد العرض.

      • تتيح لك طريقة assetLabels.list استرداد قائمة بتصنيفات مالك المحتوى.
      • تتيح لك الطريقة assetLabels.insert إنشاء تصنيف مادة عرض جديد. يمكنك أيضًا إنشاء تصنيفات جديدة من خلال استدعاء الطريقة assets.update وتعديل تصنيفات مادة عرض. سينشئ خادم واجهة برمجة التطبيقات تلقائيًا موردًا جديدًا من النوع assetLabel لأي تصنيف لم يتم تحديده سابقًا.

  • تعديلات على المراجع والأساليب الحالية

    • تم تعديل السمة label[] لمورد asset للإشارة إلى أنّه يمكنك استدعاء الطريقة assets.update لتعديل تصنيفات مادة العرض. ومع ذلك، لا يمكنك ضبط تصنيفات مادة العرض عند استدعاء الطريقة assets.insert.

      يشرح دليل استخدام تصنيفات مواد العرض الجديد كيفية إنشاء تصنيفات مواد العرض واستردادها، بالإضافة إلى كيفية تعديل تصنيفات مادة عرض أو البحث عن مواد عرض مرتبطة بتصنيفات معيّنة.

  • الأخطاء الجديدة والمحدّثة

    تتيح واجهة برمجة التطبيقات العديد من الأخطاء الجديدة لطريقتَي assetLabels.list وassetLabels.insert الجديدة.

9 تموز (يوليو) 2014

يتضمّن هذا التحديث التغييرات التالية:

  • تغيير رقم تعريف مالك المحتوى

    في السابق، كانت واجهة برمجة التطبيقات تستخدِم رمز شريك يمكن لشخص عادي قراءته، مثل "qrs_network"، لتحديد مالك المحتوى بشكل فريد والمرتبط إما بالمستخدم الذي تم إثبات هويته أو بمورد مُدار من خلال واجهة برمجة التطبيقات. في الربع الثالث من عام 2014، ستستخدِم واجهة برمجة التطبيقات معرّفًا فريدًا مكوّنًا من 22 حرفًا لتحديد مالكي المحتوى. يؤثر هذا التغيير في وظيفة واجهة برمجة التطبيقات التالية، ومن المرجّح أن يؤثر في الشركاء الذين لديهم رموز شركاء مضمّنة في تطبيقاتهم.

    • ستُرجع واجهة برمجة التطبيقات المعرّف المكوّن من 22 حرفًا كقيمة لسمات الموارد التي كانت تعرض سابقًا رمز الشريك، مثل سمة id لمورد contentOwner.
    • تتوافق جميع طُرق واجهة برمجة التطبيقات مع المَعلمة onBehalfOfContentOwner التي تحدِّد مالك المحتوى الذي يتم تقديم طلب واجهة برمجة التطبيقات نيابةً عنه. بعد إجراء التغيير، يجب ضبط المَعلمة على المعرّف المكوّن من 22 حرفًا بدلاً من "رمز الشريك". لمنع حدوث أخطاء في الرموز البرمجية، ستقبل المَعلمة أيّ قيمة خلال فترة انتقالية.
    • بعد إجراء التغيير، يجب أن تحدّد المَعلمة contentOwnerId في الطريقة contentOwners.list المعرّف المكوّن من 22 حرفًا بدلاً من رمز الشريك.

  • تعديلات على المراجع والأساليب الحالية

    • يتيح مورد asset الآن استخدام السمة label التي تحدّد قائمة بتصنيفات مواد العرض المرتبطة بمادة العرض. ويمكنك تطبيق التصنيف نفسه على مواد عرض متعددة لجمعها معًا. ويمكنك استخدام التصنيفات كفلاتر بحث لإجراء تعديلات مجمّعة أو تنزيل تقارير أو لتصفية "إحصاءات YouTube".

    • تتيح طريقة assetSearch.list الآن استخدام المَعلمات الاختيارية التالية:

      • ‫labels: حصر النتائج على تضمين مواد العرض المرتبطة فقط بالتصنيفات المحدّدة تعرض واجهة برمجة التطبيقات تلقائيًا مواد العرض التي تتطابق مع جميع التصنيفات المحدّدة. ومع ذلك، يمكنك استخدام المَعلمة includeAnyProvidedLabel لتوجيه واجهة برمجة التطبيقات إلى عرض مواد العرض التي تتطابق مع أيّ من التصنيفات المحدّدة.
      • ‫includeAnyProvidedLabel: تُستخدَم هذه المَعلمة مع المَعلمة labels لتوجيه واجهة برمجة التطبيقات لعرض مواد العرض المرتبطة بأيّ من التصنيفات المحدّدة في قيمة المَعلمة labels.

    • يتضمّن مورد claimHistory الآن السمات الجديدة التالية:

      • تقدّم السمة event[].source.userEmail عنوان البريد الإلكتروني للمستخدم الذي بدأ الحدث.
      • يحتوي الموقع الإلكتروني event[].typeDetails.disputeNotes على ملاحظات بشأن النزاع في حدث dispute_create.

    • تتيح طريقة claimSearch.list الآن استخدام المَعلمات الاختيارية التالية:

      • ‫createdAfter: حصر النتائج على المطالبات التي تم إنشاؤها بعد التاريخ المحدّد
      • ‫createdBefore: حصر النتائج على تضمين المطالبات التي تم إنشاؤها قبل التاريخ المحدّد فقط
      • ‫includeThirdPartyClaims: تُستخدَم هذه المَعلمة مع المَعلمة videoId، وتشير إلى ما إذا كان سيتم تضمين المطالبات التابعة لجهات خارجية في نتائج واجهة برمجة التطبيقات.

  • معلومات أكثر تفصيلاً عن الخطأ

    تحدّد مستندات الأخطاء الآن رمز استجابة HTTP لكل نوع من أنواع الأخطاء.

  • الأخطاء الجديدة والمحدّثة

    يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كلّ خطأ. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه. على سبيل المثال، يتم عرض خطأ required إذا حاولت إدراج مورد asset لا يتضمّن حقل بيانات وصفية مطلوبًا. في الواقع، قد يكون هناك أكثر من حقل بيانات وصفية مطلوب، وسيعرض كل حقل خطأً برسالة مختلفة قليلاً.

    يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    الطريقة الأخطاء
    assetSearch.list
    • invalidValue – لا تتيح واجهة برمجة التطبيقات إمكانية البحث عن مواد عرض المسلسلات أو المواسم. غيِّر قيمة المَعلمة type إلى قيمة متوافقة.
    assets.insert
    • conflict – هناك عدد كبير جدًا من مواد العرض التي تحمل المعرّف نفسه (مثل المعرّف المخصّص أو رمز ISRC أو غير ذلك).
    • conflict: هناك عدد كبير جدًا من نُسخ مادة العرض المحدّدة.
    • invalidValue – لا يملك المستخدم الذي يستدعي واجهة برمجة التطبيقات الإذن بإنشاء مواد عرض من النوع المحدّد.
    assets.patch
    assets.update
    • badRequest – لا تتيح واجهة برمجة التطبيقات تحويل نوع مادة العرض الذي حاولت تنفيذه.
    claimSearch.list
    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 الجديد لمورد policy الوقت الذي تم فيه تعديل السياسة آخر مرة.

    • تتيح طريقة policies.list الآن استخدام مَعلمة sort اختيارية، والتي يمكن استخدامها لتحديد ترتيب النتائج تصاعديًا أو تنازليًا حسب وقت آخر تعديل لها.

    • تحدّد السمة expiryTime الجديدة لمورد referenceConflict الوقت الذي ستنتهي فيه فترة مراجعة تعارض المرجع، ما يؤدي إلى انتهاء صلاحية التعارض.

    • تشير السمة autoGeneratedBreaks الجديدة لمورد videoAdvertisingOption إلى ما إذا كان يجب عرض إعلانات أثناء التشغيل في الفواصل التي تحدّدها YouTube تلقائيًا.

  • الأخطاء الجديدة والمحدّثة

    يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كلّ خطأ. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه. على سبيل المثال، يتم عرض خطأ required إذا حاولت إدراج مورد asset لا يتضمّن حقل بيانات وصفية مطلوبًا. في الواقع، قد يكون هناك أكثر من حقل بيانات وصفية مطلوب، وسيعرض كل حقل خطأً برسالة مختلفة قليلاً.

    يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    الطريقة الأخطاء
    assets.insert
    assets.update
    • badRequest - لا تتيح واجهة برمجة التطبيقات عمليات الكتابة على مواد عرض المقاطع الصوتية الفنية.
    claimSearch.list
    • invalidValue: تحدّد المَعلمة pageToken في الطلب رمزًا مميزًا غير صالح للصفحة.
    claims.insert
    • badRequest – المطالبة التي تحاول إنشاؤها غير صالحة لأنّ قناة الفيديو غير نشطة.
    • badRequest – الفيديو الذي تحاول المطالبة بملكية حقوقه معفى من سياسة إزالة المحتوى. إذا أردت الاستفسار، يُرجى التواصل معنا على العنوان copyright@youtube.com.
    • badRequest - لا يمكن معالجة طلبك لأنّه لا يمكنك إنشاء مطالبة من قِبل جهة خارجية بشأن الفيديو المحدّد.
    • conflict - لا يمكن لمنصة YouTube إنشاء المطالبة المطلوبة لأنّ الفيديو يخالف إشعارًا بإزالة المحتوى.
    • conflict - لا يمكن لمنصة YouTube إنشاء المطالبة المطلوبة لأنّ هناك مطالبة نشطة بإزالة المحتوى مرتبطة بالفيديو.
    references.insert
    • badRequest - تم حذف الفيديو الذي تمّت المطالبة بملكيته وحاولت استخدامه أو تم رفضه أو تعذّرت معالجته.

  • لم يعُد خطأ contentOwnerNotProvided وinternalError، اللذان لا يرتبطان بطريقة معيّنة لواجهة برمجة التطبيقات، مدرَجين في كل صفحة طريقة. لا يزال بإمكانك العثور على أوصافها في قسم الأخطاء العامة ضمن مستندات أخطاء واجهة برمجة التطبيقات.

12 أيلول (سبتمبر) 2013

يتضمّن هذا التحديث التغييرات التالية:

  • مراجع وطُرق جديدة

    • يحدِّد مورد referenceConflict الجديد تعارضًا بين ملفين مرجعيَّين ويُدرج المطابقات التي كانت موجودة بين هذين الملفَّين عند رصد التعارض. تتيح لك الطريقة referenceConflicts.list استرداد قائمة بحالات تعارض المراجع غير المحسَّنة المرتبطة بمالك المحتوى المعتمَد. تتيح لك الطريقة referenceConflicts.get استرداد تعارض مرجعي من خلال تحديد معرّف تعارض المرجع الفريد.

    تعديلات على المراجع والأساليب الحالية

    • تتيح واجهة برمجة التطبيقات الآن إمكانية استرداد سياسة المطابقة السارية لمادة عرض معيّنة. يتوافق هذا التغيير مع التغييرات التي تم طرحها في 16 تموز (يوليو) 2013، والتي تضمنت إتاحة إمكانية استرداد المجموعة الأساسية من البيانات الوصفية وبيانات الملكية الخاصة بمادة عرض.

      لاسترداد سياسة المطابقة الفعّالة لمادة عرض، اضبط قيمة المَعلمة fetchMatchPolicy على effective عند استدعاء إحدى الطريقتَين assets.get أو assets.list. في ردّ واجهة برمجة التطبيقات، يحتوي عنصر matchPolicyEffective في كل مرجع asset معروض على سياسة المطابقة السارية لمادة العرض هذه.

    • يحتوي عنصر ownershipConflicts الجديد لمصدر asset على معلومات عن التعارضات في ملكية مادة العرض. تشبه بنية العنصر بنية مورد ownership، الذي يحدّد كل نوع مختلف من الحقوق التي يمكن أن يمتلكها مالك مادة العرض. (بالنسبة إلى معظم أنواع مواد العرض، يمكن للمالكين امتلاك ملكية عامة لمواد العرض، ولكن بالنسبة إلى مواد عرض المقطوعات الموسيقية، يمكن للمالكين إدراج ملكيتهم لحقوق الأداء أو حقوق المزامنة أو الحقوق الميكانيكية).

      وبالمثل، يحتوي عنصر ownershipConflicts على قوائم منفصلة تحدد التعارضات في حقوق الملكية العامة وحقوق الأداء وحقوق المزامنة والحقوق الميكانيكية. بالنسبة إلى كل تعارض، تحدّد البيانات المناطق التي يحدث فيها التعارض، والمالكين الذين قدّموا بيانات ملكية متعارضة، والنسبة المئوية لمادة العرض التي يدعي كل مالك متعارض ملكيتها.

    • تتيح الطريقتان assets.get وassets.get الآن استخدام المَعلمة fetchOwnershipConflicts الجديدة. تحتوي المَعلمة على قيمة منطقية تشير إلى ما إذا كان يجب أن يسترجع طلب البيانات من واجهة برمجة التطبيقات تعارضات الملكية لمواد العرض في استجابة واجهة برمجة التطبيقات. القيمة التلقائية هي false، ما يعني عدم عرض تعارضات الملكية.

    • تم تعديل تعريف مَعلمة q في طريقة assetSearch.list لتحديد حقول البيانات الوصفية التي يبحث عنها YouTube.

    • تشير الآن مستندات محتوى الطلب لطريقة references.insert إلى أنّه عليك ضبط قيمة السمة contentType. يؤدي هذا التغيير إلى تعديل المستندات لتعكس بشكل صحيح وظيفة واجهة برمجة التطبيقات الفعلية، ولكنّه لا يمثّل تغييرًا في وظيفة واجهة برمجة التطبيقات.

  • الأخطاء الجديدة والمحدّثة

    • تتيح واجهة برمجة التطبيقات خطأ forbidden جديدًا، وهو ليس خاصًا بطريقة معيّنة، ويشير إلى أنّه لا يمكن تفويض العملية المطلوبة من خلال حساب خدمة.

    • تُحدِّد طريقة assets.insert الآن أخطاء البيانات الوصفية على أنّها تحدث في السمات في عنصر metadataMine بدلاً من عنصر metadata الذي تم إيقافه نهائيًا اعتبارًا من تحديث واجهة برمجة التطبيقات في 16 تموز (يوليو) 2013.

    • تم تعديل صفحة الأخطاء بحيث تحتوي كل صفحة على جدول واحد يسرد الأخطاء التي تعرضها هاتان الطريقتان لكل مورد يتيح استخدام هاتين الطريقتَين.updatepatch في السابق، كانت الصفحة تسرد الأخطاء لكل طريقة على حدة، على الرغم من أنّ القوائم كانت متطابقة دائمًا.

16 تموز (يوليو) 2013

يتضمّن هذا التحديث التغييرات التالية:

  • مراجع وطُرق جديدة

    • تتيح لك طريقة claimHistory.get الجديدة تحديد معلومات حول مطالبة معيّنة واستردادها. يحتوي مورد claimHistory الذي تم إرجاعه على قائمة بالأحداث ذات الصلة بالمطالبة، مثل إنشاء المطالبة أو تعديلها أو الاعتراض عليها أو إغلاقها.

    • تتيح لك طريقة claimSearch.list الجديدة البحث عن المطالبات التي تستوفي أيًا من المعايير التالية أو كلّها:

      • تكون المطالبات مرتبطة بمادة عرض معيّنة.
      • تكون المطالبات مرتبطة بفيديو معيّن.
      • تتطابق المطالبات مع سلسلة طلب بحث مقدَّمة في الطلب.

      يحتوي كلّ مورد claimSnippet في استجابة واجهة برمجة التطبيقات على تفاصيل حول المطالبة، بما في ذلك معرّف المطالبة الفريد وحالتها ونوعها (audio أو video أو audiovisual) ومادة العرض والفيديو المرتبطَين بالمطالبة. ويحدّد المرجع أيضًا عدد مشاهدات الفيديو الذي تمّت المطالبة بملكيته وعنوانه.

  • تعديلات على المراجع والأساليب الحالية

    • تسرد المستندات الآن القيم المسموح بها للسمات التي تحتوي على مجموعة من القيم المحدّدة. وتشمل هذه المواقع السمة type لمورد asset والسمة status لمورد claim.

    • بالنسبة إلى الطريقتَين assets.get وassets.list، تتيح لك واجهة برمجة التطبيقات الآن استخدام قيم مفصولة بفواصل لمَعلمتَي الطلب fetchMetadata وfetchOwnership، ما يتيح لك استرداد مجموعات متعدّدة من البيانات الوصفية أو بيانات الملكية.

      توضّح القائمة أدناه التغييرات المقابلة في بنية مورد asset بالإضافة إلى تأثيرات هذه التغييرات على طرق واجهة برمجة التطبيقات التي تستخدم موارد get أو list أو insert أو update أو patch.asset

      • تم إيقاف عنصر metadata نهائيًا واستبداله بعنصرَي metadataMine وmetadataEffective. تتيح العناصر الجديدة لمصدر asset تضمين كلّ من مجموعة البيانات الوصفية التي يقدّمها مالك المحتوى الذي يقدّم طلب واجهة برمجة التطبيقات، بالإضافة إلى المجموعة الأساسية من البيانات الوصفية التي حدّدت منصة YouTube أنّها المجموعة الأكثر دقة واكتمالاً من البيانات الوصفية لمادة العرض.

      • وبالمثل، تم استبدال العنصر ownership بالعنصرَين ownershipMine وownershipEffective.

      • تم استبدال العنصر matchPolicy بالعنصر matchPolicyMine. (لا تتيح واجهة برمجة التطبيقات حاليًا إمكانية استرداد سياسة المطابقة السارية لمادة عرض معيّنة).

      ملاحظة: لضمان التوافق مع الإصدارات القديمة، إذا تم طلب إصدار واحد فقط من البيانات الوصفية أو مجموعة واحدة من بيانات الملكية أو سياسة مطابقة واحدة لمادة عرض، سيتضمّن ردّ واجهة برمجة التطبيقات العنصر الذي سيتم إيقافه نهائيًا بالإضافة إلى العنصر المتوافق حديثًا. على سبيل المثال، إذا ضبط طلب المَعلمة fetchMetadata على mine، سيحتوي ردّ واجهة برمجة التطبيقات على عنصر metadata وعنصر metadataMine، وكلاهما سيحتوي على البيانات نفسها. (كانت إمكانية ضبط fetchMetadata=mine متاحة قبل تحديث الميزات الذي يتيح لك استرداد إصدارات متعددة من البيانات الوصفية).

      ومع ذلك، في حال ضبط المَعلمة fetchMetadata على mine,effective، سيتضمّن ردّ واجهة برمجة التطبيقات كائنَي metadataMine وmetadataEffective، ولكنّه لن يتضمّن كائن metadata. (لم تكن إمكانية ضبط fetchMetadata=mine,effective متاحة قبل تحديث هذه الميزة، لذا ليس من الضروري عرض عنصر metadata للحفاظ على التوافق مع الإصدارات القديمة). ينطبق المبدأ نفسه أيضًا على المَعلمتَين fetchOwnership وfetchMatchPolicy.

      بالمثل، للحفاظ على التوافق مع الإصدارات القديمة، يمكن أن يتضمّن طلب الوصول إلى مورد asset من خلال insert أو update أو patch إما عنصر metadataMine أو عنصر metadata. وينطبق المبدأ نفسه على ضبط بيانات ملكية مورد asset أو سياسة المطابقة.

    • تم إيقاف استخدام مَعلمات assetId وq وvideoId في الطريقة claims.list. للبحث عن المطالبات باستخدام أيّ من هذه المعايير، استخدِم الطريقة claimSearch.list التي تتيح استخدام كلّ هذه المَعلمات.

    • في مورد ownership، أصبحت قيم السمات general[].ratio وperformance[].ratio وsynchronization[].ratio وmechanical[].ratio تتضمّن الآن تنسيق محتوى double بدلاً من integer.

    • يسرد تعريف سمة rules[].action لمورد policy الآن القيم الصالحة لهذه السمة: block وmonetize وtakedown وtrack. تجدر الإشارة إلى أنّه لا يمكنك استخدام واجهة برمجة التطبيقات لتطبيق سياسة إزالة المحتوى على مطالبة.

    • تظهر السمة claimId الجديدة لمصدر reference إذا تم إنشاء المرجع من خلال ربط مادة عرض بفيديو حالي على YouTube تم تحميله إلى قناة على YouTube مرتبطة بحسابك على نظام إدارة المحتوى. في هذه الحالة، يحتوي هذا الحقل على معرّف المطالبة التي تمثّل الربط الناتج بين مادة العرض والفيديو.

    • تحدّد السمة excludedIntervals[] الجديدة لمصدر reference قائمة بالفواصل الزمنية التي يجب أن تتجاهلها YouTube أثناء محاولة مطابقة المرجع. يحدِّد كل فاصل وقت بدء ووقت انتهاء يتم قياسهما بالثواني من بداية الفيديو.

    • لم تعُد واجهة برمجة التطبيقات تتطلّب ضبط السمة status في مورد reference الذي يتم إرساله في نص طلب references.update أو references.patch.

    • تم تصحيح المستندات لوصف تنسيق استجابة واجهة برمجة التطبيقات بشكل صحيح لطريقة videoAdvertisingOptions.getEnabledAds. يحتوي الردّ، وهو مورد youtubePartner#videoAdvertisingOptionGetEnabledAds، على المعلومات التالية:

      • id: المعرّف الذي تستخدمه YouTube لتحديد الفيديو الذي تمّت المطالبة بملكيته والمرتبط بالإعدادات بشكل فريد

      • ‫adBreaks: قائمة بالعناصر التي يحتوي كلّ عنصر منها على معلومات عن نقطة قبل تشغيل الفيديو أو خلاله أو بعده يُسمح فيها بعرض الإعلانات. يمكن أن يحدّد كل عنصر أيضًا سمات أخرى للفاصل الإعلاني، مثل خانات الإعلانات التي تظهر أثناء الفاصل وأنواع الإعلانات المسموح بعرضها خلال كل خانة.

      • ‫adsOnEmbeds: حقل منطقي يشير إلى ما إذا كان بإمكان YouTube عرض الإعلانات عند تشغيل الفيديو في مشغّل مضمّن.

      • ‫countriesRestriction: قائمة بالكائنات التي يحدّد كلّ منها قائمة بالمناطق وأشكال الإعلانات المستخدَمة أثناء تشغيل الفيديو في تلك المناطق

  • الأخطاء الجديدة والمحدّثة

    • يحدِّد الجدول التالي الأخطاء الجديدة التي تتيحها واجهة برمجة التطبيقات والطُرق التي يمكن أن تؤدي إلى ظهور كلّ خطأ. ويحدِّد أيضًا الأخطاء التي تغيّرت. يُرجى العِلم أنّ الطريقة قد تعرض أخطاء متعددة لها نوع الخطأ نفسه. على سبيل المثال، يتم عرض خطأ required إذا حاولت إدراج مورد asset لا يتضمّن حقل بيانات وصفية مطلوبًا. في الواقع، قد يكون هناك أكثر من حقل بيانات وصفية مطلوب، وسيعرض كل حقل خطأً برسالة مختلفة قليلاً.

      يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

      الطريقة الأخطاء
      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 – لا يملك مالك المحتوى الذي تتصرّف نيابةً عنه إذنًا بالمطالبة بملكية الفيديوهات التي حمّلها المستخدمون من خلال واجهة برمجة التطبيقات.
      contentOwners.list
      • badRequest – يحدّد الطلب معايير غير صالحة. يجب تحديد مَعلمة فلتر واحدة بالضبط من المَعلمتَين التاليتَين: fetchMine وid. (في السابق، كان الخطأ يسرد مجموعة مختلفة من مَعلمات الفلترة، وهي has_conflicts_with وrestrict_to_user وname_prefix وid).
      ownership.update
      ownership.patch
      • badRequest - يجب أن يحدّد الطلب الذي يعدّل بيانات الملكية لمادة عرض التركيب بيانات الملكية الدقيقة، أي حقوق mechanical و/أو performance و/أو synchronization و/أو lyric، بدلاً من حقوق الملكية general. أصبح نوع الحقوق lyric متوافقًا حديثًا.
      policies.insert
      policies.update
      policies.patch
      • invalidValue – يحتوي الطلب على قاعدة سياسة غير صالحة لأنّ واجهة برمجة التطبيقات لا تتيح إنشاء سياسات أو تعديلها لتحديد إجراء takedown. ويحلّ هذا الخطأ، الذي يُبلغ عن سبب invalidPolicyTakedownAction، محلّ الخطأ invalidPolicyConditionalTakedown المتوقّف نهائيًا.
      references.insert
      • ‫badRequest: يجب أن يرسل الطلب إما ملف وسائط أو يحدّد قيمة لمَعلمة الطلب claimId. ومع ذلك، قد لا يُرسِل الطلب ملف وسائط ويحدّد قيمة لمَعلمة الطلب claimId.
      • badRequest: سبق أن تم إنشاء مرجع للمحتوى نفسه من مطالبة مختلفة على فيديو YouTube نفسه.
      • badRequest: لا تتيح واجهة برمجة التطبيقات إمكانية ضبط قيمة للسمة fpDirect عند إنشاء مرجع.
      • internalError – حدثت مشكلة في ملف الوسائط الذي تم تحميله.
      • invalidValue - قيمة مَعلمة الطلب contentType أو assetId أو claimId غير صالحة. يحدِّد الخطأ القيمة غير الصالحة.
      • notFound - تعذّر العثور على مادة العرض أو المطالبة التي حدّدتها. يُرجى التحقّق من قيم المَعلمتَين assetId وclaimId في طلبك.
      • required: يجب أن يحدّد الطلب قيمة للمَعلمة contentType.
      references.insert
      references.update
      references.patch
      • invalidValue: قيمة excludedIntervals المحدّدة للمرجع غير صالحة. يُرجى العلم أنّه لا يمكنك تحديد فواصل الاستبعاد عند إيقاف مرجع.

10 أيار (مايو) 2013

يتضمّن هذا التحديث التغييرات التالية:

8 نيسان (أبريل) 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تمت إعادة تسمية واجهة برمجة التطبيقات إلى YouTube Content ID API.

  • تغيّرت عدة مواقع في المورد assetMatchPolicy:

    • تم تغيير قيمة السمة kind من youtubePartner#policy إلى youtubePartner#assetMatchPolicy.
    • تحتوي السمة الجديدة policyId على قيمة تحدّد بشكل فريد مورد سياسة محفوظ.
    • أصبحت قيمة السمة rules[].subaction الآن قائمة من السلاسل بدلاً من سلسلة.
    • أصبحت قيمة السمة rules[].conditions.contentMatchType الآن قائمة من السلاسل بدلاً من سلسلة.
    • تمّت إزالة المواقع id وname وdescription.

  • تم تعديل مستندات الطريقة assetMatchPolicy.update لتوضيح أنّه يمكنك ضبط قيم للسمة policyId أو للكائن rules[] عند استدعاء الطريقة.

  • يتيح مورد claims الآن العديد من السمات الجديدة:

    اسم السمة القيمة الوصف
    timeCreated datetime التاريخ والوقت اللذان تمّ فيهما إنشاء المطالبة
    matchInfo object يحتوي عنصر matchInfo على معلومات عن المحتوى المطابق الذي أدّى إلى تقديم المطالبة. لا يتم تضمين هذه المعلومات في مرجع claim إلا إذا تم إنشاء المطالبة تلقائيًا لأنّ فيديو تم تحميله تطابق مع ملف مرجعي حالي.
    matchInfo.referenceId string المعرّف الفريد الذي يستخدمه 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 لتوضيح أنّها لا تسترجع سوى أحدث بيانات الملكية لكل مالك محتوى. ومع ذلك، إذا أرسل مالك المحتوى بيانات الملكية من خلال مصادر بيانات متعددة (واجهة برمجة التطبيقات وخلاصات المحتوى وما إلى ذلك)، ستحتوي القائمة على أحدث البيانات لكل مالك محتوى ومصدر بيانات.

  • تغيّرت عدة مواقع في المورد policy:

    • تمت إعادة تسمية الموقع rule إلى rules.
    • أصبحت قيمة السمة rules[].subaction الآن قائمة من السلاسل بدلاً من سلسلة.
    • أصبحت قيمة السمة rules[].conditions.contentMatchType الآن قائمة من السلاسل بدلاً من سلسلة.

  • تم تعديل مستندات الطريقتَين policies.insert وpolicies.update لتوضيح أنّه يمكنك ضبط قيم لكائن rules[] عند استدعاء هاتين الطريقتَين.

  • تتيح العديد من طرق واجهة برمجة التطبيقات أنواع الأخطاء الجديدة. يحدّد الجدول أدناه الطريقة ويحدّد بإيجاز أنواع الأخطاء المتوافقة حديثًا. في كثير من الحالات، قد تكون هناك أخطاء متعددة لنوع معيّن. على سبيل المثال، يتم عرض خطأ required إذا حاولت إدراج مورد asset لا يتضمّن حقل بيانات وصفية مطلوبًا. في الواقع، قد يكون هناك أكثر من حقل بيانات وصفية مطلوب، وسيعرض كل حقل خطأً برسالة مختلفة قليلاً.

    يُرجى الرجوع إلى مستندات الأخطاء لكل طريقة أو إلى صفحة الأخطاء للحصول على مزيد من المعلومات.

    الطريقة الأخطاء
    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 – تحتوي السياسة على قواعد سياسة متعارضة.

  • تعرض صفحة الأخطاء الجديدة الأخطاء التي يمكن أن تعرِضها واجهة برمجة التطبيقات. تتضمّن الصفحة أخطاء عامة قد تحدث في طرق متعددة مختلفة لواجهة برمجة التطبيقات، بالإضافة إلى أخطاء خاصة بالطريقة.

18 كانون الثاني (يناير) 2013

يتضمّن هذا التحديث التغييرات التالية:

  • تتيح لك طريقة videoAdvertisingOptions.getEnabledAds التي تم توثيقها حديثًا استرداد تفاصيل عن أنواع الإعلانات المسموح بها لفيديو محدّد يحمّله شريك أو مستخدم.

  • تم تعديل تعريف المَعلمة ownershipRestriction في الطريقة assetSearch.list للإشارة إلى أنّ القيمة التلقائية للمَعلمة هي mine، ما يشير إلى أنّ واجهة برمجة التطبيقات يجب أن تسترجع مواد العرض التي يملكها المستخدم الحالي فقط.

  • تعكس مستندات الطريقة assets.list التغييرات التالية:

    • أصبحت المَعلمة id مطلوبة الآن.

    • تتيح لك المَعلمة fetchMatchPolicy المتوافقة حديثًا الإشارة إلى ما إذا كان يجب أن يسترجع طلب البيانات من واجهة برمجة التطبيقات أيضًا سياسة المطابقة التي ضبطتها لمادة العرض.

    • تتيح لك المَعلمة fetchOwnership المتاحة حديثًا الإشارة إلى ما إذا كان يجب أن يسترجع طلب البيانات من واجهة برمجة التطبيقات أيضًا بيانات ملكية مادة العرض.

    • لم تعُد قائمة مواد العرض التي تعرضها واجهة برمجة التطبيقات تحتوي على بيانات تقسيم الصفحات. نتيجةً لذلك، تمّت إزالة السمة nextPageToken والعنصر pageInfo من استجابة واجهة برمجة التطبيقات. يتضمّن عنصر pageInfo السمات totalResults وresultsPerPage وstartIndex.

  • تم تعديل مستندات المرجع claims لتوضيح أنّه عليك تحديد سياسة عند إنشاء مطالبة. (لا تطبّق YouTube حاليًا سياسة الاستخدام التلقائية إذا لم تحدّد المطالبة المُدرَجة سياسة، على الرغم من أنّ المستندات كانت تشير سابقًا إلى أنّ ذلك كان يحدث).

  • تم إيقاف سمة hasUnpublishedDraft في المرجع policy نهائيًا.

  • تتيح لك المَعلمة id المتوافقة حديثًا مع الطريقة policies.list تحديد السياسات المحفوظة التي يجب أن يسترجعها طلب واجهة برمجة التطبيقات. لا يمكن استرداد سوى السياسات التي يملكها مالك المحتوى الذي تمّت مصادقة هويته حاليًا.

  • تم تعديل تعريف المَعلمة releaseClaims لكلّ من الطريقتَين references.patch وreferences.update للإشارة إلى أنّ المَعلمة لا تعمل إلا عند تعديل حالة المطالبة إلى inactive. في هذه الحالة، يمكنك أيضًا ضبط قيمة المَعلمة releaseClaims على true لإزالة جميع مطالبات المطابقة التي أنشأها المرجع.

  • تم تعديل الطريقتَين references.patch وreferences.update للإشارة إلى أنّه عليك تحديد حالة المرجع عند تنفيذ أيّ من هاتين العمليتين.

  • تتيح العديد من طرق واجهة برمجة التطبيقات أنواع الأخطاء الجديدة. يحدِّد الجدول أدناه الطريقة والأخطاء المتوافقة حديثًا:

    الطريقة نوع الخطأ تفاصيل الخطأ الوصف
    guideCategories.list notFound Unavailable تعذّر العثور على مادة العرض التي تحاول استرداد سياسة المطابقة لها.
    claims.get notFound Unavailable لا يمكن العثور على المطالبة التي تحاول استردادها.
    ownership.patch invalidValue Unavailable تحتوي بيانات الملكية التي قدّمتها على قيمة غير صالحة.
    ownership.update invalidValue Unavailable تحتوي بيانات الملكية التي قدّمتها على قيمة غير صالحة.