การใช้งาน: การให้คะแนน

ตัวอย่างต่อไปนี้จะแสดงวิธีใช้ YouTube Data API (v3) ในการทํางานที่เกี่ยวข้องกับการให้คะแนนวิดีโอ

ให้คะแนนวิดีโอ

เรียกใช้เมธอด videos.rate เพื่อส่งคะแนนของผู้ใช้สําหรับวิดีโอ คําขอนี้ต้องได้รับอนุญาตโดยใช้ OAuth 2.0

ตั้งค่าพารามิเตอร์ 2 รายการต่อไปนี้ในคําขอของคุณ

  • พารามิเตอร์ id ระบุรหัสวิดีโอ YouTube ของวิดีโอที่จัดประเภท (หรือมีการนําการจัดประเภทออก)
  • พารามิเตอร์ rating ระบุคะแนนที่ผู้ใช้อนุญาตซึ่งคําขอต้องการบันทึก ค่าพารามิเตอร์ที่ถูกต้องคือ like, dislike และ none ค่า 2 ค่าแรกกําหนดคะแนน และค่าที่ 3 จะนําคะแนนที่ผู้ใช้มีอยู่ก่อนหน้านี้ออก

คําขอตัวอย่างด้านล่างแสดงคะแนนเชิงบวก (เช่น) ของวิดีโอที่ใช้กล่าวปราศรัยสําคัญที่การประชุม Google I/O ปี 2014

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

เรียกข้อมูลคะแนนปัจจุบันของผู้ใช้วิดีโอ

เมธอด videos.getRating ช่วยให้คุณดูคะแนนปัจจุบันของวิดีโออย่างน้อย 1 รายการของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้ ในคําขอของคุณ ตั้งค่าของพารามิเตอร์ id เป็นรายการรหัสวิดีโอ YouTube ที่คั่นด้วยคอมมาสําหรับทรัพยากรที่คุณกําลังดึงข้อมูลการให้คะแนน โปรดทราบว่าคําขอนี้ต้องได้รับอนุญาตโดยใช้ OAuth 2.0

คําขอตัวอย่างด้านล่างดึงคะแนนของผู้ใช้ในปัจจุบันในการพูดคําปราศรัยสําคัญที่การประชุม Google I/O ปี 2014 (หากคุณดําเนินการตัวอย่างก่อนหน้านี้ในโปรแกรมสํารวจ API การตอบกลับ API ควรระบุว่าคะแนนเป็น like

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

เรียกดูวิดีโอที่ผู้ใช้ปัจจุบันให้คะแนน

พารามิเตอร์ myRating ของเมธอด videos.list ช่วยให้คุณเรียกดูรายการวิดีโอที่ผู้ใช้อนุญาตสําหรับคําขอ API ค่าพารามิเตอร์จะระบุว่าคุณต้องการเรียกข้อมูลวิดีโอที่ชอบหรือไม่ชอบ

คําขอตัวอย่างด้านล่างดึงรายการวิดีโอที่ผู้ใช้ปัจจุบันให้คะแนน like คําขอต้องได้รับอนุญาตโดยใช้ OAuth 2.0

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
หมายเหตุ: คุณยังเรียกข้อมูลรายการวิดีโอที่ชอบของผู้ใช้ (แต่ไม่ใช่วิดีโอที่ไม่ชอบ) ได้โดยทําตามขั้นตอนการดึงข้อมูลวิดีโอโปรดของช่อง ในขั้นตอนที่ 1 ของกระบวนการดังกล่าว ให้เรียกข้อมูลรหัสเพลย์ลิสต์สําหรับวิดีโอที่ชอบของช่องแทนการเรียกรหัสเพลย์ลิสต์สําหรับวิดีโอโปรดของช่อง พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.likes มีค่า

API นี้ช่วยให้คุณเรียกรายการวิดีโอที่ผู้ใช้ชอบได้โดยใช้เมธอด videos.list หรือเมธอด playlistItems.list เนื่องจากข้อมูลที่ส่งกลับมาในทรัพยากร video แตกต่างจากทรัพยากร playlistItem คุณจึงสามารถเลือกวิธีที่เหมาะกับความต้องการของคุณมากที่สุดได้