Videos: batchGetStats

API isteği parametreleriyle eşleşen video istatistiklerinin listesini alır.

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/videos:batchGetStats

Yetkilendirme

Bu yöntemin herkese açık olmayan videolarda kullanılması için kimlik doğrulama gerekirken herkese açık videolarda gerekmez. Yetkilendirme sağlanırsa isteğin aşağıdaki kapsamların en az biriyle yetkilendirilmesi 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
https://www.googleapis.com/auth/youtube.readonly

Parametreler

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

Parametreler
Gerekli parametreler
id	string id parametresi, alınan kaynakların YouTube video kimliklerinin virgülle ayrılmış listesini belirtir. videoStat kaynağında, id özelliği videonun kimliğini belirtir.
part	string part parametresi, API yanıtının içereceği bir veya daha fazla videoStat kaynak özelliğinin virgülle ayrılmış listesini belirtir. Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları yer almaktadır: contentDetails id snippet statistics
İ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çin tasarlanmıştır. onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İYS kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalının sahibi ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için ayrı ayrı kimlik doğrulama bilgileri sağlamak zorunda kalmadan tek bir kimlik doğrulama işlemiyle tüm video ve kanal verilerine erişebilir. Kullanıcının kimliğini doğruladığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek metni

Bu yöntemi çağırırken istek gövdesi sağlamayın.

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#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

Ö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#batchGetStatsResponse olur.
etag	etag Bu kaynağın ETag'i.
items[]	list İstek ölçütleriyle eşleşen video istatistiklerinin listesi.
items[].id	string YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.
items[].snippet.publishTime	datetime Videonun yüklendiği tarih ve saat.
items[].statistics.viewCount	unsigned long Videonun görüntülenme sayısı.
items[].statistics.likeCount	unsigned long Videoyu beğendiğini belirten kullanıcıların sayısı.
items[].statistics.commentCount	unsigned long Videoya yapılan yorumların sayısı.
items[].contentDetails.duration	string Videonun uzunluğu.
items[].contentDetails.durationMillis	unsigned long Videonun milisaniye cinsinden uzunluğu.
summary	object batchGetStats isteğinin özeti.
summary.requestedVideoCount	unsigned long İstenen video sayısı.
summary.succeededVideoCount	unsigned long Başarılı olan videoların sayısı.
summary.failedVideoCount	unsigned long Başarısız olan videoların sayısı.
summary.failedVideoIds[]	list Başarısız olan video kimlikleri.

Hatalar

API, bu API yöntemine özgü herhangi bir hata mesajı tanımlamıyor. Ancak bu yöntem, hata mesajı dokümanında listelenen genel API hatalarını döndürmeye devam edebilir.