Uygulama: Kanallar

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:

• Şu anda kimliği doğrulanmış kullanıcının YouTube kanalı hakkında bilgi 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ına ayarlayarak bu kullanıcı adıyla ilişkili kanalın bilgilerini alın. Bu örnekte, Google'ın resmi YouTube kanalıyla ilgili bilgileri almak için forUsername parametresi 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 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 öğ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.