Uygulama: Abonelikler

Aşağıdaki örneklerde, aboneliklerle ilgili işlevleri yerine getirmek için YouTube Data API'sının (v3) nasıl kullanılacağı gösterilmektedir.

Kanal aboneliklerini alma

Belirli bir kanalın aboneliklerini almak için subscriptions.list yöntemini çağırın. Kanalı belirlemenin iki yolu vardır:

• Kimliği doğrulanmış kullanıcının aboneliklerini almak için mine parametresinin değerini true olarak ayarlayın. mine parametresini kullanan bir isteğin OAuth 2.0 kullanılarak yetkilendirilmesi gerektiğini unutmayın.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &mine=true

• Başka bir kanalın aboneliklerini almak için channelId parametresinin değerini kanalın benzersiz YouTube kanal kimliğine ayarlayın. Aşağıdaki örnek, YouTube'da TED kanalının abone olduğu kanalların listesini alır.

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

  Not: Belirtilen kanal, aboneliklerini herkese açık şekilde göstermiyorsa ve kanal sahibi tarafından istek yetkilendirilmemişse API, 403 (Forbidden) HTTP yanıt kodu döndürür.

Kod örnekleri için subscriptions.list yönteminin dokümanlarına bakın.

Abonelik ekleme

Kanal aboneliği eklemek için subscriptions.insert yöntemini çağırın. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. İstek metni, aşağıdaki değerleri ayarlayan bir subscription kaynağıdır:

• snippet.resourceId.kind, youtube#channel değerini içerir.
• snippet.resourceId.channelId özelliği, abone olunan kanalı tanımlar. Mülk değeri benzersiz bir YouTube kanalı kimliğidir. Kanal kimliği channels.list yöntemini çağırma veya kanallar için arama sonuçları alma dahil olmak üzere birçok şekilde elde edilebilir.

Aşağıdaki API isteği YouTube'daki TED kanalına abone olmanızı sağlar:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

İstek metni:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Kod örnekleri için subscriptions.insert yönteminin dokümanlarına bakın.

Abonelik silme

Bu örnek bir aboneliği siler. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte iki adım bulunmaktadır:

• 1. Adım: Kimliği doğrulanmış kullanıcının kanalının aboneliklerini alın

  Abonelik listesini almak için subscriptions.list yöntemini çağırın. Kanal aboneliklerini almayla ilgili yukarıdaki örnekte bu istek nasıl yapılır?

  API'yi çağıran uygulama, her aboneliğin kimliğini anahtar olarak kullanarak aboneliklerin listesini göstermek için API yanıtını işleyebilir. Yanıtta, her öğenin id özelliği, ilgili aboneliği benzersiz şekilde tanımlayan abonelik kimliğini tanımlar. Bir sonraki adımda öğeyi listeden kaldırmak için bu değeri kullanacaksınız.

• 2. Adım: Bir aboneliği silin

  Bir aboneliği silmek için subscriptions.delete yöntemini çağırın. İsteğin id parametresini, kaldırmak istediğiniz abonelik için abonelik kimliğine ayarlayın. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir.

  İsteği API Gezgini'nde tamamlamak için id özelliğinin değerini ayarlamanız gerekir.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

Kod örnekleri için subscriptions.delete yönteminin dokümanlarına bakın.

Yetkili kullanıcının kanalına abone listesi alma

Kimliği doğrulanmış kullanıcının kanalına abone olan kanalların listesini almak için subscriptions.list yöntemini çağırıp mySubscribers parametresinin değerini true olarak ayarlayın. İstek OAuth 2.0 kullanılarak yetkilendirilmelidir.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true