Bu sayfa, Cloud Translation API ile çevrilmiştir.

Uygulama: Kanallar

Bu sayfada, kanal verilerini alma ve güncellemeyle ilgili işlevleri gerçekleştirmek için YouTube Data API'sının (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 getirmek için part parametre değerinin contentDetails kaynak bölümünü içerdiğinden emin olun.

Bir kanalla ilgili bilgileri alma

Belirli bir kanal hakkındaki bilgileri almak için channels.list yöntemini çağırın. Kanalı belirlemenin birkaç yolu vardır:

Kimliği doğrulanmış kullanıcının YouTube kanalıyla ilgili bilgileri almak için mine parametre değerini true olarak ayarlayın. İsteğiniz OAuth 2.0 kullanılarak yetkilendirilmelidir.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails,brandingSettings
        &mine=true
```
Bu kullanıcı adıyla ilişkili kanalın bilgilerini almak için forUsername parametresini bir YouTube kullanıcı adı olarak ayarlayın. Bu örnekte, Google'ın resmi YouTube kanalının bilgilerini almak için forUsername parametre değeri Google olarak ayarlanmıştır.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails
        &forUsername=Google
```
id parametresini, bilgi aldığınız kanalı benzersiz şekilde tanımlayan YouTube kanal kimliğine ayarlayın. Bu örnekte id parametresi, aynı zamanda Google'ın resmi YouTube kanalını da tanımlayan UCK8sQmJBp8GCxrOtXWBpyEA olarak ayarlanmıştır.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails
        &id=UCK8sQmJBp8GCxrOtXWBpyEA
```

Kanalın marka bilgilerini belirleyin

Bu örnek, kanalın marka bilinci oluşturma seçeneklerini günceller. Örnekte iki adım vardır:

1. Adım: Kanalın marka bilinci oluşturma seçeneklerini alın

channels.list yöntemini çağırıp part parametresi değerini brandingSettings, mine parametre değerini 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üleyebilir. Böylece, kullanıcının güncellenecek ayarları değiştirmesine izin verilir.
2. Adım: Kanalın marka bilinci oluşturma seçeneklerini güncelleyin

channels.list yöntemini çağırıp aşağıdaki değerleri ayarlayın:
- id özelliğini, kanalın benzersiz YouTube kanal kimliğine ayarlayın. Kimlik, 1. adımda API yanıtından çıkarılabilir.
- part parametre değerini brandingSettings olarak ayarlayın.
Aşağıdaki API Gezgini bağlantısı, aşağıdaki markalama 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 API Gezgini'nde tamamlamak için id özelliğinin değerini, kimliği doğrulanmış kullanıcının kanalının kimliğine ayarlamanız gerekir. Ayrıca, resim özelliklerini 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önetin

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 çıkan bir video grubudur. Örneğin, bir kanal en son yüklemelerini, en popüler yüklemelerini veya bir ya da daha fazla oynatma listesinden videoları içerebilir.

Aşağıdaki örnek, Google'ın resmi YouTube kanalının kanal bölümlerini alır. İstek channelSections.list yöntemini çağırır ve channelId parametre değerini Google'ı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

Bu istek, channelId parametresini kullanmak yerine mine parametre değerini true olarak ayarlarsanız yetkilendirme gerektirir. Bu parametre, kimliği doğrulanmış olan kullanıcının kanalı için kanal bölümleri aldığınızı gösterir.

Bir kanal için filigran resmi yükleyin ve ayarlayın

Filigran resmi yüklemek ve kanal için ayarlamak üzere watermarks.set yöntemini çağırabilirsiniz. Ardından resim, belirtilen kanalın videolarının oynatmaları sırasında görüntülenir. Ayrıca, resmin bağlanacağı hedef kanalın yanı sıra filigranın ne zaman görüneceğini ve ne kadar süre görüneceğini belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.

watermarks.unset yöntemi, bir kanalın filigran resmini siler.

API Gezgini, bu yöntem için gerekli olan medya dosyalarını yükleme özelliğini desteklemediğinden maalesef bu sorgu API Gezgini kullanılarak test edilemez.