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 مخصّص، بالإضافة إلى كيفية إعداد عنوان 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

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

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

بالنسبة إلى جميع تنسيقات الفيديوهات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts) على القناة، يتضمّن مقياس viewCount المشاهدات الجماعية عندما يشاهد عدة أشخاص المحتوى معًا على شاشة تلفزيون.

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
الوصف المترجَم للقناة