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

Uygulama: Oynatma listeleri

Aşağıdaki örneklerde, oynatma listeleri ve oynatma listesi öğeleriyle ilgili işlevlerin gerçekleştirilmesi için YouTube Data API'sının (v3) nasıl kullanılacağı gösterilmektedir.

Geçerli kullanıcının oynatma listelerini al

Kimliği doğrulanmış kullanıcının oynatma listelerini almak için playlists.list yöntemini çağırın. İsteğinizde 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.playlists.list?
        part=snippet,contentDetails
        &mine=true

Kullanıcının oynatma listelerini alma

Bu örnek, belirli bir kanal tarafından oluşturulan oynatma listelerini alır. Örnekte iki adım vardır:

1. Adım: Kanal kimliğini alma

Belirli bir YouTube kullanıcı adıyla ilişkili kanal kimliğini almak için channels.list yöntemini çağırın. (Bu örnekte, kullanıcı adı GoogleDevelopers'dir.) API yanıtında kanal kimliği id özelliği tarafından tanımlanır.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=id
        &forUsername=GoogleDevelopers
```
2. Adım: Kanalın oynatma listelerini alma

Kanalın oynatma listelerini almak için playlists.list yöntemini çağırın. channelId parametresinin değerini 1. adımda elde edilen değere ayarlayın.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=snippet,contentDetails
        &channelId=UC_x5XG1OV2P6uZZ5FSM9Ttw
```

Belirli bir oynatma listesiyle ilgili bilgileri alma

Bir veya daha fazla belirli oynatma listesi hakkında bilgi almak için playlists.list yöntemini çağırıp id parametresini, istenen kaynakları tanımlayan YouTube oynatma listesi kimliklerinin virgülle ayrılmış listesi olarak ayarlayın. Bu işlevin yaygın bir kullanım alanı, bir dizi arama sonucuyla döndürülen oynatma listesi grubu hakkında ek bilgi alma isteğidir. Örneğin, her bir oynatma listesindeki öğelerin sayısını almak isteyebilirsiniz.

Aşağıdaki istek, "GoogleDevelopers" sorgu terimiyle eşleşen iki oynatma listesindeki öğe sayısını almak için playlists.list yöntemini çağırır. Bu bilgi playlist kaynağının contentDetails.itemCount özelliğinde olduğu için istek part parametre değerini contentDetails olarak ayarlar.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list?
        part=contentDetails
        &id=PLOU2XLYxmsIIM9h1Ybw2DuRw6o2fkNMeR,PLyYlLs02rgBYRWBzYpoHz7m2SE8mEZ68w

Oynatma listesi ekle

Bu örnekte, kimliği doğrulanmış kullanıcının kanalında gizli bir oynatma listesi oluşturmak için playlists.insert yöntemi kullanılır. Bu yönteme yapılan tüm API istekleri OAuth 2.0 kullanılarak yetkilendirilmelidir.

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

API Gezgini'nin bağlantısı, API isteğinin gövdesini belirten bir parametre de ayarlar. İstek metni, oynatma listesinin başlığı, açıklaması ve gizlilik durumu gibi bilgileri tanımlayan bir playlist kaynağı içerir. Bu örnekte, istek gövdesi:

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "private"
  }
}

İlgili kod örnekleri: Java, JavaScript, .NET, PHP, Python

Oynatma listesi güncelleme

Bu örnek, private adlı oynatma listesinin gizlilik durumunu public olarak güncellemektedir. Örnekte iki adım vardır:

1. Adım: Oynatma listesi kimliğini alın

Kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlist.list yöntemini çağırın. Yukarıdaki örnek istek mevcut kullanıcının oynatma listelerini alma isteğiyle ilgilidir. API'yi çağıran uygulama, her bir oynatma listesinin kimliğini anahtar olarak kullanarak oynatma listesi listesini görüntülemek için API yanıtını işleyebilir.
2. Adım: Oynatma listesini güncelleyin

Belirli bir oynatma listesinde değişiklik yapmak için playlists.update yöntemini çağırın. Bu yöntem için geçerli bir OAuth 2.0 yetkilendirme jetonu gerekir.

