Channels

اکنون API از قابلیت علامت‌گذاری کانال یا ویدیوهای شما به‌عنوان «ساخته‌شده برای کودکان» پشتیبانی می‌کند. علاوه‌براین، منابع channel و video اکنون حاوی ویژگی‌ای هستند که وضعیت «ساخته‌شده برای کودکان» آن کانال یا ویدیو را مشخص می‌کند. «شرایط خدمات سرویس‌های YouTube API» و «خط‌مشی‌های توسعه‌دهنده» نیز در ۱۰ ژانویه ۲۰۲۰ به‌روزرسانی شدند. برای اطلاعات بیشتر، سابقه ویرایش سرویس YouTube Data API و شرایط خدمات سرویس‌های YouTube API را ببینید.

منبع channel حاوی اطلاعاتی درباره کانال YouTube است.

روش‌ها

«میانای برنامه‌سازی کاربردی» از روش‌های زیر برای منابع channels پشتیبانی می‌کند:

فهرست
مجموعه‌ای از صفر یا بیشتر از 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
شرح کانال. مقدار دارایی حداکثر می‌تواند ۱۰۰۰ نویسه باشد.
snippet.customUrl string
نشانی وب سفارشی کانال. مرکز راهنمایی YouTube شرایط صلاحیت برای دریافت نشانی وب سفارشی و همچنین نحوه راه‌اندازی نشانی وب را توضیح می‌دهد.
snippet.publishedAt datetime
تاریخ و زمان ایجاد کانال. مقدار در قالب ISO 8601 مشخص شده است.
snippet.thumbnails object
نقشه‌ای از تصاویر کوچک مرتبط با کانال. برای هر شیء در نقشه، کلید نام تصویر کوچک است و مقدار شیئی است که حاوی اطلاعات دیگری درباره تصویر کوچک است.

هنگام نمایش تصاویر کوچک در برنامه‌تان، مطمئن شوید که کد شما از نشانی‌های وب تصویر دقیقاً همان‌طور که در پاسخ‌های API برگردانده می‌شوند استفاده می‌کند. برای مثال، برنامه شما نباید از دامنه http به‌جای دامنه https در نشانی وب برگردانده‌شده در پاسخ API استفاده کند.

نشانی‌های وب ریزعکس کانال فقط در دامنه https دردسترس هستند، که این همان نحوه نمایش نشانی‌های وب در پاسخ‌های API است. اگر برنامه‌تان سعی کند تصاویر YouTube را از دامنه http بار کند، ممکن است تصاویر خراب در برنامه‌تان ببینید. تصاویر ریزعکس ممکن است برای کانال‌های تازه ایجادشده خالی باشد و ممکن است تا یک روز طول بکشد تا پر شود.
snippet.thumbnails.(key) object
مقادیر کلید معتبر عبارت‌اند از:
  • default – تصویر ریزعکس پیش‌فرض. ریزعکس پیش‌فرض برای یک ویدیو – یا منبعی که به یک ویدیو ارجاع می‌دهد، مانند یک مورد فهرست پخش یا نتیجه جستجو – ۱۲۰ پیکسل عرض و ۹۰ پیکسل ارتفاع دارد. ریزعکس پیش‌فرض برای کانال ۸۸ پیکسل عرض و ۸۸ پیکسل ارتفاع دارد.
  • medium – نسخه با وضوح بالاتر از تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو اشاره می‌کند)، این تصویر ۳۲۰ پیکسل عرض و ۱۸۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۲۴۰ پیکسل عرض و ۲۴۰ پیکسل ارتفاع دارد.
  • high – نسخه با وضوح بالای تصویر کوچک. برای ویدیو (یا منبعی که به ویدیو ارجاع می‌دهد)، این تصویر ۴۸۰ پیکسل عرض و ۳۶۰ پیکسل ارتفاع دارد. برای کانال، این تصویر ۸۰۰ پیکسل عرض و ۸۰۰ پیکسل ارتفاع دارد.
