Channels

تتيح واجهة برمجة التطبيقات الآن إمكانية تصنيف قناتك أو فيديوهاتك على أنّها "محتوى مخصّص للأطفال". بالإضافة إلى ذلك، تتضمّن الموارد channel وvideo الآن سمة تحدّد حالة "محتوى مخصّص للأطفال" الخاصة بالقناة أو الفيديو. تم أيضًا تعديل "بنود خدمة YouTube API" و"سياسات المطوّرين" في 10 يناير 2020. لمزيد من المعلومات، يُرجى الاطّلاع على سجلّ النُسخ السابقة لخدمة YouTube Data API وبنود خدمة YouTube API.

يحتوي مورد channel على معلومات حول قناة على YouTube.

الطُرق

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

list
تعرض هذه السمة مجموعة من موارد channel (صفر أو أكثر) تتطابق مع معايير الطلب. جرّب الميزة الآن.
تعديل
تعديل البيانات الوصفية لقناة معيّنة يُرجى العِلم أنّ هذه الطريقة تتيح حاليًا تعديل كائنَي brandingSettings وinvideoPromotion في المورد channel وخصائصهما الفرعية فقط. جرّب الميزة الآن.

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

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

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

الخصائص

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

الخصائص
kind string
يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channel.
etag etag
تمثّل هذه السمة علامة Etag لهذا المورد.
id string
المعرّف الذي يستخدمه YouTube لتحديد القناة بشكل فريد.
snippet object
يحتوي العنصر snippet على تفاصيل أساسية حول القناة، مثل عنوانها ووصفها وصورها المصغّرة.
snippet.title string
تمثّل هذه السمة عنوان القناة.
snippet.description string
وصف القناة يبلغ الحد الأقصى لطول قيمة السمة 1000 حرف.
snippet.customUrl string
تمثّل هذه السمة عنوان URL المخصّص للقناة. يوضّح مركز مساعدة YouTube متطلبات الأهلية للحصول على عنوان URL مخصّص بالإضافة إلى كيفية إعداده.
snippet.publishedAt datetime
تاريخ إنشاء القناة ووقت إنشائها يتم تحديد القيمة بتنسيق ISO 8601.
snippet.thumbnails object
خريطة للصور المصغّرة المرتبطة بالقناة بالنسبة إلى كل عنصر في الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى حول الصورة المصغّرة.

عند عرض الصور المصغّرة في تطبيقك، تأكَّد من أنّ الرمز البرمجي يستخدم عناوين URL للصور تمامًا كما يتم عرضها في ردود واجهة برمجة التطبيقات. على سبيل المثال، يجب ألا يستخدم تطبيقك النطاق http بدلاً من النطاق https في عنوان URL يتم عرضه في ردّ من واجهة برمجة التطبيقات.

تتوفّر عناوين URL الخاصة بصور مصغّرة للقنوات في النطاق https فقط، وهي الطريقة التي تظهر بها عناوين URL في الردود من واجهة برمجة التطبيقات. قد تظهر صور معطّلة في تطبيقك إذا حاول تحميل صور YouTube من النطاق http. قد تكون صور الصور المصغّرة فارغة للقنوات التي تم إنشاؤها حديثًا وقد يستغرق ملؤها ما يصل إلى يوم واحد.
snippet.thumbnails.(key) object
القيم الصالحة للمفاتيح هي:
  • ‫default: الصورة المصغّرة التلقائية يبلغ عرض الصورة المصغّرة التلقائية للفيديو أو لمورد يشير إلى فيديو، مثل عنصر في قائمة تشغيل أو نتيجة بحث، 120 بكسل وارتفاعها 90 بكسل. يبلغ عرض الصورة المصغّرة التلقائية للقناة 88 بكسل وطولها 88 بكسل.
  • ‫medium: نسخة من الصورة المصغّرة بدقة أعلى بالنسبة إلى فيديو (أو مرجع يشير إلى فيديو)، يبلغ عرض هذه الصورة 320 بكسل وارتفاعها 180 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 240 بكسل وارتفاعها 240 بكسل.
  • ‫high: نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى فيديو (أو مرجع يشير إلى فيديو)، يبلغ عرض هذه الصورة 480 بكسل وارتفاعها 360 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 800 بكسل وارتفاعها 800 بكسل.
