หน้านี้อธิบายวิธีใช้ YouTube Data API (v3) เพื่อดําเนินการที่เกี่ยวข้องกับการดึงข้อมูลและอัปเดตข้อมูลช่อง ทรัพยากร channel
รวมถึงรหัสเพลย์ลิสต์ที่ระบุวิดีโอที่อัปโหลดและกดชอบของช่อง หากต้องการดึงข้อมูลนี้เมื่อเรียกใช้เมธอด channels.list
ให้ตรวจสอบว่าค่าพารามิเตอร์ part
ประกอบด้วยส่วนทรัพยากร contentDetails
ดึงข้อมูลเกี่ยวกับช่อง
เรียกเมธอด channels.list
เพื่อดึงข้อมูลเกี่ยวกับช่องใดช่องหนึ่ง การระบุช่องทําได้ 2-3 วิธี ดังนี้
-
ตั้งค่าพารามิเตอร์เป็น
mine
เป็นtrue
เพื่อดึงข้อมูลสําหรับช่อง YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน คําขอต้องได้รับอนุญาตโดยใช้ OAuth 2.0https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails,brandingSettings &mine=true
-
ตั้งค่าพารามิเตอร์
forUsername
เป็นชื่อผู้ใช้ YouTube เพื่อดึงข้อมูลสําหรับช่องที่เชื่อมโยงกับชื่อผู้ใช้นั้น ตัวอย่างนี้ตั้งค่าพารามิเตอร์forUsername
เป็นGoogle
เพื่อดึงข้อมูลสําหรับช่อง YouTube อย่างเป็นทางการของ Googlehttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &forUsername=Google
-
ตั้งค่าพารามิเตอร์
id
เป็นรหัสช่อง YouTube ที่ระบุช่องที่คุณกําลังดึงข้อมูลอย่างไม่ซ้ํากัน ตัวอย่างนี้ตั้งค่าพารามิเตอร์id
เป็นUCK8sQmJBp8GCxrOtXWBpyEA
ซึ่งระบุช่อง YouTube อย่างเป็นทางการของ Google ด้วยhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
ตั้งค่าข้อมูลการสร้างแบรนด์ของช่อง
ตัวอย่างนี้จะอัปเดตตัวเลือกการสร้างแบรนด์ของช่อง ตัวอย่างมี 2 ขั้นตอนดังนี้
-
ขั้นตอนที่ 1: ดึงตัวเลือกการสร้างแบรนด์ของช่อง
เรียกเมธอด
channels.list
และตั้งค่าค่าพารามิเตอร์part
เป็นbrandingSettings
และค่าพารามิเตอร์mine
เป็นtrue
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=brandingSettings &mine=true
แอปพลิเคชันอาจแสดงการตั้งค่าที่ดึงมาได้ ซึ่งช่วยให้ผู้ใช้แก้ไขการตั้งค่าเพื่ออัปเดตได้
-
ขั้นตอนที่ 2: อัปเดตตัวเลือกการสร้างแบรนด์ของช่อง
เรียกเมธอด
channels.list
และตั้งค่าต่อไปนี้- ตั้งค่าพร็อพเพอร์ตี้
id
เป็นรหัสช่อง YouTube ที่ไม่ซ้ํากันของช่อง คุณจะดึงรหัสจากการตอบกลับ API ในขั้นตอนที่ 1 ได้ - กําหนดค่าพารามิเตอร์
part
เป็นbrandingSettings
ลิงก์ไปยัง API Explorer ด้านล่างสร้างทรัพยากร
channel
ที่มีการตั้งค่าการสร้างแบรนด์ต่อไปนี้{ "id": "CHANNEL_ID", "brandingSettings": { "channel": { "description": "A great channel to be enjoyed by all.", "moderateComments": true, "showRelatedChannels": true, "showBrowseView": true, "featuredChannelsTitle": "Featured Channel Stuff", "featuredChannelsUrls": [ "UC_x5XG1OV2P6uZZ5FSM9Ttw", "UCBR8-60-B28hp2BmDPdntcQ", "UCK8sQmJBp8GCxrOtXWBpyEA" ], "profileColor": "#006600" } } }
หากต้องการส่งคําขอใน API Explorer ให้เสร็จสิ้น คุณต้องตั้งค่าของพร็อพเพอร์ตี้
id
เป็นรหัสช่องของช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว คุณควรตั้งค่าคุณสมบัติของรูปภาพให้ตรงกับการตั้งค่าปัจจุบันด้วยhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update? part=brandingSettings
- ตั้งค่าพร็อพเพอร์ตี้
จัดการส่วนช่อง
API รองรับเมธอด channelSections.list, channelSections.insert, channelSections.update และ channelSections.delete เพื่อจัดการส่วนช่อง ส่วนช่องคือชุดวิดีโอที่แสดงในช่อง เช่น ส่วนอาจรวมถึงการอัปโหลดล่าสุดของช่อง การอัปโหลดยอดนิยม หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการ
ตัวอย่างด้านล่างเรียกข้อมูลส่วนช่องสําหรับช่อง YouTube อย่างเป็นทางการของ Google คําขอเรียกใช้เมธอด channelSections.list
และตั้งค่าค่าพารามิเตอร์ channelId
เป็น UCK8sQmJBp8GCxrOtXWBpyEA
ซึ่งเป็นรหัสแชแนลสําหรับช่องของ Google
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list? part=snippet,contentDetails &channelId=UCK8sQmJBp8GCxrOtXWBpyEA
คําขอนี้ต้องมีการให้สิทธิ์หากคุณตั้งค่าพารามิเตอร์ mine
เป็น true
แทนการใช้พารามิเตอร์ channelId
พารามิเตอร์ดังกล่าวบ่งชี้ว่าคุณกําลังเรียกส่วนของแชแนลสําหรับช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบัน
อัปโหลดและตั้งค่ารูปภาพลายน้ําของช่อง
คุณสามารถเรียกเมธอด watermarks.set
เพื่ออัปโหลดรูปภาพลายน้ําและตั้งค่าเป็นช่องทาง จากนั้นรูปภาพจะแสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังสามารถระบุช่องเป้าหมายที่รูปภาพจะลิงก์ รวมถึงรายละเอียดช่วงเวลาที่กําหนดเวลาที่ลายน้ําจะปรากฏและระยะเวลาที่จะมองเห็นรูปภาพได้
เมธอด watermarks.unset
จะลบรูปภาพลายน้ําของช่อง
ขออภัย ไม่สามารถทดสอบการค้นหานี้โดยใช้ API Explorer เนื่องจาก API Explorer ไม่สนับสนุนความสามารถในการอัปโหลดไฟล์สื่อ ซึ่งเป็นข้อกําหนดสําหรับวิธีนี้