เพิ่มการให้คะแนนการชอบหรือไม่ชอบลงในวิดีโอ หรือนำการให้คะแนนออกจากวิดีโอ
ผลกระทบของโควต้า: การเรียกใช้วิธีการนี้มีต้นทุนโควต้า 50 หน่วย
หมายเหตุ: การดำเนินการนี้ไม่ส่งผลต่อจำนวนการชอบ/ไม่ชอบอย่างเป็นทางการของวิดีโอ
Use Case ทั่วไป
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
การให้สิทธิ์
คำขอนี้จำเป็นต้องให้สิทธิ์พร้อมขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
| ขอบเขต |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงอยู่เป็นพารามิเตอร์การค้นหา
| พารามิเตอร์ | ||
|---|---|---|
| พารามิเตอร์ที่จำเป็น | ||
id |
stringพารามิเตอร์ id ระบุรหัสวิดีโอ YouTube ของวิดีโอที่กำลังมีการจัดประเภทหรือนำการจัดประเภทออก |
|
rating |
stringระบุการจัดประเภทที่จะบันทึก ค่าที่ยอมรับมีดังนี้
|
|
เนื้อหาของคำขอ
ไม่ต้องให้เนื้อหาคำขอเมื่อเรียกใช้วิธีการนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงโค้ดตอบกลับ HTTP 204 (No Content)
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับข้อความแสดงข้อผิดพลาด
| ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
|---|---|---|
badRequest (400) |
emailNotVerified |
ผู้ใช้ต้องยืนยันอีเมลก่อนให้คะแนน |
badRequest (400) |
invalidRating |
คำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์ rating |
badRequest (400) |
videoPurchaseRequired |
วิดีโอให้เช่าจะได้รับการจัดประเภทโดยผู้ใช้ที่เช่าวิดีโอเท่านั้น |
forbidden (403) |
forbidden |
วิดีโอที่คุณพยายามให้คะแนนไม่สามารถให้คะแนนได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
forbidden (403) |
videoRatingDisabled |
เจ้าของวิดีโอที่คุณพยายามให้คะแนนได้ปิดการให้คะแนนวิดีโอนั้น |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามให้คะแนน โปรดตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
ลองใช้เลย
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้ และดูคำขอ API และการตอบสนอง