Channels

ตอนนี้ API รองรับการตั้งสถานะช่องหรือวิดีโอเป็น "สร้างมาเพื่อเด็ก" แล้ว นอกจากนี้ ขณะนี้ทรัพยากร channel และ video ยังมีพร็อพเพอร์ตี้ที่ระบุสถานะ "สร้างมาเพื่อเด็ก" ของช่องหรือวิดีโอนั้นด้วย นอกจากนี้ เรายังได้ปรับปรุงนโยบายสำหรับนักพัฒนาซอฟต์แวร์และข้อกำหนดในการให้บริการของบริการ YouTube API ไปเมื่อวันที่ 10 มกราคม 2020 ด้วย ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไขบริการ YouTube Data API และข้อกำหนดในการให้บริการของบริการ YouTube API

ทรัพยากร channel มีข้อมูลเกี่ยวกับช่อง YouTube

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร channels

list
แสดงคอลเล็กชันทรัพยากร channel อย่างน้อย 1 รายการที่ตรงกับเกณฑ์คำขอ ลองใช้เลย
update
อัปเดตข้อมูลเมตาของช่อง โปรดทราบว่าปัจจุบันเมธอดนี้รองรับเฉพาะการอัปเดตออบเจ็กต์ 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
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#channel
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่ไม่ซ้ำกัน
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับช่อง เช่น ชื่อ คำอธิบาย และภาพปก
snippet.title string
ชื่อช่อง
snippet.description string
คําอธิบายของช่อง ค่าของพร็อพเพอร์ตี้มีความยาวได้สูงสุด 1,000 อักขระ
snippet.customUrl string
URL ที่กำหนดเองของช่อง ศูนย์ช่วยเหลือของ YouTube จะอธิบายข้อกำหนดของการได้รับสิทธิ์สำหรับรับ URL ที่กำหนดเอง รวมถึงวิธีตั้งค่า URL
snippet.publishedAt datetime
วันที่และเวลาที่สร้างช่อง ค่าที่ระบุอยู่ในรูปแบบ ISO 8601
snippet.thumbnails object
แผนที่รูปภาพขนาดย่อที่เชื่อมโยงกับช่อง สําหรับออบเจ็กต์แต่ละรายการในแผนที่ คีย์คือชื่อรูปภาพขนาดย่อ และค่าคือออบเจ็กต์ที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ

เมื่อแสดงภาพขนาดย่อในแอปพลิเคชัน โปรดตรวจสอบว่าโค้ดของคุณใช้ URL รูปภาพเหมือนกับที่แสดงในการตอบกลับของ API ตัวอย่างเช่น แอปพลิเคชันไม่ควรใช้โดเมน http แทนโดเมน https ใน URL ที่แสดงในการตอบกลับของ API

URL ภาพปกของช่องจะใช้ได้เฉพาะในโดเมน https ซึ่งเป็นลักษณะที่ URL จะปรากฏในการตอบกลับของ API คุณอาจเห็นรูปภาพที่ใช้งานไม่ได้ในแอปพลิเคชันหากแอปพลิเคชันพยายามโหลดรูปภาพ YouTube จากโดเมน http ช่องที่สร้างขึ้นใหม่อาจไม่มีภาพปกและอาจใช้เวลาถึง 1 วันจึงจะแสดงภาพปก
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 มีชื่อและคำอธิบายที่แปลแล้วสำหรับช่อง หรือมีชื่อและคำอธิบายของช่องในภาษาเริ่มต้นสำหรับข้อมูลเมตาของช่อง
  • ระบบจะแสดงข้อความที่แปลแล้วในสnippet ทรัพยากรหากคำขอ 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
จำนวนครั้งที่มีการดูช่อง
statistics.commentCount unsigned long
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

