Channels

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

แหล่งข้อมูล 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 – ภาพขนาดย่อเวอร์ชันความละเอียดสูงขึ้น สำหรับวิดีโอ (หรือแหล่งข้อมูลที่กล่าวถึงวิดีโอ) รูปภาพนี้กว้าง 320 พิกเซลและสูง 180 พิกเซล สำหรับช่อง รูปภาพนี้จะกว้าง 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 อักขระสูงสุดที่อนุญาต หรือ หากมีเครื่องหมายคำพูดที่ไม่ได้ใช้ Escape (") โปรดทราบว่า 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
คำอธิบายช่องที่แปลเป็นภาษาท้องถิ่น