ตอนนี้ API รองรับการตั้งสถานะช่องหรือวิดีโอเป็น "สร้างมาเพื่อเด็ก" แล้ว นอกจากนี้ ขณะนี้ทรัพยากร
channel
และ video
ยังมีพร็อพเพอร์ตี้ที่ระบุสถานะ "สร้างมาเพื่อเด็ก" ของช่องหรือวิดีโอนั้นด้วย นอกจากนี้ เรายังได้ปรับปรุงนโยบายสำหรับนักพัฒนาซอฟต์แวร์และข้อกำหนดในการให้บริการของบริการ YouTube API ไปเมื่อวันที่ 10 มกราคม 2020 ด้วย ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไขบริการ YouTube Data API และข้อกำหนดในการให้บริการของบริการ YouTube API
ทรัพยากร channel
มีข้อมูลเกี่ยวกับช่อง YouTube
เมธอด
API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร channels
การนําเสนอทรัพยากร
โครงสร้าง 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 ที่แสดงในการตอบกลับของ APIURL ภาพปกของช่องจะใช้ได้เฉพาะในโดเมน https ซึ่งเป็นลักษณะที่ URL จะปรากฏในการตอบกลับของ API คุณอาจเห็นรูปภาพที่ใช้งานไม่ได้ในแอปพลิเคชันหากแอปพลิเคชันพยายามโหลดรูปภาพ YouTube จากโดเมน http ช่องที่สร้างขึ้นใหม่อาจไม่มีภาพปกและอาจใช้เวลาถึง 1 วันจึงจะแสดงภาพปก |
snippet.thumbnails.(key) |
object คีย์-ค่าที่ใช้ได้มีดังนี้
|
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 มีชื่อและคำอธิบายที่แปลแล้วสำหรับช่อง หรือมีชื่อและคำอธิบายของช่องในภาษาเริ่มต้นสำหรับข้อมูลเมตาของช่อง
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.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 สถานะความเป็นส่วนตัวของช่อง ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.isLinked |
boolean ระบุว่าข้อมูลช่องระบุผู้ใช้ที่ลิงก์กับชื่อผู้ใช้ YouTube หรือบัญชี Google+ อยู่แล้วหรือไม่ ผู้ใช้ที่มีลิงก์ใดลิงก์หนึ่งเหล่านี้จะมีข้อมูลประจำตัว YouTube แบบสาธารณะอยู่แล้ว ซึ่งเป็นข้อกําหนดเบื้องต้นสําหรับการดําเนินการหลายอย่าง เช่น การอัปโหลดวิดีโอ |
status.longUploadsStatus |
string ระบุว่าช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีหรือไม่ ระบบจะแสดงพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่เจ้าของช่องให้สิทธิ์คำขอ API ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่ศูนย์ช่วยเหลือของ 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 คำอธิบายช่องที่แปลแล้ว |