snippet.thumbnails.(key).url string
نشانی وب تصویر. برای دستورالعمل‌های بیشتر درباره استفاده از نشانی‌های وب ریزعکس در برنامه‌تان، تعریف ویژگی 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 در تاریخ ۲۸ اوت ۲۰۱۵ منسوخ شد. درنتیجه، به دلایل تاریخی، این مقدار ویژگی ممکن است حاوی شناسه فهرست پخشی باشد که به یک فهرست پخش خالی اشاره دارد و بنابراین قابل واکشی نیست.
contentDetails.relatedPlaylists.uploads string
شناسه فهرست پخشی که حاوی ویدیوهای بارگذاری‌شده کانال است. از روش videos.insert برای بارگذاری ویدیوهای جدید و از روش videos.delete برای حذف ویدیوهای بارگذاری‌شده قبلی استفاده کنید.
statistics object
شیء statistics آمار کانال را دربرمی‌گیرد.
statistics.viewCount unsigned long

مجموع تعداد دفعاتی که همه ویدیوها در همه قالب‌ها برای یک کانال مشاهده شده‌اند.

از ۲۴ اوت ۲۰۲۶، برای همه قالب‌های ویدیو (طولانی، زنده، و «کوته‌ویدیوها») در کانال، 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
فهرستی از شناسه‌های موضوع مرتبط با کانال.

این ویژگی از ۱۰ نوامبر ۲۰۱۶ منسوخ شده است. این شناسه تا ۱۰ نوامبر ۲۰۱۷ پشتیبانی خواهد شد.

مهم: به‌دلیل منسوخ شدن Freebase و Freebase API، شناسه موضوعات از ۲۷ فوریه ۲۰۱۷ به‌طور متفاوتی کار می‌کنند. در آن زمان، YouTube شروع به برگرداندن مجموعه کوچکی از شناسه‌های موضوعی انتخاب‌شده کرد.

topicDetails.topicCategories[] list
فهرستی از نشانی‌های وب ویکی‌پدیا که محتوای کانال را توصیف می‌کنند.
status object
شیء status اطلاعات مربوط به وضعیت حریم خصوصی کانال را کپسوله می‌کند.
status.privacyStatus string
وضعیت حریم خصوصی کانال.

مقادیر معتبر برای این ویژگی عبارتند از:
  • private
  • public
  • unlisted
status.isLinked boolean
نشان می‌دهد که آیا داده‌های کانال کاربری را شناسایی می‌کند که قبلاً به نام کاربری YouTube یا حساب Google+‎ پیوند شده است یا نه. کاربری که یکی از این پیوندها را دارد، ازقبل دارای هویت عمومی YouTube است که پیش‌نیاز چندین اقدام، مانند بارگذاری ویدیو، است.
status.longUploadsStatus string
نشان می‌دهد که آیا کانال واجدشرایط بارگذاری ویدیوهای طولانی‌تر از ۱۵ دقیقه است یا خیر. این ویژگی فقط درصورتی برگردانده می‌شود که مالک کانال درخواست API را مجاز کرده باشد. برای اطلاعات بیشتر درباره این ویژگی، به مرکز راهنمایی YouTube مراجعه کنید.

مقادیر معتبر برای این ویژگی عبارتند از:
  • allowed – این کانال می‌تواند ویدیوهای طولانی‌تر از ۱۵ دقیقه بارگذاری کند.
  • disallowed – این کانال قادر یا واجدشرایط بارگذاری ویدیوهای طولانی‌تر از ۱۵ دقیقه نیست. کانال تنها درصورتی واجدشرایط بارگذاری ویدیوهای طولانی است که براساس رهنمودهای انجمن YouTube در وضعیت خوبی باشد و محتوای آن هیچ‌گونه مسدودسازی جهانی Content ID نداشته باشد.

    پس‌از اینکه مالک کانال مشکلات مانع بارگذاری ویدیوهای طولانی را برطرف کرد، کانال به وضعیت allowed یا eligible بازمی‌گردد.
  • eligible – این کانال واجدشرایط بارگذاری ویدیوهای طولانی‌تر از ۱۵ دقیقه است. بااین‌حال، مالک کانال باید ابتدا امکان بارگذاری ویدیوهای طولانی‌تر را ازطریق درستی‌سنجی تلفنی فعال کند. برای جزئیات بیشتر درباره این ویژگی، به مرکز راهنمایی YouTube مراجعه کنید.
