Auf dieser Seite findest du Beispielanfragen für die YouTube Analytics API. In jedem Beispiel wird der abgerufene Bericht kurz beschrieben und dann die entsprechenden Parameterwerte für dimensions, metrics, filters und sort angezeigt. In den Dokumenten zu Kanalberichten und Berichten für Rechteinhaber werden die Berichte aufgeführt, die von der API unterstützt werden.
Jedes Beispiel enthält einen Link zum Google APIs Explorer, in dem die angezeigten Werte eingefügt werden. In den Beispielen werden außerdem die standardmäßigen Start- und Enddaten (YYYY-MM-DD) von 2023-09-01 und 2024-03-31 verwendet.
Nach der Verknüpfung mit APIs Explorer müssen Sie weiterhin den Kanal oder Rechteinhaber angeben, für den Sie Berichte abrufen möchten. Im APIs Explorer wird der Wert des Parameters ids entweder mit channel==MINE oder contentOwner==CONTENT_OWNER_ID ausgefüllt, je nachdem, auf welche Abfrage Sie geklickt haben. Bei Kanalberichten können Sie MINE durch die Kanal-ID des authentifizierten Nutzers ersetzen. Bei Berichten zu Rechteinhabern musst du CONTENT_OWNER_ID durch deine Rechteinhaber-ID ersetzen.
Außerdem musst du als angegebener Kanal- oder Rechteinhaber authentifiziert sein, damit der APIs Explorer deine API-Anfragen mit OAuth 2.0 autorisieren kann.
Anfragen nach mehreren Dimensionen/Messwerten sortieren
Die API unterstützt die Sortierung von Antwortdaten anhand mehrerer Dimensionen oder Messwerte. Mit der folgenden Anfrage werden beispielsweise tägliche Daten zu Besucherquellen für die Videos eines bestimmten Kanals abgerufen. In jeder Zeile der Ergebnismenge sind die Anzahl der Aufrufe und die geschätzte Wiedergabezeit angegeben, die an einem bestimmten Tag aus einer bestimmten Art von Besucherquelle (z. B. EXT_URL) stammen.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-viewsIn der Antwort sind die Ergebnisse chronologisch sortiert. Innerhalb der Ergebnismenge für jeden Tag werden die Ergebnisse in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Die erste Zeile im Ergebnissatz enthält also Daten für die Besucherquelle, über die am ersten Tag des angegebenen Zeitraums die meisten Aufrufe erzielt wurden. Die zweite Zeile enthält Daten für die Besucherquelle, die am ersten Tag die nächsthöhere Anzahl von Aufrufen generiert hat.
Kanalberichte
Videoberichte
Gesamtzahl der Aufrufe, geschätzte Wiedergabezeit und mehr für einen Kanal
Mit dieser Abfrage werden zusammengefasste Messwerte für die Inhalte des Kanals abgerufen. Der Bericht enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDurationLänderspezifische Aufrufzahlen und mehr für einen Kanal
Mit dieser Abfrage werden Messwerte für ein bestimmtes Land für die Videos eines Kanals abgerufen. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==USTop 10 – Die meistgesehenen Videos eines Kanals
Mit dieser Abfrage werden die zehn meistgesehenen Videos eines Kanals abgerufen, gemessen an der geschätzten Wiedergabezeit im angegebenen Zeitraum. Die Ergebnisse werden nach den geschätzten angesehenen Minuten in absteigender Reihenfolge sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatchedTop 10 – Klickraten für Anmerkungen in den meistgesehenen Videos eines Kanals
Mit dieser Anfrage werden die Aufrufzahlen, die Klickraten für Anmerkungen, die Abbruchraten für Anmerkungen und die Anmerkungsimpressionen für die zehn meistgesehenen Videos des Kanals abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Das meistgesehene Video wird also zuerst angezeigt.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-viewsPlaylist-Berichte
Gesamtzahl der Playlistaufrufe für einen Kanal
Mit dieser Anfrage werden die Gesamtzahl der Playliststarts, die geschätzte Wiedergabedauer in Minuten, die Aufrufe (zusammengefasster Videomesswert), die Playlistaufrufe (Messwert für Playlists) und die Aufrufe pro Playliststart für Playlists auf dem Kanal des authentifizierten Nutzers abgerufen.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStartStatistiken für eine bestimmte Playlist
Mit dieser Anfrage werden die Gesamtzahl der Playliststarts, die geschätzte Wiedergabedauer in Minuten, die Aufrufe (zusammengefasster Videomesswert), die Playlistaufrufe (Messwert für Playlists) und die Aufrufe pro Playliststart für eine bestimmte Playlist abgerufen. Wenn du diese Abfrage im API Explorer ausführen möchtest, musst du den String PLAYLIST_ID im Parameterwert filters durch die Playlist-ID einer Playlist auf dem Kanal des authentifizierten Nutzers ersetzen.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDWenn du zusammengefasste Statistiken für mehrere Playlists abrufen möchtest, kannst du den String „PLAYLIST_ID“ auch durch eine durch Kommas getrennte Liste mit bis zu 500 Playlist-IDs für Playlists auf dem Kanal des authentifizierten Nutzers ersetzen.
Top 10 – Die meistgesehenen Playlists eines Kanals
Mit dieser Abfrage werden die zehn meistgesehenen Playlists eines Kanals abgerufen, gemessen anhand der Playlist-Aufrufe im angegebenen Zeitraum. Außerdem werden mehrere andere Playlist-Messwerte abgerufen, z. B. wie oft Zuschauer die Wiedergabe der einzelnen Playlists gestartet haben und wie lange sich ein Zuschauer durchschnittlich Videos in der Playlist angesehen hat, nachdem er sie gestartet hat. Die Ergebnisse werden in absteigender Reihenfolge nach den Aufrufen der Playlists sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist verwendet wird, müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViewsVideoberichte
Messwerte zur täglichen Wiedergabezeit für die Videos eines Kanals
Diese Abfrage ruft die tägliche Anzahl von Aufrufen, Wiedergabezeiten und neuen Abonnenten für die Videos eines Kanals ab. Der Bericht enthält eine Datenzeile für jeden Tag im angeforderten Zeitraum. Zeilen werden in chronologischer Reihenfolge sortiert.
dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=dayTägliche Messwerte zu Anmerkungen für die Videos eines Kanals
Über diese Anfrage werden die täglichen Aufrufzahlen, die Klickraten für Anmerkungen, die Schließungsraten für Anmerkungen und die Impressionen für Anmerkungen für die Inhalte des Kanals abgerufen. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=dayPlaylist-Berichte
Tägliche Aufrufe von Playlists für einen Kanal
Diese Anfrage ruft die tägliche Anzahl von Aufrufen (zusammengefasster Videomesswert), Playlist-Aufrufe (In-Playlist-Messwert), Playlist-Starts, die geschätzte Wiedergabezeit in Minuten und die Aufrufe pro Playlist-Start für den Kanal des authentifizierten Nutzers ab. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=dayVideoberichte
Länderspezifische Messwerte zur Wiedergabezeit für die Videos eines Kanals
Mit dieser Abfrage werden länderspezifische Aufrufzahlen, Messwerte zur Wiedergabezeit und zu Abos für die Videos eines Kanals abgerufen. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Videos des Kanals angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatchedLänderspezifische Anmerkungsmesswerte für die Videos eines Kanals
Mit dieser Anfrage werden länderspezifische Aufrufzahlen, Klickraten für Anmerkungen, Abbruchraten für Anmerkungen und Anmerkungsimpressionen für die Videos des Kanals abgerufen. Die Ergebnisse werden nach der Klickrate für Anmerkungen in absteigender Reihenfolge sortiert. Das Land mit der höchsten Klickrate für Anmerkungen wird zuerst aufgeführt.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRateProvinzspezifische Messwerte für US-Bundesstaaten und Washington, D.C.
Mit dieser Anfrage erhältst du eine Aufschlüsselung nach Provinz für die Anzahl der Aufrufe, die geschätzte Wiedergabezeit in Minuten und die durchschnittliche Wiedergabedauer der Videos des Kanals. Die Daten umfassen US-Bundesstaaten und Washington D.C. Die Ergebnisse werden alphabetisch nach den ISO 3166-2-Codes der Provinzen sortiert.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=provinceTop 10 – Meistgesehene Videos in einem bestimmten Land
Mit dieser Abfrage werden die zehn meistgesehenen Videos des Kanals im angegebenen Zeitraum in einem bestimmten Land abgerufen. Die Reihenfolge wird anhand der Anzahl der Aufrufe bestimmt. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-viewsTop 10 der US-Städte nach Gesamtzahl der Aufrufe
Diese Abfrage ruft eine Liste der zehn US-Städte ab, die im angegebenen Zeitraum für die meisten Aufrufe der Kanalinhalte verantwortlich sind. Die Abfrage kann so geändert werden, dass Daten für ein anderes Land angefordert werden. Dazu wählen Sie einen anderen gültigen Wert für diesen Filter aus. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen. Dazu verwenden Sie den Filter subContinent und einen seiner gültigen Werte. Andere Filter werden ebenfalls unterstützt. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-viewsDie zehn US-Städte mit den meisten Aufrufen pro Inhaltstyp
Diese Abfrage ruft eine Liste der zehn US-Städte ab, die im angegebenen Zeitraum für jeden unterstützten creatorContentType die meisten Aufrufe von Inhalten des Kanals generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-viewsTop-10-Städte in den USA nach Gesamtwiedergabezeit
Mit dieser Abfrage wird eine Liste der zehn Tage im angegebenen Zeitraum abgerufen, an denen eine US-amerikanische Stadt die höchste tägliche Wiedergabezeit für die Inhalte des Kanals verzeichnet hat. Die Abfrageergebnisse enthalten die gesamte Wiedergabezeit, das Datum, an dem die Wiedergabezeit stattgefunden hat, und die Stadt, in der die Inhalte wahrscheinlich angesehen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der Gesamtwiedergabezeit sortiert.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTimeTop 10 – Meistgesehene Videos in Europa
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Videos des Kanals in Europa abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum. Die Abfrage kann so geändert werden, dass Daten für einen anderen Kontinent angefordert werden. Dazu wählen Sie einen anderen gültigen Wert für diesen Filter aus. In ähnlicher Weise könnte die Abfrage so geändert werden, dass Daten für einen Subkontinent wie Westeuropa oder Südostasien abgerufen werden. Dazu verwenden Sie den Filter subContinent und einen seiner gültigen Werte. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-viewsPlaylist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
Mit dieser Abfrage werden länderspezifische Aufrufzahlen (zusammengefasster Videomesswert), Playlist-Aufrufe (Messwert für Playlists) und Wiedergabezeitmesswerte für die Playlists eines Kanals abgerufen. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Playlists des Kanals angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der Minuten sortiert, die du dir angesehen hast.
dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatchedTop 10 – Playlists mit den meisten Wiedergaben in den USA
Mit dieser Abfrage werden die 10 Playlists abgerufen, die Zuschauer in den USA im angegebenen Zeitraum am häufigsten gestartet haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Playlist-Starts sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist verwendet wird, müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf einen Ganzzahlwert von 10 oder weniger festlegen.
dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStartsVideoberichte
Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit der Videos eines bestimmten Kanals abgerufen. Die Ergebnisse werden nach dem Typ der Seite oder Anwendung zusammengefasst, auf bzw. in der die Videowiedergabe stattgefunden hat. Sie werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-viewsTägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit in den USA für die Videos eines bestimmten Kanals abgerufen. Die Ergebnisse werden für jede Art von Seite oder Anwendung, auf bzw. in der Videowiedergaben stattgefunden haben, nach Tag gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
Top 10: Websites von Drittanbietern, auf denen die meisten Aufrufe für ein eingebettetes Video erzielt wurden
Diese Abfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für ein bestimmtes Video oder eine Gruppe von Videos ab. Die Ergebnisse werden nach der Website des Drittanbieters gruppiert, auf der das Video eingebettet war. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Wenn du diese Abfrage im APIs Explorer ausführen möchtest, musst du den String VIDEO_ID im Parameterwert filters durch eine kommagetrennte Liste mit einer oder mehreren Video-IDs für deine hochgeladenen Videos ersetzen.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsPlaylist-Berichte
Aufrufzahlen und Wiedergabezeit von Playlists an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Aufrufe (zusammengefasster Videomesswert), die Aufrufe der Playlist (Messwert für die Wiedergabe in der Playlist), die geschätzte Wiedergabezeit und die Anzahl der Playliststarts für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der die Videowiedergaben erfolgten. Die Ergebnisse sind in absteigender Reihenfolge nach Playlist-Starts sortiert.
dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStartsAnzahl der täglichen Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die täglichen Playlist-Starts, die Anzahl der Aufrufe (ein zusammengefasster Videomesswert), die Playlist-Aufrufe (ein In-Playlist-Messwert) und die geschätzte Wiedergabezeit in den USA für die Playlists eines bestimmten Kanals ab. Die Ergebnisse werden für jede Art von Seite oder Anwendung, in der Playlistaufrufe erfolgten, nach Tag gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=dayVideoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Mit dieser Abfrage wird die Anzahl der Likes und Dislikes für jeden Inhaltstyp auf einem Kanal abgerufen.
dimensions=creatorContentType
metrics=likes,dislikesVideoberichte
Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos des Kanals in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. Diese gibt an, wie Nutzer das Video gefunden haben.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==USTägliche Aufrufzahlen und Wiedergabezeit aus verschiedenen Zugriffsquellen
Diese Anfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte tägliche Wiedergabezeit für die Videos des Kanals ab. Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=dayTop 10: YouTube-Suchbegriffe, die die meisten Zugriffe auf ein Video generieren
Mit dieser Abfrage werden die zehn Suchbegriffe abgerufen, die für ein oder mehrere bestimmte Videos die meisten Aufrufe über die YouTube-Suchergebnisse generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Zum Ausführen dieser Abfrage im APIs Explorer musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs ersetzen.
Du kannst die Abfrage beispielsweise für ein einzelnes Video ausführen oder VIDEO_ID ersetzen, um die Suchbegriffe zu ermitteln, die die meisten Zugriffe auf dieses Video generieren. Du kannst auch alle Videos in einer bestimmten Playlist auflisten, um herauszufinden, mit welchen Suchbegriffen die meisten Zugriffe auf die Videos in dieser Playlist erzielt werden.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsTop 10: Externe Websites, über die die meisten Zugriffe auf ein Video erfolgen
Mit dieser Abfrage werden die zehn externen Websites abgerufen, die die meisten Aufrufe für ein bestimmtes Video oder eine Gruppe von Videos generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der geschätzten Wiedergabezeit sortiert. Wenn du diese Abfrage im APIs Explorer ausführen möchtest, musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte Liste mit bis zu 500 Video-IDs für deine hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedPlaylist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Aufrufe (zusammengefasster Videomesswert), die Aufrufe der Playlist (Messwert für Playlists), die Wiedergabestarts der Playlist und die geschätzte Wiedergabezeit für Playlist-Aufrufe in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst. Diese gibt an, wie Nutzer die Playlist aufgerufen haben.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==USDie tägliche Anzahl der Wiedergaben und die Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen
Mit dieser Anfrage werden die täglichen Aufrufe von Playlists eines Kanals (Messwert „In der Playlist“), die Anzahl der Playlist-Starts und die geschätzte Wiedergabezeit abgerufen. Außerdem wird die Gesamtzahl der Aufrufe abgerufen (ein zusammengefasster Videomesswert). Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=dayVideoberichte
Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit auf Android-Geräten für die Videos eines bestimmten Kanals abgerufen. Die Ergebnisse sind nach Tag und Gerätetyp gruppiert, auf dem die Videowiedergabe stattgefunden hat. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=dayTägliche Betriebssystemmesswerte für Mobilgeräte
Diese Abfrage ruft die tägliche Anzahl an Aufrufen und die geschätzte Wiedergabezeit auf Mobilgeräten für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden für jedes Betriebssystem, mit dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=dayTägliche Messwerte zu Betriebssystem und Gerätetyp
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit für einen Kanal abgerufen. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayPlaylist-Berichte
Tagesmesswerte für Gerätetypen bei Wiedergaben von Playlists unter Android
Mit dieser Abfrage werden die täglichen Aufrufe (zusammengefasster Videomesswert), Playlist-Aufrufe (In-Playlist-Messwert) und die geschätzte Wiedergabezeit auf Android-Geräten für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse sind für jeden Gerätetyp, auf dem Playlist-Aufrufe stattgefunden haben, nach Tag gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=dayTägliche Betriebssystemmesswerte für Playlistaufrufe auf Mobilgeräten
Mit dieser Abfrage werden tägliche Aufrufe (zusammengefasster Videomesswert), Playlist-Aufrufe (Messwert für Playlists) und die geschätzte Wiedergabezeit auf Mobilgeräten für die Playlists eines bestimmten Kanals abgerufen. Die Ergebnisse sind nach Tag und Betriebssystem gruppiert, auf dem die Wiedergabeaufrufe stattgefunden haben. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=dayVideoberichte
Demografische Merkmale von Zuschauern in Kalifornien (Altersgruppe und Geschlecht)
In diesem Bericht findest du Statistiken zur Altersgruppe und zum Geschlecht der Zuschauer in Kalifornien, die sich die Videos des Kanals angesehen haben. Die Ergebnisse sind nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage kann geändert werden, um dieselben Statistiken für alle Betrachter weltweit oder für alle Betrachter in einem Land, Kontinent, Subkontinent oder einem anderen US-Bundesstaat abzurufen, indem Sie den Parameterwert filters anpassen.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupPlaylist-Berichte
Demografische Merkmale von Playlist-Zuschauern in Kalifornien (Altersgruppe und Geschlecht)
In diesem Bericht werden Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien abgerufen, die sich die Playlists des Kanals angesehen haben. Die Ergebnisse sind nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage kann so angepasst werden, dass dieselben Statistiken für alle Zuschauer weltweit oder alle Zuschauer in einem Land, auf einem Kontinent, einem Subkontinent oder einem anderen US-Bundesstaat abgerufen werden. Dazu muss der Parameterwert filters angepasst werden.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroupMesswerte zur Videofreigabe, nach Dienst aggregiert, in dem Videos geteilt wurden
Mit dieser Anfrage wird ermittelt, wie oft Nutzer die Schaltfläche Share verwendet haben, um die Videos eines Kanals zu teilen. Die Ergebnisse werden nach dem jeweiligen Teilenetzwerk (Google+, Twitter usw.) zusammengefasst und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService
metrics=shares
sort=-sharesMesswerte zur Zuschauerbindung für ein Video
In diesem Bericht wird gemessen, wie gut Zuschauer ein Video bis zum Ende ansehen. Der Bericht kann jeweils nur für ein einzelnes Video abgerufen werden. Um diese Abfrage im APIs Explorer auszuführen, müssen Sie den String VIDEO_ID im Parameterwert filters durch die Video-ID eines Ihrer hochgeladenen Videos ersetzen. In Berichten zur Zielgruppenbindung können Sie für den Filter video keine mehreren Werte angeben.
In diesem Beispiel wird im Bericht der Filter audienceType verwendet, um die Antwort so einzuschränken, dass sie nur Daten für organische Aufrufe enthält, die auf eine direkte Nutzeraktion zurückzuführen sind, z. B. eine Suche nach einem Video oder ein Klick auf ein vorgeschlagenes Video. Der Bericht enthält daher keine Daten zu Aufrufen über TrueView In-Stream- oder TrueView In-Display-Anzeigen. Du kannst den Filter entfernen, um die Daten zur Zuschauerbindung des Videos aus allen Zielgruppentypen abzurufen.
Daten für den Filter audienceType sind seit dem 25. September 2013 verfügbar. Die API gibt keine Daten für Abfragen zurück, bei denen mit dem Filter versucht wird, Daten aus früheren Zeiträumen abzurufen. Abfragen ohne Filter funktionieren für alle Daten nach dem 1. Juli 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICMesswerte für den Kanalumsatz und die Anzeigenleistung
Diese Anfrage ruft die Messwerte eines Kanals zum Umsatz und zur Anzeigenleistung ab. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksMesswerte für den täglichen Umsatz und die Anzeigenleistung
Mit dieser Anfrage werden die täglichen Umsatz- und Anzeigenleistungsmesswerte eines Kanals abgerufen.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacksLänderspezifische Umsatz- und Anzeigenleistungsmesswerte
Mit dieser Anfrage werden die länderspezifischen Umsatz- und Anzeigenleistungsmesswerte eines Kanals abgerufen. Die Ergebnisse werden nach Umsatz absteigend sortiert. Das erste aufgeführte Land ist also das Land, in dem der Partner den höchsten Nettoumsatz erzielt hat.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenueTop 10 – Videos mit dem höchsten Umsatz
Mit dieser Anfrage werden Umsatz- und Anzeigenleistungsmesswerte für die zehn Videos mit dem höchsten Umsatz des Kanals abgerufen. Die Ergebnisse werden nach Umsatz absteigend sortiert. Das erste Video ist also dasjenige mit dem höchsten geschätzten Umsatz.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenueMesswerte zur Anzeigenleistung für unterschiedliche Anzeigentypen
Über diese Anfrage werden Leistungsmesswerte für die Inhalte des Rechteinhabers abgerufen, für die Ansprüche geltend gemacht wurden. Die Ergebnisse sind nach Anzeigentyp gruppiert. So können Sie die Umsatz- und CPM-Werte für verschiedene Anzeigentypen vergleichen.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adTypeRechteinhaberberichte
Videoberichte
Aufrufzahlen insgesamt, geschätzte Wiedergabezeit und mehr für alle Inhalte, für die Ansprüche geltend gemacht wurden
Mit dieser Abfrage werden zusammengefasste Messwerte für die Inhalte des Rechteinhabers abgerufen, auf die Anspruch erhoben wurde. Der Bericht enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimedLänderspezifische Aufrufzahlen und mehr für alle selbst hochgeladenen Videos
Mit dieser Abfrage werden Messwerte für ein bestimmtes Land für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FRDie Gesamtzahl der Aufrufe und weitere Informationen zu allen Inhalten von Drittanbietern, auf die Ansprüche erhoben wurden
Mit dieser Abfrage werden aggregierte Messwerte für Videos abgerufen, auf die der Rechteinhaber einen Anspruch erhoben, aber nicht selbst hochgeladen hat. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimedGesamtzahl der Aufrufe und weitere Statistiken für alle selbst hochgeladenen Inhalte
Mit dieser Abfrage werden aggregierte Messwerte für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==selfGesamtzahl der Aufrufe und weitere Informationen zu allen selbst hochgeladenen Inhalten, für die Ansprüche erhoben wurden
Mit dieser Abfrage werden zusammengefasste Messwerte für Videos abgerufen, die der Rechteinhaber hochgeladen und auf die er Anspruch erhoben hat. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimedTop 10 – Die meistgesehenen Videos eines Rechteinhabers
Mit dieser Abfrage werden die 10 am häufigsten aufgerufenen Videos des Rechteinhabers im angegebenen Zeitraum anhand der Anzahl der Aufrufe abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-viewsTop 10 – Die meistgesehenen Videos eines Rechteinhabers
Mit dieser Abfrage werden die zehn meistgesehenen Videos des Rechteinhabers im angegebenen Zeitraum abgerufen. Die Reihenfolge wird anhand der geschätzten Wiedergabezeit bestimmt. Die Ergebnisse werden in absteigender Reihenfolge nach den geschätzten Minuten sortiert.
dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatchedTop 10 – Meistgesehene Videos auf dem Kanal eines Rechteinhabers
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Videos eines bestimmten Kanals oder einer Gruppe von Kanälen abgerufen, die vom Rechteinhaber verwaltet werden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Wenn du diese Abfrage im API Explorer ausführen möchtest, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-viewsTop 10 – Klickraten von Anmerkungen in den meistgesehenen Videos eines Kanals
Mit dieser Anfrage werden die Aufrufzahlen, Klickraten für Anmerkungen, Schließungsraten für Anmerkungen und Anmerkungsimpressionen für die zehn meistgesehenen Videos auf einem bestimmten Kanal oder in einer bestimmten Kanalgruppe abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Das meistgesehene Video wird also zuerst angezeigt. Um diese Abfrage im APIs Explorer auszuführen, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-viewsPlaylist-Berichte
Wiedergabezahlen für Playlists auf den Kanälen eines Rechteinhabers
Mit dieser Anfrage werden die Gesamtzahl der Playliststarts, die geschätzte Wiedergabedauer der Playlist, die Aufrufe der Playlist und die Aufrufe pro Playliststart für Playlists auf den Kanälen des Rechteinhabers abgerufen. Beim Messwert playlistViews werden nur Videoaufrufe gezählt, die im Kontext einer Playlist stattgefunden haben. Da alle angeforderten Messwerte innerhalb einer Playlist liegen, müssen die Filter playlist oder group nicht angegeben werden.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStartStatistiken für eine bestimmte Playlist
Mit dieser Anfrage werden die Gesamtzahl der Playliststarts, die geschätzte Wiedergabedauer in Minuten, die Aufrufe (zusammengefasster Videomesswert), die Playlistaufrufe (Messwert für Playlists) und die Aufrufe pro Playliststart für eine bestimmte Playlist abgerufen. Um diese Abfrage im APIs Explorer auszuführen, musst du den String PLAYLIST_ID im Parameterwert filters durch die Playlist-ID einer Playlist auf einem der Kanäle des Rechteinhabers ersetzen.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_IDWenn du zusammengefasste Statistiken für mehrere Playlists abrufen möchtest, kannst du den String PLAYLIST_ID auch durch eine durch Kommas getrennte Liste von bis zu 500 Playlist-IDs für Playlists auf den Kanälen des Rechteinhabers ersetzen.
Videoberichte
Tägliche Messwerte zur Wiedergabezeit für selbst hochgeladene Inhalte
Mit dieser Abfrage werden tägliche Messwerte zur Wiedergabezeit sowie Aufrufe, monetarisierte Wiedergaben und Impressionen für Videos abgerufen, die der Rechteinhaber hochgeladen hat. Der Bericht gibt für jeden Tag im angeforderten Zeitraum eine Datenzeile zurück. Die Zeilen sind in chronologischer Reihenfolge sortiert.
dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=dayAnmerkungsmesswerte für Inhalte mit Ansprüchen
Über diese Anfrage werden die täglichen Aufrufzahlen, die Klickraten für Anmerkungen, die Schließungsraten für Anmerkungen und die Anmerkungsimpressionen für die Inhalte des Rechteinhabers abgerufen, für die Ansprüche geltend gemacht wurden. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=dayPlaylist-Berichte
Tägliche Playlist-Aufrufe für einen Rechteinhaber
Mit dieser Anfrage werden Messwerte für tägliche Nutzerinteraktionen mit Videos in den Playlists des Rechteinhabers abgerufen. Im Bericht werden die Messwerte playlistViews, playlistStarts, playlistEstimatedMinutesWatched und viewsPerPlaylistStart abgerufen. Alle diese Messwerte beziehen sich auf Playlists. Da alle angeforderten Messwerte innerhalb einer Playlist liegen, müssen die Filter playlist oder group nicht in der Anfrage enthalten sein.
dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=dayVideoberichte
Länderspezifische Messwerte zur Wiedergabezeit für selbst hochgeladene Inhalte
Mit dieser Abfrage werden die Aufrufzahlen, die Wiedergabezeit und die geschätzten Werbeeinnahmen für jedes Land abgerufen. Die Messwerte beziehen sich auf Videos, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Videos angesehen wurden. Die Zeilen sind in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatchedLänderspezifische Anmerkungsmesswerte für selbst hochgeladene Inhalte
Mit dieser Anfrage werden länderspezifische Aufrufzahlen, Klickraten für Anmerkungen, Schließungsraten für Anmerkungen und Anmerkungsimpressionen für die hochgeladenen Videos des Rechteinhabers abgerufen. Die Ergebnisse werden in absteigender Reihenfolge nach der Klickrate der Anmerkungen sortiert. Das Land mit der höchsten Klickrate wird zuerst aufgeführt.
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRateProvinzspezifische Messwerte für die US-Bundesstaaten und Washington D.C.
Mit dieser Anfrage wird eine Aufschlüsselung nach Provinz für die Aufrufzahlen, die geschätzte Wiedergabezeit und die durchschnittliche Wiedergabedauer für die Videos des Rechteinhabers abgerufen, für die Ansprüche geltend gemacht wurden. Die Daten umfassen US-Bundesstaaten und Washington D.C. Die Ergebnisse werden alphabetisch nach den ISO 3166-2-Codes der Provinzen sortiert.
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province10 Städte in den USA nach Aufrufen insgesamt
Mit dieser Abfrage wird eine Liste der zehn US-Städte abgerufen, in denen die Videos des Rechteinhabers, für die Ansprüche geltend gemacht wurden, im angegebenen Zeitraum die meisten Aufrufe erzielt haben. Die Abfrage kann so geändert werden, dass Daten für ein anderes Land angefordert werden. Dazu wählen Sie einen anderen gültigen Wert für diesen Filter aus. Ebenso kann die Abfrage so geändert werden, dass Daten für einen Subkontinent wie Westeuropa oder Südostasien abgerufen werden, indem der Filter subContinent und einer seiner gültigen Werte verwendet wird. Auch andere Filter werden unterstützt. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-viewsTop 10 der US-amerikanischen Städte nach Aufrufen insgesamt für jeden Inhaltstyp
Mit dieser Abfrage wird für jeden unterstützten creatorContentType eine Liste der zehn US-Städte abgerufen, in denen die Inhalte des Rechteinhabers im angegebenen Zeitraum am häufigsten aufgerufen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-viewsTop-10-Städte in den USA nach Gesamtwiedergabezeit
Mit dieser Abfrage wird eine Liste der Top-10-Tage im angegebenen Zeitraum abgerufen, wenn eine Stadt in den USA die höchste tägliche Wiedergabezeit der beanspruchten Inhalte des Rechteinhabers hatte. Die Abfrageergebnisse enthalten die Gesamtwiedergabezeit, das Datum, an dem die Wiedergabezeit stattgefunden hat, und die Stadt, in der sich die Zuschauer die Inhalte voraussichtlich angesehen haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Gesamtwiedergabezeit sortiert.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTimeTop 10 – Meistgesehene Videos in Europa
Mit dieser Abfrage werden die zehn meistgesehenen Videos in Europa abgerufen, die vom Rechteinhaber Ansprüche erhoben wurden. Die Rangfolge wird anhand der Anzahl der Aufrufe im angegebenen Zeitraum bestimmt. Die Abfrage kann so geändert werden, dass Daten für einen anderen Kontinent angefordert werden. Dazu wählen Sie einen anderen gültigen Wert für diesen Filter aus. In ähnlicher Weise könnte die Abfrage geändert werden, um Daten für einen Subkontinent wie Westeuropa oder Südostasien abzurufen. Dazu verwenden Sie den Filter subContinent und einen seiner gültigen Werte. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatchedPlaylist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Rechteinhabers
Mit dieser Abfrage werden länderspezifische Aufrufzahlen und Wiedergabezeit-Messwerte für alle Playlists auf den Kanälen des Rechteinhabers abgerufen. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Playlists angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der Minuten sortiert, die du dir angesehen hast.
dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatchedTop 10 der am häufigsten erstellten Playlists in den USA
Mit dieser Abfrage werden die zehn Playlists von Kanälen des Rechteinhabers abgerufen, die sich Zuschauer in den USA im angegebenen Zeitraum am häufigsten angesehen haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Playlist-Starts sortiert.
Hinweis: Da in diesem Bericht die Dimension playlist verwendet wird, müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf eine Ganzzahl von 10 oder weniger festlegen.
dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStartsVideoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Mit dieser Abfrage wird die Anzahl der Likes und Dislikes für jeden Inhaltstyp auf einem bestimmten Kanal oder einer Gruppe von Kanälen abgerufen. Um diese Abfrage im APIs Explorer auszuführen, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_IDVideoberichte
Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
Diese Abfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit von Videos ab, die auf einen bestimmten Kanal oder eine Kanalgruppe hochgeladen wurden. Die Ergebnisse werden nach dem Typ der Seite oder Anwendung zusammengefasst, auf bzw. in der die Videowiedergabe stattgefunden hat. Sie werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Wenn du diese Abfrage im API Explorer ausführen möchtest, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-viewsTägliche Aufrufzahlen und Wiedergabezeit von verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit in den USA für Videos abgerufen, die auf einen bestimmten Kanal oder eine Gruppe von Kanälen hochgeladen wurden. Die Ergebnisse werden für alle Arten von Seiten oder Apps, auf denen Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse werden in umgekehrter chronologischer Reihenfolge sortiert. Um diese Abfrage im APIs Explorer auszuführen, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-dayTop 10: Websites von Drittanbietern, auf denen die meisten Aufrufe für ein eingebettetes Video erzielt wurden
Mit dieser Abfrage werden die Aufrufzahlen und die geschätzte Wiedergabezeit für ein bestimmtes Video oder eine Gruppe von Videos abgerufen. Die Ergebnisse werden nach der Website des Drittanbieters gruppiert, auf der das Video eingebettet war. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Um diese Abfrage im APIs Explorer auszuführen, musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für deine hochgeladenen Videos ersetzen.
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-viewsPlaylist-Berichte
Aufrufzahlen und Wiedergabezeit von Playlists an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die Anzahl der Playlist-Aufrufe, die geschätzte Wiedergabezeit der Playlist und die Anzahl der Playlist-Starts für alle Playlists auf den Kanälen eines Rechteinhabers abgerufen. Die Ergebnisse werden nach dem Typ der Seite oder Anwendung zusammengefasst, auf bzw. in der die Videowiedergabe stattgefunden hat. Sie werden in absteigender Reihenfolge nach den Playlist-Starts sortiert.
dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStartsAufrufe und Wiedergabezeit von Playlists an verschiedenen Wiedergabeorten
Mit dieser Abfrage werden die täglichen Wiedergabestarts, die Anzahl der Aufrufe und die geschätzte Wiedergabezeit von Playlists in den USA für alle Playlists auf den Kanälen eines Rechteinhabers abgerufen. Die Ergebnisse werden für jeden Seiten- oder App-Typ zurückgegeben, auf bzw. in dem Playlist-Aufrufe stattgefunden haben.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Videoberichte
Aufrufzahlen und Wiedergabezeit aus verschiedenen Besucherquellen
Diese Anfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos des Rechteinhabers ab. Die Messwerte werden nach Besucherquelle zusammengefasst. Diese gibt an, wie Nutzer das Video gefunden haben.
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==selfDie Anzahl der Aufrufe pro Tag und die Wiedergabezeit von verschiedenen Zugriffsquellen
Mit dieser Anfrage werden die täglichen Aufrufzahlen und die geschätzte tägliche Wiedergabezeit für die Videos des Rechteinhabers abgerufen. Die Messwerte werden täglich nach Zugriffsquelle aggregiert und in umgekehrter chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-dayHinweis: Die nächsten beiden Beispielberichte werden nur für bestimmte Besucherquellen unterstützt. Die Zugriffsquellen VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES und NO_LINK_EMBEDDED gehören zu den nicht unterstützten Zugriffsquellen.
Top 10: YouTube-Suchbegriffe, die die meisten Zugriffe für ein Video generieren
Mit dieser Abfrage werden die zehn Suchbegriffe abgerufen, die die meisten Aufrufe über die YouTube-Suchergebnisse für ein bestimmtes Video oder eine Gruppe von Videos generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert. Um diese Abfrage im APIs Explorer auszuführen, musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für deine hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsTop 10: Externe Websites, die die meisten Zugriffe für ein Video generieren
Mit dieser Abfrage werden die zehn externen Websites abgerufen, die die meisten Aufrufe über die Google-Suchergebnisse für ein bestimmtes Video oder eine Gruppe von Videos generiert haben. Die Ergebnisse werden in absteigender Reihenfolge nach der geschätzten Wiedergabezeit sortiert. Um diese Abfrage im APIs Explorer auszuführen, musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Video-IDs für deine hochgeladenen Videos ersetzen.
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatchedPlaylist-Berichte
Anzahl der Wiedergaben und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen in einem Land
Mit dieser Anfrage werden die Anzahl der Playlist-Aufrufe, die Anzahl der Playlist-Starts und die geschätzte Wiedergabezeit der Playlist für Playlist-Aufrufe in einem bestimmten Land abgerufen. Die Messwerte werden nach Besucherquelle zusammengefasst.
dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==USWiedergabezahlen und Wiedergabezeit von Playlists aus verschiedenen Zugriffsquellen
Diese Anfrage ruft Playlist-Aufrufe, Playlist-Starts und die geschätzte Wiedergabezeit für Playlists auf einem oder mehreren Kanälen eines Rechteinhabers ab. Die Messwerte werden nach Besucherquelle zusammengefasst. Um diese Abfrage im APIs Explorer auszuführen, müssen Sie den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für Ihre Kanäle ersetzen.
dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_IDVideoberichte
Tägliche Messwerte für Gerätetypen bei Videos mit Ansprüchen
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit nach Gerätetyp für Videos abgerufen, auf die ein bestimmter Rechteinhaber Ansprüche erhoben hat. Die Ergebnisse sind nach Tag und Gerätetyp gruppiert, auf dem die Videowiedergabe stattgefunden hat. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=dayTägliche Betriebssystemmesswerte für Videos mit Ansprüchen, die auf Mobilgeräten angesehen werden
Diese Abfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte Wiedergabezeit nach Betriebssystem für Aufrufe von Videos ab, auf die ein Rechteinhaber Anspruch erhoben hat, die auf Mobilgeräten erfolgt sind. Die Ergebnisse sind nach Tag und Betriebssystem gruppiert, auf dem die Videowiedergaben stattgefunden haben. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=dayTägliche Messwerte für Betriebssystem und Gerätetyp
Mit dieser Abfrage werden die täglichen Aufrufzahlen und die geschätzte Wiedergabezeit für Videos abgerufen, auf die ein bestimmter Rechteinhaber Ansprüche erhoben hat. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse werden in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=dayPlaylist-Berichte
Messwerte nach Gerätetyp für Playlistaufrufe unter dem Android-Betriebssystem
Diese Abfrage ruft die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit auf Android-Geräten für Playlists in einem oder mehreren Kanälen eines Rechteinhabers ab. Die Ergebnisse werden für jeden Gerätetyp zurückgegeben, auf dem Wiedergaben der Playlist stattgefunden haben. Wenn du diese Abfrage im API Explorer ausführen möchtest, musst du den String CHANNEL_ID im Parameterwert filters durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle ersetzen.
dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROIDBetriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten
Mit dieser Abfrage werden die Aufrufzahlen und die geschätzte Wiedergabezeit von Playlists auf Mobilgeräten für Playlists auf allen Kanälen eines Rechteinhabers abgerufen. Die Ergebnisse werden für jedes Betriebssystem zurückgegeben, auf dem Wiedergaben der Playlist stattgefunden haben.
dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILEVideoberichte
Demografische Merkmale von Zuschauern in Kalifornien (Altersgruppe und Geschlecht)
In diesem Bericht findest du Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien, die sich die Inhalte des Rechteinhabers angesehen haben, für die eine Beschwerde eingereicht wurde. Die Ergebnisse werden nach Geschlecht und dann nach Altersgruppe sortiert. Diese Abfrage kann so angepasst werden, dass dieselben Statistiken für alle Zuschauer weltweit oder alle Zuschauer in einem Land, auf einem Kontinent, einem Subkontinent oder einem anderen US-Bundesstaat abgerufen werden. Dazu muss der Parameterwert filters angepasst werden.
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroupMesswerte zur Videofreigabe, nach Dienst aggregiert, in dem Videos geteilt wurden
Mit dieser Anfrage wird ermittelt, wie oft Nutzer die Schaltfläche Share verwendet haben, um Videos zu teilen, die der Rechteinhaber hochgeladen hat. Die Ergebnisse werden nach dem jeweiligen Teilenetzwerk (Google+, Twitter usw.) zusammengefasst und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-sharesMesswerte zur Zuschauerbindung für ein Video
In diesem Bericht wird gemessen, wie gut es gelingt, die Zuschauer bei einem Video zu halten. Der Bericht kann jeweils nur für ein einzelnes Video abgerufen werden. Um diese Abfrage im APIs Explorer auszuführen, müssen Sie den String VIDEO_ID im Parameterwert filters durch die Video-ID eines Ihrer hochgeladenen Videos ersetzen. Beachten Sie, dass es in Berichten zur Zuschauerbindung nicht möglich ist, mehrere Werte für den Filter video anzugeben.
In diesem Beispiel wird im Bericht der Filter audienceType verwendet, um die Antwort so einzuschränken, dass sie nur Daten für organische Aufrufe enthält, die auf eine direkte Nutzeraktion zurückzuführen sind, z. B. eine Suche nach einem Video oder ein Klick auf ein vorgeschlagenes Video. Der Bericht enthält daher keine Daten zu Aufrufen über TrueView-In-Stream- oder TrueView-In-Display-Anzeigen. Du kannst den Filter entfernen, um die Daten zur Zuschauerbindung des Videos aus allen Zielgruppentypen abzurufen.
Daten für den Filter audienceType stehen seit dem 25. September 2013 zur Verfügung. Die API gibt keine Daten für Abfragen zurück, bei denen der Filter zum Abrufen von Daten aus früheren Zeiträumen verwendet wird. Abfragen ohne Filter funktionieren für alle Daten nach dem 1. Juli 2008.
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICUmsatz- und Anzeigenleistungsmesswerte für Inhalte, auf die Anspruch erhoben wurde
Über diese Anfrage werden Umsatz- und Anzeigenleistungsmesswerte für die Inhalte des Rechteinhabers abgerufen, auf die Anspruch erhoben wurde. Der Bericht gibt eine einzelne Datenzeile mit den Summen für jeden angeforderten Messwert im angegebenen Zeitraum zurück.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedMesswerte zum täglichen Umsatz und zur Anzeigenleistung
Mit dieser Anfrage werden die täglichen Messwerte zum Umsatz und zur Anzeigenleistung für die beanspruchten Inhalte des Rechteinhabers abgerufen.
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimedLänderspezifische Messwerte zum Umsatz und zur Anzeigenleistung
Über diese Anfrage werden länderspezifische Umsatz- und Anzeigenleistungsmesswerte für die Inhalte des Rechteinhabers abgerufen, für die Ansprüche geltend gemacht wurden. Die Ergebnisse werden nach Umsatz in absteigender Reihenfolge sortiert. Das erste aufgeführte Land ist also das Land, in dem der Partner den höchsten geschätzten Umsatz erzielt hat.
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenueTop 10 – Videos mit dem höchsten Umsatz
Mit dieser Anfrage werden Umsatz- und Anzeigenleistungsmesswerte für die zehn Videos abgerufen, für die der Rechteinhaber Ansprüche geltend gemacht hat und die den höchsten Umsatz erzielt haben. Die Ergebnisse werden in absteigender Reihenfolge nach Umsatzbetrag sortiert. Das bedeutet, dass das erste Video das Video mit dem höchsten geschätzten Umsatz ist.
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenueMesswerte zur Anzeigenleistung für unterschiedliche Anzeigentypen
Über diese Anfrage werden Leistungsmesswerte für die Inhalte des Rechteinhabers abgerufen, für die Ansprüche geltend gemacht wurden. Die Ergebnisse sind nach Anzeigentyp gruppiert. So können Sie die Umsatz- und CPM-Werte für verschiedene Anzeigentypen vergleichen.
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType