Sponsors

ملاحظة: تم إيقاف العمل بهذا المورد اعتبارًا من 31 آذار (مارس) 2020. تم استبداله بالمورد member. يمكنك العثور على معلومات حول هذا المورد في مستندات YouTube Data API.

وفي إطار هذا الإيقاف، سيتم إيقاف طريقة sponsors.list نهائيًا في 30 أيلول (سبتمبر) 2020 أو بعد هذا التاريخ. على عملاء واجهة برمجة التطبيقات تعديل الاستدعاءات إلى الطريقة sponsors.list لاستخدام طريقة members.list بدلاً منها.

يُمثِّل مورد sponsor منتسبًا إلى قناة على YouTube (كان يُعرَف سابقًا باسم "جهة راعية"). يقدّم المُنتسِب دعمًا ماليًا متكرّرًا إلى منشئ المحتوى ويتلقّى مزايا خاصة. على سبيل المثال، يمكن للمنتسبين الدردشة عندما يفعّل منشئ المحتوى وضع المحادثة الحصرية للمنتسبين.

الطُرق

تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (sponsors):

list

يتضمن قائمة بجهات راعية لقناة. يجب أن يأذن مالك القناة بطلب واجهة برمجة التطبيقات. التجربة الآن

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد sponsors:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

أماكن إقامة
kind	string تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#sponsor.
etag	etag Etag لهذا المورد.
id	string المعرّف الذي تحدّده منصة YouTube لتعريف الجهة الراعية بشكل فريد
snippet	object يحتوي الكائن snippet على تفاصيل عن الجهة الراعية.
snippet.channelId	string يحدّد هذا المعرّف القناة التي تقدّم الرعاية.
snippet.sponsorDetails	object يحتوي هذا العنصر على تفاصيل عن الجهة الراعية.
snippet.sponsorDetails.channelId	string معرّف قناة YouTube
snippet.sponsorDetails.channelUrl	string عنوان URL للقناة
snippet.sponsorDetails.displayName	string الاسم المعروض للقناة
snippet.sponsorDetails.profileImageUrl	string عنوان URL للصورة الرمزية للقنوات
snippet.sponsorSince	datetime التاريخ والوقت الذي أصبح فيه المستخدم جهة راعية يتم تحديد القيمة بتنسيق ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).