Uygulama: Oynatma listeleri

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

Mevcut kullanıcının oynatma listelerini alma

Şu anda 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 örnekte, belirli bir kanal tarafından oluşturulan oynatma listeleri alınır. Örnekte iki adım vardır:

Belirli bir oynatma listesi hakkında bilgi alma

Bir veya daha fazla oynatma listesi hakkında bilgi almak için playlists.list yöntemini çağırın ve id parametresini, istenen kaynakları tanımlayan YouTube oynatma listesi kimliklerinin virgülle ayrılmış bir listesine ayarlayın. Bu işlevin yaygın kullanım alanlarından biri, bir arama sonucu grubunda döndürülen bir oynatma listesi grubu hakkında ek bilgi alma isteğidir. Örneğin, her oynatma listesinde bulunan öğ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 bilgiler playlist kaynağının contentDetails.itemCount mülkünde olduğundan istek, part parametresinin değerini contentDetails olarak ayarlar. 

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

Oynatma listesi ekleme

Bu örnekte, kimliği doğrulanmış kullanıcının kanalında gizli bir oynatma listesi oluşturmak için playlists.insert yöntemi çağrılıyor. Bu yönteme gönderilen tüm API isteklerinin OAuth 2.0 kullanılarak yetkilendirilmesi gerekir.

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

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

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

Aşağıdaki örnekte, yeni oynatma listesi podcast programı olarak işaretlenmiştir:

{
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "podcastStatus": "enabled"
  }
}

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

Oynatma listesini güncelleme

Bu örnekte, bir oynatma listesinin gizlilik durumu private olarak ayarlanmışken public olarak güncellenmektedir. Ö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 playlists.list yöntemini çağırın. Yukarıdaki mevcut kullanıcının oynatma listelerini alma konulu örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyebilir ve her şarkı listesinin kimliğini anahtar olarak kullanarak şarkı listelerinin listesini görüntüleyebilir.

  • 2. Adım: Oynatma listesini güncelleme

    Belirli bir oynatma listesini değiştirmek 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öntem çağrılırken snippet.title özelliği gerekli olduğundan istek metni, playlist kaynağının snippet bölümünü içermelidir. Ayrıca, güncellenen oynatma listesi kaynağında snippet.description veya snippet.tags özellikleri için değerler belirtilmişse bu değerler güncelleme isteğinde yeniden belirtilmelidir. Aksi takdirde silinirler.

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

    Yukarıdaki şarkı listesi ekleme örneğinde olduğu gibi, API Gezgini bağlantısı API isteğinin gövdesini belirten bir parametre ayarlar. İstek gövdesinde, oynatma listesinin başlığı, açıklaması ve gizlilik durumu gibi bilgileri tanımlayan bir playlist kaynağı bulunur. Bu örnekte aşağıdaki istek gövdesi kullanılmıştır:

    {
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "privacyStatus": "public"
  }
}

    Aşağıdaki örnekte, oynatma listesi podcast programı olarak işaretlenmiştir:

    {
  "id": "PLAYLIST_ID",
  "snippet": {
    "title": "New playlist",
    "description": "New playlist description"
  },
  "status": {
    "podcastStatus": "enabled"
  }
}

    Not: Bu sorguyu API Gezgini'nde test ediyorsanız kaynak gövdesine geçerli bir oynatma listesi kimliği eklemeniz gerekir. Oynatma listesi kimliği almak için önce yukarıda gösterilen oynatma listesi ekleme isteğini çalıştırmanızı öneririz. API yanıtından oynatma listesi kimliğini ayıklayı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ı, ilgili örnekte kullanılanlarla aynıdır.

Oynatma listesi öğesi ekleme

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

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

    Şu anda kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki mevcut kullanıcının oynatma listelerini alma konulu örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyebilir ve her şarkı listesinin kimliğini anahtar olarak kullanarak şarkı listelerinin listesini görüntü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 gövdesi, en az aşağıdaki değerleri belirten bir playlistItem kaynağıdır:

    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 özellikleri için değerler ayarlamanız gerekir.

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

    Not: playlistItems.insert yönteminin dokümanında, şarkı listesi öğesi eklerken ayarlayabileceğiniz diğer özellik değerleri tanımlanır.

Oynatma listesi resmi ekleme

Özel küçük resim yüklemek ve oynatma listesi için ayarlamak üzere v3 API'nin playlistImages.insert yöntemini kullanabilirsiniz. İsteğinizde playlistId parametresinin değeri, küçük resmin kullanılacağı oynatma listesini tanımlar.

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

Oynatma listesi öğesini güncelleme

