เปลี่ยนสถานะของข้อความแชทสดใน YouTube และเริ่มกระบวนการที่เชื่อมโยงกับสถานะใหม่ เช่น เมื่อคุณเปลี่ยนสถานะของโพลสดเป็น closed YouTube จะสิ้นสุดโพลของข้อความนั้น คุณควรยืนยันว่าค่าของพร็อพเพอร์ตี้ status สำหรับข้อความโพลสดเป็น active ก่อนที่จะเรียกใช้เมธอดนี้
ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 20 หน่วย
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages/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