Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
Uygulama: Kanallar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, kanal verilerini alma ve güncellemeyle ilgili işlevleri gerçekleştirmek için YouTube Data API'nin (v3) nasıl kullanılacağı açıklanmaktadır. channel kaynağı, bir kanalın yüklenen ve beğenilen videolarını tanımlayan oynatma listesi kimliklerini içerir. channels.list yöntemini çağırırken bu bilgileri almak için part parametre değerinin contentDetails kaynak bölümünü içerdiğinden emin olun.
Kanallarla ilgili bilgileri alma
Belirli bir kanalla ilgili bilgileri almak için channels.list yöntemini çağırın. Kanalı tanımlamanın birkaç yolu vardır:
Kanalın marka öğelerini ayarlama
Bu örnekte, bir kanalın marka öğeleri seçenekleri güncellenmektedir. Örnekte iki adım vardır:
-
1. adım: Kanalın marka öğesi seçeneklerini alın
channels.list yöntemini çağırın ve part parametresi değerini brandingSettings, mine parametresi değerini ise true olarak ayarlayın.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
part=brandingSettings
&mine=true
Uygulamanız, alınan ayarları görüntüleyerek kullanıcının güncellenecek ayarları değiştirmesine olanak tanıyabilir.
-
2. Adım: Kanalın marka öğesi seçeneklerini güncelleyin
channels.list yöntemini çağırın ve aşağıdaki değerleri ayarlayın:
id mülkünü kanalın benzersiz YouTube kanal kimliğine ayarlayın. Kimlik, 1. adımdaki API yanıtından alınabilir.part parametre değerini brandingSettings olarak ayarlayın.
Aşağıdaki API Gezgini bağlantısı, aşağıdaki markalaşma ayarlarına sahip bir channel kaynağı oluşturur:
{
"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"
}
}
}
İsteği APIs Explorer'da tamamlamak için id mülkünün değerini, kimliği doğrulanmış kullanıcının kanalının kanal kimliğine ayarlamanız gerekir. Resim özelliklerini de mevcut ayarlarınızla eşleşecek şekilde ayarlamanız gerekir.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
part=brandingSettings
Kanal bölümlerini yönetme
API, kanal bölümlerini yönetmek için channelSections.list, channelSections.insert, channelSections.update ve channelSections.delete yöntemlerini destekler. Kanal bölümü, bir kanalda öne çıkarılan videolardan oluşur. Örneğin, bir bölümde kanalın son yüklemeleri, en popüler yüklemeleri veya bir veya daha fazla oynatma listesindeki videolar yer alabilir.
Aşağıdaki örnekte, Google'ın resmi YouTube kanalının kanal bölümleri getirilmektedir. İstek, channelSections.list yöntemini çağırır ve channelId parametre değerini Google kanalının kanal kimliği olan UCK8sQmJBp8GCxrOtXWBpyEA olarak ayarlar.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA
channelId parametresi yerine mine parametre değerini true olarak ayarlarsanız bu istek için yetkilendirme gerekir. Bu parametre, şu anda kimliği doğrulanmış kullanıcının kanalının kanal bölümlerini aldığınızı gösterir.
Kanal için filigran resmi yükleme ve ayarlama
Filigran resmi yüklemek ve bir kanal için ayarlamak üzere watermarks.set yöntemini çağırabilirsiniz. Bu resim, belirtilen kanalın videoları oynatıldığında gösterilir. Ayrıca, resmin bağlanacağı hedef kanalı ve filigranın ne zaman ve ne kadar süreyle görüneceğini belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.
watermarks.unset yöntemi, kanalın filigran resmini siler.
API Gezgini, bu yöntem için gerekli olan medya dosyası yükleme özelliğini desteklemediğinden maalesef bu sorgu API Gezgini kullanılarak test edilemez.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-23 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