Bu örnekte, bir oynatma listesi öğesi oynatma listesinin ilk öğesi olacak şekilde güncellenmektedir. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnek üç adımdan oluşur:

  • 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 playlists.list yöntemini çağırın. Yukarıdaki mevcut kullanıcının oynatma listelerini alma konulu örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyebilir ve her şarkı listesinin kimliğini anahtar olarak kullanarak şarkı listelerinin listesini görüntüleyebilir.

  • 2. adım: Seçilen şarkı listesindeki öğeleri alın

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

    API yanıtındaki her kaynak, ilgili öğeyi benzersiz şekilde tanımlayan oynatma listesi öğesi kimliğini tanımlayan bir id özelliği içerir. Bir sonraki adımda listeden öğe kaldırmak için bu değeri kullanacaksınız.

  • 3. Adım: Seçilen şarkı 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 metni, en azından aşağıdaki değerleri ayarlayan bir playlistItem kaynağı olmalıdır:

    • id mülkünü, 2. adımda elde edilen oynatma listesi öğesi kimliği olarak ayarlayın.
    • snippet.playlistId mülkünü, 1. adımda elde edilen oynatma listesi kimliğine ayarlayın.
    • snippet.resourceId.kind özelliğini youtube#video olarak ayarlayın.
    • snippet.resourceId.videoId mülkünü, oynatma listesine eklenen videoyu benzersiz şekilde tanımlayan video kimliğine ayarlayın.
    • snippet.position mülkünü 0 olarak veya öğenin görünmesini istediğiniz konuma (0 tabanlı bir dizin kullanarak) ayarlayın.

    Aşağıdaki API isteği, bir oynatma listesi öğesini oynatma listesindeki ilk öğe olacak şekilde günceller. İstek metni:

    {
  "id": "PLAYLIST_ITEM_ID",
  "snippet": {
    "playlistId": "PLAYLIST_ID",
    "resourceId": {
      "kind": "youtube#video",
      "videoId": "VIDEO_ID"
    },
    "position": 0
  }
}

    APIs Explorer'da isteği tamamlamak için id, snippet.playlistId ve snippet.resourceId.videoId özellikleri için değerler ayarlamanız gerekir.

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

Oynatma listesi resmini güncelleme

Oynatma listesinin küçük resmini güncellemek için v3 API'nin playlistImages.update yöntemini kullanabilirsiniz. İsteğinizde playlistId parametresinin değeri, küçük resmin kullanılacağı oynatma listesini tanımlar.

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

Oynatma listesi öğesini kaldırma

Bu örnekte, oynatma listesinden bir video silinmektedir. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte üç adım vardı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, oynatma listesinden video kaldırmak için playlistItems.delete yöntemini çağırın. İsteğin id parametresini, kaldırmak istediğiniz öğenin oynatma listesi öğe kimliğine ayarlayın. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir.

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

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

Oynatma listesi resmini kaldırma

Bu örnekte bir oynatma listesi resmi silinmektedir. Örnekte iki adım vardır:

  • 1. Adım: Oynatma listesini alın

    Şu anda kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki mevcut kullanıcının oynatma listelerini alma konulu örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyebilir ve her şarkı listesinin kimliğini anahtar olarak kullanarak şarkı listelerinin listesini görüntüleyebilir.

  • 2. Adım: Oynatma listesi resim kimliğini alın

    Oynatma listesinin küçük resmini almak için playlistImages.list yöntemini çağırın. Değiştirmek istediğiniz oynatma listesinin oynatma listesi kimliğini kullanın.

  • 3. adım: Şarkı listesi resmini silme

    Belirli bir oynatma listesi resmini silmek için playlistImages.delete yöntemini çağırın. İstekteki id parametresi, silinen oynatma listesi resminin 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.playlistImages.delete?
        id=ID

    Not: Bu sorguyu API Gezgini'nde test ediyorsanız id parametre değerini geçerli bir oynatma listesi resim kimliğiyle değiştirmeniz gerekir.

Oynatma listesini kaldırma

Bu örnekte bir oynatma listesi siliniyor. Ö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 playlists.list yöntemini çağırın. Yukarıdaki mevcut kullanıcının oynatma listelerini alma konulu örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyebilir ve her şarkı listesinin kimliğini anahtar olarak kullanarak şarkı listelerinin listesini görüntüleyebilir.

  • 2. Adım: Şarkı listesini silme

    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 önce yukarıda gösterilen oynatma listesi ekleme isteğini çalıştırmanızı öneririz. API yanıtından oynatma listesi kimliğini ayıklayın ve silmek istediğiniz oynatma listesi için bu değeri kullanın.