我们正在更新 Data API,以便与 YouTube 统计 Shorts 短视频观看次数的方式保持一致。
了解详情
实现:渠道
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页介绍了如何使用 YouTube Data API (v3) 执行与检索和更新频道数据相关的功能。channel
资源包含用于标识频道上传的视频和赞过的视频的播放列表 ID。如需在调用 channels.list
方法时提取此信息,请确保 part
参数值包含 contentDetails
资源部分。
检索有关渠道的信息
设置频道的品牌信息
此示例会更新频道的品牌信息选项。该示例包含两个步骤:
管理频道版块
为频道上传并设置水印图片
您可以调用 watermarks.set
方法来上传水印图片并为频道设置水印。然后,在播放指定频道的视频时,系统会显示该图片。您还可以指定要将图片链接到的目标渠道,以及用于确定水印显示时间和显示时长的时间详细信息。
watermarks.unset
方法用于删除频道的水印图片。
很遗憾,您无法使用 API Explorer 测试此查询,因为 API Explorer 不支持上传媒体文件,而这是此方法的要求。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-11-23。
[null,null,["最后更新时间 (UTC):2024-11-23。"],[[["\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."]]