จำนวนความคิดเห็นของช่อง
statistics.subscriberCount unsigned long
จำนวนผู้ติดตามของช่อง ค่านี้จะปัดเศษลงเป็นเลขนัยสำคัญ 3 หลัก ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีปัดเศษจำนวนผู้ติดตามได้ที่ประวัติการแก้ไขหรือศูนย์ช่วยเหลือของ 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 นาทีหรือไม่ ระบบจะแสดงพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่เจ้าของช่องให้สิทธิ์คำขอ API ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่ศูนย์ช่วยเหลือของ YouTube

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
  • allowed – ช่องนี้อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาทีได้
  • disallowed – ช่องนี้ไม่สามารถหรือไม่มีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที ช่องจะมีสิทธิ์อัปโหลดวิดีโอขนาดยาวก็ต่อเมื่ออยู่ในสถานะดีตามหลักเกณฑ์ของชุมชน YouTube และไม่มีบล็อก Content ID ทั่วโลกในเนื้อหา

    หลังจากเจ้าของช่องแก้ไขปัญหาที่ทำให้อัปโหลดวิดีโอที่ยาวขึ้นไม่ได้แล้ว ช่องจะเปลี่ยนกลับไปอยู่ในสถานะ allowed หรือ eligible
  • eligible – ช่องนี้มีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที แต่เจ้าของช่องต้องเปิดใช้ความสามารถในการอัปโหลดวิดีโอที่ยาวขึ้นผ่านการยืนยันทางโทรศัพท์ก่อน ดูรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่ศูนย์ช่วยเหลือของ YouTube
