LiveChatMessages: insert

เพิ่มข้อความในแชทสด ปัจจุบัน API รองรับความสามารถในการแทรก SMS เท่านั้น

Use Case ทั่วไป

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages

การให้สิทธิ์

คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงอยู่เป็นพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part ทำหน้าที่ 2 ประการ โดยระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับจาก API จะรวมอยู่ด้วย ตั้งค่าพารามิเตอร์เป็น snippet

เนื้อหาของคำขอ

ระบุทรัพยากร LiveChatMessage ในเนื้อหาคำขอ สำหรับแหล่งข้อมูลดังกล่าว ให้ทำดังนี้

  • คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้เหล่านี้

    • snippet.liveChatId
    • snippet.type: ปัจจุบันค่าที่รองรับมีเพียงรายการเดียวคือ textMessageEvent
    • snippet.textMessageDetails.messageText

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากร LiveChatMessage ในเนื้อหาการตอบกลับ

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) forbidden คุณไม่มีสิทธิ์ที่จำเป็นในการสร้างข้อความที่ระบุ
forbidden (403) liveChatDisabled แชทสดดังกล่าวถูกปิดใช้โดยเจ้าของ ซึ่งหมายความว่าไม่สามารถเพิ่มข้อความลงในแชทได้
forbidden (403) liveChatEnded แชทสดที่ระบุไม่เผยแพร่แล้ว
invalidValue (400) messageTextInvalid ข้อความ (snippet.textMessageDetails.messageText) ไม่ถูกต้อง
notFound (404) liveChatNotFound ไม่มีแชทสดที่ระบุไว้ในคำขอ API ข้อผิดพลาดนี้จะเกิดขึ้นหากเจ้าของลบแชทไปแล้ว
rateLimitExceeded rateLimitExceeded ผู้ใช้โพสต์ข้อความแชทมากเกินไปภายในกรอบเวลาที่กำหนด
required (400) liveChatIdRequired ทรัพยากร LiveChatMessage ต้องรวมและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.liveChatId
required (400) messageTextRequired ทรัพยากร LiveChatMessage ต้องรวมและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.textMessageDetails.messageText
required (400) typeRequired ทรัพยากร LiveChatMessage ต้องรวมและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.type ตั้งค่าค่าพารามิเตอร์เป็น text

ลองใช้เลย

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้เพื่อดูคำขอและการตอบสนองของ API