หน้านี้อธิบายวิธีใช้ 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เป็นtruehttps://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 ด้านล่างจะสร้างทรัพยากร
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 ให้เสร็จสมบูรณ์ คุณต้องตั้งค่าพร็อพเพอร์ตี้
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 ได้เนื่องจากโปรแกรมสำรวจ API ไม่รองรับความสามารถในการอัปโหลดไฟล์สื่อ ซึ่งเป็นข้อกำหนดของเมธอดนี้