Bu yöntemi çağırırken snippet.title özelliği gerekli olduğundan istek gövdesi playlist kaynağının snippet bölümünü içermelidir. Ayrıca, güncellenen oynatma listesi kaynağı snippet.description veya snippet.tags özellikleri için değer belirtiyorsa bu değerlerin güncelleme isteğinde yeniden belirtilmesi gerekir; aksi takdirde silinirler.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.update?
        part=snippet,status
```
Oynatma listesi eklemeyle ilgili yukarıdaki örnekte olduğu gibi, API Gezgini'nin bağlantısı, API isteğinin gövdesini belirten bir parametre ayarlar. İstek metni, oynatma listesinin başlığı, açıklaması ve gizlilik durumu gibi bilgileri tanımlayan bir playlist kaynağı içerir. Bu örnekte aşağıdaki istek gövdesi kullanılmaktadır:
```
{
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "public"
  }
}
```
Not: Bu sorguyu API Gezgini'nde test ediyorsanız kaynak gövdesinde geçerli bir oynatma listesi kimliği oluşturmanız gerekir. Oynatma listesi kimliği almak için öncelikle oynatma listesi ekleme bölümünde gösterilen isteği çalıştırmanızı öneririz. API yanıtından oynatma listesi kimliğini çıkarın ve güncellemek istediğiniz oynatma listesi için bu değeri kullanın. Bu örnekte kullanılan oynatma listesi başlığı ve açıklaması bu örnekte kullanılanlarla aynıdır.

Oynatma listesi öğesi ekleme

Bu örnek, oynatma listesine bir öğe ekler. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte iki adım bulunmaktadır:

1. Adım: Uygun oynatma listesi kimliğini alın

Kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlist.list yöntemini çağırın. Yukarıdaki örnek istek mevcut kullanıcının oynatma listelerini alma isteğiyle ilgilidir. API'yi çağıran uygulama, her bir oynatma listesinin kimliğini anahtar olarak kullanarak oynatma listesi listesini görüntülemek için API yanıtını işleyebilir.
2. Adım: Oynatma listesine video ekleyin

Oynatma listesine video eklemek için playlistItems.insert yöntemini çağırın. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. İstek metni, en az aşağıdaki değerleri belirten bir playlistItem kaynağıdır:
- snippet.playlistId, videoyu eklediğiniz oynatma listesini tanımlar. Bu, 1. adımda edindiğiniz oynatma listesi kimliğidir.
- snippet.resourceId.kind, youtube#video değerini içerir.
- snippet.resourceId.videoId, oynatma listesine eklediğiniz videoyu tanımlar. Mülk değeri, benzersiz bir YouTube video kimliğidir.
Aşağıdaki API isteği, bir oynatma listesine video ekler. İstek metni:
```
{
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    }
  }
}
```
İsteği API Gezgini'nde tamamlamak için snippet.playlistId ve snippet.resourceId.videoId özelliklerine ilişkin değerleri ayarlamanız gerekir.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.insert?
        part=snippet
```
Not: playlistItems.insert yöntemine ilişkin dokümanlar, oynatma listesi öğesi eklerken ayarlayabileceğiniz diğer özellik değerlerini tanımlar.

Oynatma listesi öğesini güncelleme

Bu örnekte oynatma listesi öğesi, oynatma listesindeki ilk öğe olacak şekilde güncellenir. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte üç adım bulunmaktadır:

1. Adım: Uygun oynatma listesi kimliğini alın

Kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlist.list yöntemini çağırın. Yukarıdaki örnek istek mevcut kullanıcının oynatma listelerini alma isteğiyle ilgilidir. API'yi çağıran uygulama, her bir oynatma listesinin kimliğini anahtar olarak kullanarak oynatma listesi listesini görüntülemek için API yanıtını işleyebilir.
2. Adım: Seçili oynatma listesindeki öğeleri alın

Seçilen oynatma listesindeki videoların listesini almak için playlistItems.list yöntemini çağırın. playlistId parametresinin değerini 1. adımda elde ettiğiniz oynatma listesi kimliğine ayarlayın.

