Videos: batchGetStats

Pobiera listę statystyk filmów, które pasują do parametrów żądania do interfejsu API.

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu w wysokości 1 jednostki.

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/videos:batchGetStats

Autoryzacja

W przypadku filmów niepublicznych do korzystania z tej metody wymagane jest uwierzytelnianie, ale w przypadku filmów publicznych nie jest ono konieczne. Jeśli autoryzacja jest zapewniona, żądanie musi być autoryzowane za pomocą co najmniej jednego z tych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).

Zakres
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

Parametry

W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry to parametry zapytania.

Parametry
Parametry wymagane
id	string Parametr id określa rozdzieloną przecinkami listę identyfikatorów filmów w YouTube dla pobieranych zasobów. W zasobie videoStat właściwość id określa identyfikator filmu.
part	string Parametr part określa rozdzieloną przecinkami listę co najmniej 1 właściwości zasobu videoStat, które będą uwzględnione w odpowiedzi interfejsu API. Poniższa lista zawiera nazwy part, które możesz uwzględnić w wartości parametru: contentDetails id snippet statistics
Parametry opcjonalne
onBehalfOfContentOwner	string Ten parametr może być używany tylko w odpowiednio autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów YouTube zajmujących się treściami. Parametr onBehalfOfContentOwner oznacza, że dane logowania autoryzacji żądania identyfikują użytkownika systemu CMS YouTube, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Umożliwia właścicielom treści jednorazowe uwierzytelnianie i uzyskiwanie dostępu do wszystkich danych dotyczących filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału z osobna. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "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
    ]
  }
}

Właściwości

W tej tabeli znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość to youtube#batchGetStatsResponse.
etag	etag Etag tego zasobu.
items[]	list Lista statystyk filmów, które pasują do kryteriów żądania.
items[].id	string Identyfikator, którego YouTube używa do jednoznacznej identyfikacji filmu.
items[].snippet.publishTime	datetime Data i godzina przesłania filmu.
items[].statistics.viewCount	unsigned long Liczba wyświetleń filmu.
items[].statistics.likeCount	unsigned long Liczba użytkowników, którzy polubili film.
items[].statistics.commentCount	unsigned long Liczba komentarzy do filmu.
items[].contentDetails.duration	string Długość filmu.
items[].contentDetails.durationMillis	unsigned long Długość filmu w milisekundach.
summary	object Podsumowanie żądania batchGetStats.
summary.requestedVideoCount	unsigned long Liczba żądanych filmów.
summary.succeededVideoCount	unsigned long Liczba filmów, które zostały przesłane.
summary.failedVideoCount	unsigned long Liczba filmów, których nie udało się przetworzyć.
summary.failedVideoIds[]	list Identyfikatory filmów, których nie udało się przetworzyć.

Błędy

Interfejs API nie definiuje żadnych komunikatów o błędach, które są unikalne dla tej metody. Może jednak zwracać ogólne błędy interfejsu API wymienione w dokumentacji komunikatów o błędach.