status.madeForKids boolean
این مقدار نشان می‌دهد که آیا کانال به‌عنوان کودک‌محور تعیین شده است یا نه، و شامل وضعیت فعلی «ساخته‌شده برای کودکان» کانال است. برای مثال، ممکن است وضعیت براساس مقدار ویژگی selfDeclaredMadeForKids تعیین شود. برای اطلاعات بیشتر درباره تنظیم مخاطب برای کانال، ویدیوها، یا همه‌فرستی‌های خود، به مرکز راهنمایی YouTube مراجعه کنید .
status.selfDeclaredMadeForKids boolean
در درخواست channels.update، این ویژگی به مالک کانال اجازه می‌دهد کانال را به‌عنوان کانال ویژه کودکان تعیین کند. مقدار مشخصه فقط درصورتی برگردانده می‌شود که مالک کانال درخواست API را مجاز کرده باشد.
brandingSettings object
شیء brandingSettings اطلاعات مربوط به نمانام‌سازی کانال را کپسوله‌سازی می‌کند.
brandingSettings.channel object
شیء channel ویژگی‌های نمانام‌سازی صفحه کانال را دربرمی‌گیرد.
brandingSettings.channel.title string
عنوان کانال. حداکثر طول عنوان ۳۰ نویسه است.
brandingSettings.channel.description string
شرح کانال که در چارگوش اطلاعات کانال در صفحه کانالتان نشان داده می‌شود. حداکثر طول مقدار ویژگی ۱۰۰۰ نویسه است.
brandingSettings.channel.keywords string
کلیدواژه‌های مرتبط با کانال شما. مقدار فهرستی از رشته‌ها است که با فاصله از هم جدا شده‌اند. اگر کلیدواژه‌های کانال از حداکثر طول مجاز ۵۰۰ نویسه فراتر بروند یا حاوی علامت نقل‌قول بدون گریز (") باشند، ممکن است کوتاه شوند. توجه داشته باشید که حد ۵۰۰ نویسه برای هر کلیدواژه نیست، بلکه حد کل طول همه کلیدواژه‌ها است.
brandingSettings.channel.trackingAnalyticsAccountId string
شناسه حساب Google Analytics که می‌خواهید برای ردیابی و اندازه‌گیری ترافیک کانالتان استفاده کنید.
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
این دارایی منسوخ شده است.

نشانی وب تصویر برنما که در صفحه کانال در وب‌سایت YouTube نشان داده می‌شود. تصویر ۱۰۶۰ پیکسل در ۱۷۵ پیکسل است.
brandingSettings.image.bannerMobileImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویر برنمای نشان‌داده‌شده در صفحه کانال در برنامه‌های تلفن همراه. تصویر ۶۴۰ پیکسل در ۱۷۵ پیکسل است.
brandingSettings.image.watchIconImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویری که بالای پخش‌کننده ویدیو ظاهر می‌شود. این تصویر ۲۵ پیکسل ارتفاع دارد و عرض آن انعطاف‌پذیر است و نمی‌تواند از ۱۷۰ پیکسل بیشتر باشد. اگر این تصویر را ارائه ندهید، نام کانال شما به‌جای تصویر نمایش داده خواهد شد.
brandingSettings.image.trackingImageUrl string
این ویژگی منسوخ شده است.

نشانی وب پیکسل ردیابی ۱ در ۱ پیکسلی که می‌تواند برای جمع‌آوری آمار بازدید از کانال یا صفحات ویدیو استفاده شود.
brandingSettings.image.bannerTabletLowImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنما با وضوح پایین که در صفحه کانال در برنامه‌های رایانه لوحی نمایش داده می‌شود. حداکثر اندازه تصویر ۱۱۳۸ پیکسل در ۱۸۸ پیکسل است.
brandingSettings.image.bannerTabletImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنمایی که در صفحه کانال در برنامه‌های رایانه لوحی نمایش داده می‌شود. ابعاد تصویر ۱۷۰۷ پیکسل در ۲۸۳ پیکسل است.
brandingSettings.image.bannerTabletHdImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنمای وضوح بالا که در صفحه کانال در برنامه‌های رایانه لوحی نمایش داده می‌شود. حداکثر اندازه تصویر ۲۲۷۶ پیکسل در ۳۷۷ پیکسل است.
brandingSettings.image.bannerTabletExtraHdImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنما با وضوح بسیار بالا که در صفحه کانال در برنامه‌های رایانه لوحی نمایش داده می‌شود. حداکثر اندازه تصویر ۲۵۶۰ پیکسل در ۴۲۴ پیکسل است.
brandingSettings.image.bannerMobileLowImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویر برنما با وضوح پایین که در صفحه کانال در برنامه‌های تلفن همراه نمایش داده می‌شود. حداکثر اندازه تصویر ۳۲۰ پیکسل در ۸۸ پیکسل است.
brandingSettings.image.bannerMobileMediumHdImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنما با وضوح متوسط که در صفحه کانال در برنامه‌های تلفن همراه نمایش داده می‌شود. حداکثر اندازه تصویر ۹۶۰ پیکسل در ۲۶۳ پیکسل است.
brandingSettings.image.bannerMobileHdImageUrl string
این دارایی منسوخ شده است.

نشانی وب برای تصویر برنمای با وضوح بالا که در صفحه کانال در برنامه‌های تلفن همراه نمایش داده می‌شود. حداکثر اندازه تصویر ۱۲۸۰ پیکسل در ۳۶۰ پیکسل است.
brandingSettings.image.bannerMobileExtraHdImageUrl string
این ویژگی منسوخ شده است.

نشانی وب برای تصویر برنمای با وضوح بسیار بالا که در صفحه کانال در برنامه‌های تلفن همراه نمایش داده می‌شود. حداکثر اندازه تصویر ۱۴۴۰ پیکسل در ۳۹۵ پیکسل است.
brandingSettings.image.bannerTvImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویر برنما با وضوح بسیار بالا که در صفحه کانال در برنامه‌های تلویزیون نمایش داده می‌شود. حداکثر اندازه تصویر ۲۱۲۰ پیکسل در ۱۱۹۲ پیکسل است.
brandingSettings.image.bannerTvLowImageUrl string
این دارایی منسوخ شده است.

نشانی وب تصویر برنمای وضوح پایین که در صفحه کانال در برنامه‌های تلویزیون نمایش داده می‌شود. حداکثر اندازه تصویر ۸۵۴ پیکسل در ۴۸۰ پیکسل است.
brandingSettings.image.bannerTvMediumImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویر برنما با وضوح متوسط که در صفحه کانال در برنامه‌های تلویزیون نمایش داده می‌شود. حداکثر اندازه تصویر ۱۲۸۰ پیکسل در ۷۲۰ پیکسل است.
brandingSettings.image.bannerTvHighImageUrl string
این ویژگی منسوخ شده است.

نشانی وب تصویر برنما با وضوح بالا که در صفحه کانال در برنامه‌های تلویزیون نمایش داده می‌شود. حداکثر اندازه تصویر ۱۹۲۰ پیکسل در ۱۰۸۰ پیکسل است.
brandingSettings.image.bannerExternalUrl string
این ویژگی مکان تصویر برنما را مشخص می‌کند که YouTube از آن برای تولید اندازه‌های مختلف تصویر برنما برای کانال استفاده می‌کند.
brandingSettings.hints[] list
این دارایی و همه دارایی‌های فرزند آن منسوخ شده‌اند.

شیء hints ویژگی‌های نمانام‌سازی اضافی را دربرمی‌گیرد.
brandingSettings.hints[].property string
این ویژگی منسوخ شده است.

یک دارایی.
brandingSettings.hints[].value string
این دارایی منسوخ شده است.

مقدار خصوصیت.
auditDetails object
شیء auditDetails داده‌های کانال را کپسوله می‌کند که یک شبکه چندکانالی (MCN) هنگام تصمیم‌گیری برای پذیرش یا رد یک کانال خاص ارزیابی می‌کند. توجه داشته باشید که هر درخواست API که این بخش منبع را بازیابی می‌کند باید یک توکن مجوز ارائه دهد که حاوی دامنه https://www.googleapis.com/auth/youtubepartner-channel-audit باشد. علاوه‌براین، هر نشانه‌ای که از آن دامنه استفاده می‌کند باید زمانی که MCN تصمیم به پذیرش یا رد کانال می‌گیرد یا ظرف دو هفته از تاریخ صدور نشانه، لغو شود.
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
شرح بومی‌سازی‌شده کانال.