Channels

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

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

เมธอด

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

list
แสดงผลคอลเล็กชันของทรัพยากร channel ตั้งแต่ 0 รายการขึ้นไปที่ตรงกับเกณฑ์คำขอ ลองใช้เลย
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 มีชื่อและคำอธิบายที่แปลแล้วสำหรับช่อง หรือมีชื่อและคำอธิบายของช่องในภาษาเริ่มต้นสำหรับข้อมูลเมตาของช่อง
  • ระบบจะแสดงข้อความที่แปลแล้วในข้อมูลโค้ดของทรัพยากรหากคำขอ 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 สิงหาคม 2569 เป็นต้นไป ระบบจะอัปเดต viewCount ให้นับยอดดูทันทีที่วิดีโอเริ่มเล่น (รวมถึงการเล่นอัตโนมัติ การวางเคอร์เซอร์เหนือวิดีโอ และการคลิก/แตะเพื่อเล่น) สำหรับวิดีโอทุกรูปแบบ (แบบยาว, ไลฟ์สด และ Shorts) ในช่อง
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 สำหรับพิกเซลการติดตามขนาด 1x1 พิกเซลที่ใช้รวบรวมสถิติยอดดูหน้าช่องหรือหน้าวิดีโอได้
brandingSettings.image.bannerTabletLowImageUrl string
เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว

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

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

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

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

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

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

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

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

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

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

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

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