snippet.thumbnails.(key).url string
عنوان URL للصورة للحصول على إرشادات إضافية حول استخدام عناوين URL للصور المصغّرة في تطبيقك، يمكنك الاطّلاع على تعريف السمة snippet.thumbnails.
snippet.thumbnails.(key).width unsigned integer
عرض الصورة
snippet.thumbnails.(key).height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.
snippet.defaultLanguage string
لغة النص في السمتَين snippet.title وsnippet.description للمورد channel.
snippet.localized object
يحتوي العنصر snippet.localized على عنوان ووصف مترجمَين للقناة أو على عنوان القناة ووصفها باللغة التلقائية للبيانات الوصفية للقناة.
  • يتم عرض النص المترجَم في مقتطف المورد إذا كان طلب channels.list يستخدم المَعلمة hl لتحديد لغة يجب عرض النص المترجَم بها، وتحدّد قيمة المَعلمة hl لغة تطبيق YouTube، ويتوفّر النص المترجَم بهذه اللغة.
  • يتم عرض البيانات الوصفية للّغة التلقائية في حال عدم تحديد قيمة المَعلمة hl أو في حال تحديد قيمة ولكنّ البيانات الوصفية المترجَمة غير متاحة للّغة المحدّدة.
يحتوي الموقع على قيمة للقراءة فقط. استخدِم العنصر localizations لإضافة بيانات وصفية مترجَمة أو تعديلها أو حذفها.
snippet.localized.title string
عنوان القناة المترجَم
snippet.localized.description string
وصف القناة المترجَم
snippet.country string
البلد المرتبط بالقناة لضبط قيمة هذه السمة، عدِّل قيمة السمة brandingSettings.channel.country.
contentDetails object
يغلّف العنصر contentDetails معلومات عن محتوى القناة.
contentDetails.relatedPlaylists object
إنّ العنصر relatedPlaylists هو خريطة تحدّد قوائم التشغيل المرتبطة بالقناة، مثل الفيديوهات التي تم تحميلها على القناة أو فيديوهات أعجبتك. يمكنك استرداد أيّ من قوائم التشغيل هذه باستخدام طريقة playlists.list.
contentDetails.relatedPlaylists.likes string
معرّف قائمة التشغيل التي تتضمّن فيديوهات أعجبتك في القناة. استخدِم الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر إلى هذه القائمة أو إزالتها منها.
contentDetails.relatedPlaylists.favorites string
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة معرّف قائمة التشغيل التي تتضمّن الفيديوهات المفضّلة في القناة. استخدِم الطريقتَين playlistItems.insert وplaylistItems.delete لإضافة عناصر إلى هذه القائمة أو إزالتها منها.

يُرجى العِلم أنّ YouTube قد أوقف وظيفة الفيديوهات المفضّلة. على سبيل المثال، تم إيقاف السمة statistics.favoriteCount للمورد video نهائيًا في 28 أغسطس 2015. ونتيجةً لذلك، ولأسباب تاريخية، قد تحتوي قيمة هذه السمة على رقم تعريف قائمة تشغيل يشير إلى قائمة تشغيل فارغة، وبالتالي لا يمكن استرجاعها.
contentDetails.relatedPlaylists.uploads string
تمثّل هذه السمة معرّف قائمة التشغيل التي تتضمّن الفيديوهات المحمّلة على القناة. استخدِم طريقة videos.insert لتحميل فيديوهات جديدة وطريقة videos.delete لحذف الفيديوهات التي تم تحميلها سابقًا.
statistics object
يغلّف العنصر statistics إحصاءات القناة.
statistics.viewCount unsigned long

مجموع عدد مرات مشاهدة جميع الفيديوهات بجميع التنسيقات في قناة معيّنة

