تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Members

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

لا يمكن لصنّاع المحتوى الفرديين استخدام نقطة النهاية هذه إلا لتقديم طلبات بشأن قناتهم على YouTube التي فعّلت ميزة "الاشتراك الداعم". يُرجى التواصل مع ممثل Google أو YouTube لطلب إذن الوصول.

يمثّل مورد member أحد المشتركين الداعمين لقناة على YouTube. يقدّم المشترك الداعم دعمًا ماليًا متكررًا لصانع محتوى معيّن ويحصل على مزايا خاصة. على سبيل المثال، يمكن للمشتركين الداعمين إجراء محادثة عندما يفعّل صانع المحتوى وضع المحادثة الحصرية للأعضاء في إحدى المحادثات.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد member:

list: تعرض هذه البطاقة المشتركين الداعمين (المعروفين سابقًا باسم "الجهات الراعية") لقناة معيّنة. يجب أن يوافق صاحب القناة على طلب البيانات من واجهة برمجة التطبيقات.

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

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

{
  "kind": "youtube#member",
  "etag": etag,
  "snippet": {
    "creatorChannelId": string,
    "memberDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "membershipsDetails": {
      "highestAccessibleLevel": string,
      "highestAccessibleLevelDisplayName": string,
      "accessibleLevels": [
        string
      ],
      "membershipsDuration": {
        "memberSince": datetime,
        "memberTotalDurationMonths": integer,
      },
      "membershipsDurationAtLevel": [
        {
          "level": string,
          "memberSince": datetime,
          "memberTotalDurationMonths": integer,
        }
      ]
    }
  }
}

أماكن إقامة

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

