YouTube Content ID API

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

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

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

مستند Discovery

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

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

نقطة نهاية الخدمة هي عنوان 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: مواد العرض

الطُرق
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: الحملات

الطُرق
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: السياسات

الطُرق
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: المدقق

الطُرق
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
يسترجع هذا الطلب قائمة بالقنوات المُدرَجة في القائمة المسموح بها الخاصة بمالك محتوى معيّن.