اعتبارًا من 24 أغسطس 2026، سيتم تعديل مقياس "viewCount" ليحتسب المشاهدات عند بدء تشغيل الفيديو في جميع التنسيقات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts) على القناة (يشمل ذلك التشغيل التلقائي، وتمرير المؤشر فوق الفيديو، والنقر لتشغيله).

statistics.commentCount unsigned long
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة عدد التعليقات على القناة.
statistics.subscriberCount unsigned long
عدد المشتركين في القناة يتم تقريب هذه القيمة إلى ثلاثة أرقام معنوية. لمزيد من التفاصيل حول كيفية تقريب أعداد المشتركين، يُرجى الاطّلاع على سجلّ النُسخ السابقة أو مركز مساعدة YouTube.
statistics.hiddenSubscriberCount boolean
يشير إلى ما إذا كان عدد المشتركين في القناة مرئيًا للجميع.
statistics.videoCount unsigned long
عدد الفيديوهات العلنية التي تم تحميلها إلى القناة يُرجى العِلم أنّ القيمة تعكس عدد الفيديوهات العلنية في القناة فقط، حتى بالنسبة إلى مالكي القناة. ويتوافق هذا السلوك مع الأعداد المعروضة على موقع YouTube الإلكتروني.
topicDetails object
يحتوي العنصر topicDetails على معلومات حول المواضيع المرتبطة بالقناة.

ملاحظة مهمة: لمزيد من التفاصيل حول التغييرات المتعلّقة بمعرّفات المواضيع، يُرجى الاطّلاع على تعريف السمة topicDetails.topicIds[] وسجلّ النُسخ السابقة.
topicDetails.topicIds[] list
قائمة بمعرّفات المواضيع المرتبطة بالقناة

تم إيقاف هذه السمة نهائيًا اعتبارًا من 10 تشرين الثاني (نوفمبر) 2016. وستبقى متاحة حتى 10 تشرين الثاني (نوفمبر) 2017.

ملاحظة مهمة: بسبب إيقاف Freebase وواجهة برمجة التطبيقات Freebase API نهائيًا، بدأ استخدام معرّفات المواضيع بطريقة مختلفة اعتبارًا من 27 شباط (فبراير) 2017. في ذلك الوقت، بدأ YouTube في عرض مجموعة صغيرة من معرّفات المواضيع المنظَّمة.

topicDetails.topicCategories[] list
قائمة بعناوين URL على Wikipedia تصف محتوى القناة
status object
يتضمّن العنصر status معلومات حول حالة خصوصية القناة.
status.privacyStatus string
حالة خصوصية القناة.

في ما يلي القيم الصالحة لهذه السمة:
  • private
  • public
  • unlisted
status.isLinked boolean
تُستخدَم لتحديد ما إذا كانت بيانات القناة تحدّد هوية مستخدم مرتبط حاليًا باسم مستخدم على YouTube أو حساب على Google+. إنّ المستخدم الذي لديه أحد هذه الروابط لديه هوية علنية على YouTube، وهي شرط أساسي لعدة إجراءات، مثل تحميل الفيديوهات.
status.longUploadsStatus string
تشير إلى ما إذا كانت القناة مؤهلة لتحميل فيديوهات تزيد مدتها عن 15 دقيقة. لا يتم عرض هذه السمة إلا إذا سمح مالك القناة بطلب البيانات من واجهة برمجة التطبيقات. لمزيد من المعلومات حول هذه الميزة، يُرجى الاطّلاع على مركز مساعدة YouTube.