API yanıtındaki her kaynak, bir öğeyi benzersiz şekilde tanımlayan oynatma listesi öğesi kimliğini tanımlayan bir id özelliği içerir. Bir sonraki adımda öğeyi listeden kaldırmak için bu değeri kullanacaksınız.
3. Adım: Seçili oynatma listesi öğesini güncelleyin

Videonun oynatma listesindeki konumunu değiştirmek için playlistItems.update yöntemini çağırın. part parametre değerini snippet olarak ayarlayın. İstek gövdesi, en azından aşağıdaki değerleri ayarlayan bir playlistItem kaynağı olmalıdır:
- id özelliğini, 2. adımda elde edilen oynatma listesi öğesi kimliğine ayarlayın.
- snippet.playlistId özelliğini, 1. adımda elde ettiğiniz oynatma listesi kimliğine ayarlayın.
- snippet.resourceId.kind özelliğini youtube#video olarak ayarlayın.
- snippet.resourceId.videoId özelliğini, oynatma listesine eklenen videoyu benzersiz şekilde tanımlayan video kimliğine ayarlayın.
- snippet.position özelliğini 0 veya öğenin görünmesini istediğiniz konuma (0 tabanlı bir dizin kullanarak) ayarlayın.
Aşağıdaki API isteği, oynatma listesi öğelerini oynatma listesindeki ilk öğe olarak günceller. İstek metni:
```
{
  "id": "PLAYLIST_ITEM_ID",
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    },
    "position": 0
  }
}
```
İsteği API Gezgini'nde tamamlamak için id, snippet.playlistId ve snippet.resourceId.videoId mülklerinin değerlerini ayarlamanız gerekir.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.update?
        part=snippet
```

Oynatma listesi öğesini kaldırma

Bu örnek, oynatma listesindeki bir videoyu siler. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte üç adım bulunmaktadır. İlk iki adım, yukarıdaki oynatma listesi öğesini güncelleme örneğindeki adımlarla aynıdır.

Bu adımları tamamladıktan sonra videoyu oynatma listesinden kaldırmak için playlistItems.delete yöntemini çağırın. İsteğin id parametresini, kaldırmak istediğiniz öğenin oynatma listesi öğesi kimliğine ayarlayın. Bu istek OAuth 2.0 kullanılarak yetkilendirilmelidir.

Oynatma listesindeki bir videoyu tanımlamak için kullanılan oynatma listesi öğesi kimliğinin, videoyu benzersiz şekilde tanımlayan YouTube video kimliğinden farklı olduğunu unutmayın. Oynatma listesi kimliği, videoyu belirli bir oynatma listesinde öğe olarak tanımlar.

İ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.playlistItems.delete?
        id=PLAYLIST_ITEM_ID

Oynatma listesini kaldırma

Bu örnek, oynatma listesini siler. Örnekte iki adım vardır:

1. Adım: Oynatma listesi kimliğini alın

Kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlist.list yöntemini çağırın. Yukarıdaki örnek istek mevcut kullanıcının oynatma listelerini alma isteğiyle ilgilidir. API'yi çağıran uygulama, her bir oynatma listesinin kimliğini anahtar olarak kullanarak oynatma listesi listesini görüntülemek için API yanıtını işleyebilir.
2. Adım: Oynatma listesini silin

Belirli bir oynatma listesini silmek için playlists.delete yöntemini çağırın. İstekte id parametresi, silinen oynatma listesinin oynatma listesi kimliğini belirtir. Bu yöntem için geçerli bir OAuth 2.0 yetkilendirme jetonu gerekir. Bu sorguyu API Gezgini'nde test ediyorsanız id parametre değerini geçerli bir oynatma listesi kimliğiyle değiştirmeniz gerekir.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.delete?
        id=PLAYLIST_ID
```
Not: Bu sorguyu API Gezgini'nde test ediyorsanız id parametre değerini geçerli bir oynatma listesi kimliğiyle değiştirmeniz gerekir. Oynatma listesi kimliği almak için öncelikle oynatma listesi ekleme bölümünde gösterilen isteği çalıştırmanızı öneririz. API yanıtından oynatma listesi kimliğini çıkarın ve silmek istediğiniz oynatma listesi için bu değeri kullanın.