YouTube Content ID API

تتيح واجهة برمجة تطبيقات Content ID في YouTube إدارة مواد العرض على YouTube بالإضافة إلى المحتوى والمراجع والملكية والحقوق والسياسات المرتبطة بها.

الخدمة: youtubepartner.googleapis.com

لطلب هذه الخدمة، ننصح باستخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.

مستند الاستكشاف

مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات IDE الإضافية وغيرها من الأدوات التي تتفاعل مع Google APIs. تجدر الإشارة إلى أنّ خدمة واحدة قد تقدّم أكثر من وثيقة استكشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://youtubepartner.googleapis.com

مورد REST: ‏ assetLabels

الطُرق
insert POST /youtube/partner/v1/assetLabels
أدخِل تصنيف مادة عرض لمالك.
list GET /youtube/partner/v1/assetLabels
يستردّ هذا الطلب قائمة بجميع تصنيفات مواد العرض لمالك معيّن.

مورد REST: ‏ assetMatchPolicy

الطُرق
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
يستردّ هذا الإجراء سياسة المطابقة التي خصّصها مالك المحتوى المرتبط بالمستخدم الذي تمّت مصادقته لمادة العرض المحدّدة.
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
تعمل هذه الطريقة على تعديل سياسة المطابقة الخاصة بمادة العرض.
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
تعدّل هذه الطريقة سياسة المطابقة الخاصة بمادة العرض.

مورد REST: ‏ assetRelationships

الطُرق
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
لحذف علاقة بين مادتَي عرض
insert POST /youtube/partner/v1/assetRelationships
تنشئ هذه الطريقة علاقة تربط بين مادتَي عرض.
list GET /youtube/partner/v1/assetRelationships
يستردّ هذا الإجراء قائمة بالعلاقات الخاصة بمادة عرض معيّنة.

مورد REST: ‏ assetSearch

الطُرق
list GET /youtube/partner/v1/assetSearch
يبحث عن مواد العرض استنادًا إلى البيانات الوصفية لمواد العرض.

مورد REST: ‏ assetShares

الطُرق
list GET /youtube/partner/v1/assetShares
تستردّ هذه الطريقة إما قائمة بحصص مواد العرض التي يملكها الشريك والمرتبطة بمعرّف عرض مادة عرض محدّد أو تستردّ قائمة بعروض مواد العرض المرتبطة بمعرّف حصة مادة عرض محدّد يملكه الشريك.

مورد REST: ‏ assets

الطُرق
get GET /youtube/partner/v1/assets/{assetId}
يستردّ هذا الإجراء البيانات الوصفية لمادة العرض المحدّدة.
insert POST /youtube/partner/v1/assets
تُدرج هذه السمة مادة عرض مع البيانات الوصفية المحدّدة.
list GET /youtube/partner/v1/assets
يستردّ هذا الإجراء قائمة بمواد العرض استنادًا إلى البيانات الوصفية لمادة العرض.
patch PATCH /youtube/partner/v1/assets/{assetId}
تعدّل هذه الطريقة البيانات الوصفية لمادة العرض المحدّدة.
update PUT /youtube/partner/v1/assets/{assetId}
تعدّل هذه الطريقة البيانات الوصفية لمادة العرض المحدّدة.

مورد REST: ‏ campaigns

الطُرق
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
يحذف هذا الإجراء حملة محدّدة لمالك.
get GET /youtube/partner/v1/campaigns/{campaignId}
لاسترداد حملة معيّنة لمالك
insert POST /youtube/partner/v1/campaigns
إدراج حملة جديدة لمالك باستخدام بيانات الحملة المحدّدة
list GET /youtube/partner/v1/campaigns
تعرض هذه الطريقة قائمة بالحملات الخاصة بمالك حساب.
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
تعديل بيانات حملة معيّنة
update PUT /youtube/partner/v1/campaigns/{campaignId}
عدِّل بيانات حملة معيّنة.

مورد REST: ‏ claimHistory

الطُرق
get GET /youtube/partner/v1/claimHistory/{claimId}
يستردّ هذا الإجراء سجلّ المطالبة المحدّدة.

مورد REST: ‏ claimSearch

الطُرق
list GET /youtube/partner/v1/claimSearch
لاسترداد قائمة بالمطالبات التي تطابق معايير البحث

مورد REST: ‏ claims

الطُرق
get GET /youtube/partner/v1/claims/{claimId}
يستردّ مطالبة معيّنة حسب رقم التعريف.
insert POST /youtube/partner/v1/claims
لإنشاء مطالبة.
list GET /youtube/partner/v1/claims
تعرض هذه الطريقة قائمة بالمطالبات التي يديرها مالك المحتوى المرتبط بالمستخدم الحالي الذي تمّت المصادقة عليه.
patch PATCH /youtube/partner/v1/claims/{claimId}
يعدّل هذا الإجراء مطالبة حالية من خلال تغيير سياستها أو حالتها.
update PUT /youtube/partner/v1/claims/{claimId}
تعدّل هذه الطريقة مطالبة حالية من خلال تغيير سياستها أو حالتها.

مورد REST: ‏ contentOwners

الطُرق
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
تعرض هذه الطريقة معلومات عن مالك المحتوى المحدّد.
list GET /youtube/partner/v1/contentOwners
يستردّ هذا الطلب قائمة بمالكي المحتوى الذين يستوفون معايير الطلب.

مورد REST: ‏ liveCuepoints

الطُرق
insert POST /youtube/partner/v1/liveCuepoints
تُدرج هذه السمة نقطة إشارة في بث مباشر.

مورد REST: ‏ metadataHistory