في ما يلي القيم الصالحة لهذه السمة:
  • allowed: يمكن لهذه القناة تحميل فيديوهات تزيد مدّتها عن 15 دقيقة.
  • disallowed: لا يمكن لهذه القناة تحميل فيديوهات تزيد مدتها عن 15 دقيقة أو أنّها غير مؤهَّلة لذلك. تكون القناة مؤهّلة لتحميل فيديوهات طويلة فقط إذا كانت في وضع جيد وفقًا لإرشادات منتدى YouTube ولم يتم حظر أي من محتواها في جميع أنحاء العالم من خلال Content ID.

    بعد أن يحلّ مالك القناة المشاكل التي تمنع القناة من تحميل فيديوهات أطول، ستعود القناة إلى الحالة allowed أو eligible.
  • eligible – هذه القناة مؤهّلة لتحميل فيديوهات تزيد مدّتها عن 15 دقيقة. ومع ذلك، على مالك القناة أولاً تفعيل إمكانية تحميل فيديوهات أطول من خلال تأكيد الحساب عبر الهاتف. لمزيد من التفاصيل حول هذه الميزة، يُرجى الانتقال إلى مركز مساعدة YouTube.
status.madeForKids boolean
تشير هذه القيمة إلى ما إذا كانت القناة مصنّفة على أنّها موجّهة للأطفال، وتتضمّن الحالة الحالية للقناة في ما يتعلّق بتصنيف "محتوى مخصّص للأطفال". على سبيل المثال، يمكن تحديد الحالة استنادًا إلى قيمة السمة selfDeclaredMadeForKids. لمزيد من المعلومات حول ضبط إعدادات الجمهور لقناتك أو فيديوهاتك أو أحداث البث، يُرجى الانتقال إلى مركز مساعدة YouTube .
status.selfDeclaredMadeForKids boolean
في طلب channels.update، تتيح هذه السمة لمالك القناة تصنيفها على أنّها موجّهة إلى الأطفال. لا يتم عرض قيمة السمة إلا إذا وافق مالك القناة على طلب البيانات من واجهة برمجة التطبيقات.
brandingSettings object
يحتوي العنصر brandingSettings على معلومات حول العلامة التجارية للقناة.
brandingSettings.channel object
يغلّف العنصر channel خصائص العلامة التجارية لصفحة القناة.
brandingSettings.channel.title string
عنوان القناة يجب ألا يتجاوز عدد أحرف العنوان 30 حرفًا.
brandingSettings.channel.description string
وصف القناة الذي يظهر في مربّع معلومات القناة على صفحة قناتك يبلغ الحد الأقصى لطول قيمة السمة 1000 حرف.
brandingSettings.channel.keywords string
الكلمات الرئيسية المرتبطة بقناتك القيمة هي قائمة سلاسل مفصولة بمسافات. قد يتم اقتطاع الكلمات الرئيسية للقناة إذا تجاوزت الحدّ الأقصى المسموح به للطول وهو 500 حرف أو إذا كانت تحتوي على علامات اقتباس غير مُلغاة ("). يُرجى العِلم أنّ الحدّ الأقصى المسموح به وهو 500 حرف لا ينطبق على كل كلمة رئيسية، بل على الطول الإجمالي لكل الكلمات الرئيسية.
brandingSettings.channel.trackingAnalyticsAccountId string
معرّف حساب "إحصاءات Google" الذي تريد استخدامه لتتبُّع عدد الزيارات إلى قناتك وقياسه.
brandingSettings.channel.unsubscribedTrailer string
الفيديو الذي يجب تشغيله في وحدة الفيديو المميّز في طريقة عرض التصفّح في صفحة القناة للمشاهدين غير المشتركين. قد يظهر للمشاهدين المشتركين فيديو مختلف يسلط الضوء على نشاط القناة الأحدث.

في حال تحديد هذه السمة، يجب أن تكون قيمتها هي معرّف فيديو على YouTube علني أو غير مُدرَج يملكه مالك القناة.
brandingSettings.channel.defaultLanguage string
لغة النص في السمتَين snippet.title وsnippet.description للمورد channel.
brandingSettings.channel.country string
تمثّل هذه السمة البلد المرتبط بالقناة. عدِّل هذه السمة لضبط قيمة السمة snippet.country.
brandingSettings.watch object
ملاحظة: تم إيقاف هذا العنصر وجميع سماته الفرعية نهائيًا.

يغلّف العنصر watch خصائص العلامة التجارية لصفحات المشاهدة الخاصة بفيديوهات القناة.
brandingSettings.watch.textColor string
ملاحظة: تم إيقاف هذه السمة نهائيًا.

لون النص في المنطقة التي تحمل العلامة التجارية في صفحة مشاهدة الفيديو
brandingSettings.watch.backgroundColor string
ملاحظة: تم إيقاف هذه السمة نهائيًا.

لون خلفية المساحة المخصّصة للعلامة التجارية في صفحة مشاهدة الفيديو
brandingSettings.watch.featuredPlaylistId string
ملاحظة: تم إيقاف هذه السمة نهائيًا. وتعرض واجهة برمجة التطبيقات خطأً إذا حاولت ضبط قيمتها.
brandingSettings.image object
تم إيقاف هذا الموقع وجميع مواقعه الفرعية نهائيًا.

يتضمّن العنصر image معلومات حول الصور التي تظهر على صفحة القناة أو صفحات مشاهدة الفيديوهات.
brandingSettings.image.bannerImageUrl string
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة عنوان URL لصورة البانر المعروضة على صفحة القناة على موقع YouTube الإلكتروني. يجب أن تكون الصورة بدقة 1060 × 175 بكسل.
brandingSettings.image.bannerMobileImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة البانر التي تظهر على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة أبعاد الصورة هي 640 × 175 بكسل.
brandingSettings.image.watchIconImageUrl string
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة عنوان URL للصورة التي تظهر فوق مشغّل الفيديو. هذه صورة بارتفاع 25 بكسل وبعرض مرن لا يمكن أن يتجاوز 170 بكسل. في حال عدم تقديم هذه الصورة، سيظهر اسم قناتك بدلاً منها.
brandingSettings.image.trackingImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لبكسل تتبُّع بحجم 1×1 بكسل يمكن استخدامه لجمع إحصاءات عن مشاهدات صفحات القناة أو الفيديو.
brandingSettings.image.bannerTabletLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة منخفضة تظهر على صفحة القناة في تطبيقات الأجهزة اللوحية. الحدّ الأقصى لحجم الصورة هو 1138 بكسل × 188 بكسل.
brandingSettings.image.bannerTabletImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر تظهر على صفحة القناة في تطبيقات الأجهزة اللوحية تبلغ أبعاد الصورة 1707 بكسل × 283 بكسل.
brandingSettings.image.bannerTabletHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة تظهر على صفحة القناة في تطبيقات الأجهزة اللوحية الحد الأقصى لحجم الصورة هو 2276 بكسل × 377 بكسل.
brandingSettings.image.bannerTabletExtraHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة عالية جدًا تظهر على صفحة القناة في تطبيقات الأجهزة اللوحية. الحدّ الأقصى لحجم الصورة هو 2560 بكسل × 424 بكسل.
brandingSettings.image.bannerMobileLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة منخفضة تظهر على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 320 بكسل × 88 بكسل.
brandingSettings.image.bannerMobileMediumHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة عنوان URL لصورة بانر بدقة متوسطة يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحد الأقصى لحجم الصورة هو 960 × 263 بكسل.
brandingSettings.image.bannerMobileHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة يتم عرضها على صفحة القناة في التطبيقات المتوافقة مع الأجهزة الجوّالة. الحدّ الأقصى لحجم الصورة هو 1280 بكسل × 360 بكسل.
brandingSettings.image.bannerMobileExtraHdImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة عالية جدًا تظهر على صفحة القناة في التطبيقات للأجهزة الجوّالة. الحدّ الأقصى لحجم الصورة هو 1440 × 395 بكسل.
brandingSettings.image.bannerTvImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة عالية جدًا تظهر على صفحة القناة في تطبيقات التلفزيون الحدّ الأقصى لحجم الصورة هو 2120 × 1192 بكسل.
brandingSettings.image.bannerTvLowImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة منخفضة تظهر على صفحة القناة في تطبيقات التلفزيون. الحد الأقصى لحجم الصورة هو 854 × 480 بكسل.
brandingSettings.image.bannerTvMediumImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر بدقة متوسطة تظهر على صفحة القناة في تطبيقات التلفزيون يبلغ الحدّ الأقصى لحجم الصورة 1280 بكسل × 720 بكسل.
brandingSettings.image.bannerTvHighImageUrl string
تم إيقاف هذه السمة نهائيًا.

عنوان URL لصورة بانر عالية الدقة تظهر على صفحة القناة في تطبيقات التلفزيون. الحدّ الأقصى لحجم الصورة هو 1920 بكسل × 1080 بكسل.
brandingSettings.image.bannerExternalUrl string
تحدّد هذه السمة موقع صورة البانر التي يستخدمها YouTube لإنشاء أحجام مختلفة لصورة البانر في القناة.
brandingSettings.hints[] list
تم إيقاف هذه السمة وجميع سماتها الفرعية نهائيًا.

يغلف الكائن hints سمات إضافية للعلامة التجارية.
brandingSettings.hints[].property string
تم إيقاف هذه السمة نهائيًا.

تمثّل هذه السمة موقعًا.
brandingSettings.hints[].value string
تم إيقاف هذه السمة نهائيًا.

قيمة السمة.
auditDetails object
يغلّف العنصر auditDetails بيانات القناة التي تقيّمها شبكة متعددة القنوات (MCN) عند تحديد ما إذا كانت ستقبل قناة معيّنة أو ترفضها. يُرجى العِلم أنّ أي طلب بيانات من واجهة برمجة التطبيقات يسترد جزء المورد هذا يجب أن يقدّم رمز تفويض يحتوي على النطاق https://www.googleapis.com/auth/youtubepartner-channel-audit. بالإضافة إلى ذلك، يجب إبطال أي رمز مميّز يستخدم هذا النطاق عندما تقرّر الشبكة المتعدّدة القنوات قبول القناة أو رفضها أو في غضون أسبوعين من تاريخ إصدار الرمز المميّز.
auditDetails.overallGoodStanding boolean
يشير هذا الحقل إلى ما إذا كانت هناك أي مشاكل في القناة. يمثّل هذا الحقل حاليًا نتيجة العملية المنطقية AND على السمات communityGuidelinesGoodStanding وcopyrightStrikesGoodStanding وcontentIdClaimsGoodStanding، ما يعني أنّ هذه السمة لها القيمة true إذا كانت جميع السمات الأخرى لها القيمة true أيضًا. ومع ذلك، ستكون قيمة هذه السمة false إذا كانت قيمة أيّ من هذه السمات false. يُرجى العِلم أنّ المنهجية المستخدَمة لضبط قيمة هذه السمة عرضة للتغيير.
auditDetails.communityGuidelinesGoodStanding boolean
تشير إلى ما إذا كانت القناة تحترم إرشادات المنتدى في YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
يشير إلى ما إذا كانت القناة قد تلقّت أي إنذارات بسبب انتهاك حقوق الطبع والنشر.
auditDetails.contentIdClaimsGoodStanding boolean
يشير إلى ما إذا كانت القناة تتضمّن أي مطالبات لم يتم حلّها.
contentOwnerDetails object
يغلّف العنصر contentOwnerDetails بيانات القناة التي تظهر فقط لشريك YouTube الذي ربط القناة بحسابه في "إدارة المحتوى".
contentOwnerDetails.contentOwner string
تمثّل هذه السمة رقم تعريف مالك المحتوى المرتبط بالقناة.
contentOwnerDetails.timeLinked datetime
تاريخ ووقت ربط القناة بحساب مالك المحتوى يتم تحديد القيمة بالتنسيق ISO 8601.
localizations object
يحتوي العنصر localizations على ترجمات للبيانات الوصفية الخاصة بالقناة.
localizations.(key) object
تمثّل لغة البيانات الوصفية المترجمة المرتبطة بقيمة المفتاح. القيمة هي سلسلة تحتوي على رمز لغة BCP-47.
localizations.(key).title string
تمثّل هذه السمة عنوان القناة المترجَم.
localizations.(key).description string
وصف القناة المترجَم