LiveChatMessages: insert

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

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ 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