Channels

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

แหล่งข้อมูล channel มีข้อมูลเกี่ยวกับช่อง YouTube

วิธีการ

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

list
แสดงผลคอลเล็กชันทรัพยากร channel อย่างน้อย 0 รายการที่ตรงกับเกณฑ์คำขอ ลองเลย
อัปเดต
อัปเดตข้อมูลเมตาของช่อง โปรดทราบว่าปัจจุบันวิธีนี้รองรับเฉพาะการอัปเดตออบเจ็กต์ 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 – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นของวิดีโอหรือทรัพยากรที่อ้างอิงไปยังวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120px และสูง 90px ภาพขนาดย่อเริ่มต้นของช่องคือกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – ภาพปกเวอร์ชันที่มีความละเอียดสูงกว่า สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 320px และสูง 180px สำหรับช่อง รูปภาพนี้จะกว้าง 240 พิกเซลและสูง 240 พิกเซล
  • high – รูปภาพขนาดย่อเวอร์ชันความละเอียดสูง สำหรับวิดีโอ (หรือทรัพยากรที่อ้างถึงวิดีโอ) รูปภาพนี้จะกว้าง 480 พิกเซล และสูง 360 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 800 พิกเซลและสูง 800 พิกเซล
snippet.thumbnails.(key).url string
URL ของรูปภาพ ดูคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails สำหรับหลักเกณฑ์เพิ่มเติมเกี่ยวกับการใช้ URL ภาพขนาดย่อในแอปพลิเคชันของคุณ
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
จำนวนครั้งที่มีการดูช่อง
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 นาที อย่างไรก็ตาม เจ้าของช่องจะต้องเปิดใช้ความสามารถในการอัปโหลดวิดีโอที่ยาวขึ้นที่ https://www.youtube.com/verify ก่อน ดูรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่ศูนย์ช่วยเหลือของ 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
คำอธิบายช่องที่แปลเป็นภาษาท้องถิ่น