Uygulama: Kanallar

Bu sayfada, kanal verilerini alma ve güncelleme ile 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.

Bir kanal hakkında bilgi alma

Belirli bir kanal hakkında bilgi almak için channels.list yöntemini çağırın. Kanalı tanımlamanın birkaç yolu vardır:

• Kimliği doğrulanmış mevcut 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

• forUsername parametresini bir YouTube kullanıcı adı olarak ayarlayarak bu kullanıcı adıyla ilişkili kanalın bilgilerini alabilirsiniz. Bu örnekte, Google'ın resmi YouTube kanalıyla ilgili bilgileri 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, bilgilerini aldığınız kanalı benzersiz şekilde tanımlayan YouTube kanal kimliğine ayarlayın. Bu örnekte, id parametresi UCK8sQmJBp8GCxrOtXWBpyEA olarak ayarlanmıştır. Bu değer, Google'ın resmi YouTube kanalını da tanımlar.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &id=UCK8sQmJBp8GCxrOtXWBpyEA

Kanalın marka bilgilerini ayarlama

Bu örnekte, bir kanalın marka öğeleri seçenekleri güncelleniyor. Örnek iki adımdan oluşur:

• 1. adım: Kanalın marka öğeleri seçeneklerini alın

  channels.list yöntemini çağırın ve part parametre değerini brandingSettings, mine parametre 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 ö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 marka ayarlarıyla 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"
      }
    }
  }

  API Gezgini'nde isteği tamamlamak için id özelliğinin değerini, kimliği doğrulanmış kullanıcının kanalının kanal kimliği olarak 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ö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 bir dizi videodur. Örneğin, bir bölümde kanalın en son yüklemeleri, en popüler yüklemeleri veya bir ya da daha fazla oynatma listesindeki videolar yer alabilir.

Aşağıdaki örnekte, Google'ın resmi YouTube kanalının kanal bölümleri alınır. İstek, channelSections.list yöntemini çağırır ve channelId parametre değerini UCK8sQmJBp8GCxrOtXWBpyEA olarak ayarlar. Bu değer, Google'ın kanalının kanal kimliğidir.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

channelId parametresini kullanmak 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ına ait kanal bölümlerini aldığınızı gösterir.

Kanal için filigran resmi yükleme ve ayarlama

Filigran resmi yüklemek ve bunu bir kanal için ayarlamak üzere watermarks.set yöntemini çağırabilirsiniz. Ardından, belirtilen kanalın videoları oynatılırken resim gösterilir. Ayrıca, resmin bağlantı vereceği hedef kanalı ve filigranın ne zaman görüneceğini ve ne kadar süreyle görünür kalacağını belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.

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

Maalesef bu sorgu, API Gezgini kullanılarak test edilemez. Çünkü API Gezgini, bu yöntem için gerekli olan medya dosyası yükleme özelliğini desteklemez.