การใช้งาน: แชแนล
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
หน้านี้จะอธิบายวิธีใช้ YouTube Data API (เวอร์ชัน 3) เพื่อดำเนินการต่างๆ ที่เกี่ยวข้องกับการเรียกข้อมูลและอัปเดตข้อมูลช่อง ทรัพยากร channel มีรหัสเพลย์ลิสต์ที่ระบุวิดีโอที่อัปโหลดและวิดีโอที่ชอบของช่อง หากต้องการดึงข้อมูลนี้เมื่อเรียกใช้เมธอด channels.list ให้ตรวจสอบว่าค่าพารามิเตอร์ part มีส่วนของทรัพยากร contentDetails
เรียกข้อมูลเกี่ยวกับช่อง
เรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับช่องที่ต้องการ คุณสามารถระบุช่องได้หลายวิธี ดังนี้
ตั้งค่าข้อมูลการสร้างแบรนด์ของช่อง
ตัวอย่างนี้จะอัปเดตตัวเลือกการสร้างแบรนด์ของช่อง ตัวอย่างนี้มี 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
จัดการส่วนต่างๆ ของช่อง
อัปโหลดและตั้งค่ารูปภาพลายน้ำสำหรับช่อง
คุณสามารถเรียกใช้เมธอด watermarks.set เพื่ออัปโหลดรูปภาพลายน้ำและตั้งค่าให้กับช่อง จากนั้นรูปภาพจะแสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณยังระบุแชแนลเป้าหมายที่จะลิงก์กับรูปภาพ รวมถึงรายละเอียดการกำหนดเวลาที่จะกำหนดว่าลายน้ำจะปรากฏเมื่อใดและแสดงนานเท่าใดได้ด้วย
วิธีการ watermarks.unset จะลบรูปภาพลายน้ำของช่อง
ขออภัย คุณจะทดสอบการค้นหานี้โดยใช้โปรแกรมสำรวจ API ไม่ได้ เนื่องจากโปรแกรมสำรวจ API ไม่รองรับการอัปโหลดไฟล์สื่อ ซึ่งเป็นข้อกําหนดของวิธีการนี้
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-11-23 UTC
[null,null,["อัปเดตล่าสุด 2024-11-23 UTC"],[[["\u003cp\u003eThe YouTube Data API (v3) allows retrieval of channel data, including playlist IDs for uploaded and liked videos, by using the \u003ccode\u003echannels.list\u003c/code\u003e method and including the \u003ccode\u003econtentDetails\u003c/code\u003e resource part.\u003c/p\u003e\n"],["\u003cp\u003eInformation about a specific channel can be retrieved using the \u003ccode\u003echannels.list\u003c/code\u003e method by setting the \u003ccode\u003emine\u003c/code\u003e parameter to \u003ccode\u003etrue\u003c/code\u003e for the authenticated user's channel, the \u003ccode\u003eforUsername\u003c/code\u003e parameter for a specific username, or the \u003ccode\u003eid\u003c/code\u003e parameter for a specific channel ID.\u003c/p\u003e\n"],["\u003cp\u003eChannel branding options can be updated in two steps, first retrieving current settings with \u003ccode\u003echannels.list\u003c/code\u003e and \u003ccode\u003ebrandingSettings\u003c/code\u003e part, then updating with \u003ccode\u003echannels.update\u003c/code\u003e and setting the channel ID and desired \u003ccode\u003ebrandingSettings\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports managing channel sections using \u003ccode\u003echannelSections.list\u003c/code\u003e, \u003ccode\u003echannelSections.insert\u003c/code\u003e, \u003ccode\u003echannelSections.update\u003c/code\u003e, and \u003ccode\u003echannelSections.delete\u003c/code\u003e, which can include featured videos like latest uploads or playlist contents.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ewatermarks.set\u003c/code\u003e method allows the upload and setting of a watermark image for a channel's videos, with the \u003ccode\u003ewatermarks.unset\u003c/code\u003e method for deletion, although this cannot be tested with the API Explorer.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) manages channel data. To retrieve channel information, use the `channels.list` method, specifying `contentDetails` in the `part` parameter. Identify channels via `mine`, `forUsername`, or `id` parameters. Branding information can be updated in two steps: first, retrieve existing settings via the API, then modify and update them using the `brandingSettings`. Channel sections, sets of featured videos, can be managed via `channelSections` methods. Watermark images can be uploaded and managed using `watermarks.set` and `watermarks.unset`.\n"],null,["# Implementation: Channels\n\nThis page explains how to use the YouTube Data API (v3) to perform functions related to retrieving and updating channel data. A `channel` resource includes playlist IDs that identify a channel's uploaded and liked videos. To fetch this information when calling the `channels.list` method, make sure the [part](/youtube/v3/docs/channels/list#part) parameter value includes the `contentDetails` resource part.\n\nRetrieve information about a channel\n------------------------------------\n\nCall the [channels.list](/youtube/v3/docs/channels/list) method to retrieve information about a particular channel. There are a few ways to identify the channel:\n\n- Set the [mine](/youtube/v3/docs/channels/list#mine) parameter value to `true` to retrieve information for the currently authenticated user's YouTube channel. Your request must be authorized using OAuth 2.0.\n\n ```\n https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?\n part=snippet,contentDetails,brandingSettings\n &mine=true\n ```\n- Set the [forUsername](/youtube/v3/docs/channels/list#forUsername) parameter to a YouTube username to retrieve information for the channel associated with that username. This example sets the `forUsername` parameter value to `Google` to retrieve information for Google's official YouTube channel.\n\n ```\n https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?\n part=snippet,contentDetails\n &forUsername=Google\n ```\n- Set the [id](/youtube/v3/docs/channels/list#id) parameter to the YouTube channel ID that uniquely identifies the channel for which you are retrieving information. This example sets the `id` parameter to `UCK8sQmJBp8GCxrOtXWBpyEA`, which also identifies Google's official YouTube channel.\n\n ```\n https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?\n part=snippet,contentDetails\n &id=UCK8sQmJBp8GCxrOtXWBpyEA\n ```\n\nSet a channel's branding information\n------------------------------------\n\nThis example updates a channel's branding options. The example has two steps:\n\n- **Step 1: Retrieve the channel's branding options**\n\n Call the `channels.list` method and set the [part](/youtube/v3/docs/channels/list#part) parameter value to `brandingSettings` and the [mine](/youtube/v3/docs/channels/list#mine) parameter value to `true`. \n\n ```\n https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?\n part=brandingSettings\n &mine=true\n ```\n\n Your application could display the retrieved settings, allowing the user to modify the settings to update.\n- **Step 2: Update the channel's branding options**\n\n Call the `channels.list` method and set the following values:\n\n \u003cbr /\u003e\n\n - Set the [id](/youtube/v3/docs/channels#id) property to the channel's unique YouTube channel ID. The ID can be extracted from the API response in step 1.\n - Set the [part](/youtube/v3/docs/channels/update#part) parameter value to `brandingSettings`.\n\n \u003cbr /\u003e\n\n The link to the API Explorer below creates a `channel` resource with the following branding settings: \n\n ```\n {\n \"id\": \"CHANNEL_ID\",\n \"brandingSettings\": {\n \"channel\": {\n \"description\": \"A great channel to be enjoyed by all.\",\n \"moderateComments\": true,\n \"showRelatedChannels\": true,\n \"showBrowseView\": true,\n \"featuredChannelsTitle\": \"Featured Channel Stuff\",\n \"featuredChannelsUrls\": [\n \"UC_x5XG1OV2P6uZZ5FSM9Ttw\",\n \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"UCK8sQmJBp8GCxrOtXWBpyEA\"\n ],\n \"profileColor\": \"#006600\"\n }\n }\n }\n ```\n\n To complete the request in the APIs Explorer, you need to set the `id` property's value to the channel ID of the authenticated user's channel. You should also set the image properties to match your current settings. \n\n ```\n https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?\n part=brandingSettings\n ```\n\nManage channel sections\n-----------------------\n\nThe API supports the [channelSections.list](/youtube/v3/docs/channelSections/list), [channelSections.insert](/youtube/v3/docs/channelSections/insert), [channelSections.update](/youtube/v3/docs/channelSections/update), and [channelSections.delete](/youtube/v3/docs/channelSections/delete) methods for managing channel sections. A channel section is a set of videos that are featured on a channel. For example, a section could include a channel's latest uploads, most popular uploads, or videos from one or more playlists.\n\nThe example below retrieves the channel sections for Google's official YouTube channel. The request calls the `channelSections.list` method and sets the [channelId](/youtube/v3/docs/channelSections/list#channelId) parameter value to `UCK8sQmJBp8GCxrOtXWBpyEA`, which is the channel ID for Google's channel. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?\npart=snippet,contentDetails\n&channelId=UCK8sQmJBp8GCxrOtXWBpyEA\n```\n\nThis request requires authorization if, instead of using the `channelId` parameter, you set the `mine` parameter value to `true`. That parameter indicates that you are retrieving channel sections for the currently authenticated user's channel.\n\nUpload and set a watermark image for a channel\n----------------------------------------------\n\nYou can call the [watermarks.set](/youtube/v3/docs/watermarks/set) method to upload a watermark image and set it for a channel. The image then displays during playbacks of the specified channel's videos. You can also specify a target channel to which the image will link as well as timing details that determine when the watermark appears and how long it is visible.\n\nThe [watermarks.unset](/youtube/v3/docs/watermarks/unset) method deletes a channel's watermark image.\n\nUnfortunately, this query cannot be tested using the APIs Explorer because the APIs Explorer does not support the ability to upload media files, which is a requirement for this method."]]
