PlaylistImages: list

API isteği parametreleriyle eşleşen oynatma listesi resimleri koleksiyonunu döndürür. Belirli bir oynatma listesinin oynatma listesi resmini veya benzersiz kimliklerine göre bir ya da daha fazla oynatma listesi resmini alabilirsiniz.

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

İstek

HTTP isteği

GET 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.
Filtreler (aşağıdaki parametrelerden tam olarak birini belirtin)
id
string id parametresi, bir veya daha fazla benzersiz oynatma listesi resim kimliğinin virgülle ayrılmış listesini belirtir.
playlistId
string playlistId parametresi, oynatma listesi resimlerini almak istediğiniz oynatma listesinin benzersiz kimliğini belirtir. Bu isteğe bağlı bir parametre olsa da, oynatma listesi resimlerini almak için yapılan her isteğin id parametresi veya playlistId parametresi için bir değer belirtmesi gerektiğini unutmayın.
İsteğe bağlı parametreler
maxResults
unsigned integer maxResults parametresi, sonuç kümesinde döndürülmesi gereken maksimum resim sayısını belirtir. Kabul edilebilir değerler: 0 - 50 (bu değerler dahil). Varsayılan değer 5 değeridir.
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.
pageToken
string pageToken parametresi, sonuç kümesinde döndürülmesi gereken belirli bir sayfayı tanımlar. API yanıtında nextPageToken ve prevPageToken özellikleri, alınabilecek diğer sayfaları tanımlar.

İstek içeriği

Bu yöntemi çağırırken istek gövdesini belirtmeyin.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
          "kind": "youtube#playlistImageListResponse",
          "nextPageToken": string,
          "prevPageToken": string,
          "pageInfo": {
            "totalResults": integer,
            "resultsPerPage": integer
          },
          "items": [
            playlistImages Resource
          ]
        }

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind
string API kaynağının türünü tanımlar. Değer youtube#playlistImageListResponse olur.
nextPageToken
string Sonuç kümesinde sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
prevPageToken
string Sonuç kümesinde önceki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
pageInfo
object pageInfo nesnesi, sonuç kümesine ait sayfa oluşturma bilgilerini içerir.
pageInfo.totalResults
integer Sonuç kümesindeki toplam sonuç sayısı.
pageInfo.resultsPerPage
integer API yanıtına dahil edilen sonuçların sayısı.
items[]
list İstek ölçütleriyle eşleşen oynatma listesi resimlerinin listesi.