ตัวอย่างต่อไปนี้จะแสดงวิธีใช้ 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
contentDetails.relatedPlaylists.likes
มีค่าAPI นี้ช่วยให้คุณเรียกรายการวิดีโอที่ผู้ใช้ชอบได้โดยใช้เมธอด
videos.list
หรือเมธอด playlistItems.list
เนื่องจากข้อมูลที่ส่งกลับมาในทรัพยากร video
แตกต่างจากทรัพยากร playlistItem
คุณจึงสามารถเลือกวิธีที่เหมาะกับความต้องการของคุณมากที่สุดได้