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).