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