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ğiid
ö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övdesiplaylist
kaynağınınsnippet
bölümünü içermelidir. Ayrıca, güncellenen oynatma listesi kaynağısnippet.description
veyasnippet.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 birplaylistItem
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
vesnippet.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ğerinisnippet
olarak ayarlayın. İstek gövdesi, en azından aşağıdaki değerleri ayarlayan birplaylistItem
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ğiniyoutube#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ğini0
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
vesnippet.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. İstekteid
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ızid
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.