LiveChatMessages

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

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

เมธอด

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

list

แสดงข้อความแชทสดของแชทที่เฉพาะเจาะจง ลองใช้เลย

streamList

เปิดใช้การเชื่อมต่อการสตรีมจากเซิร์ฟเวอร์เพื่อรับข้อความแชทสดสำหรับแชทที่เฉพาะเจาะจงโดยมีความหน่วงต่ำ ลองใช้เลย

แทรก

เพิ่มข้อความหรือแบบสำรวจไปยังแชทสด ลองใช้เลย

การเปลี่ยนภาพ

เปลี่ยนสถานะของข้อความที่ใช้แสดงอยู่ ลองใช้เลย

ลบ

ลบข้อความแชท คำขอ 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
    },
    "pollDetails": {
      "metadata": {
        "options": {
          "optionText": string,
          "tally": string,
        },
        "questionText": string,
        "status": enum
      },
    },
    "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 - ผู้ใช้ซื้อ Super Chat superStickerEvent - ผู้ใช้ซื้อ Super Stickers textMessageEvent - ผู้ใช้ส่งข้อความ tombstone – เครื่องหมายหลุมศพแสดงว่าเคยมีข้อความที่มีรหัสและเวลาเผยแพร่นี้ แต่ถูกลบไปแล้ว ระบบจะไม่ส่งข้อความนี้เมื่อลบข้อความ แต่จะแสดงเพื่อระบุตำแหน่งที่ข้อความเคยอยู่ก่อนที่จะถูกลบ มีเพียงฟิลด์ snippet.liveChatId, snippet.type และ snippet.publishedAt เท่านั้นที่อยู่ในข้อความประเภทนี้ userBannedEvent – ผู้ใช้ถูกโมเดอเรเตอร์แบน author ฟิลด์จะมีรายละเอียดของผู้ดูแล membershipGiftingEvent – ผู้ใช้ซื้อแพ็กเกจสมาชิกให้แก่ผู้ชมรายอื่น giftMembershipReceivedEvent - ผู้ใช้ได้รับแพ็กเกจสมาชิกแบบของขวัญ pollDetails - ผู้ใช้สร้างแบบสำรวจสด
snippet.liveChatId	string รหัสที่ระบุแชทสดที่ไม่ซ้ำกันซึ่งเชื่อมโยงกับข้อความ ระบบจะแสดงรหัสแชทสดที่เชื่อมโยงกับการออกอากาศในพร็อพเพอร์ตี้ snippet.liveChatId ของทรัพยากร liveBroadcast
snippet.authorChannelId	string รหัสของผู้ใช้ที่เขียนข้อความ ระบบจะกรอกข้อมูลในช่องนี้สำหรับข้อความประเภทต่อไปนี้เท่านั้น หากประเภทข้อความเป็น textMessageEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่เขียนข้อความ หากประเภทข้อความเป็น fanFundingEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่ให้เงินสนับสนุนการออกอากาศ หากประเภทข้อความเป็น messageDeletedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ดูแลที่ลบข้อความ หากประเภทข้อความเป็น newSponsorEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่เพิ่งเป็นสปอนเซอร์ หากประเภทข้อความเป็น memberMilestoneChatEvent ค่าพร็อพเพอร์ตี้จะระบุสมาชิกที่ส่งข้อความ หากประเภทข้อความเป็น userBannedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ดูแลที่แบนผู้ใช้ หากประเภทข้อความเป็น membershipGiftingEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่ซื้อการให้ของขวัญเป็นสมาชิก หากประเภทข้อความเป็น giftMembershipReceivedEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่ได้รับของขวัญเป็นสมาชิก หากประเภทข้อความเป็น pollEvent ค่าพร็อพเพอร์ตี้จะระบุผู้ใช้ที่สร้างโพลสด
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 ของข้อความต้นฉบับ เช่น หาก 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.tally	string ผลรวมของตัวเลือกแบบสำรวจสด โดยผลรวมจะแสดงก็ต่อเมื่อเจ้าของช่องอนุญาตคำขอ API เท่านั้น
snippet.pollDetails.metadata.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 ค่านี้ระบุว่าผู้เขียนเป็นผู้ดูแลแชทสดหรือไม่