Videos: batchGetStats

Ruft eine Liste von Videostatistiken ab, die den Parametern der API-Anfrage entsprechen.

Kontingentbelastung:Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.

Anfrage

HTTP-Anfrage

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

Autorisierung

Für die Verwendung dieser Methode für nicht öffentliche Videos ist eine Authentifizierung erforderlich, für öffentliche Videos jedoch nicht. Wenn eine Autorisierung erfolgt, muss die Anfrage mit mindestens einem der folgenden Bereiche autorisiert werden (weitere Informationen zur Authentifizierung und Autorisierung).

Umfang
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

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
id string
Der Parameter id gibt eine durch Kommas getrennte Liste der YouTube-Video-IDs für die abzurufenden Ressourcen an. In einer videoStat-Ressource gibt die Eigenschaft id die ID des Videos an.
part string
Mit dem Parameter part wird eine durch Kommas getrennte Liste mit einer oder mehreren videoStat-Ressourceneigenschaften angegeben, die in der API-Antwort enthalten sein sollen.

Die folgende Liste enthält die part-Namen, die Sie im Parameterwert angeben können:
  • contentDetails
  • id
  • snippet
  • statistics
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten der Anfrage einen YouTube-CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist für YouTube-Content-Partner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

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

Properties

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Properties
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#batchGetStatsResponse.
etag etag
Das ETag dieser Ressource.
items[] list
Eine Liste der Videostatistiken, die den Anfragekriterien entsprechen.
items[].id string
Die ID, die YouTube zur eindeutigen Identifizierung des Videos verwendet.
items[].snippet.publishTime datetime
Das Datum und die Uhrzeit, zu der das Video hochgeladen wurde.
items[].statistics.viewCount unsigned long
Gibt an, wie oft das Video aufgerufen wurde.
items[].statistics.likeCount unsigned long
Die Anzahl der Nutzer, die das Video mit „Mag ich“ bewertet haben.
items[].statistics.commentCount unsigned long
Die Anzahl der Kommentare zum Video.
items[].contentDetails.duration string
Die Länge des Videos.
items[].contentDetails.durationMillis unsigned long
Die Länge des Videos in Millisekunden.
summary object
Zusammenfassung der batchGetStats-Anfrage.
summary.requestedVideoCount unsigned long
Die Anzahl der angeforderten Videos.
summary.succeededVideoCount unsigned long
Die Anzahl der Videos, die erfolgreich hochgeladen wurden.
summary.failedVideoCount unsigned long
Die Anzahl der Videos, bei denen ein Fehler aufgetreten ist.
summary.failedVideoIds[] list
Die Video-IDs, bei denen der Vorgang fehlgeschlagen ist.

Fehler

Für diese API-Methode sind keine spezifischen Fehlermeldungen definiert. Diese Methode kann jedoch weiterhin allgemeine API-Fehler zurückgeben, die in der Dokumentation zu Fehlermeldungen aufgeführt sind.