الطُرق
list GET /youtube/partner/v1/metadataHistory
يستردّ هذا الإجراء قائمة بجميع البيانات الوصفية المقدَّمة لمادة عرض، بغض النظر عن مالك المحتوى الذي قدّم البيانات.

مورد REST: ‏ musicChangeRequests

الطُرق
create POST /youtube/partner/v1/music/changeRequests
تُنشئ هذه السمة طلب تغيير موسيقيًا تم إبلاغ إصدار أو مقطع صوتي به.
list GET /youtube/partner/v1/music/changeRequests
تعرض هذه الطريقة قائمة بطلبات تغيير الموسيقى التي تم إبلاغها بشأن إصدار أو مقطع صوتي.

مورد REST: ‏ musicReleases

الطُرق
list GET /youtube/partner/v1/music/releases
تعرض هذه الطريقة قائمة بالإصدارات الموسيقية.

مورد REST: ‏ musicTracks

الطُرق
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
تعرض هذه الطريقة قائمة بأغاني الموسيقى.

مورد REST: ‏ ownership

الطُرق
get GET /youtube/partner/v1/assets/{assetId}/ownership
يستردّ هذا الإجراء بيانات الملكية المقدَّمة لمادة العرض المحدّدة من قِبل مالك المحتوى المرتبط بالمستخدم الذي تمّت مصادقته.
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
تقدّم هذه السمة معلومات جديدة عن ملكية مادة العرض المحدّدة.
update PUT /youtube/partner/v1/assets/{assetId}/ownership
تقدّم هذه السمة معلومات جديدة عن ملكية مادة العرض المحدّدة.

مورد REST: ‏ ownershipHistory

الطُرق
list GET /youtube/partner/v1/ownershipHistory
يستردّ هذا الإجراء قائمة ببيانات الملكية الخاصة بمادة عرض، بغض النظر عن مالك المحتوى الذي قدّم البيانات.

مورد REST: ‏ package

الطُرق
get GET /youtube/partner/v1/package/{packageId}
يستردّ معلومات الحزمة المحدّدة.
insert POST /youtube/partner/v1/package
يُدرج حزمة بيانات وصفية فقط.

مورد REST: ‏ policies

الطُرق
get GET /youtube/partner/v1/policies/{policyId}
يستردّ السياسة المحفوظة المحدّدة.
insert POST /youtube/partner/v1/policies
تُنشئ هذه السمة سياسة محفوظة.
list GET /youtube/partner/v1/policies
يستردّ هذا الطلب قائمة بالسياسات المحفوظة لمالك المحتوى.
patch PATCH /youtube/partner/v1/policies/{policyId}
تعدّل هذه السمة السياسة المحفوظة المحدّدة.
update PUT /youtube/partner/v1/policies/{policyId}
تعدّل هذه السمة السياسة المحفوظة المحدّدة.

مورد REST: ‏ referenceConflicts

الطُرق
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
يسترد معلومات حول تعارض المرجع المحدّد.
list GET /youtube/partner/v1/referenceConflicts
يستردّ هذا الإجراء قائمة بتعارضات المراجع التي لم يتم حلّها.

مورد REST: ‏ references

الطُرق
get GET /youtube/partner/v1/references/{referenceId}
يسترد معلومات حول المرجع المحدّد.
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references

يتم إنشاء مرجع بإحدى الطرق التالية:

  • إذا كان طلبك يتضمّن تحميل ملف مرجعي، ينشئ YouTube المرجع من المحتوى المقدَّم.
list GET /youtube/partner/v1/references
يستردّ هذا الإجراء قائمة بالمراجع حسب رقم التعريف أو قائمة بالمراجع الخاصة بمادة العرض المحدّدة.
patch PATCH /youtube/partner/v1/references/{referenceId}
تعديل مرجع
update PUT /youtube/partner/v1/references/{referenceId}
تعدّل هذه السمة مرجعًا.

مورد REST: ‏ spreadsheetTemplate

الطُرق
list GET /youtube/partner/v1/spreadsheetTemplate
يستردّ هذا الطلب قائمة بنماذج جداول البيانات الخاصة بمالك محتوى.

مورد REST: ‏ uploader

الطُرق
list GET /youtube/partner/v1/uploader
تعرض هذه الطريقة قائمة بالمستخدمين الذين حمّلوا محتوًى لمالك محتوى معيّن.

مورد REST: ‏ validator

الطُرق
validate POST /youtube/partner/v1/validator
التحقّق من صحة ملف بيانات وصفية
validateAsync POST /youtube/partner/v1/validatorAsync
إثبات صحة ملف بيانات وصفية بشكل غير متزامن
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
الحصول على حالة التحقّق غير المتزامن

مورد REST: ‏ videoAdvertisingOptions

الطُرق
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
يستردّ إعدادات الإعلانات للفيديو المحدّد.
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
تعرض هذه الطريقة تفاصيل حول أنواع الإعلانات المسموح بها لفيديو محدّد حمّله الشريك أو المستخدم.
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
يعدّل إعدادات الإعلانات للفيديو المحدّد.
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
تعدّل هذه الطريقة إعدادات الإعلانات للفيديو المحدّد.

مورد REST: ‏ whitelists

الطُرق
delete DELETE /youtube/partner/v1/whitelists/{id}
تزيل هذه الطريقة قناة من القائمة البيضاء لمالك محتوى.
get GET /youtube/partner/v1/whitelists/{id}
تعرض هذه الطريقة قناة معيّنة تمت إضافتها إلى القائمة البيضاء حسب رقم تعريفها.
insert POST /youtube/partner/v1/whitelists
أضِف قناة على YouTube إلى القائمة البيضاء لمالك المحتوى.
list GET /youtube/partner/v1/whitelists
تعرض هذه الطريقة قائمة بالقنوات المُدرَجة في القائمة البيضاء لمالك محتوى.