PlaylistImages: insert

Oynatma listesine resim ekler.

Bu yöntem medya yüklemeyi destekler. Yüklenen dosyalar şu kısıtlamalara uymalıdır:

  • Maksimum dosya boyutu: 2 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 50 birimlik kota maliyeti olur.

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (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, bir veya daha fazla playlistImage kaynağının virgülle ayrılmış listesi özellikleri.

Parametre alt mülkleri içeren bir mülkü tanımlar, bu da yanıta dahil edilecek.
İsteğe bağlı parametreler
onBehalfOfContentOwner
string Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları içindir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İçerik Yönetim Sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimliklerini doğrulamalarını ve tüm video ve kanal verilerine erişmelerini sağlar. Kullanıcının kimlik doğrulaması yaptığı 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.

onBehalfOfContentOwnerChannel parametresi videonun gösterildiği kanalın YouTube kanal kimliğini belirtir eklendi. Bu parametre, bir istek onBehalfOfContentOwner parametresidir ve yalnızca şurada kullanılabilir: bu parametreyle bağlantılı değildir. Ayrıca, istek içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirilmiş olmalıdır. onBehalfOfContentOwner parametresi belirtir. Son olarak, onBehalfOfContentOwnerChannel parametresinin değerinin etkin olduğu kanal belirtilen içerik sahibine bağlı olması gerektiğini belirtir onBehalfOfContentOwner parametresi belirtilir.

Bu parametresi, birçok videonun sahibi ve yöneticisi olan YouTube içerik iş ortaklarına farklı YouTube kanallarından. İçerik sahiplerinin bir kez kimlik doğrulaması yapmasını sağlar ve parametrede belirtilen kanal adına işlem gerçekleştirmeleri gerekir. her biri için kimlik doğrulama bilgileri sağlamak zorunda kalmadan ayrı bir kanal.

İstek içeriği

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

Bu kaynak için:

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

    • snippet.playlistId
    • snippet.type

  • Şu ö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.