status.madeForKids boolean
ค่านี้ระบุว่าช่องได้รับการกำหนดให้เป็นช่องที่มุ่งเป้าไปยังเด็กหรือไม่ และจะมีสถานะ "สร้างมาเพื่อเด็ก" ของช่องในปัจจุบัน เช่น ระบบอาจกำหนดสถานะตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมของช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube
status.selfDeclaredMadeForKids boolean
ในคำขอ channels.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องกำหนดให้ช่องมีเด็กเป็นกลุ่มเป้าหมายได้ ระบบจะแสดงค่าพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คําขอ API เท่านั้น
brandingSettings object
ออบเจ็กต์ brandingSettings จะรวมข้อมูลเกี่ยวกับการสร้างแบรนด์ของช่อง
brandingSettings.channel object
ออบเจ็กต์ channel แสดงถึงพร็อพเพอร์ตี้การสร้างแบรนด์ของหน้าช่อง
brandingSettings.channel.title string
ชื่อช่อง ชื่อมีความยาวได้สูงสุด 30 อักขระ
brandingSettings.channel.description string
คำอธิบายช่องซึ่งปรากฏในช่องข้อมูลช่องในหน้าช่อง ค่าของพร็อพเพอร์ตี้มีความยาวได้สูงสุด 1,000 อักขระ
brandingSettings.channel.keywords string
คีย์เวิร์ดที่เชื่อมโยงกับช่องของคุณ ค่าดังกล่าวเป็นรายการสตริงที่คั่นด้วยเว้นวรรค คีย์เวิร์ดของแชแนลอาจถูกตัดให้สั้นลงหากมีความยาวเกิน 500 อักขระซึ่งเป็นขีดจำกัดสูงสุดที่อนุญาต หรือหากมีคําพูดที่ยกมา (") ที่ไม่ได้ใช้เครื่องหมายหลีก โปรดทราบว่าขีดจํากัด 500 อักขระไม่ใช่ขีดจํากัดต่อคีย์เวิร์ด แต่คือขีดจํากัดของความยาวรวมของคีย์เวิร์ดทั้งหมด
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
หมายเหตุ: เราได้เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว API จะแสดงข้อผิดพลาดหากคุณพยายามตั้งค่า
brandingSettings.image object
เราเลิกใช้งานพร็อพเพอร์ตี้นี้และพร็อพเพอร์ตี้ย่อยทั้งหมดแล้ว

ออบเจ็กต์ image จะรวมข้อมูลเกี่ยวกับรูปภาพที่แสดงในหน้าช่องหรือหน้าดูวิดีโอของช่อง
brandingSettings.image.bannerImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่แสดงในหน้าช่องบนเว็บไซต์ YouTube รูปภาพมีขนาด 1060 x 175 พิกเซล
brandingSettings.image.bannerMobileImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ รูปภาพมีขนาด 640 x 175 พิกเซล
brandingSettings.image.watchIconImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพที่ปรากฏเหนือวิดีโอเพลเยอร์ รูปภาพนี้มีความสูง 25 พิกเซลและความกว้างที่ปรับได้ไม่เกิน 170 พิกเซล หากคุณไม่ได้ให้รูปภาพนี้ไว้ ชื่อช่องของคุณจะปรากฏแทนรูปภาพ
brandingSettings.image.trackingImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของพิกเซลการติดตามขนาด 1 x 1 พิกเซลซึ่งสามารถใช้รวบรวมสถิติยอดดูของช่องหรือหน้าวิดีโอ
brandingSettings.image.bannerTabletLowImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดต่ำซึ่งแสดงในหน้าช่องในแอปพลิเคชันแท็บเล็ต ขนาดสูงสุดของรูปภาพคือ 1138 x 188 พิกเซล
brandingSettings.image.bannerTabletImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันแท็บเล็ต รูปภาพมีขนาด 1707 x 283 พิกเซล
brandingSettings.image.bannerTabletHdImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ความละเอียดสูงที่แสดงในหน้าช่องในแอปพลิเคชันแท็บเล็ต ขนาดสูงสุดของรูปภาพคือ 2276 x 377 พิกเซล
brandingSettings.image.bannerTabletExtraHdImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดสูงพิเศษซึ่งแสดงในหน้าช่องในแอปพลิเคชันแท็บเล็ต ขนาดรูปภาพสูงสุดคือ 2560 x 424 พิกเซล
brandingSettings.image.bannerMobileLowImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดต่ำซึ่งแสดงในหน้าช่องในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ ขนาดสูงสุดของรูปภาพคือ 320 x 88 พิกเซล
brandingSettings.image.bannerMobileMediumHdImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ความละเอียดปานกลางที่แสดงในหน้าช่องในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ ขนาดรูปภาพสูงสุดคือ 960 x 263 พิกเซล
brandingSettings.image.bannerMobileHdImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ความละเอียดสูงที่แสดงในหน้าช่องในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ ขนาดรูปภาพสูงสุดคือ 1280 x 360 พิกเซล
brandingSettings.image.bannerMobileExtraHdImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดสูงมากซึ่งแสดงในหน้าช่องในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ ขนาดสูงสุดของรูปภาพคือ 1440 x 395 พิกเซล
brandingSettings.image.bannerTvImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดสูงพิเศษซึ่งแสดงในหน้าช่องในแอปพลิเคชันทีวี ขนาดรูปภาพสูงสุดคือ 2120 x 1192 พิกเซล
brandingSettings.image.bannerTvLowImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ที่มีความละเอียดต่ำซึ่งแสดงในหน้าช่องในแอปพลิเคชันทีวี ขนาดรูปภาพสูงสุดคือ 854 x 480 พิกเซล
brandingSettings.image.bannerTvMediumImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ความละเอียดปานกลางที่แสดงในหน้าช่องในแอปพลิเคชันทีวี ขนาดรูปภาพสูงสุดคือ 1280 x 720 พิกเซล
brandingSettings.image.bannerTvHighImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

URL ของรูปภาพแบนเนอร์ความละเอียดสูงที่แสดงในหน้าช่องในแอปพลิเคชันทีวี ขนาดรูปภาพสูงสุดคือ 1920 x 1080 พิกเซล
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 ตัดสินใจยอมรับหรือปฏิเสธแชแนล หรือภายใน 2 สัปดาห์นับจากวันที่ออกโทเค็น
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
คำอธิบายช่องที่แปลแล้ว