เพิ่มการให้คะแนนชอบหรือไม่ชอบวิดีโอ หรือนำการให้คะแนนออกจากวิดีโอ
ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 50 หน่วย
หมายเหตุ: การดำเนินการนี้ไม่ส่งผลต่อจำนวนการชอบ/ไม่ชอบอย่างเป็นทางการของวิดีโอ
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ 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