Sponsors
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملاحظة: تم إيقاف العمل بهذا المورد اعتبارًا من 31 آذار (مارس) 2020. تم استبداله بالمورد
member. يمكنك العثور على
معلومات حول هذا المورد في مستندات YouTube Data API.
وفي إطار هذا الإيقاف، سيتم إيقاف طريقة
sponsors.list نهائيًا
في 30 أيلول (سبتمبر) 2020 أو بعد هذا التاريخ. على عملاء واجهة برمجة التطبيقات تعديل الاستدعاءات إلى الطريقة
sponsors.list لاستخدام طريقة
members.list بدلاً منها.
يُمثِّل مورد sponsor منتسبًا إلى قناة على YouTube (كان يُعرَف سابقًا باسم "جهة راعية").
يقدّم المُنتسِب دعمًا ماليًا متكرّرًا إلى منشئ المحتوى ويتلقّى
مزايا خاصة. على سبيل المثال، يمكن للمنتسبين الدردشة عندما يفعّل منشئ المحتوى وضع المحادثة الحصرية للمنتسبين.
الطُرق
تتوافق واجهة برمجة التطبيقات مع الطرق التالية لموردَين (sponsors):
- list
- يتضمن قائمة بجهات راعية لقناة. يجب أن يأذن مالك القناة بطلب واجهة برمجة التطبيقات.
التجربة الآن
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
| أماكن إقامة |
kind |
string
تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#sponsor. |
etag |
etag
Etag لهذا المورد. |
id |
string
المعرّف الذي تحدّده منصة YouTube لتعريف الجهة الراعية بشكل فريد |
snippet |
object
يحتوي الكائن snippet على تفاصيل عن الجهة الراعية. |
snippet.channelId |
string
يحدّد هذا المعرّف القناة التي تقدّم الرعاية. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis \u003ccode\u003esponsors\u003c/code\u003e resource is deprecated as of March 31, 2020, and has been replaced by the \u003ccode\u003emember\u003c/code\u003e resource, with the \u003ccode\u003esponsors.list\u003c/code\u003e method no longer supported after September 30, 2020.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003esponsor\u003c/code\u003e resource represents a YouTube channel member who provides recurring monetary support and receives special benefits.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esponsors.list\u003c/code\u003e method allowed API clients to list the sponsors for a channel, but now they should use \u003ccode\u003emembers.list\u003c/code\u003e instead.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esponsors\u003c/code\u003e resource contains properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e which includes detailed information like the channel ID, display name, profile image URL, and the date they became a sponsor.\u003c/p\u003e\n"]]],["The `sponsors` resource, representing channel members, was deprecated on March 31, 2020, and replaced by the `members` resource. The `sponsors.list` method will be unsupported after September 30, 2020, requiring API clients to use `members.list` instead. A sponsor provides recurring support and receives benefits. The resource contains properties such as `kind`, `etag`, `id`, and `snippet`. `snippet` include the channel's ID, details about the sponsor, and when the user became a sponsor.\n"],null,["# Sponsors\n\nNote: This resource is deprecated as of March 31, 2020. It has been replaced by the [member](/youtube/v3/docs/members) resource. You can find information about that resource in the YouTube Data API documentation. \n\nAs part of this deprecation, the `sponsors.list` method will no longer be supported on or after September 30, 2020. API clients should update calls to the `sponsors.list` method to use the [members.list](/youtube/v3/docs/members/list) method instead.\n\nA **sponsor** resource represents a channel member (formerly known as a \"sponsor\") for a YouTube channel.\nA member provides recurring monetary support to a creator and receives\nspecial benefits. For example, members are able to chat when the creator turns on members-only mode for a chat.\n\nMethods\n-------\n\nThe API supports the following methods for `sponsors` resources:\n\n[list](/youtube/v3/live/docs/sponsors/list)\n: Lists sponsors for a channel. The API request must be authorized by the channel owner.\n [Try it now](/youtube/v3/live/docs/sponsors/list#try-it).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `sponsors` resource: \n\n```text\n{\n \"kind\": \"youtube#sponsor\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": string,\n \"sponsorDetails\": {\n \"channelId\": string,\n \"channelUrl\": string,\n \"displayName\": string,\n \"profileImageUrl\": string\n },\n \"sponsorSince\": datetime\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#sponsor`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube assigns to uniquely identify the sponsor. |\n| `snippet` | `object` The `snippet` object contains details about the sponsor. |\n| snippet.`channelId` | `string` This ID identifies the channel being sponsored. |\n| snippet.`sponsorDetails` | `object` This object contains details about the sponsor. |\n| snippet.sponsorDetails.`channelId` | `string` The YouTube channel ID. |\n| snippet.sponsorDetails.`channelUrl` | `string` The channel's URL. |\n| snippet.sponsorDetails.`displayName` | `string` The channel's display name. |\n| snippet.sponsorDetails.`profileImageUrl` | `string` The channels's avatar URL. |\n| snippet.`sponsorSince` | `datetime` The date and time when the user became a sponsor. The value is specified in [ISO 8601](//www.w3.org/TR/NOTE-datetime) (`YYYY-MM-DDThh:mm:ss.sZ`) format. |"]]