أماكن إقامة
`kind`	`string` لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة `youtube#member`.
`etag`	`etag` رقم تعريف Etag لهذا المورد.
`snippet`	`object` يحتوي عنصر `snippet` على تفاصيل عن العضو.
`snippet.creatorChannelId`	`string` رقم تعريف قناة صانع المحتوى الذي يقدّم العضويات على YouTube.
`snippet.memberDetails`	`object` يحتوي هذا العنصر على بيانات الملف الشخصي للقناة على YouTube التي تدفع رسوم الاشتراك. يُرجى العِلم أنّه يمكن أن تتضمّن القناة مشتركين داعمين لا تتوفّر بيانات ملفاتهم التجارية. على سبيل المثال، يحدث ذلك مع المشتركين الذين حذفوا قنواتهم ولكن لا يزالون يدفعون مقابل العضويات. يُرجى العِلم أنّه سيظل بإمكان هؤلاء المشتركين الاستفادة من مزايا الاشتراك. تتضمّن ردود واجهة برمجة التطبيقات موارد لهؤلاء الأعضاء لضمان أعداد دقيقة حتى في حال عدم ضبط تفاصيل الملف التجاري داخل عنصر `memberDetails`. سيظل بإمكان هؤلاء الأعضاء الاستفادة من `membershipsDetails`.
`snippet.memberDetails.channelId`	`string` معرّف القناة على YouTube التي تتضمّن ميزة "الاشتراك الداعم". وفي حال ضبطه، يمكن أيضًا التعامل مع معرّف القناة كمعرّف فريد للمشترك الداعم. وفي حال عدم ضبطه، لا يمكن تحديد هوية العضو بشكل فريد، ولكن يظلّ المرجع ينقل تفاصيل العضوية، مثل المستويات التي يمكن للعضو الوصول إليها ومدة عضويته.
`snippet.memberDetails.channelUrl`	`string` عنوان URL الخاص بالقناة.
`snippet.memberDetails.displayName`	`string` الاسم المعروض للقناة.
`snippet.memberDetails.profileImageUrl`	`string` عنوان URL الخاص بأفاتار القناة.
`snippet.membershipsDetails`	`object` يحتوي هذا العنصر على تفاصيل الاشتراك الداعم للقناة.
`snippet.membershipsDetails.highestAccessibleLevel`	`string` رقم تعريف أعلى مستوى اشتراك يمكن للقنوات المنتسَبة الوصول إليه حاليًا. تتوافق القيمة مع قيمة سمة `id` في مورد `membershipsLevel`.
`snippet.membershipsDetails.highestAccessibleLevelDisplayName`	`string` اسم أعلى مستوى اشتراك يمكن للقناة التي تتضمّن ميزة "الاشتراك الداعم" الاستفادة منه حاليًا. تتوافق قيمة مع قيمة سمة `displayName` في مورد `membershipsLevel`.
`snippet.membershipsDetails.accessibleLevels[]`	`list (of strings)` قائمة بأرقام تعريف جميع مستويات الاشتراك التي يمكن للمستخدم الوصول إليها حاليًا تتضمّن القائمة المستوى النشط حاليًا وجميع المستويات أدناه.
`snippet.membershipsDuration`	`object` يحتوي هذا العنصر على معلومات عن المدة الإجمالية لاشتراك العضو الحالي بدون النظر إلى مستويات الأسعار. يحتوي الحقل `snippet.membershipsDetails.membershipsDurationAtLevel[]` بعد ذلك على قائمة بالعناصر التي تحتوي على تفاصيل عن فترة الاشتراك التي تمكّن خلالها العضو من الوصول إلى مستوى اشتراك معيّن. يوضّح المثال التالي كيفية عمل هذه السمات: يشتري أحد المشتركين اشتراكًا جديدًا في كانون الثاني (يناير) في المستوى 1 من الاشتراك ويحتفظ به حتى آذار (مارس). في شهرَي نيسان (أبريل) وأيار (مايو)، ليس لدى العميل عضوية. في حزيران (يونيو)، يعيد المشترك تفعيل اشتراكه مجددًا في المستوى 1. بعد ذلك، في آب (أغسطس)، يُجري المشترك ترقية لاشتراكه إلى المستوى 2. وبالتالي، إذا تم إجراء طلب من واجهة برمجة التطبيقات في تشرين الأول (أكتوبر)، سيحتوي المورد `member` على ما يلي: "membershipsDetails": { "membershipsDuration": { "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7, }, "membershipsDurationAtLevel": [ { "level": "level_1_ID", "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7 }, { "level": "level_2_ID", "memberSince": "2020-08-01T12:00:00", "memberTotalDurationMonths": 2 }, ] }
`snippet.membershipsDuration.memberSince`	`datetime` تاريخ ووقت بدء اشتراك المشترك الحالي. بعبارة أخرى، أصبح للمشترك اشتراكًا مستمرًا منذ هذا التاريخ والوقت. يُرجى العِلم أنّه قد تم إنفاق فترات مختلفة من الاشتراك في مستويات عضوية مختلفة.
`snippet.membershipsDuration.memberTotalDurationMonths`	`integer` عدد الأشهر التي كان فيها المستخدم مشتركًا، مع التقريب إلى أقرب عدد صحيح تعكس القيمة عدد الأشهر الكاملة التي كان فيها العضو مشتركًا في القناة، ولكن لا يشير الرقم إلى أنّ العضو كان مشتركًا في القناة باستمرار لعدة أشهر.
`snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[]`	`list (of objects)` قائمة بالكائنات التي يحتوي كلّ منها على تفاصيل عن فترة من فترة الاشتراك التي تمكّن خلالها العضو من الوصول إلى مستوى اشتراك معيّن. تتضمّن القائمة كائنًا واحدًا لكل مستوى اشتراك يمكن للعضو الوصول إليه حاليًا.
`snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level`	`string` رقم تعريف مستوى العضوية. تتطابق القيمة مع قيمة سمة `id` في مورد `membershipsLevel`.
`snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince`	`datetime` التاريخ والوقت اللذان أصبح فيهما بإمكان المشترك الاستفادة من مستوى العضوية المحدّد. وبعبارة أخرى، كان بإمكان المشترك الاستفادة من المستوى باستمرار منذ هذا التاريخ والوقت. يُرجى العِلم أنّه قد تم إنفاق فترات مختلفة من الاشتراك في مستويات عضوية أعلى.
`snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths`	`integer` عدد الأشهر التي تمكّن فيها المستخدم من الوصول إلى المستوى المحدّد، مع التقريب إلى أقرب عدد صحيح تعكس القيمة عدد الأشهر الكاملة التي تمكّن فيها العضو من الوصول إلى المستوى، ولكنّ الرقم لا يشير إلى أنّ العضو كان لديه اشتراكًا مستمرًا طوال هذا العدد من الأشهر.