การใช้งาน: แชแนล

หน้านี้อธิบายวิธีใช้ YouTube Data API (v3) เพื่อเรียกใช้ฟังก์ชันที่เกี่ยวข้องกับการดึงและอัปเดตข้อมูลช่อง ทรัพยากร channel มีรหัสเพลย์ลิสต์ที่ระบุวิดีโอที่อัปโหลดและวิดีโอที่ชอบของช่อง หากต้องการดึงข้อมูลนี้เมื่อเรียกใช้เมธอด channels.list ให้ตรวจสอบว่าค่าพารามิเตอร์ part มีส่วนทรัพยากร contentDetails

ดึงข้อมูลเกี่ยวกับช่อง

เรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับช่องที่ต้องการ โดยมีวิธีระบุช่อง 2-3 วิธีดังนี้

ตั้งค่าข้อมูลการสร้างแบรนด์ของช่อง

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