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.

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

Kimliği doğrulanmış geçerli 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

Bir kullanıcının oynatma listelerini al

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

Belirli bir oynatma listesi hakkında bilgi alma

Belirli 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ış listesine ayarlayın. Bu işlevin yaygın kullanım alanlarından biri, bir dizi arama sonucunda döndürülen oynatma listeleri grubu hakkında ek bilgi alma isteğidir. Örneğin, her bir oynatma listesindeki öğe sayısını almak isteyebilirsiniz.

Aşağıdaki istekte, iki oynatma listesindeki "GoogleDevelopers" sorgu terimiyle eşleşen öğelerin sayısını almak için playlists.list yöntemi çağrılır. Bu bilgi, playlist kaynağının contentDetails.itemCount özelliğinde yer aldığı 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 ekleme

Bu örnekte, kimliği doğrulanan kullanıcının kanalında gizli bir oynatma listesi oluşturmak için playlists.insert yöntemi çağrılır. Bu yönteme yapılacak 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'ne giden bağlantı, 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, isteğin gövdesi şöyledir:

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

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

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

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

Oynatma listesi güncelleme

Bu örnekte, bir oynatma listesinin private olan gizlilik durumu public olarak güncellenir. Örnekte iki adım vardır:

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

    Kimliği doğrulanmış olan kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki geçerli kullanıcının oynatma listelerini alma ile ilgili örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyerek bir oynatma listesi listesi görüntüleyebilir ve her oynatma listesinin kimliğini anahtar olarak kullanabilir.

  • 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 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 özelliklerinin değerlerini belirtiyorsa bu değerler güncelleme isteğinde yeniden belirtilmelidir. Aksi takdirde bu değerler silinir.

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

    Yukarıdaki oynatma listesi ekleme örnekte olduğu gibi API Gezgini'nin 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ılı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şaretlenmektedir:

    {
  "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. Bir 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 çı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 ekleyin

Bu örnek, bir oynatma listesine öğe ekler. 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

    Kimliği doğrulanmış olan kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki geçerli kullanıcının oynatma listelerini alma ile ilgili örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyerek bir oynatma listesi listesi görüntüleyebilir ve her oynatma listesinin kimliğini anahtar olarak kullanabilir.

  • 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. İsteğin gövdesi, en azından aşağıdaki değerleri belirten bir playlistItem kaynağıdır:

    Aşağıdaki API isteği, bir oynatma listesine video ekler. İsteğin ana 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 özelliklerinin değerlerini ayarlamanız gerekir.

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

    Not: playlistItems.insert yönteminin dokümanlarında, oynatma listesi öğesi eklerken ayarlayabileceğiniz diğer özellik değerleri tanımlanmaktadır.

Oynatma listesi resmi ekleyin

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

API Gezgini, medya dosyalarını yükleme özelliğini desteklemediğinden bu sorgu API Gezgini ile test edilemez. Bu özellik bu yöntem için gereklidir.

Oynatma listesi öğesini güncelleme

Bu örnek, bir oynatma listesi öğesini, oynatma listesindeki ilk öğe olacak şekilde günceller. Bu istek, OAuth 2.0 kullanılarak yetkilendirilmelidir. Bu örnekte üç adım vardır:

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

    Kimliği doğrulanmış olan kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki geçerli kullanıcının oynatma listelerini alma ile ilgili örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyerek bir oynatma listesi listesi görüntüleyebilir ve her oynatma listesinin kimliğini anahtar olarak kullanabilir.

  • 2. Adım: Seçili oynatma 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 elde ettiğiniz oynatma listesi kimliğine ayarlayın.

    API yanıtındaki her kaynak, söz konusu öğeyi benzersiz şekilde tanımlayan oynatma listesi öğesi kimliğini tanımlayan bir id özelliği içerir. Bir sonraki adımda listeden bir öğeyi 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. İsteğin gövdesi, en azından aşağıdaki değerleri ayarlayan bir playlistItem kaynağı olmalıdır:

    • id özelliğini, 2. adımda elde ettiğiniz 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 değerine veya öğenin görünmesini istediğiniz konuma ayarlayın (0 tabanlı bir dizin kullanarak).

    Aşağıdaki API isteği, bir oynatma listesi öğesini oynatma listesindeki ilk öğe olacak şekilde günceller. İsteğin ana 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 özelliklerinin değerlerini 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'sinin playlistImages.update yöntemini kullanabilirsiniz. İsteğinizde playlistId parametresi değeri, küçük resmin kullanılacağı oynatma listesini tanımlar.

API Gezgini, medya dosyalarını yükleme özelliğini desteklemediğinden bu sorgu API Gezgini ile test edilemez. Bu özellik bu yöntem için gereklidir.

Oynatma listesi öğesini kaldırma

Bu örnekte, oynatma listesinden bir video silinir. 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 adımıyla aynıdır.

Bu adımları tamamladıktan sonra, bir 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 öğ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 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 listesi resmini kaldırma

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

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

    Kimliği doğrulanmış olan kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki geçerli kullanıcının oynatma listelerini alma ile ilgili örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyerek bir oynatma listesi listesi görüntüleyebilir ve her oynatma listesinin kimliğini anahtar olarak kullanabilir.

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

    Bir 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: Oynatma listesi resmini silme

    Belirli bir oynatma listesi resmini silmek için playlistImages.delete yöntemini çağırın. İstekte id parametresi, silinmekte olan 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 görüntü kimliğiyle değiştirmeniz gerekir.

Oynatma listesi kaldırma

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

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

    Kimliği doğrulanmış olan kullanıcının kanalındaki oynatma listelerini almak için playlists.list yöntemini çağırın. Yukarıdaki geçerli kullanıcının oynatma listelerini alma ile ilgili örnek istek bu isteği göstermektedir. API'yi çağıran uygulama, API yanıtını işleyerek bir oynatma listesi listesi görüntüleyebilir ve her oynatma listesinin kimliğini anahtar olarak kullanabilir.

  • 2. Adım: Oynatma 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. Bir 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 çıkarın ve silmek istediğiniz oynatma listesi için bu değeri kullanın.