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

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