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

การนําไปใช้งาน: ช่อง

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

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

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

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