ตอนนี้ 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 ของรูปภาพ ดูคำจำกัดความของพร็อพเพอร์ตี้ 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 มีชื่อและคำอธิบายที่แปลแล้วสำหรับช่อง หรือมีชื่อและคำอธิบายของช่องเป็นภาษาเริ่มต้นสำหรับข้อมูลเมตาของช่อง
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 คำอธิบายช่องที่แปลเป็นภาษาท้องถิ่น |