การใช้งาน: การจัดประเภท

ตัวอย่างต่อไปนี้จะแสดงวิธีใช้ API ข้อมูลของ YouTube (v3) เพื่อเรียกใช้ฟังก์ชันที่เกี่ยวข้องกับการจัดประเภทวิดีโอ

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

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

กำหนดพารามิเตอร์ 2 รายการต่อไปนี้ในคำขอ

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

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