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

Uygulama: Abonelikler

Aşağıdaki örneklerde, aboneliklerle ilgili işlevleri gerçekleştirmek için YouTube Data API'nin (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ı tanımlamanın iki yolu vardır:

Şu anda 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 söz konusu kanalın benzersiz YouTube kanal kimliğine ayarlayın. Aşağıdaki örnekte, YouTube'daki TED kanalının abone olduğu kanalların listesi getirilmektedir.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Not: Belirtilen kanal aboneliklerini herkese açık olarak göstermezse ve istek kanalın sahibi tarafından 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 gövdesi, aşağıdaki değerleri ayarlayan bir subscription kaynağıdır:

snippet.resourceId.kind, youtube#channel değerini içerir.
snippet.resourceId.channelId mülkü, abone olunan kanalı tanımlar. Mülk değeri, benzersiz bir YouTube kanalı kimliğidir. Kanal kimliği, channels.list yönteminin çağrılması veya kanal arama sonuçlarının alınması da dahil olmak üzere çeşitli yöntemlerle elde edilebilir.

Aşağıdaki API isteği, sizi YouTube'daki TED kanalına abone eder:

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.

Aboneliği silme

Bu örnekte bir abonelik siliniyor. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte iki adım vardır:

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

Aboneliklerin listesini almak için subscriptions.list yöntemini çağırın. Yukarıdaki kanal aboneliklerini alma örneğinde bu isteğin nasıl yapılacağı açıklanmaktadır.

API'yi çağıran uygulama, API yanıtını işleyebilir ve her aboneliğin kimliğini anahtar olarak kullanarak aboneliklerin listesini görüntüleyebilir. Yanıtta, her öğenin id mülkü, ilgili aboneliği benzersiz şekilde tanımlayan abonelik kimliğini tanımlar. Bir sonraki adımda listeden öğe kaldırmak için bu değeri kullanacaksınız.
2. Adım: Aboneliği silin

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

İsteği APIs Explorer'da tamamlamak için id mülkünün 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 olan kullanıcıların listesini alma

Şu anda kimliği doğrulanmış kullanıcının kanalına abone olan kanalların listesini almak için subscriptions.list yöntemini çağırın ve 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