หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

เรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับช่องที่ต้องการ คุณสามารถระบุช่องได้หลายวิธี ดังนี้

ตั้งค่าพารามิเตอร์ mine เป็น true เพื่อดึงข้อมูลสำหรับช่อง YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์ในปัจจุบัน คำขอของคุณต้องได้รับสิทธิ์โดยใช้ OAuth 2.0
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails,brandingSettings
        &mine=true
```
ตั้งค่าพารามิเตอร์ forUsername เป็นชื่อผู้ใช้ YouTube เพื่อดึงข้อมูลของช่องที่เชื่อมโยงกับชื่อผู้ใช้นั้น ตัวอย่างนี้จะตั้งค่าพารามิเตอร์ forUsername เป็น Google เพื่อดึงข้อมูลสำหรับช่อง YouTube อย่างเป็นทางการของ Google
```
https://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 ด้านล่างจะสร้างทรัพยากร 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 ไม่รองรับการอัปโหลดไฟล์สื่อ ซึ่งเป็นข้อกําหนดของวิธีการนี้