เปลี่ยนสถานะของข้อความแชทสดของ YouTube และเริ่มขั้นตอนที่เกี่ยวข้องกับสถานะใหม่ เช่น เมื่อคุณเปลี่ยนสถานะของแบบสำรวจที่เผยแพร่อยู่เป็นclosed YouTube จะยุติแบบสำรวจของข้อความนั้น ก่อนเรียกใช้วิธีการนี้ คุณควรยืนยันว่าค่าของพร็อพเพอร์ตี้ status สำหรับข้อความแบบสำรวจแบบสดคือ active
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
| ขอบเขต |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา
| พารามิเตอร์ | ||
|---|---|---|
| พารามิเตอร์ที่จำเป็น | ||
id |
stringพารามิเตอร์ id ระบุรหัสที่ไม่ซ้ำกันของข้อความที่กำลังเปลี่ยนไปมีสถานะอื่น |
|
status |
enumพารามิเตอร์ status จะระบุสถานะที่ข้อความจะเปลี่ยนแปลง หากต้องการเปลี่ยนสถานะของข้อความเป็น closed status จะต้องเป็น active สำหรับแบบสำรวจที่เชื่อมโยงกับข้อความ
คุณสามารถเปลี่ยนเป็น closed เท่านั้น ซึ่งหมายความว่าแบบสำรวจปิดแล้ว
|
|
| พารามิเตอร์ที่ไม่บังคับ | ||
part |
stringพารามิเตอร์ part ระบุส่วนทรัพยากร liveChatMessage ที่การตอบกลับจาก API จะรวมไว้ ค่าที่รองรับคือ id, snippet และ authorDetails
ตั้งค่าพารามิเตอร์เป็น snippet เพื่อรับผลของแบบสำรวจสุดท้ายในเนื้อหาการตอบกลับ
|
|
เนื้อหาของคำขอ
ไม่ต้องระบุเนื้อหาคำขอเมื่อเรียกใช้วิธีการนี้
คำตอบ
หากทำสำเร็จ เมธอดนี้จะแสดงทรัพยากร LiveChatMessages ในเนื้อหาการตอบกลับ
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจส่งคืนเมื่อมีการเรียกใช้เมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด
| ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
|---|---|---|
forbidden (403) |
forbidden |
คุณไม่มีสิทธิ์ที่จำเป็นในการเปลี่ยนสถานะของข้อความที่ระบุ |
required (400) |
idRequired |
พารามิเตอร์ id ที่จำเป็นต้องระบุข้อความที่คุณต้องการเปลี่ยนสถานะ |
required (400) |
statusRequired |
คำขอ API ต้องระบุค่าของพารามิเตอร์ status |
notFound (404) |
liveChatMessagesNotFound |
ไม่มีข้อความที่ระบุโดยพารามิเตอร์ id |
forbidden (403) |
modificationNotAllowed |
เปลี่ยนสถานะของทรัพยากร liveChatMessage ที่ระบุไม่ได้ พารามิเตอร์ id อาจระบุข้อความที่เปลี่ยนสถานะไม่ได้ |
ลองใช้งาน
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้ รวมถึงดูคำขอ API และการตอบกลับ