Estamos atualizando a API Data para corresponder à forma como o YouTube conta as visualizações dos Shorts.
Saiba mais
Implementação: canais
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, explicamos como usar a API Data do YouTube (v3) para realizar funções relacionadas à recuperação e atualização de dados do canal. Um recurso channel inclui IDs de playlist que identificam os vídeos enviados e marcados como "Gostei" de um canal. Para buscar essas informações ao chamar o método channels.list, verifique se o valor do parâmetro part inclui a parte do recurso contentDetails.
Recuperar informações sobre um canal
Chame o método channels.list para recuperar informações sobre um canal específico. Há algumas maneiras de identificar o canal:
Definir as informações de branding de um canal
Neste exemplo, as opções de branding de um canal são atualizadas. O exemplo tem duas etapas:
-
Etapa 1: recuperar as opções de branding do canal
Chame o método channels.list e defina o valor do parâmetro part como brandingSettings e o valor do parâmetro mine como true.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
part=brandingSettings
&mine=true
O app pode mostrar as configurações recuperadas, permitindo que o usuário as modifique para atualizar.
-
Etapa 2: atualizar as opções de branding do canal
Chame o método channels.list e defina os seguintes valores:
- Defina a propriedade
id como o ID exclusivo do canal do YouTube. O ID pode ser extraído da resposta da API na etapa 1.
- Defina o valor do parâmetro
part como brandingSettings.
O link para a API Explorer abaixo cria um recurso channel com as seguintes configurações de branding:
{
"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"
}
}
}
Para concluir a solicitação no APIs Explorer, defina o valor da propriedade id como o ID do canal do usuário autenticado. Você também precisa definir as propriedades da imagem para corresponder às configurações atuais.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
part=brandingSettings
Gerenciar seções do canal
Fazer upload e definir uma imagem de marca-d'água para um canal
É possível chamar o método watermarks.set para fazer upload de uma imagem de marca d'água e definir para um canal. A imagem é mostrada durante a reprodução dos vídeos do canal especificado. Você também pode especificar um canal de destino ao qual a imagem será vinculada, além de detalhes de tempo que determinam quando a marca d'água aparece e por quanto tempo ela fica visível.
O método watermarks.unset exclui a imagem de marca-d'água de um canal.
Infelizmente, essa consulta não pode ser testada usando o APIs Explorer porque ele não oferece suporte para fazer upload de arquivos de mídia, o que é um requisito para esse método.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-11-23 UTC.
[null,null,["Última atualização 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."]]
