نحن بصدد تعديل Data API لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
ChannelSections
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحتوي مورد channelSection على معلومات حول مجموعة من
الفيديوهات التي اختارت القناة عرضها. على سبيل المثال، يمكن أن يعرض أحد الأقسام
الفيديوهات الأخيرة أو الفيديوهات الأكثر رواجًا أو الفيديوهات من قائمة تشغيل واحدة أو أكثر
يمكن للقناة إنشاء 10 أرفف كحد أقصى.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد channelSections:
- list
- تعرض قائمة بموارد
channelSection التي تتطابق مع معايير طلب واجهة برمجة التطبيقات.
تجربة ذلك الآن
- إدراج
- إضافة قسم قناة إلى قناة المستخدم الذي تمت المصادقة عليه يمكن للقناة إنشاء 10 أرفف كحد أقصى.
التجربة الآن
- تعديل
- يعدّل قسمًا في القناة.
التجربة الآن
- حذف
- حذف قسم في القناة
التجربة الآن
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
| أماكن إقامة |
kind |
string
تحدد هذه السياسة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channelSection. |
etag |
etag
تشير هذه السمة إلى علامة هذا المورد. |
id |
string
المعرّف الذي يستخدمه YouTube لتحديد قسم القناة بشكل فريد. |
snippet |
object
يحتوي العنصر snippet على تفاصيل أساسية حول قسم القناة، مثل نوعه وعنوانه. |
snippet.type |
string
نوع قسم القناة.
القيم الصالحة لهذه السمة هي:
allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
|
snippet.channelId |
string
المعرّف الذي يستخدمه YouTube لتحديد القناة التي نشرت قسم القناة بشكل فريد |
snippet.title |
string
تمثّل هذه السمة عنوان القسم. يمكنك فقط ضبط عنوان قسم من القناة له القيمة snippet.type إما multiplePlaylists أو multipleChannels، وفي الواقع، عليك تحديد عنوان عند إدراج أو تحديث أي من هذين النوعين من الأقسام. إذا حددت عنوانًا لأنواع أخرى من أقسام القناة، سيتم تجاهل القيمة.
تتضمّن قيمة هذا الموقع 100 حرف كحدٍّ أقصى، وقد تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و<. |
snippet.position |
unsigned integer
موضع القسم في صفحة القناة تستخدم هذه السمة فهرسًا يستند إلى 0. تحدد القيمة 0 القسم الأول الذي يظهر على القناة، وتحدّد القيمة 1 القسم الثاني، وما إلى ذلك.
في حال عدم تحديد قيمة لهذه السمة عند إدراج قسم في القناة، سيكون السلوك التلقائي هو عرض القسم الجديد أخيرًا. |
contentDetails |
object
يحتوي العنصر contentDetails على تفاصيل حول محتوى قسم القناة، مثل قائمة قوائم التشغيل أو القنوات المعروضة في القسم. |
contentDetails.playlists[] |
list
قائمة بمعرّف واحد أو أكثر من معرّفات قوائم التشغيل الظاهرة في أحد أقسام القناة. يجب تحديد قائمة بأرقام تعريف قوائم التشغيل إذا كانت السمة snippet.type الخاصة بمورد channelSection إما singlePlaylist أو multiplePlaylists، ويجب عدم تحديد هذه السمة لأنواع أخرى من الأقسام. إذا كان النوع singlePlaylist، يجب أن تحدّد هذه القائمة رقم تعريف واحدًا فقط لقائمة التشغيل. |
contentDetails.channels[] |
list
قائمة بمعرّف قناة واحد أو أكثر تظهر في قسم من القنوات. يجب تحديد قائمة بمعرّفات القنوات إذا كانت السمة snippet.type في مورد channelSection هي multipleChannels، ويجب عدم تحديد هذه السمة لأنواع أخرى من الأقسام. لا يمكنك تضمين قناتك الخاصة في القائمة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA \u003ccode\u003echannelSection\u003c/code\u003e resource contains information about a set of videos that a channel features, such as latest uploads, popular uploads, or playlists.\u003c/p\u003e\n"],["\u003cp\u003eChannels can manage their featured videos using the API, which allows creating, listing, updating, and deleting \u003ccode\u003echannelSection\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eA channel can have a maximum of 10 sections, each with a specified type like \u003ccode\u003esinglePlaylist\u003c/code\u003e, \u003ccode\u003emultipleChannels\u003c/code\u003e, or \u003ccode\u003epopularUploads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003echannelSection\u003c/code\u003e has properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003esnippet\u003c/code\u003e, and \u003ccode\u003econtentDetails\u003c/code\u003e, which specify details about the section and its contents.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econtentDetails\u003c/code\u003e property can contain a list of either playlists or channels featured in the section, depending on the \u003ccode\u003esnippet.type\u003c/code\u003e property.\u003c/p\u003e\n"]]],["Channel sections feature a curated set of videos, like latest or popular uploads, or playlists. API methods allow listing, inserting, updating, and deleting these sections. A channel can have up to 10 sections. Each section contains `snippet` and `contentDetails` objects which describes the type, title, position, and the featured channels/playlists. The type can be single or multiple playlists, or channels, amongst others. Specific titles are required for some types and cannot include \"\u003c\" or \"\u003e\".\n"],null,["# ChannelSections\n\nA **channelSection** resource contains information about a set of\nvideos that a channel has chosen to feature. For example, a section could feature a channel's\nlatest uploads, most popular uploads, or videos from one or more playlists. \n\n\nA channel can create a maximum of 10 shelves.\n\nMethods\n-------\n\nThe API supports the following methods for `channelSections` resources:\n\n[list](/youtube/v3/docs/channelSections/list)\n: Returns a list of `channelSection` resources that match the API request criteria.\n [Try it now](/youtube/v3/docs/channelSections/list#usage).\n\n[insert](/youtube/v3/docs/channelSections/insert)\n: Adds a channel section to the authenticated user's channel. A channel can create a maximum of 10 shelves.\n [Try it now](/youtube/v3/docs/channelSections/insert#usage).\n\n[update](/youtube/v3/docs/channelSections/update)\n: Updates a channel section.\n [Try it now](/youtube/v3/docs/channelSections/update#usage).\n\n[delete](/youtube/v3/docs/channelSections/delete)\n: Deletes a channel section.\n [Try it now](/youtube/v3/docs/channelSections/delete#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `channelSections` resource: \n\n```carbon\n{\n \"#kind\": \"youtube#channelSection\",\n \"#etag\": etag,\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.type\": string,\n \"#snippet.channelId\": string,\n \"#snippet.title\": string,\n \"#snippet.position\": unsigned integer\n },\n \"#contentDetails\": {\n \"#contentDetails.playlists[]\": [\n string\n ],\n \"#contentDetails.channels[]\": [\n string\n ]\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#channelSection`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the channel section. |\n| `snippet` | `object` The `snippet` object contains basic details about the channel section, such as its type and title. |\n| snippet.`type` | `string` The channel section's type. Valid values for this property are: - `allPlaylists` - `completedEvents` - `liveEvents` - `multipleChannels` - `multiplePlaylists` - `popularUploads` - `recentUploads` - `singlePlaylist` - `subscriptions` - `upcomingEvents` |\n| snippet.`channelId` | `string` The ID that YouTube uses to uniquely identify the channel that published the channel section. |\n| snippet.`title` | `string` The section's title. You can only set the title of a channel section that has a `snippet.type` value of either `multiplePlaylists` or `multipleChannels`, and, in fact, you must specify a title when inserting or updating either of those types of sections. If you specify a title for other types of channel sections, the value will be ignored. This property's value has a maximum length of 100 characters and may contain all valid UTF-8 characters except **\\\u003c** and **\\\u003e**. |\n| snippet.`position` | `unsigned integer` The section's position on the channel page. This property uses a 0-based index. A value of `0` identifies the first section that appears on the channel, a value of `1` identifies the second section, and so forth. If you do not specify a value for this property when inserting a channel section, the default behavior is to display the new section last. |\n| `contentDetails` | `object` The `contentDetails` object contains details about the channel section's content, such as a list of playlists or channels featured in the section. |\n| contentDetails.`playlists[]` | `list` A list of one or more playlist IDs that are featured in a channel section. You must specify a list of playlist IDs if the `channelSection` resource's `snippet.type` property is either `singlePlaylist` or `multiplePlaylists`, and this property should not be specified for other types of sections. If the type is `singlePlaylist`, this list must specify exactly one playlist ID. |\n| contentDetails.`channels[]` | `list` A list of one or more channel IDs that are featured in a channel section. You must specify a list of channel IDs if the `channelSection` resource's `snippet.type` property is `multipleChannels`, and this property should not be specified for other types of sections. You cannot include your own channel in the list. |"]]
