Auf dieser Seite findest du Beispiele für YouTube Analytics API-Anfragen. In jedem Beispiel wird kurz der abgerufene Bericht beschrieben. Anschließend werden die entsprechenden Parameterwerte dimensions, metrics, filters und sort angezeigt. In den Dokumenten zu Kanalberichten und Rechteinhabern sind die Berichte aufgeführt, die von der API unterstützt werden.
Jedes Beispiel ist mit dem Google APIs Explorer verknüpft und wird mit den angezeigten Werten gefüllt. 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 in die Kanal-ID des authentifizierten Nutzers ändern. Für Rechteinhaber-Berichte musst du CONTENT_OWNER_ID durch deine Rechteinhaber-ID ersetzen.
Außerdem musst du als angegebener Kanal oder Rechteinhaber authentifiziert sein, damit APIs Explorer deine API-Anfragen mit OAuth 2.0 autorisieren kann.
Anfragen nach mehreren Dimensionen/Messwerten sortieren
Die API unterstützt die Möglichkeit, Antwortdaten nach mehreren Dimensionen oder Messwerten zu sortieren. Mit der folgenden Anfrage werden beispielsweise tägliche Zugriffsquellendaten für die Videos eines bestimmten Kanals abgerufen. Jede Zeile in der Ergebnismenge gibt die Anzahl der Aufrufe und die geschätzte Wiedergabezeit an, die an einem bestimmten Tag über eine bestimmte Zugriffsquelle (z.B. EXT_URL) zustande gekommen sind.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
In 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. Daher enthält die erste Zeile der Ergebnismenge Daten zu der Besucherquelle, die am ersten Tag im angeforderten Zeitraum die meisten Aufrufe generiert hat. Die zweite Zeile enthält Daten für die Besucherquelle, die am ersten Tag die nächsthöhere Anzahl von Aufrufen generiert hat.
Channel-Berichte
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,averageViewDuration
Länderspezifische Aufrufzahlen für einen Kanal
Diese Abfrage ruft Messwerte für ein bestimmtes Land für die Videos eines Kanals ab. 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=country==US
Top 10: Am häufigsten angesehene Videos eines Kanals
Mit dieser Abfrage werden die zehn meistgesehenen Videos eines Kanals abgerufen. Die Angabe erfolgt anhand der geschätzten Wiedergabezeit in Minuten 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 eine Ganzzahl von maximal 10 festlegen.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
Top 10 – Klickraten der Anmerkungen für die meistgesehenen Videos eines Kanals
Diese Anfrage ruft die Anzahl der Aufrufe, die Klickrate bei Anmerkungen, die Abschlussraten bei Anmerkungen sowie die Impressionen von Anmerkungen für die zehn am häufigsten angesehenen Videos des Kanals ab. Die Ergebnisse werden nach der Anzahl der Aufrufe in absteigender Reihenfolge sortiert. Das am häufigsten angesehene Video wird also zuerst aufgeführt.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf eine Ganzzahl von maximal 10 festlegen.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
Playlist-Berichte
Gesamtzahl der Playlist-Aufrufe für einen Kanal
Mit dieser Anfrage werden die gesamten Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (ein aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), und Aufrufe pro Playlist-Start für Playlists auf dem Kanal des authentifizierten Nutzers.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
Statistiken für eine bestimmte Playlist
Mit dieser Anfrage werden die gesamten Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (ein
aggregierter Videomesswert),
Playlistaufrufe (ein In-Playlist-Messwert),
und Aufrufe pro Playlist-Start für eine bestimmte Playlist. Zum Ausführen dieser Abfrage in den APIs
Explorer verwenden möchten, müssen Sie den String PLAYLIST_ID im filters ersetzen.
mit der Playlist-ID für eine Playlist auf dem Kanal des authentifizierten Nutzers.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Um zusammengefasste Statistiken für mehrere Playlists abzurufen, kannst du den String PLAYLIST_ID auch durch eine durch Kommas getrennte Liste von bis zu 500 Playlist-IDs für Playlists auf dem Kanal des authentifizierten Nutzers ersetzen.
Top 10: Am häufigsten angesehene Playlists eines Kanals
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Playlists eines Kanals abgerufen, gemessen an den Playlistaufrufen im angegebenen Zeitraum angezeigt. Außerdem werden weitere Playlist-Messwerte abgerufen, z. B. wie oft die Zuschauer die Wiedergabe jeder Playlist gestartet haben, und Die Zeit, die ein Zuschauer Videos in der Playlist angesehen hat, nachdem sie gestartet wurde. Die Ergebnisse sind in absteigender Reihenfolge nach Playlistaufrufen 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 maximal 10 festlegen.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
Videoberichte
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. Die Zeilen sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained sort=day
Tägliche Anmerkungsmesswerte zu den Videos eines Kanals
Diese Anfrage ruft die tägliche Anzahl von Aufrufen, die Klickrate (Click-through-Rate, CTR) bei Anmerkungen, die Abschlussraten bei Anmerkungen sowie die Anmerkungsimpressionen für den Kanalinhalt ab. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=day
Playlist-Berichte
Tägliche Playlist-Aufrufe für einen Kanal
Diese Anfrage ruft die Anzahl der täglichen Aufrufe ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), Playlist-Starts, geschätzte Wiedergabezeit in Minuten und Aufrufe pro Playlist-Start für die authentifizierte auf den Kanal des Nutzers. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart sort=day
Videoberichte
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=-estimatedMinutesWatched
Länderspezifische Anmerkungsmesswerte zu den Videos eines Kanals
Diese Anfrage ruft länderspezifische Aufrufzahlen, Klickraten für Anmerkungen, Abschlussraten bei Anmerkungen und Anmerkungsimpressionen für die Videos des Kanals ab. Die Ergebnisse werden in absteigender Reihenfolge nach der Anmerkungsklickrate sortiert. Das bedeutet, dass das Land mit der höchsten Anmerkungsklickrate zuerst aufgeführt wird.
dimensions=country metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions sort=-annotationClickThroughRate
Provinzspezifische Messwerte für die US-Bundesstaaten und Washington D.C.
Diese Anfrage ruft 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 ab. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Die Ergebnisse sind alphabetisch nach den Provinzen sortiert. ISO 3166-2-Codes.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
Top 10 – Meistgesehene Videos in einem bestimmten Land
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Videos des Kanals abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum in einem bestimmten Land. 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 eine Ganzzahl von maximal 10 festlegen.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=country==US maxResults=10 sort=-views
10 Städte in den USA nach Aufrufen insgesamt
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 könnte geändert werden, um Daten für ein anderes Land anzufordern, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. 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=-views
Top 10 der US-amerikanischen Städte nach Aufrufen insgesamt für jeden 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 der Kanalinhalte 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=-views
Top 10 der US-Städte nach Gesamtwiedergabezeit
Diese Abfrage ruft eine Liste der Top-10-Tage im angegebenen Zeitraum ab, wenn eine Stadt in den USA die höchste tägliche Wiedergabezeit der Inhalte des Kanals hatte. Die Abfrageergebnisse enthalten die gesamte Wiedergabezeit, das Datum, an dem die Wiedergabezeit aufgetreten ist, und die Stadt, in der die Inhalte wahrscheinlich angesehen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der gesamten Wiedergabezeit sortiert.
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime
Top 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 könnte so geändert werden, dass Daten für einen anderen Kontinent angefordert werden, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. 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.
Hinweis: Für diesen Bericht müssen Sie einen Wert für den Anfrageparameter sort angeben und den Parameter maxResults auf eine Ganzzahl von maximal 10 festlegen.
dimensions=video metrics=views,estimatedMinutesWatched,likes,subscribersGained filters=continent==150 maxResults=10 sort=-views
Playlist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Kanals
Diese Abfrage ruft länderspezifische Aufrufzahlen ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), und Wiedergabezeit für die Playlists eines Kanals. Der Bericht enthält jeweils eine Datenzeile, Land, in dem die Playlists des Kanals angesehen wurden. Die Zeilen werden in absteigender Reihenfolge nach der Anzahl der angesehenen Minuten sortiert.
dimensions=country metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-estimatedMinutesWatched
Top 10 – Playlists mit den meisten in den USA am häufigsten gestarteten Playlists
Mit dieser Abfrage werden die zehn Playlists 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 maximal 10 festlegen.
dimensions=playlist metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration filters=isCurated==1;country==US maxResults=10 sort=-playlistStarts
Videoberichte
Anzahl der Aufrufe und Wiedergabezeiten an verschiedenen Wiedergabeorten
Diese Abfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der die Videowiedergabe erfolgte. Die Ergebnisse sind in absteigender Reihenfolge nach der Anzahl der Aufrufe sortiert.
dimensions=insightPlaybackLocationType metrics=estimatedMinutesWatched,views sort=-views
Anzahl der Aufrufe pro Tag und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die tägliche Anzahl an Aufrufen und die geschätzte Wiedergabezeit in den USA für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden für alle Arten von Seiten oder Apps, auf denen Videos wiedergegeben wurden, 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, die die meisten Aufrufe für ein eingebettetes Video generieren
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. Um diese Abfrage im APIs Explorer auszuführen, musst du den String VIDEO_ID im Parameterwert filters durch eine durch Kommas getrennte 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=-views
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die Anzahl der Aufrufe ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), geschätzte Wiedergabezeit und Playlist-Starts für die Playlists eines bestimmten Kanals. Die Ergebnisse sind die nach dem Typ der Seite oder App zusammengefasst werden, auf der die Videos wiedergegeben wurden, und Die Ergebnisse werden in absteigender Reihenfolge nach Playlist-Starts sortiert.
dimensions=insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=-playlistStarts
Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft tägliche Playlist-Starts, Aufrufzahlen (ein aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), und die geschätzte Wiedergabezeit in den USA für die Playlists eines bestimmten Kanals. Ergebnisse werden für jede Art von Seite oder Anwendung, in der Playlistaufrufe erfolgten, nach Tag gruppiert. Ergebnisse in chronologischer Reihenfolge sortiert.
dimensions=day,insightPlaybackLocationType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews filters=country==US sort=day
Videoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Diese Abfrage ruft die Anzahl an „Mag ich“- und „Mag ich nicht“-Bewertungen für jeden Inhaltstyp auf einem Kanal ab.
dimensions=creatorContentType metrics=likes,dislikes
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit über verschiedene Zugriffsquellen in einem Land
Diese Anfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos des Kanals in einem bestimmten Land ab. Die Messwerte werden nach Zugriffsquelle zusammengefasst. So wird beschrieben, wie Nutzer auf das Video gelangt sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=country==US
Die Anzahl der Aufrufe pro Tag und die Wiedergabezeit von 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=day
Top 10: YouTube-Suchbegriffe, die die meisten Zugriffe für 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 könntest zum Beispiel nach einem einzelnen Video suchen oder VIDEO_ID ersetzen, um die Suchbegriffe zu ermitteln, die die meisten Zugriffe für dieses Video generieren. Du kannst auch alle Videos in einer bestimmten Playlist auflisten, um festzustellen, welche Suchbegriffe für die Videos in dieser Playlist die meisten Zugriffe generieren.
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
Top 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 für ein bestimmtes Video oder eine Gruppe von Videos generiert haben. Die Ergebnisse werden nach der geschätzten Wiedergabezeit in absteigender Reihenfolge 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=-estimatedMinutesWatched
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen in einem Land
Diese Anfrage ruft die Anzahl der Aufrufe ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), Playlist-Starts und die geschätzte Wiedergabezeit für Playlistaufrufe in einem bestimmten Land. Die Messwerte werden nach Zugriffsquelle zusammengefasst. So wird beschrieben, wie Nutzer auf die Playlist gelangt sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews filters=country==US
Anzahl der täglichen Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen
Diese Anfrage ruft die täglichen Playlist-Aufrufe eines Kanals ab (eine In-Playlist-Messwert) Playlist-Starts und die geschätzte Wiedergabezeit. Außerdem wird die Gesamtanzahl der Aufrufe abgerufen (eine aggregierten Videomesswert. Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews sort=day
Videoberichte
Tägliche Messwerte zu Gerätetypen für das Android-Betriebssystem
Diese Abfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte Wiedergabezeit auf Android-Geräten für die Videos eines bestimmten Kanals ab. Die Ergebnisse werden für jeden Gerätetyp, auf dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=operatingSystem==ANDROID sort=day
Tä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 sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=deviceType==MOBILE sort=day
Tägliche Messwerte zu Betriebssystem und Gerätetyp
Diese Abfrage ruft die tägliche Anzahl an Aufrufen und die geschätzte Wiedergabezeit für einen Kanal ab. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Playlist-Berichte
Tägliche Messwerte für den Gerätetyp für Playlist-Aufrufe auf dem Android-Betriebssystem
Diese Abfrage ruft tägliche Aufrufe ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), und die geschätzte Wiedergabezeit auf Android-Geräten für die Playlists eines bestimmten Kanals. Die Ergebnisse sind gruppiert nach Tag für jeden Gerätetyp, auf dem Playlist-Aufrufe erfolgten. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
Tägliche Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten
Diese Abfrage ruft tägliche Aufrufe ab (eine aggregierter Videomesswert), Playlistaufrufe (ein In-Playlist-Messwert), und die geschätzte Wiedergabezeit auf Mobilgeräten für die Playlists eines bestimmten Kanals. Die Ergebnisse sind gruppiert nach Tag für jedes Betriebssystem, mit dem Playlistaufrufe erfolgt sind. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE sort=day
Videoberichte
Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht der Zuschauer in Kalifornien ab, die sich die Videos des Kanals angesehen haben. Die Ergebnisse werden 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,ageGroup
Playlist-Berichte
Demografische Merkmale der Playlist-Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien ab, die
hat sich die Playlists des Kanals angesehen. Die Ergebnisse werden nach Geschlecht und dann nach Altersgruppe sortiert. Dieses
könnte geändert werden, um dieselben Statistiken für alle Zuschauer weltweit oder alle
Nutzer in einem Land, Kontinent, Subkontinent oder einem anderen US-Bundesstaat, indem du den Parameterwert filters anpasst.
dimensions=ageGroup,gender metrics=viewerPercentage filters=province==US-CA sort=gender,ageGroup
Messwerte zum Teilen, zusammengefasst nach dem Dienst, bei dem Videos geteilt wurden
Diese Anfrage ruft die Häufigkeit ab, mit der Nutzer die Videos eines Kanals über die Schaltfläche „Share“ geteilt haben. Die Ergebnisse werden nach Freigabedienst (Google+, Twitter usw.) zusammengefasst und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService metrics=shares sort=-shares
Messwerte zur Zuschauerbindung für ein Video
Mit diesem Bericht wird gemessen, inwieweit ein Video Zuschauer binden kann. 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 das Ergebnis einer direkten Nutzeraktion wie einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video sind. Daher enthält der Bericht 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==ORGANIC
Messwerte zum Kanalumsatz und zur Anzeigenleistung
Diese Anfrage ruft die Messwerte eines Kanals zum Umsatz und zur Anzeigenleistung ab. Der Bericht enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Messwerte zum täglichen Umsatz und zur Anzeigenleistung
Mit dieser Anfrage werden die täglichen Messwerte zum Umsatz und zur Anzeigenleistung eines Kanals abgerufen.
dimensions=day metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
Länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung
Diese Anfrage ruft die länderspezifischen Messwerte zum Umsatz und zur Anzeigenleistung eines Kanals ab. Die Ergebnisse werden in absteigender Reihenfolge nach Umsatzbetrag sortiert. Das bedeutet, dass das erste Land das Land ist, in dem der Partner den höchsten Nettoumsatz erzielt hat.
dimensions=country metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks sort=-estimatedRevenue
Top 10 – Videos mit den höchsten Einnahmen
Mit dieser Anfrage werden Messwerte zum Umsatz und zur Anzeigenleistung für die zehn Videos des Kanals mit dem höchsten Umsatz abgerufen. 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 maxResults=10 sort=-estimatedRevenue
Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
Mit dieser Anfrage werden Messwerte zur Anzeigenleistung für die Inhalte des Rechteinhabers abgerufen, auf die Anspruch erhoben wurde. Die Ergebnisse werden nach Anzeigentyp gruppiert, sodass Sie Umsatz- und CPM-Werte für verschiedene Anzeigentypen vergleichen können.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType
Rechteinhaber-Berichte
Videoberichte
Gesamtzahl der Aufrufe, geschätzte Wiedergabezeit und mehr für alle Inhalte, auf die Anspruch erhoben wurde
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==claimed
Länderspezifische Aufrufzahlen 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 enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
Gesamtzahl der Aufrufe für alle Inhalte Dritter, auf die Anspruch erhoben wurde
Mit dieser Abfrage werden aggregierte Messwerte für Videos abgerufen, auf die der Rechteinhaber Anspruch erhoben, aber nicht 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,shares filters=uploaderType==thirdParty;claimedStatus==claimed
Gesamtzahl der Aufrufe für alle von dir hochgeladenen Inhalte
Mit dieser Abfrage werden zusammengefasste 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==self
Gesamtzahl der Aufrufe für alle von dir hochgeladenen Inhalte, auf die Anspruch erhoben wurde
Mit dieser Abfrage werden zusammengefasste Messwerte für Videos abgerufen, die der Rechteinhaber hochgeladen und ebenfalls beansprucht 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==self;claimedStatus==claimed
Top 10 – Meistgesehene Videos für einen Rechteinhaber
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Videos abgerufen, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum, die der Rechteinhaber hochgeladen hat. 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=-views
Top 10 – Meistgesehene Videos eines Rechteinhabers
Mit dieser Abfrage werden die 10 am häufigsten angesehenen Videos abgerufen, gemessen an der geschätzten Wiedergabezeit in Minuten im angegebenen Zeitraum, die der Rechteinhaber hochgeladen hat. Die Ergebnisse werden nach den geschätzten angesehenen Minuten in absteigender Reihenfolge sortiert.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
Top 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. 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 filters=channel==CHANNEL_ID maxResults=10 sort=-views
Top 10 – Klickraten der Anmerkungen für die meistgesehenen Videos eines Kanals
Diese Anfrage ruft die Anzahl der Aufrufe, die Klickrate bei Anmerkungen, die Abschlussraten bei Anmerkungen und die Anmerkungsimpressionen für die zehn am häufigsten angesehenen Videos in einem bestimmten Kanal oder in einer Gruppe von Kanälen ab. Die Ergebnisse werden nach der Anzahl der Aufrufe in absteigender Reihenfolge sortiert. Das am häufigsten angesehene Video wird also zuerst aufgeführt. 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=-views
Playlist-Berichte
Playlistaufrufe für die Kanäle eines Rechteinhabers
Diese Anfrage ruft die Gesamtzahl der Playlist-Starts, die geschätzte Wiedergabezeit der Playlist und die Playlist-Anzahl ab.
Aufrufe und Aufrufe pro Playlist beginnen für Playlists auf den Kanälen des Rechteinhabers. Die
Der Messwert playlistViews zählt nur Videoaufrufe, die im Zusammenhang mit einem
. Da es sich bei allen angeforderten Messwerten um In-Playlist-Messwerte handelt, enthält die Anfrage keinen
muss auch den Filter Playlist oder Gruppe enthalten.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
Statistiken für eine bestimmte Playlist
Mit dieser Anfrage werden die gesamten Playlist-Starts, die geschätzte Wiedergabezeit in Minuten, die Aufrufe (ein
aggregierter Videomesswert),
Playlistaufrufe (ein In-Playlist-Messwert),
und Aufrufe pro Playlist-Start für eine bestimmte Playlist. Zum Ausführen dieser Abfrage in den APIs
Explorer verwenden möchten, müssen Sie den String PLAYLIST_ID im filters ersetzen.
mit der Playlist-ID für eine Playlist auf einem der Kanäle des Rechteinhabers.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
Um zusammengefasste Statistiken für mehrere Playlists abzurufen, 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
Messwerte zur täglichen 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 eine Datenzeile für jeden Tag im angeforderten Zeitraum zurück und die Zeilen sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions filters=uploaderType==self sort=day
Messwerte zu Anmerkungen für Inhalte mit Ansprüchen
Diese Anfrage ruft die tägliche Anzahl von Aufrufen, die Klickrate (Click-through-Rate, CTR) bei Anmerkungen, die Abschlussraten bei Anmerkungen sowie die Anmerkungsimpressionen für den Content, auf den der Rechteinhaber Anspruch erhoben hat, ab. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=claimedStatus==claimed sort=day
Playlist-Berichte
Tägliche Playlist-Aufrufe für einen Rechteinhaber
Diese Anfrage ruft Messwerte für tägliche Nutzerinteraktionen mit Videos im Playlists. Im Bericht werden folgende Messwerte abgerufen: playlistViews, playlistStarts, playlistEstimatedMinutesWatched und viewsPerPlaylistStart an. Alle diese Messwerte sind In-Playlist-Messwerte. Da es sich bei allen angeforderten Messwerten um In-Playlist-Messwerte handelt, muss die Anfrage auch den Filter Playlist oder Gruppe hinzufügen.
dimensions=day metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart sort=day
Videoberichte
Länderspezifische Messwerte zur Wiedergabezeit bei selbst hochgeladenen Inhalten
Diese Abfrage ruft die Anzahl der Aufrufe, Messwerte zur Wiedergabezeit und den geschätzten Werbeumsatz für jedes Land ab. Die Messwerte gelten für Videos, die der Rechteinhaber hochgeladen hat. Der Bericht enthält eine Datenzeile für jedes Land, in dem die Videos angesehen wurden, und 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=-estimatedMinutesWatched
Länderspezifische Anmerkungsmesswerte für selbst hochgeladene Inhalte
Diese Anfrage ruft länderspezifische Aufrufzahlen, Klickraten für Anmerkungen, Abschlussraten bei Anmerkungen und Anmerkungsimpressionen für die hochgeladenen Videos des Rechteinhabers ab. 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 filters=uploaderType==self sort=-annotationClickThroughRate
Provinzspezifische Messwerte für die US-Bundesstaaten und Washington D.C.
Mit dieser Anfrage wird eine nach Provinz aufgeschlüsselte Aufschlüsselung der Anzahl der Aufrufe, der geschätzten Wiedergabezeit in Minuten und der durchschnittlichen Wiedergabedauer der beanspruchten Videos des Rechteinhabers abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Die Ergebnisse sind alphabetisch nach den Provinzen sortiert. ISO 3166-2-Codes.
dimensions=province metrics=views,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed;country==US sort=province
10 Städte in den USA nach Aufrufen insgesamt
Mit dieser Abfrage wird eine Liste der zehn US-Städte abgerufen, in denen im angegebenen Zeitraum die meisten Aufrufe der Videos mit Ansprüchen des Rechteinhabers generiert wurden. Die Abfrage könnte geändert werden, um Daten für ein anderes Land anzufordern, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. 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=claimedStatus==claimed;country==US
maxResults=10
sort=-views
Top 10 der US-amerikanischen Städte nach Aufrufen insgesamt für jeden Inhaltstyp
Mit dieser Abfrage wird eine Liste der zehn US-amerikanischen Städte abgerufen, in denen im angegebenen Zeitraum für jeden unterstützten creatorContentType die meisten Aufrufe der beanspruchten Inhalte des Rechteinhabers verzeichnet 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=-views
Top 10 der US-Städte 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 gesamte Wiedergabezeit, das Datum, an dem die Wiedergabezeit aufgetreten ist, und die Stadt, in der die Inhalte wahrscheinlich angesehen wurden. Die Ergebnisse werden in absteigender Reihenfolge nach der gesamten Wiedergabezeit sortiert.
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime
Top 10 – Meistgesehene Videos in Europa
Mit dieser Abfrage werden die zehn am häufigsten angesehenen Videos in Europa ermittelt, einschließlich der Videos, auf die der Rechteinhaber Anspruch erhoben hat, gemessen an der Anzahl der Aufrufe im angegebenen Zeitraum. Die Abfrage könnte so geändert werden, dass Daten für einen anderen Kontinent angefordert werden, indem Sie einen anderen gültigen Wert für diesen Filter auswählen. 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=-estimatedMinutesWatched
Playlist-Berichte
Länderspezifische Messwerte zur Wiedergabezeit für die Playlists eines Rechteinhabers
Diese Abfrage ruft länderspezifische Messwerte für Playlist-Aufrufe und Playlist-Wiedergabezeit ab für alle Playlists auf den Kanälen des Rechteinhabers. Der Bericht enthält jeweils eine Datenzeile, in dem die Playlists angesehen wurden. Zeilen werden absteigend nach der Anzahl der Minuten angesehen.
dimensions=country metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist sort=-playlistEstimatedMinutesWatched
Top 10 – Playlists mit den meisten in den USA am häufigsten gestarteten Playlists
Diese Abfrage ruft die zehn Playlists von den Kanälen des Rechteinhabers ab, die Zuschauer in der In den USA wurden im angegebenen Zeitraum am häufigsten Videos angesehen. Die Ergebnisse sind in absteigender Reihenfolge nach der Anzahl der Playlist-Starts sortiert.
Hinweis: Da in diesem Bericht das Feld
playlist verwenden, müssen Sie
einen Wert für den Anfrageparameter sort angeben und auch den Wert
maxResults in einen Ganzzahlwert von 10 oder kleiner.
dimensions=playlist metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration filters=country==US maxResults=10 sort=-playlistStarts
Videoberichte
„Mag ich“- und „Mag ich nicht“-Bewertungen nach Inhaltstyp
Diese Abfrage ruft die Anzahl der „Mag ich“- und „Mag ich nicht“-Bewertungen für jeden Inhaltstyp auf einem bestimmten Kanal oder einer Kanalgruppe ab. 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_ID
Videoberichte
Anzahl der Aufrufe und Wiedergabezeiten an 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 basierend auf dem Typ der Seite oder Anwendung zusammengefasst, auf der die Videowiedergabe erfolgte. Die Ergebnisse sind in absteigender Reihenfolge nach der Anzahl der Aufrufe 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=insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=channel==CHANNEL_ID sort=-views
Anzahl der Aufrufe pro Tag und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die tägliche Anzahl von Aufrufen und die geschätzte Wiedergabezeit in den USA für Videos ab, die auf einen bestimmten Kanal oder eine Kanalgruppe 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=-day
Top 10: Websites von Drittanbietern, die die meisten Aufrufe für ein eingebettetes Video generieren
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. 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=-views
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die Anzahl der Playlist-Aufrufe, die geschätzte Playlist-Wiedergabezeit und Playlist startet für alle Playlists in den Kanälen eines Rechteinhabers. Die Ergebnisse basieren auf aggregierten je nach Art der Seite oder Anwendung, auf der die Videowiedergabe erfolgte, und die Ergebnisse werden in absteigender Reihenfolge nach Playlist-Starts sortieren.
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
Anzahl der Playlist-Aufrufe und Wiedergabezeit an verschiedenen Wiedergabeorten
Diese Abfrage ruft die täglichen Playlist-Starts, die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit der Playlist ab Zeit in den USA für alle Playlists in den Kanälen eines Rechteinhabers fest. Ergebnisse werden zurückgegeben für jede Art von Seite oder Anwendung, auf der Playlist-Aufrufe erfolgt sind.
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
Videoberichte
Anzahl der Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen
Diese Anfrage ruft die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für die Videos des Rechteinhabers ab. Die Messwerte werden nach Zugriffsquelle zusammengefasst. So wird beschrieben, wie Nutzer auf das Video gelangt sind.
dimensions=insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self
Die Anzahl der Aufrufe pro Tag und die Wiedergabezeit von verschiedenen Zugriffsquellen
Diese Anfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte tägliche Wiedergabezeit für die Videos des Rechteinhabers ab. Die Messwerte werden täglich nach Besucherquelle zusammengefasst und in umgekehrter chronologischer Reihenfolge sortiert.
dimensions=day,insightTrafficSourceType metrics=views,estimatedMinutesWatched filters=uploaderType==self sort=-day
Hinweis:Die nächsten beiden Beispielberichte werden nur für bestimmte Besucherquellen unterstützt. Da die Zugriffsquelle „NO_LINK_EMBEDDED“ beispielsweise keine zusätzlichen Details enthält, sind diese Berichte für diese Quelle nicht verfügbar. Weitere Informationen zu den Zugriffsquellen, für die diese Berichtstypen verfügbar sind, findest du in der insightTrafficSourceType-Definition.
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=-views
Top 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 nach der geschätzten Wiedergabezeit in absteigender Reihenfolge 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=-estimatedMinutesWatched
Playlist-Berichte
Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen in einem Land
Diese Anfrage ruft die Anzahl der Playlist-Aufrufe, Playlist-Starts und die geschätzte Wiedergabezeit der Playlist ab. wie oft Playlist-Aufrufe in einem bestimmten Land erzielt wurden. Die Messwerte werden nach Besucherquelle, der die Art und Weise beschreibt, wie Nutzer auf die Playlist gelangt sind.
dimensions=insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=country==US
Anzahl der Playlist-Aufrufe und Wiedergabezeit von verschiedenen Zugriffsquellen
Diese Anfrage ruft Playlist-Aufrufe, Playlist-Starts und die geschätzte Wiedergabezeit der Playlist ab
für Playlists in einem oder mehreren Kanälen des Rechteinhabers. Die Messwerte werden durch
Besucherquelle. Zum Ausführen dieser Abfrage in APIs Explorer müssen Sie die Zeichenfolge
CHANNEL_ID im Parameterwert filters durch ein Komma
Liste mit bis zu 500 Kanal-IDs für deine Kanäle.
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
Videoberichte
Tägliche Messwerte für Gerätetypen für Videos mit Ansprüchen
Diese Abfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte Wiedergabezeit nach Gerätetyp für Videos ab, auf die ein bestimmter Rechteinhaber Anspruch erhoben hat. Die Ergebnisse werden für jeden Gerätetyp, auf dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,deviceType metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed sort=day
Tä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 bestimmter Rechteinhaber Anspruch erhoben hat und die auf Mobilgeräten erfolgt sind. Die Ergebnisse werden für jedes Betriebssystem, in dem Videos wiedergegeben wurden, nach Tag gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem metrics=estimatedMinutesWatched,views filters=claimedStatus==claimed;deviceType==MOBILE sort=day
Tägliche Messwerte zu Betriebssystem und Gerätetyp
Diese Abfrage ruft die Anzahl der Aufrufe pro Tag und die geschätzte Wiedergabezeit für Videos ab, auf die ein bestimmter Rechteinhaber Anspruch erhoben hat. Die Statistiken sind nach Betriebssystem und Gerätetyp gruppiert. Die Ergebnisse sind in chronologischer Reihenfolge sortiert.
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
Playlist-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 ab
für Playlists in einem oder mehreren Kanälen des Rechteinhabers. Es werden Ergebnisse zurückgegeben für
jede Art von Gerät, auf dem Playlist-Aufrufe erfolgt sind. Zum Ausführen dieser Abfrage in den APIs
Explorer verwenden möchten, müssen Sie den String CHANNEL_ID im filters ersetzen.
durch eine durch Kommas getrennte Liste von bis zu 500 Kanal-IDs für deine Kanäle.
dimensions=deviceType metrics=playlistViews,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID;operatingSystem==ANDROID
Betriebssystemmesswerte für Playlist-Aufrufe auf Mobilgeräten
Diese Abfrage ruft die Anzahl der Playlist-Aufrufe und die geschätzte Wiedergabezeit auf Mobilgeräten ab. für Playlists auf den Kanälen eines Rechteinhabers. Es werden jeweils Ergebnisse für Betriebssystem der Playlist-Aufrufe.
dimensions=operatingSystem metrics=views,estimatedMinutesWatched filters=deviceType==MOBILE
Videoberichte
Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht)
Dieser Bericht ruft Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien ab, die sich die beanspruchten Inhalte des Rechteinhabers angesehen haben. Die Ergebnisse werden 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=claimedStatus==claimed;province==US-CA sort=gender,ageGroup
Messwerte zum Teilen, zusammengefasst nach dem Dienst, bei dem Videos geteilt wurden
Diese Anfrage ruft die Häufigkeit ab, mit der Nutzer Videos über die Schaltfläche Share geteilt haben, die der Rechteinhaber hochgeladen hat. Die Ergebnisse werden nach Freigabedienst (Google+, Twitter usw.) zusammengefasst und in absteigender Reihenfolge nach der Anzahl der geteilten Inhalte sortiert.
dimensions=sharingService metrics=shares filters=uploaderType==self sort=-shares
Messwerte zur Zuschauerbindung für ein Video
Mit diesem Bericht wird gemessen, inwieweit ein Video Zuschauer binden kann. 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 Zuschauerbindung ist es nicht möglich, 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 das Ergebnis einer direkten Nutzeraktion wie einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video sind. Daher enthält der Bericht 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==ORGANIC
Messwerte zum Umsatz und zur Anzeigenleistung für Inhalte, auf die Anspruch erhoben wurde
Mit dieser Anfrage werden Messwerte zum Umsatz und zur Anzeigenleistung für die beanspruchten Inhalte des Rechteinhabers abgerufen. Der Bericht enthält eine einzelne Datenzeile mit den Gesamtwerten für jeden angeforderten Messwert im angegebenen Zeitraum.
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks filters=claimedStatus==claimed
Messwerte 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==claimed
Länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung
Diese Anfrage ruft länderspezifische Messwerte zum Umsatz und zur Anzeigenleistung für die Inhalte des Rechteinhabers ab, auf die Anspruch erhoben wurde. Die Ergebnisse werden in absteigender Reihenfolge nach Umsatzbetrag sortiert. Das bedeutet, dass das erste Land das Land ist, 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=-estimatedRevenue
Top 10 – Videos mit den höchsten Einnahmen
Mit dieser Anfrage werden die Messwerte zum Umsatz und zur Anzeigenleistung für die zehn Videos abgerufen, auf die vom Rechteinhaber Anspruch erhoben wurde 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=-estimatedRevenue
Messwerte zur Anzeigenleistung für verschiedene Anzeigentypen
Mit dieser Anfrage werden Messwerte zur Anzeigenleistung für die Inhalte des Rechteinhabers abgerufen, auf die Anspruch erhoben wurde. Die Ergebnisse werden nach Anzeigentyp gruppiert, sodass Sie Umsatz- und CPM-Werte für verschiedene Anzeigentypen vergleichen können.
dimensions=adType metrics=grossRevenue,adImpressions,cpm filters=claimedStatus==claimed sort=-adType