ทรัพยากร liveChatMessage
แสดงข้อความแชทในแชทสดของ YouTube ทรัพยากรอาจมีรายละเอียดเกี่ยวกับข้อความประเภทต่างๆ รวมถึงข้อความที่โพสต์ใหม่หรือกิจกรรมการให้เงินสนับสนุนของแฟนๆ
ฟีเจอร์แชทสดจะเปิดใช้โดยค่าเริ่มต้นสำหรับการถ่ายทอดสด และจะพร้อมใช้งานขณะถ่ายทอดสด (หลังจากกิจกรรมสิ้นสุดลง แชทสดจะไม่พร้อมใช้งานสำหรับกิจกรรมนั้นอีกต่อไป)
วิธีการ
API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร liveChatMessages
รายการ
การนำเสนอทรัพยากร
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร liveChatMessages
{ "kind": "youtube#liveChatMessage", "etag": etag, "id": string, "snippet": { "type": string, "liveChatId": string, "authorChannelId": string, "publishedAt": datetime, "hasDisplayContent": boolean, "displayMessage": string, "fanFundingEventDetails": { "amountMicros": unsigned long, "currency": string, "amountDisplayString": string, "userComment": string }, "textMessageDetails": { "messageText": string }, "messageDeletedDetails": { "deletedMessageId": string }, "userBannedDetails": { "bannedUserDetails": { "channelId": string, "channelUrl": string, "displayName": string, "profileImageUrl": string }, "banType": string, "banDurationSeconds": unsigned long }, "memberMilestoneChatDetails": { "userComment": string, "memberMonth": unsigned integer, "memberLevelName": string }, "newSponsorDetails": { "memberLevelName": string, "isUpgrade": bool }, "superChatDetails": { "amountMicros": unsigned long, "currency": string, "amountDisplayString": string, "userComment": string, "tier": unsigned integer }, "superStickerDetails": { "superStickerMetadata": { "stickerId": string, "altText": string, "language": string }, "amountMicros": unsigned long, "currency": string, "amountDisplayString": string, "tier": unsigned integer }, "membershipGiftingDetails": { "giftMembershipsCount": integer, "giftMembershipsLevelName": string }, "giftMembershipReceivedDetails": { "memberLevelName": string, "gifterChannelId": string, "associatedMembershipGiftingMessageId": string }, }, "authorDetails": { "channelId": string, "channelUrl": string, "displayName": string, "profileImageUrl": string, "isVerified": boolean, "isChatOwner": boolean, "isChatSponsor": boolean, "isChatModerator": boolean }, }
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#liveChatMessage |
etag |
etag Etag ของแหล่งข้อมูลนี้ |
id |
string รหัสที่ YouTube กำหนดเพื่อระบุข้อความแบบไม่ซ้ำ |
snippet |
object ออบเจ็กต์ snippet มีรายละเอียดหลักเกี่ยวกับข้อความแชท |
snippet.type |
string ประเภทข้อความ พร็อพเพอร์ตี้นี้จะปรากฏอยู่เสมอ และค่าจะเป็นตัวกําหนดว่ามีฟิลด์ใดอยู่ในทรัพยากร ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
snippet.liveChatId |
string รหัสที่ระบุแชทสดที่เชื่อมโยงกับข้อความโดยไม่ซ้ำกัน ระบบจะส่งรหัสแชทสดที่เชื่อมโยงกับการออกอากาศกลับมาในพร็อพเพอร์ตี้ snippet.liveChatId ของทรัพยากร liveBroadcast |
snippet.authorChannelId |
string รหัสของผู้ใช้ที่เขียนข้อความ ช่องนี้จะมีข้อความประเภทต่อไปนี้เท่านั้น
|
snippet.publishedAt |
datetime วันที่และเวลาที่เผยแพร่ข้อความเป็นครั้งแรก ค่าจะระบุไว้ในรูปแบบ ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) |
snippet.hasDisplayContent |
boolean ระบุว่าข้อความมีเนื้อหาที่ควรแสดงต่อผู้ใช้หรือไม่ |
snippet.displayMessage |
string มีสตริงที่จะแสดงต่อผู้ใช้ ช่องนี้จะไม่แสดงหากประเภทข้อความคือ chatEndedEvent หรือ tombstone |
snippet.fanFundingEventDetails |
object หมายเหตุ: เราเลิกใช้งานออบเจ็กต์นี้และพร็อพเพอร์ตี้ย่อยแล้ว ตั้งแต่วันที่ 28 กุมภาพันธ์ 2017 ทรัพยากร liveChatMessage รายการจะไม่แสดงรายละเอียดกิจกรรมการให้เงินสนับสนุนของแฟนๆ อีกต่อไปออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรมการให้เงินสนับสนุน และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น fanFundingEvent |
snippet.fanFundingEventDetails.amountMicros |
unsigned long หมายเหตุ: เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว จำนวนเงินของกองทุน |
snippet.fanFundingEventDetails.currency |
string หมายเหตุ: เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว สกุลเงินของเงินที่ใช้ซื้อ |
snippet.fanFundingEventDetails.amountDisplayString |
string หมายเหตุ: พร็อพเพอร์ตี้นี้เลิกใช้งานแล้ว สตริงที่แสดงผลซึ่งแสดงจำนวนเงินเงินและสกุลเงินต่อผู้ใช้ |
snippet.fanFundingEventDetails.userComment |
string หมายเหตุ: พร็อพเพอร์ตี้นี้เลิกใช้งานแล้ว ความคิดเห็นที่ผู้ใช้เพิ่มในกิจกรรมการให้เงินสนับสนุนของแฟนๆ นี้ |
snippet.textMessageDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับข้อความ และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น textMessageEvent |
snippet.textMessageDetails.messageText |
string ข้อความของผู้ใช้ |
snippet.messageDeletedDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับข้อความที่ผู้ดูแลแชทหรือเจ้าของช่องการถ่ายทอดสดลบ และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น messageDeletedEvent |
snippet.messageDeletedDetails.deletedMessageId |
string รหัสที่ระบุข้อความที่ถูกลบแบบไม่ซ้ำ ค่านี้เหมือนกับค่าพร็อพเพอร์ตี้ id ของ SMS ต้นฉบับ เช่น หาก textMessageEvent มีค่าพร็อพเพอร์ตี้ id เป็น 123 และข้อความดังกล่าวถูกลบในภายหลัง ค่า snippet.messageDeletedDetails.deletedMessageId สำหรับข้อความนั้นก็จะเป็น 123 หากคุณแคชข้อความแชทหลังจากเรียกข้อมูลข้อความแล้ว ให้ใช้ค่าของพร็อพเพอร์ตี้นี้เพื่อระบุข้อความที่ไม่ควรแสดงอีกต่อไป |
snippet.userBannedDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับผู้ใช้ที่ถูกแบนจากแชท รวมถึงรายละเอียดเกี่ยวกับการแบนด้วย ผู้ใช้สามารถแบนจากแชทอย่างถาวรหรือชั่วคราวได้ |
snippet.userBannedDetails.bannedUserDetails |
object ออบเจ็กต์นี้มีข้อมูลเกี่ยวกับผู้ใช้ที่ถูกแบน |
snippet.userBannedDetails.bannedUserDetails.channelId |
string รหัสช่อง YouTube ของผู้ใช้ที่ถูกแบน |
snippet.userBannedDetails.bannedUserDetails.channelUrl |
string URL ช่อง YouTube ของผู้ใช้ที่ถูกแบน |
snippet.userBannedDetails.bannedUserDetails.displayName |
string ชื่อที่แสดงในช่อง YouTube ของผู้ใช้ที่ถูกแบน |
snippet.userBannedDetails.bannedUserDetails.profileImageUrl |
string รูปโปรไฟล์ช่อง YouTube ของผู้ใช้ที่ถูกแบน |
snippet.userBannedDetails.banType |
string ประเภทของการแบน ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
snippet.userBannedDetails.banDurationSeconds |
unsigned long ระยะเวลาของการแบน พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อค่าพร็อพเพอร์ตี้ snippet.userBannedDetails.banType คือ temporary |
snippet.memberMilestoneChatDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับเหตุการณ์เป้าหมายของสมาชิก และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น memberMilestoneChatEvent |
snippet.memberMilestoneChatDetails.userComment |
string ความคิดเห็นที่สมาชิกเพิ่มเข้ามาในข้อความแชทสุดพิเศษสำหรับสมาชิกนี้ ช่องนี้ว่างเปล่าสำหรับข้อความที่ไม่มีความคิดเห็นจากสมาชิก |
snippet.memberMilestoneChatDetails.memberMonth |
unsigned integer จำนวนเดือนทั้งหมด (ปัดเศษขึ้น) ที่ผู้ชมเป็นสมาชิกที่มอบข้อความแชทสุดพิเศษสำหรับสมาชิกนี้ โดยจำนวนนี้คือจำนวนเดือนเดียวกันกับที่แสดงต่อผู้ใช้ YouTube |
snippet.memberMilestoneChatDetails.memberLevelName |
string ชื่อของระดับที่ผู้ชมเป็นสมาชิก ชื่อระดับจะกำหนดโดยช่อง YouTube ที่เสนอการเป็นสมาชิก ในบางสถานการณ์ ช่องนี้จะไม่ได้รับข้อมูล |
snippet.newSponsorDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรมการประกาศสมาชิกใหม่ ระบบจะตั้งค่าเมื่อเป็นประเภท newSponsorEvent เท่านั้น "สมาชิก" เป็นคำของ "ผู้สนับสนุน"
|
snippet.newSponsorDetails.memberLevelName |
string ชื่อของระดับที่ผู้ชมเป็นสมาชิก ชื่อระดับจะกำหนดโดยช่อง YouTube ที่เสนอการเป็นสมาชิก บางช่องจะไม่ได้รับข้อมูลในบางสถานการณ์ |
snippet.newSponsorDetails.isUpgrade |
bool ระบุว่าผู้ชมเพิ่งอัปเกรดจากระดับที่ต่ำลงหรือไม่ สำหรับผู้ชมที่ไม่ได้เป็นสมาชิก ณ เวลาที่ซื้อ ค่าในช่องคือ false
|
snippet.superChatDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรม Super Chat และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น superChatEvent |
snippet.superChatDetails.amountMicros |
unsigned long ยอดรวมการซื้อในหน่วยไมโครของสกุลเงินที่ใช้ในการซื้อ เช่น หากยอดรวมการซื้อคือ 1 ดอลลาร์ มูลค่าพร็อพเพอร์ตี้ snippet.amountMicros จะเท่ากับ 1000000 |
snippet.superChatDetails.currency |
string สกุลเงินที่ใช้ทำการซื้อ ค่านี้คือรหัสสกุลเงิน ISO 4217 |
snippet.superChatDetails.amountDisplayString |
string สตริง เช่น $1.00 ที่มียอดรวมการซื้อและสกุลเงิน สตริงนี้มีวัตถุประสงค์เพื่อแสดงต่อผู้ใช้ |
snippet.superChatDetails.userComment |
string ความคิดเห็นที่ผู้ใช้เพิ่มในกิจกรรม Super Chat นี้ |
snippet.superChatDetails.tier |
unsigned integer ระดับของข้อความที่มีการชำระเงิน โปรดทราบว่าในทรัพยากร superChatEvent พร็อพเพอร์ตี้ snippet.messageType จะมีค่านี้ระดับจะขึ้นอยู่กับจำนวนเงินที่ใช้ซื้อข้อความ นอกจากนี้ยังกำหนดสีที่ใช้ไฮไลต์ข้อความใน UI ของแชทสด ความยาวข้อความสูงสุด และระยะเวลาที่ปักหมุดทิกเกอร์ข้อความด้วย ข้อมูลระดับของ Super Chat มีอยู่ในศูนย์ช่วยเหลือของ YouTube (ดูส่วนที่ขยายได้เกี่ยวกับรายละเอียดการซื้อ Super Chat) ในรายการนี้ ระดับที่มียอดรวมการซื้อต่ำสุดคือระดับ 1 ส่วนราคาต่ำสุดถัดไปคือระดับ 2 เป็นต้น |
snippet.superStickerDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรม Super Stickers และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น superStickerEvent |
snippet.superStickerDetails.superStickerMetadata |
object รายละเอียดเกี่ยวกับ Super Stickers |
snippet.superStickerDetails.superStickerMetadata.stickerId |
string รหัสที่ไม่ซ้ำกันซึ่งระบุรูปภาพสติกเกอร์ โปรดทราบว่ารูปภาพจะแสดงเป็นส่วนหนึ่งของข้อความ Super Stickers เท่านั้นเมื่อผู้ใช้ดูหน้าต่างแชทบน YouTube แต่ URL ของรูปภาพจะไม่พร้อมใช้งานเมื่อใช้ API คุณสามารถดูรหัสสติกเกอร์ที่เกี่ยวข้องกับ Super Stickers ได้ในไฟล์ CSV นี้ เพื่อเป็นข้อมูลอ้างอิงเท่านั้น |
snippet.superStickerDetails.superStickerMetadata.altText |
string สตริงข้อความที่อธิบายสติกเกอร์ ช่อง snippet.superStickerDetails.superStickerMetadata.language จะระบุภาษาของข้อความ เมื่อเรียกใช้เมธอด liveChatMessages.list ให้ตั้งค่าค่าพารามิเตอร์ hl เป็นภาษาที่เลือกสำหรับข้อความ |
snippet.superStickerDetails.superStickerMetadata.language |
string ภาษาของค่าพร็อพเพอร์ตี้ snippet.superStickerDetails.superStickerMetadata.altText |
snippet.superStickerDetails.amountMicros |
unsigned long ยอดรวมการซื้อในหน่วยไมโครของสกุลเงินที่ใช้ในการซื้อ เช่น หากยอดรวมการซื้อคือ 1 ดอลลาร์ มูลค่าพร็อพเพอร์ตี้ snippet.amountMicros จะเท่ากับ 1000000 |
snippet.superStickerDetails.currency |
string สกุลเงินที่ใช้ทำการซื้อ ค่านี้คือรหัสสกุลเงิน ISO 4217 |
snippet.superStickerDetails.amountDisplayString |
string สตริง เช่น $1.00 ที่มียอดรวมการซื้อและสกุลเงิน สตริงนี้มีวัตถุประสงค์เพื่อแสดงต่อผู้ใช้ |
snippet.superStickerDetails.tier |
unsigned integer ระดับของข้อความที่มีการชำระเงิน โปรดทราบว่าในทรัพยากร superChatEvent พร็อพเพอร์ตี้ snippet.messageType จะมีค่านี้ระดับจะขึ้นอยู่กับจำนวนเงินที่ใช้ซื้อข้อความ นอกจากนี้ยังกำหนดสีที่ใช้ไฮไลต์ข้อความใน UI ของแชทสด ความยาวข้อความสูงสุด และระยะเวลาที่ปักหมุดทิกเกอร์ข้อความไว้ด้วย ข้อมูลระดับต่างๆ ของ Super Chat ซึ่งครอบคลุม Super Stickers จะแสดงอยู่ในศูนย์ช่วยเหลือของ YouTube (ดูส่วนที่ขยายได้เกี่ยวกับรายละเอียดการซื้อ Super Chat) ในรายการนี้ ระดับที่มียอดรวมการซื้อต่ำสุดคือระดับ 1 ส่วนราคาต่ำสุดถัดไปคือระดับ 2 เป็นต้น |
snippet.pollDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับเหตุการณ์ของแบบสำรวจ และจะปรากฏก็ต่อเมื่อประเภทข้อความเป็น pollEvent |
snippet.pollDetails.metadata |
object รายละเอียดเกี่ยวกับเหตุการณ์ของแบบสำรวจ |
snippet.pollDetails.metadata.options |
object ตัวเลือกในแบบสำรวจสด |
snippet.pollDetails.metadata.options.optionText |
string ข้อความของตัวเลือกแบบสำรวจสด |
snippet.pollDetails.metadata.options.questionText |
string ข้อความของคำถามในแบบสำรวจแบบเรียลไทม์ |
snippet.pollDetails.metadata.status |
enum สถานะของกิจกรรมแบบสำรวจสด ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
snippet.membershipGiftingDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรมการซื้อแพ็กเกจสมาชิกแบบของขวัญ และจะปรากฏก็ต่อเมื่อ message type เป็น membershipGiftingEvent |
snippet.membershipGiftingDetails.giftMembershipsCount |
integer จำนวนแพ็กเกจสมาชิกแบบของขวัญที่ผู้ใช้ซื้อ |
snippet.membershipGiftingDetails.giftMembershipsLevelName |
string ชื่อระดับของแพ็กเกจสมาชิกแบบของขวัญที่ผู้ใช้ซื้อ ชื่อระดับจะกำหนดโดยช่อง YouTube ที่เสนอการเป็นสมาชิก บางช่องจะไม่ได้รับข้อมูลในบางสถานการณ์ |
snippet.giftMembershipReceivedDetails |
object ออบเจ็กต์นี้มีรายละเอียดเกี่ยวกับกิจกรรมที่ได้รับแพ็กเกจสมาชิกแบบของขวัญ และจะปรากฏก็ต่อเมื่อ message type เป็น giftMembershipReceivedEvent |
snippet.giftMembershipReceivedDetails.memberLevelName |
string ชื่อของระดับที่ผู้ชมเป็นสมาชิก รายการนี้ตรงกับ snippet.membershipGiftingDetails.giftMembershipsLevelName ของข้อความที่เกี่ยวข้องซึ่งเสนอการเป็นสมาชิกแบบของขวัญ ชื่อระดับจะกำหนดโดยช่อง YouTube ที่เสนอการเป็นสมาชิก บางช่องจะไม่ได้รับข้อมูลในบางสถานการณ์ |
snippet.giftMembershipReceivedDetails.gifterChannelId |
string รหัสของผู้ใช้ที่ซื้อแพ็กเกจสมาชิกแบบของขวัญ รายการนี้ตรงกับ snippet.authorChannelId ของข้อความที่เกี่ยวข้องซึ่งเสนอการเป็นสมาชิกแบบของขวัญ |
snippet.giftMembershipReceivedDetails.associatedMembershipGiftingMessageId |
string รหัสข้อความเกี่ยวกับแพ็กเกจสมาชิกแบบของขวัญที่เกี่ยวข้องกับแพ็กเกจสมาชิกแบบของขวัญนี้ รหัสนี้จะอ้างถึงข้อความเสมอซึ่ง type คือ membershipGiftingEvent |
authorDetails |
object ออบเจ็กต์ authorDetails มีรายละเอียดเพิ่มเติมเกี่ยวกับผู้ใช้ที่โพสต์ข้อความนี้ |
authorDetails.channelId |
string รหัสช่อง YouTube ของผู้เขียน |
authorDetails.channelUrl |
string URL ช่อง YouTube ของผู้เขียน |
authorDetails.displayName |
string ชื่อที่แสดงของช่อง YouTube ของผู้เขียน |
authorDetails.profileImageUrl |
string URL รูปโปรไฟล์ของช่อง YouTube ของผู้เขียน |
authorDetails.isVerified |
boolean ค่านี้บ่งชี้ว่า YouTube ได้ยืนยันตัวตนของผู้เขียนแล้วหรือยัง |
authorDetails.isChatOwner |
boolean ค่านี้ระบุว่าผู้เขียนเป็นเจ้าของแชทสดหรือไม่ |
authorDetails.isChatSponsor |
boolean ค่านี้ระบุว่าผู้เขียนเป็นผู้สนับสนุนของแชทสดหรือไม่ |
authorDetails.isChatModerator |
boolean ค่านี้ระบุว่าผู้เขียนเป็นผู้ดูแลแชทสดหรือไม่ |