LiveChatMessages

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

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

เมธอด

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

list
แสดงรายการข้อความแชทสดของแชทที่เฉพาะเจาะจง ลองใช้เลย
streamList
เปิดใช้การเชื่อมต่อการสตรีมผ่านเซิร์ฟเวอร์เพื่อรับข้อความแชทสดสำหรับแชทที่เฉพาะเจาะจงโดยมีความหน่วงต่ำ ลองใช้เลย
แทรก
เพิ่มข้อความหรือแบบสำรวจลงในแชทสด ลองใช้เลย
transition
เปลี่ยนสถานะของข้อความที่ใช้แสดงอยู่ ลองใช้เลย
ลบ
ลบข้อความแชท คำขอ 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 - ผู้ใช้ส่งข้อความ SMS
  • 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 อย่างไรก็ตาม คุณจะใช้ API เพื่อดู URL ของรูปภาพไม่ได้ คุณดูรหัสสติกเกอร์ที่เกี่ยวข้องกับ 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
ค่านี้ระบุว่าผู้เขียนเป็นผู้ดูแลแชทสดหรือไม่