PlaylistImages: insert

Oynatma listesine resim ekler.

Bu yöntem, medya yüklemeyi destekler. Yüklenen dosyalar aşağıdaki kısıtlamalara uygun olmalıdır:

  • Maksimum dosya boyutu: 50 MB
  • Kabul edilen en boy oranı: 1:1 (kare)
  • Kabul edilen medya MIME türleri: image/jpeg, image/png

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 50 birimdir.

İstek

HTTP isteği

POST https://www.googleapis.com/youtube/v3/playlistImages

Yetkilendirme

Bu istek için aşağıdaki kapsamların en az biriyle yetkilendirme yapılması gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string

part parametresi, API yanıtının içereceği bir veya daha fazla playlistImage kaynak özelliğinin virgülle ayrılmış listesini belirtir.

Parametre, alt özellikleri içeren bir özellik tanımlıyorsa alt özellikler yanıta dahil edilir.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca doğru şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına işlem yapan bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahipleri, bu özellik sayesinde bir kez kimlik doğrulama yaparak tüm video ve kanal verilerine erişebilir. Her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamaları gerekmez. Kullanıcının kimlik doğrulaması için kullandığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

The onBehalfOfContentOwnerChannel parametresi bir videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bu parametre, bir istekte onBehalfOfContentOwner parametresi için bir değer belirtildiğinde zorunludur ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca isteğin, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirilmesi gerekir. Son olarak, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.

Bu parametre, birçok farklı YouTube kanalının sahibi olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin bir kez kimlik doğrulaması yapmasına ve her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamak zorunda kalmadan, parametre değerinde belirtilen kanal adına işlem yapmasına olanak tanır.

İstek metni

İstek gövdesinde bir playlistImages kaynağı sağlayın.

Bu kaynak için:

  • Şu özellikler için bir değer belirtmeniz gerekir:

    • snippet.playlistId
    • snippet.type

  • Bu özellikler için değerler ayarlayabilirsiniz:

    • snippet.width
    • snippet.height

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir playlistImages kaynağı döndürür.