LiveChatMessages

ทรัพยากร liveChatMessage แสดงข้อความแชทในแชทสดของ YouTube ทรัพยากรอาจมีรายละเอียดเกี่ยวกับข้อความประเภทต่างๆ รวมถึงข้อความที่โพสต์ใหม่หรือกิจกรรมการให้เงินสนับสนุนของแฟนๆ

ฟีเจอร์แชทสดจะเปิดใช้โดยค่าเริ่มต้นสำหรับการถ่ายทอดสด และจะพร้อมใช้งานขณะถ่ายทอดสด (หลังจากกิจกรรมสิ้นสุดลง แชทสดจะไม่พร้อมใช้งานสำหรับกิจกรรมนั้นอีกต่อไป)

วิธีการ

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

list
แสดงข้อความแชทสดสำหรับแชทที่เฉพาะเจาะจง ลองใช้เลย
แทรก
เพิ่มข้อความในแชทสด ลองเลย
ลบ
ลบข้อความแชท คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือผู้ดูแลแชทสด ลองใช้เลย

การนำเสนอทรัพยากร

โครงสร้าง 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
ประเภทข้อความ พร็อพเพอร์ตี้นี้จะปรากฏอยู่เสมอ และค่าจะเป็นตัวกําหนดว่ามีฟิลด์ใดอยู่ในทรัพยากร

ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
  • chatEndedEvent – แชทสิ้นสุดแล้วและคุณจะแทรกข้อความไม่ได้อีกหลังจากข้อความนี้ ซึ่งจะเกิดขึ้นเองภายในช่วงเวลาเล็กน้อยหลังจากการออกอากาศสิ้นสุดลง ระบบจะไม่ส่งข้อความประเภทนี้ในแชทสดในการออกอากาศเริ่มต้นของช่อง
  • messageDeletedEvent – ผู้ดูแลลบข้อความแล้ว ช่อง author มีรายละเอียดของผู้ดูแล เหตุการณ์นี้ไม่มีเนื้อหาที่แสดง
  • sponsorOnlyModeEndedEvent – แชทจะไม่อยู่ในโหมดสำหรับผู้สนับสนุนเท่านั้นอีกต่อไป ซึ่งหมายความว่าผู้ใช้ที่ไม่ใช่ผู้สนับสนุนจะสามารถส่งข้อความได้ เหตุการณ์นี้ไม่มีเนื้อหาที่แสดง
  • sponsorOnlyModeStartedEvent – แชทได้เข้าสู่โหมดสำหรับผู้สนับสนุนเท่านั้นแล้ว ซึ่งหมายความว่าเฉพาะผู้สนับสนุนเท่านั้นที่ส่งข้อความได้ กิจกรรมนี้ไม่มีเนื้อหาที่แสดง
  • newSponsorEvent – ผู้ใช้ใหม่ได้สนับสนุนช่องที่เป็นเจ้าของแชทสด ช่อง author มีรายละเอียดของผู้สนับสนุนรายใหม่
  • memberMilestoneChatEvent – ผู้ใช้ได้ส่งข้อความแชทสุดพิเศษสำหรับสมาชิก
  • superChatEvent – ผู้ใช้ 1 คนซื้อ Super Chat
  • superStickerEvent – ผู้ใช้ซื้อ Super Stickers
  • textMessageEvent – ผู้ใช้ได้ส่งข้อความ
  • tombstone - Tombstone บ่งบอกว่าข้อความเคยมีอยู่กับรหัสนี้และเวลาเผยแพร่ แต่ปัจจุบันได้ถูกลบไปแล้ว ข้อความนี้ไม่ได้ส่งเมื่อมีการลบข้อความ แต่จะแสดงเพื่อระบุตำแหน่งที่ข้อความเคยอยู่ก่อนการลบ ข้อความประเภทนี้มีเพียงช่อง snippet.liveChatId, snippet.type และ snippet.publishedAt เท่านั้น
  • userBannedEvent – ผู้ใช้ถูกแบนโดยผู้ดูแล ช่อง author มีรายละเอียดของผู้ดูแล
  • membershipGiftingEvent – ผู้ใช้ซื้อการเป็นสมาชิกสำหรับผู้ชมรายอื่น
  • giftMembershipReceivedEvent – ผู้ใช้ได้รับแพ็กเกจสมาชิกแบบของขวัญ
snippet.liveChatId string
รหัสที่ระบุแชทสดที่เชื่อมโยงกับข้อความโดยไม่ซ้ำกัน ระบบจะส่งรหัสแชทสดที่เชื่อมโยงกับการออกอากาศกลับมาในพร็อพเพอร์ตี้ snippet.liveChatId ของทรัพยากร liveBroadcast
snippet.authorChannelId string
รหัสของผู้ใช้ที่เขียนข้อความ ช่องนี้จะมีข้อความประเภทต่อไปนี้เท่านั้น
  • หากประเภทข้อความคือ textMessageEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่เขียนข้อความ
  • หากประเภทข้อความคือ fanFundingEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่สนับสนุนการออกอากาศ
  • หากประเภทข้อความคือ messageDeletedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ดูแลที่ลบข้อความ
  • หากประเภทข้อความคือ newSponsorEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่เพิ่งเข้ามาเป็นผู้สนับสนุน
  • หากประเภทข้อความคือ memberMilestoneChatEvent ค่าพร็อพเพอร์ตี้จะระบุสมาชิกที่ส่งข้อความ
  • หากประเภทข้อความคือ userBannedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ดูแลที่แบนผู้ใช้
  • หากประเภทข้อความคือ membershipGiftingEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่ซื้อแพ็กเกจสมาชิกแบบของขวัญ
  • หากประเภทข้อความคือ giftMembershipReceivedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่ได้รับแพ็กเกจสมาชิกแบบของขวัญ
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
สถานะของกิจกรรมแบบสำรวจสด ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
  • unknown
  • active
  • closed
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
ค่านี้ระบุว่าผู้เขียนเป็นผู้ดูแลแชทสดหรือไม่