YouTube Content ID API

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

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

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

مستند Discovery

مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكونات 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: مواد العرض

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

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

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

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

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

موارد REST: المراجع

الطُرق
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: نموذج جدول البيانات

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

مورد REST: أداة التحميل

الطُرق
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: video AdvertisingOptions

الطُرق
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: القوائم البيضاء

الطُرق
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
لاسترداد قائمة بالقنوات المضافة إلى القائمة البيضاء لمالك محتوى.