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[] بعد ذلك قائمة بالعناصر التي تحتوي على تفاصيل حول مدة انتساب معيّنة تمكّن العضو خلالها من الوصول إلى مستوى انتساب معيّن. يوضّح المثال التالي كيفية عمل هذه الخصائص: يشتري أحد المشتركين اشتراكًا جديدًا في شهر كانون الثاني (يناير) من مستوى الانتساب الأول ويظل متاحًا حتى شهر آذار (مارس). في شهرَي نيسان (أبريل) وأيار (مايو)، لا يملك العضو اشتراكًا داعمًا. وفي شهر حزيران (يونيو)، سيُعيد العضو تفعيل انتسابه من المستوى الأول. بعد ذلك، ستتم ترقية الانتساب إلى المستوى 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 عدد الأشهر، التي يتم تقريبها إلى أقرب عدد صحيح، والتي كان بإمكان المستخدم الوصول إلى المستوى المحدَّد بها. تعكس القيمة عدد الأشهر الكاملة التي حصل فيها العضو على إمكانية الوصول إلى المستوى، ولكن لا يشير الرقم ضمنًا إلى أن العضو قد حصل باستمرار على انتساب لمدة عدة أشهر.