Überarbeitungsverlauf

Auf dieser Seite werden API-Änderungen und Aktualisierungen der Dokumentation für die YouTube Reporting API und die YouTube Analytics API aufgeführt. Beide APIs ermöglichen es Entwicklern, auf YouTube Analytics-Daten zuzugreifen, wenn auch auf unterschiedliche Weise. Dieses Änderungsprotokoll abonnieren Abonnieren

4. Dezember 2023

Die YouTube Analytics (Targeting Queries) API wurde aktualisiert, sodass jetzt zwei insightTrafficSourceType-Dimensionswerte zusammengeführt werden. Bisher wurde mit der Dimension zwischen Videos, die als Teil einer Playlist abgespielt wurden (PLAYLIST) und Aufrufen unterschieden, die über eine Seite erfolgten, auf der alle Videos einer Playlist aufgeführt sind (YT_PLAYLIST_PAGE). Zukünftig werden beide Arten von Aufrufen dem Dimensionswert PLAYLIST zugeordnet.

15. Dezember 2022

Die YouTube Analytics API (Targeting-Anfragen) unterstützt zwei neue Dimensionen und einen neuen Bericht:

  • In einem neuen Bericht werden die Nutzeraktivitäten nach Stadt aufgeführt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension city, die eine Schätzung der Stadt angibt, in der die Nutzeraktivität stattgefunden hat.

  • Die neue Dimension creatorContentType gibt die Art von YouTube-Inhalten an, die mit den Messwerten zur Nutzeraktivität in der Datenzeile verknüpft ist. Unterstützte Werte sind LIVE_STREAM, SHORTS, STORY und VIDEO_ON_DEMAND.

    Die Dimension „creatorContentType“ wird als optionale Dimension für alle Berichte zu Videos von Kanälen und Rechteinhabern unterstützt.

  • Der Leitfaden zu Beispielanfragen an die YouTube Analytics API enthält jetzt Beispiele für beide neuen Dimensionen.

  • Verweise auf die Dimensionen 7DayTotals und 30DayTotals wurden aus der Dokumentation entfernt. Die Einstellung dieser Dimensionen wurde im Oktober 2019 angekündigt.

26. August 2022

Die YouTube Analytics API (Gezielte Anfragen) und die YouTube Reporting (Bulk Reports) API unterstützen beide einen neuen Detailwert für Besucherquellen:

  • Wenn in der YouTube Analytics API (Targeting Queries) API der Wert der Dimension insightTrafficSourceType auf SUBSCRIBER festgelegt ist, kann der Wert insightTrafficSourceDetail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde.
  • Wenn in der YouTube Reporting (Bulk Reports) API der Wert der Dimension traffic_source_type auf 3 gesetzt ist, kann der Wert traffic_source_detail auf podcasts gesetzt werden. Das bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde.

11. Februar 2022

Die gültigen Werte für die Dimension gender ändern sich am oder nach dem 11. August 2022. Möglicherweise handelt es sich um eine nicht abwärtskompatible Änderung an Ihrer API-Implementierung. Gemäß dem Abschnitt Abwärtsinkompatible Änderungen der Nutzungsbedingungen der YouTube API-Dienste wird diese Änderung sechs Monate vor ihrem Inkrafttreten angekündigt. Bitte aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um einen nahtlosen Übergang zu den neuen Werten zu ermöglichen.

Folgende Änderungen werden vorgenommen:

  • In der YouTube Analytics API (Gezielte Anfragen) unterstützt die Dimension gender derzeit zwei Werte: female und male. Ab dem 11. August 2022 unterstützt diese Dimension drei Werte: female, male und user_specified.
  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension gender derzeit drei Werte: FEMALE, MALE und GENDER_OTHER. Am oder nach dem 11. August 2022 werden die unterstützten Werte in FEMALE, MALE und USER_SPECIFIED geändert.

9. Februar 2022

Seit dem 13. Dezember 2021 wurden zwei Messwerte aktualisiert, um den Traffic in Form von Schleifenclips auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics (Gezielte Suchanfragen) API als auch die YouTube Reporting (Bulk Reports) API.

2. Februar 2022

Diese YouTube Reporting (Bulk Reports) API unterstützt einen neuen Dimensionswert für Zugriffsquellen, der angibt, dass die Aufrufe über Live Redirects stammen:

  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension traffic_source_type den Wert 28.

Bei diesem Zugriffsquellentyp gibt die Dimension traffic_source_detail die Kanal-ID an, von der der Zuschauer gekommen ist.

23. September 2020

Die YouTube Analytics API (Targeting Queries) und die YouTube Reporting (Bulk Reports) API unterstützen beide einen neuen Dimensionswert für Zugriffsquellen. Dieser zeigt an, dass der Zuschauer durch vertikales Wischen im YouTube Shorts-Wiedergabeformat auf deine Website gelangt ist:

  • In der YouTube Analytics API (Targeting Queries) API unterstützt die Dimension insightTrafficSourceType den Wert SHORTS.
  • In der YouTube Reporting API (Bulk Reports) unterstützt die Dimension traffic_source_type den Wert 24.

Die Dimension „Details zu Zugriffsquellen“ – insightTrafficSourceDetail in der YouTube Analytics API oder traffic_source_detail in der YouTube Reporting API – wird für diesen neuen Besucherquellentyp nicht ausgefüllt.

20. Juli 2020

Diese Aktualisierung umfasst zwei Änderungen, die sich auf die YouTube Analytics (Targeting Queries) API auswirken:

  • Die maximale Größe einer YouTube Analytics-Berichtsgruppe wurde von 200 auf 500 Elemente erhöht.
  • Der Parameter filters der Methode reports.query gibt eine Liste von Filtern an, die beim Abrufen von YouTube Analytics-Daten angewendet werden sollen. Der Parameter unterstützt die Möglichkeit, mehrere Werte für die Filter video, playlist und channel anzugeben. Außerdem wurde die maximale Anzahl von IDs, die für diese Filter angegeben werden können, von 200 auf 500 erhöht.

13. Februar 2020

Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API und die YouTube Reporting (Bulk Reports) API. Weitere Informationen zu diesen Änderungen findest du in der YouTube-Hilfe.

In beiden APIs ändert sich der Satz möglicher Detailwerte für Besucherquellen für Benachrichtigungen. In Targeting-Abfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17 gemeldet.

Durch die neuen Werte werden Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded gemeldet wurden, in zwei Kategorien unterteilt:

  • uploaded_push – Aufrufe über Push-Benachrichtigungen, die Abonnenten beim Hochladen eines Videos gesendet haben
  • uploaded_other: Aufrufe, die über andere Kanäle als Push-Benachrichtigungen (z. B. E-Mail- oder Posteingangsbenachrichtigungen) stammen, die Abonnenten beim Hochladen eines Videos erhalten haben.

Diese Werte werden für den Zeitraum ab dem 13.01.2020 (13. Januar 2020) zurückgegeben.

Zur Erinnerung: Diese Werte stellen keine Benachrichtigungen selbst dar, sondern die Zugriffsquellen, über die bestimmte YouTube-Aufrufe erzielt wurden. Wenn in einer Berichtszeile beispielsweise views=3, traffic_source_type=17 (NOTIFICATION) und traffic_source_detail=uploaded_push angezeigt werden, gibt die Zeile an, dass drei Aufrufe durch Nutzer erfolgten, die auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.

15. Oktober 2019

Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:

  • Hinweis:Diese Ankündigung wird eingestellt.

    Die Dimensionen 7DayTotals und 30DayTotals werden von YouTube nicht mehr unterstützt. Bis zum 15. April 2020 können Sie noch Daten mit diesen Dimensionen abrufen. An oder nach diesem Datum wird ein Fehler zurückgegeben, wenn Berichte mit der Dimension 7DayTotals oder 30DayTotals abgerufen werden.

    Nutzer können einige Daten für diese Dimensionen reproduzieren, indem sie eine Abfrage mit der Dimension day ausführen und Daten über einen Zeitraum von 7 oder 30 Tagen aggregieren oder ableiten. Beispiel:

    • Die Anzahl der Aufrufe über einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe von jedem Tag dieses Zeitraums aggregiert wird.
    • Der Prozentsatz der Zuschauer für einen Zeitraum von sieben Tagen lässt sich berechnen, indem du die Anzahl der Aufrufe pro Tag mit dem Prozentsatz der Zuschauer für diesen Tag multiplizierest. So erhältst du die Anzahl der Zuschauer, die beim Ansehen des Videos an diesem Tag angemeldet waren. Anschließend kannst du die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum addieren und durch die Gesamtzahl der Aufrufe in diesem Zeitraum teilen. So erhältst du den Prozentsatz für Zuschauer für den gesamten Zeitraum.
    • Die Anzahl der einzelnen Nutzer für einen Zeitraum von sieben Tagen kann nicht berechnet werden, da derselbe Nutzer als einzelner Nutzer an verschiedenen Tagen berechnet werden kann. Sie können jedoch möglicherweise die Dimension month anstelle der Dimension 30DayTotals verwenden, um Daten zur Anzahl der einzelnen Nutzer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimension month bezieht sich auf Kalendermonate, während mit der Dimension 30DayTotals 30-Tage-Zeiträume basierend auf dem angegebenen Start- und Enddatum berechnet werden.

27. Juni 2019

Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:

  • Da Version 1 der API jetzt vollständig eingestellt ist, wurde die Dokumentation aktualisiert und Verweise auf diese Version entfernt, einschließlich des Hinweises zu veralteten Versionen und der Migrationsanleitung, in der die Aktualisierung auf Version 2 erläutert wird.

1. November 2018

Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:

17. September 2018

Diese Aktualisierung enthält die folgenden Änderungen in Bezug auf die YouTube Analytics (Targeting Queries) API:

  • Im neuen Abschnitt Datenanonymisierung im Übersichtsdokument zum Datenmodell wird erläutert, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn die Messwerte einen bestimmten Grenzwert nicht erreichen. Dies kann in verschiedenen Fällen passieren. In der Praxis bedeutet dies, dass ein Bericht möglicherweise nicht alle oder gar keine Daten enthält, wenn:

    1. ein Video oder Kanal während eines bestimmten Zeitraums nur wenige Zugriffe hat,

      oder

    2. Sie einen Filter oder eine Dimension wie Besucherquelle oder Land ausgewählt haben, für den bzw. die die Werte einen bestimmten Grenzwert nicht erreichen.

    In dem neuen Abschnitt werden auch die Datentypen erläutert, die in YouTube Analytics-Berichten möglicherweise eingeschränkt sind.

  • Die Dokumente Kanalberichte und Rechteinhaberberichte wurden aktualisiert, um die Tatsache zu berücksichtigen, dass die Messwerte redViews und estimatedRedMinutesWatched für Berichte zu Wiedergabeort, Besucherquelle und Gerätetyp/Betriebssystem nicht mehr unterstützt werden.

18. Juni 2018

Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

  • Die Anforderungen für den Umfang der folgenden Methoden haben sich geändert:
    • Anfragen an die Methode reports.query müssen Zugriff auf den Bereich https://www.googleapis.com/auth/youtube.readonly haben.
    • Anfragen an die Methode groupItems.list müssen Zugriff auf Folgendes haben:
      • https://www.googleapis.com/auth/youtube-Bereich
        oder
      • den Bereich https://www.googleapis.com/auth/youtube.readonly
        und
        den Bereich https://www.googleapis.com/auth/yt-analytics.readonly

      Bei der ersten Option wird ein Bereich verwendet, bei dem es sich zufällig um einen nicht schreibgeschützten Bereich handelt, während bei der zweiten Option zwei schreibgeschützte Bereiche verwendet werden.

23. Mai 2018

Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

  • Die API-Übersicht enthält einen neuen Abschnitt, zusammengefasste Messwerte und gelöschte Elemente. Darin wird erläutert, wie API-Antworten mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verbundene Daten verarbeiten.
  • Der Abschnitt Best Practices in der API-Übersicht wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für Ressourcen abrufen kannst, die in Antworten der YouTube Analytics API identifiziert wurden. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) angegeben, müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.

22. Mai 2018

Diese Aktualisierung umfasst die folgenden Änderungen in Bezug auf die YouTube Reporting (Bulk Reports) API:

  • Die folgenden Änderungen sollen derzeit im Juli 2018 in Kraft treten. Die neuen Richtlinien gelten weltweit für alle Berichte und Berichterstellungsjobs.
    • Nach der Änderung sind die meisten API-Berichte, einschließlich Backfill-Berichte, ab dem Zeitpunkt ihrer Erstellung 60 Tage lang verfügbar. Berichte mit Verlaufsdaten sind jedoch ab Erstellung 30 Tage lang verfügbar.

      Bisher waren alle API-Berichte ab ihrer Erstellung 180 Tage lang verfügbar. Wir möchten noch einmal darauf hinweisen, dass ab dem Inkrafttreten dieser Richtlinienänderung auch keine Berichte zu Verlaufsdaten mehr als 30 Tage über die API verfügbar sind. Alle anderen Berichte, die älter als 60 Tage sind, können ebenfalls nicht mehr aufgerufen werden. Aus diesem Grund sind Berichte, die vor der Richtlinienänderung erstellt wurden, jetzt bis zu 180 Tage lang verfügbar.

    • Wenn Sie nach der Änderung einen Berichterstellungsjob planen, erstellt YouTube ab diesem Tag Berichte, die die 30 Tage vor der Planung des Jobs abdecken. Wenn Sie vor der Änderung einen Berichterstellungsjob planen, erstellt YouTube Berichte für die 180 Tage vor der Planung des Jobs.

  • Der Abschnitt Best Practices wurde aktualisiert, um dich daran zu erinnern, dass du mit der YouTube Data API zusätzliche Metadaten für in Berichten identifizierte Ressourcen abrufen kannst. Wie in den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) angegeben, müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen aus dieser API entweder löschen oder aktualisieren.

  • Der Abschnitt Berichtsmerkmale wurde aktualisiert. Obwohl Berichtsdaten nicht gefiltert wurden, enthalten Berichte, die Daten für einen Zeitraum ab dem 1. Juni 2018 enthalten, keine Verweise auf YouTube-Ressourcen, die mindestens 30 Tage vor dem Datum der Berichterstellung gelöscht wurden.

  • Der Abschnitt Verlaufsdaten in der API-Übersicht wurde aktualisiert. Wenn Sie einen neuen Berichterstellungsjob planen, werden die Berichte zu bisherigen Daten in der Regel innerhalb weniger Tage veröffentlicht. Laut der Dokumentation kann es bis zu 30 Tage dauern, bis solche Berichte verfügbar sind.

  • Der Abschnitt Backfill-Daten der API-Übersicht wurde aktualisiert, um Backfill-Daten deutlicher als Datenpools zu definieren, die zuvor übermittelte Daten ersetzen.

26. April 2018

Version 2 der YouTube Analytics (Targeting Queries) API (Version 2) ist jetzt öffentlich verfügbar. In der folgenden Liste sind Änderungen an Produkten und Dokumentationen im Zusammenhang mit der neuen API-Version aufgeführt:

  • Die API v2 ist fast identisch mit der API v1. Wahrscheinlich ist es jedoch erforderlich, dass Sie Ihren Code aktualisieren, um die unten aufgeführten Änderungen widerzuspiegeln. All diese Änderungen werden im neuen Migrationsleitfaden ausführlich erläutert.

    • Die API-Version wurde von v1 zu v2 geändert.
    • Die Basis-URL für API-Anfragen wurde von https://www.googleapis.com/youtube/analytics/v1 zu https://youtubeanalytics.googleapis.com/v2 geändert.
    • Mehrere Parameter für die Methode reports.query haben aktualisierte Namen. Insbesondere Parameternamen, die Bindestriche enthalten, wie end-date in der API V1, verwenden in der API V1 die Camel-Case-Schreibweise (endDate) anstelle von Bindestrichen. Durch diese Änderung sind Parameternamen im gesamten API einheitlich, da bei den API-Methoden zum Erstellen und Verwalten von Gruppen bereits die Camel-Case-Schreibweise für Parameternamen verwendet wird.
    • Die API V2 unterstützt keine Batchanfragen, die an den globalen HTTP-Batchendpunkt von Google (www.googleapis.com/batch) gesendet werden. Wenn Sie Batchanfragen mit der API V2 senden, müssen Sie stattdessen den Endpunkt https://youtubeanalytics.googleapis.com/v2 verwenden.

    Außerdem werden einige Funktionen von Version 1 von API V2 nicht unterstützt:

    • Die Methode reports.query unterstützt die Anfrageparameter alt, quotaUser und userIp nicht mehr.
    • Die API V2 bietet keinen Batchendpunkt, der Batches aus Anfragen an verschiedene APIs unterstützt. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden desselben APIs bestehen. Diese Einstellung bezieht sich nicht nur auf die YouTube Analytics API, da Google den globalen Batchendpunkt für alle seine APIs einstellt.
    • Das JSON-RPC-Protokoll, das in API Version 1 unterstützt wurde, wird von der API V2 nicht unterstützt. Diese Einstellung bezieht sich nicht nur auf die YouTube Analytics API.

  • Hinweis:Diese Ankündigung wird eingestellt.

    Version 1 der API (v1) wurde eingestellt und wird bis zum 31. Oktober 2018 unterstützt. Nach diesem Datum funktionieren alle Anfragen an die v1 API nicht mehr. Deshalb solltest du bis zum 31. Oktober 2018 auf die Version 2 der API aktualisieren, damit du weiterhin über die API auf YouTube Analytics-Daten zugreifen kannst.

21. Februar 2018

Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics (Targeting Queries) API:

  • Berichte zur Leistung nach demografischen Merkmalen, in denen Wiedergabestatistiken auf Grundlage der Altersgruppe und des Geschlechts der Zuschauer zusammengefasst werden, unterstützen nicht mehr die Dimension „youtubeProduct“, die den YouTube-Dienst identifiziert, bei dem die Nutzeraktivität aufgetreten ist.

18. Januar 2018

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension operating_system, die das Softwaresystem des Geräts ermittelt, auf dem die Aufrufe erfolgten, unterstützt jetzt den folgenden Wert:
      • 25: KaiOS
  • YouTube Analytics API (gezielte Suchanfragen)

    • Die Dimension „operatingSystem“ unterstützt den Dimensionswert „KAIOS“.

20. Dezember 2017

Diese Aktualisierung umfasst zwei Änderungen, die die YouTube Reporting API betreffen:

  • Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen zum Herunterladen von Berichten. Für andere Arten von API-Anfragen wird die GZIP-Komprimierung nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Und obwohl Ihre Anwendung zum Dekomprimieren von API-Antworten zusätzliche CPU-Zeit benötigt, überwiegt der Vorteil, weniger Netzwerkressourcen zu verbrauchen, diese Kosten.

    Um eine mit gzip codierte Antwort zu erhalten, setzen Sie den Accept-Encoding-HTTP-Anfrageheader auf gzip, wie im folgenden Beispiel gezeigt:

    Accept-Encoding: gzip

    Diese Funktion wird in der API-Übersicht und in der Definition des Attributs downloadUrl der Ressource report erläutert.

  • Die Dokumentation für die Dimensionen age group und gender wurde korrigiert und zeigt jetzt die tatsächlichen Werte an, die die API für diese Dimensionen zurückgibt. Beachten Sie, dass dies eine Korrektur in der Dokumentation ist und keine Änderung der API-Funktionalität oder des Verhaltens widerspiegelt. Insbesondere haben sich die folgenden Werte geändert:

    • Die Werte für die Dimension „age_group“ umfassen Großbuchstaben, Unterstriche zwischen dem Wort „AGE“ und den Ziffern in der Altersgruppe und Unterstriche anstelle von Bindestrichen. Daher wurden Werte wie age13-17 und age18-24 zu AGE_13_17 bzw. AGE_18_24 korrigiert.
    • In den Werten der Dimension „gender“ werden Großbuchstaben verwendet. Daher wurden die Werte female, male und gender_other zu FEMALE, MALE und GENDER_OTHER korrigiert.

10. August 2017

Am 10. August 2016 wurde in dieser Dokumentation bekannt gegeben, dass der Messwert earnings der YouTube Analytics API eingestellt wird. Gleichzeitig wurde in der API ein neuer Messwert mit dem Namen estimatedRevenue unterstützt, der dieselben Daten liefert.

Da der Messwert „earnings“ ein wichtiger Messwert war, wurde er ab dem Datum der Ankündigung ein Jahr lang unterstützt. Da dieser einjährige Zeitraum nun zu Ende ist, wird der Messwert earnings jedoch nicht mehr unterstützt. Daher wird bei API-Anfragen, die den Messwert earnings angeben, jetzt der HTTP-Antwortcode 400 zurückgegeben. Wenn du deine App noch nicht aktualisiert hast, um den Messwert estimatedRevenue anstelle des Messwerts earnings zu verwenden, tu dies bitte so bald wie möglich.

Die API-Dokumentation wurde aktualisiert und die verbleibenden Verweise auf den Messwert earnings wurden entfernt.

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (gezielte Suchanfragen)

    • Die API-Dokumentation wurde aktualisiert, um die Tatsache zu berücksichtigen, dass API-Antworten Daten bis zum letzten Tag im angeforderten Zeitraum enthalten, für den alle abgefragten Messwerte verfügbar sind.

      Wenn in einer Anfrage beispielsweise der 5. Juli 2017 als Enddatum angegeben ist und die Werte für alle angeforderten Messwerte nur bis zum 3. Juli 2017 verfügbar sind, werden in der Antwort letzte Daten berücksichtigt. Das gilt auch dann, wenn Daten für einige der angeforderten Messwerte für den 4. Juli 2017 verfügbar sind.

    • Die Dimension „adType“ unterstützt jetzt den Wert reservedBumperInstream, der sich auf eine nicht überspringbare Videoanzeige von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann. Das Anzeigenformat ist mit der auctionBumperInstream-Anzeige identisch. Dieser Typ bezieht sich jedoch auf Anzeigen, die auf Reservierungsbasis und nicht auf Auktionsbasis verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

    • Für die Dimension „ad_type“ wird jetzt der Wert 20 unterstützt, der sich auf Bumper-Anzeigen bezieht, die auf Reservierungsbasis verkauft werden. Bumper-Anzeigen sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden. Der Wert 19 für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die über eine Auktion und nicht über einen reservierten Kauf verkauft werden.

    • Berichterstellungsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Diese Berichtstypen wurden am 15. September 2016 als eingestellt angekündigt und nach dem 15. Dezember 2016 wurden keine entsprechenden Berichte mehr erstellt. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 15. Juni 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports verknüpften Jobs auch nicht benötigt.

24. Mai 2017

Alle Berichterstellungsjobs für die folgenden YouTube Reporting API-Berichte wurden gelöscht:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Diese Berichtstypen wurden am 22. Juni 2016 als eingestellt angekündigt. Nach dem 22. September 2016 wurden keine entsprechenden Berichte mehr generiert. Zuvor erstellte Berichte waren ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar. Daher waren einige Berichte erst seit dem 22. März 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports verknüpften Jobs auch nicht benötigt.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension sharing_service, die den Dienst angibt, über den Videos freigegeben wurden, unterstützt jetzt die folgenden Werte:

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Darüber hinaus wurde der Name zur Identifizierung des Werts 52 in der Dokumentation in Kakao (Kakao Talk) geändert, um ihn deutlicher vom Wert 73 (Kakao Story) zu unterscheiden. Diese Änderung hat keine Auswirkungen auf das API-Verhalten oder die Klassifizierung von Videos, die mit diesen Diensten geteilt werden.

  • YouTube Analytics API (gezielte Suchanfragen)

    • Für die Dimension „sharingService“ werden jetzt folgende Werte unterstützt:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28. März 2017

Kanalinhaber, die über YouTube Analytics in Creator Studio auf Umsatzdaten zugreifen können, können jetzt auch über die YouTube Analytics API auf diese Umsatzdaten zugreifen:

17. März 2017

Dieses Update enthält die folgenden Änderungen:

  • Die YouTube Analytics API unterstützt die Messwerte redViews und estimatedRedMinutesWatched, die sich beide auf die YouTube Red-Zuschauerzahlen beziehen. Die API unterstützt diese Messwerte bereits seit einiger Zeit und die YouTube Reporting API unterstützt bereits beide Messwerte, wie am 15. September 2016 angekündigt.

    • Der Messwert redViews gibt an, wie oft ein Video von YouTube Red-Abonnenten angesehen wurde.
    • Der Messwert estimatedRedMinutesWatched gibt die Anzahl der Minuten an, die YouTube Red-Abonnenten ein Video angesehen haben.

    Die Dokumentation zu Kanalberichten und Berichten zu Rechteinhabern wurde aktualisiert. Jetzt sehen Sie, in welchen Berichten die beiden neuen Messwerte unterstützt werden. Sie werden in allen Berichten unterstützt, in denen die Messwerte „views“ und „estimatedMinutesWatched“ bereits unterstützt werden.

3. März 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Definition der Dimension date wurde korrigiert. Der Dimensionswert bezieht sich nun auf den Zeitraum, der um 00:00 Uhr Pacific Time beginnt und am angegebenen Tag, Monat und Jahr um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die Zeitzone entweder UTC-7 oder UTC-8.

      Obwohl ein Datum in der Regel 24 Stunden entspricht, handelt es sich bei einem Datum, an dem die Uhren vorwärts bewegt werden, um einen 23-Stunden-Zeitraum und ein Datum, an dem die Uhren rückwärts bewegt werden, einem 25-Stunden-Zeitraum. Zuvor war in der Dokumentation angegeben, dass jedes Datum einen eindeutigen 24-Stunden-Zeitraum darstellte und dass die Pacific Time immer UTC-8 war.

      Beachten Sie, dass diese Korrektur keine Änderung des tatsächlichen API-Verhaltens darstellt.

    • Die Dimension operating_system, die das Softwaresystem des Geräts ermittelt, auf dem die Aufrufe erfolgten, unterstützt jetzt folgende Werte:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia
    • Alle Berichterstellungsjobs für den Berichtstyp content_owner_basic_a1 wurden gelöscht. Dieser Berichtstyp wurde am 19. August 2016 vollständig eingestellt. Allerdings waren zuvor generierte content_owner_basic_a1-Berichte ab dem Zeitpunkt ihrer Erstellung noch 180 Tage lang verfügbar. Daher waren einige Berichte erst am 19. Februar 2017 verfügbar. Da die Reports jedoch nicht mehr verfügbar sind, werden die mit den Reports verknüpften Jobs auch nicht benötigt.

  • YouTube Analytics API (gezielte Suchanfragen)

    • Die Beschreibung der Dimensionen in Bezug auf time periods wurde korrigiert. Der Dimensionswert bezieht sich nun auf den Zeitraum, der um 00:00 Uhr Pacific Time beginnt und am angegebenen Tag, Monat und Jahr um 23:59 Uhr Pacific Time endet. Je nach Jahreszeit entspricht die Zeitzone entweder UTC-7 oder UTC-8.

      Obwohl ein Datum in der Regel 24 Stunden entspricht, handelt es sich bei einem Datum, an dem die Uhren vorwärts bewegt werden, um einen 23-Stunden-Zeitraum und ein Datum, an dem die Uhren rückwärts bewegt werden, einem 25-Stunden-Zeitraum. Zuvor wurde in der Dokumentation angegeben, dass die Pacific Time UTC-8 war, und es wurde nicht erwähnt, dass ein Tag möglicherweise keinen 24-Stunden-Zeitraum darstellt.

      Beachten Sie, dass diese Korrektur keine Änderung des tatsächlichen API-Verhaltens darstellt.

    • Die Dokumentation zu Channelberichten wurde aktualisiert. Channelberichte enthalten derzeit keine Messwerte zu Einnahmen oder Anzeigenleistung. Daher bietet der Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly derzeit keinen Zugriff auf monetäre Daten in Channelberichten.

    • Die Dimension operatingSystem unterstützt drei neue Dimensionswerte:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8. Februar 2017

Die YouTube Analytics API unterstützt jetzt den optionalen Parameter include-historical-channel-data. Dieser Parameter ist nur beim Abrufen von Rechteinhaberberichten relevant.

Mit dem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Wiedergabezeit und Aufrufdaten der Kanäle aus dem Zeitraum vor der Verknüpfung der Kanäle mit dem Rechteinhaber enthalten soll. Der Standardparameterwert lautet false. Das bedeutet, dass die API-Antwort standardmäßig nur Wiedergabezeit- und Aufrufdaten ab dem Zeitpunkt enthält, an dem die Kanäle mit dem Rechteinhaber verknüpft wurden.

Diese Regeln gelten auch, wenn die API-Anfrage Daten für mehrere Kanäle abruft:

  • Wenn der Parameterwert false lautet, basieren die zurückgegebenen Daten zu Wiedergabezeit und Aufrufen für einen bestimmten Kanal auf dem Datum, an dem dieser Kanal mit dem Rechteinhaber verknüpft wurde.

    Denken Sie daran, dass unterschiedliche Kanäle möglicherweise zu unterschiedlichen Zeitpunkten mit einem Rechteinhaber verknüpft wurden. Wenn mit der API-Anfrage Daten für mehrere Kanäle abgerufen werden und der Parameterwert false lautet, enthält die API-Antwort Daten zu Wiedergabezeit und Aufrufen basierend auf dem Verknüpfungsdatum für den jeweiligen Kanal.
  • Wenn der Parameterwert true lautet, gibt die Antwort Wiedergabezeit- und Aufrufdaten für alle Kanäle basierend auf dem in der API-Anfrage angegebenen Start- und Enddatum zurück.

15. Dezember 2016

Die folgenden YouTube Reporting API-Berichte werden nicht mehr unterstützt und aus der Dokumentation entfernt. Für jeden Bericht ist eine neuere Version verfügbar. Diese Berichte wurden am 15. September 2016 eingestellt.

Die Liste der aktuellen Berichtstypen in der API-Referenzdokumentation wurde ebenfalls aktualisiert.

11. November 2016

Dieses Update enthält die folgenden Änderungen:

    Die YouTube Reporting API unterstützt drei neue Abspannelemente sowie neue Dimensionen und Messwerte für diese Berichte. Die Berichte enthalten Impressions- und Klickstatistiken für die Abspanne, die nach Ende der Wiedergabe eines Videos angezeigt werden.

    8. November 2016

    Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Analytics API:

    • Die Messwerte in der folgenden Liste wurden vollständig eingestellt und werden nicht mehr unterstützt. Wie am 10. August 2016 angekündigt, werden bereits neue Messwerte unterstützt, die sich auf dieselben Daten beziehen. Die folgende Tabelle zeigt den eingestellten Messwertnamen und den neuen Messwertnamen:

      Eingestellter Messwert Neuer Messwert
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27. Oktober 2016

    YouTube erstellt jetzt automatisch eine Reihe von vom System verwalteten Berichten zu Werbeeinnahmen für Rechteinhaber, die Zugriff auf die entsprechenden Berichte im Abschnitt Berichte von YouTube Studio haben. Die neuen systemverwalteten API-Berichte bieten einen programmatischen Zugriff auf Daten, die auch in den manuell herunterladbaren Berichten in Creator Studio verfügbar sind.

    Die Übersicht über vom System verwaltete Berichte bietet einen kurzen Überblick über die neuen Berichte und erläutert, wie sie über die API abgerufen werden. Dieser Prozess unterscheidet sich geringfügig vom Abrufen von Bulk-Berichten für YouTube Analytics, da Partner zum Generieren der Berichte keine Jobs planen müssen.

    Das Attribut id der Ressource reportType wurde aktualisiert und enthält nun eine Liste der vom System verwalteten Berichte, auf die Sie über die API zugreifen können:

    • Monatliche, weltweite Werbeeinnahmen pro Video
    • Täglicher Werbeumsatz pro Land und Video
    • Monatlicher, weltweiter Werbeumsatz pro Asset
    • Täglicher Werbeumsatz pro Land und Asset
    • Ansprüche (dieser Bericht enthält keine Umsatzdaten)

    27. September 2016

    Hinweis:Diese Ankündigung wird eingestellt.

    Der Messwert „uniques“ der YouTube Analytics API wurde eingestellt. Dies ist kein Hauptmesswert, der bis zum 31. Oktober 2016 unterstützt wird.

    15. September 2016

    Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:

    19. August 2016

    Diese Aktualisierung enthält die folgende Änderung an der YouTube Reporting API:

    • Der Bericht „content_owner_basic_a1“ wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube generiert keine neuen Berichte dieses Typs mehr. Berichte, die bereits erstellt wurden, sind aber noch 180 Tage lang verfügbar, nachdem sie generiert wurden.

      Anstelle des Berichts content_owner_basic_a1 wird der Bericht content_owner_basic_a2 ersetzt, wie im Überarbeitungsverlauf vom 19. Mai 2016 erläutert.

    11. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • Die neu veröffentlichten Nutzungsbedingungen der YouTube API-Dienste („Aktualisierte Nutzungsbedingungen“), die im YouTube Engineering and Developers Blog ausführlich erörtert werden, enthalten zahlreiche Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

      Die vollständigen neuen Dokumente finden Sie im Überarbeitungsverlauf für die aktualisierten Nutzungsbedingungen. Darüber hinaus werden zukünftige Änderungen an den aktualisierten Nutzungsbedingungen oder an diesen Begleitdokumenten im Überarbeitungsverlauf erläutert. Sie können einen RSS-Feed abonnieren, der die Änderungen im Überarbeitungsverlauf über einen Link in diesem Dokument auflistet.

    10. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (gezielte Suchanfragen)

      • Hinweis:Diese Ankündigung wird eingestellt.

        Die Messwerte in der folgenden Tabelle werden eingestellt. Gleichzeitig werden neue Messwerte eingeführt, die sich auf dieselben Daten beziehen. Das bedeutet, dass die alten Messwerte umbenannt werden, wobei die YouTube Analytics API beide Messwertnamen bis zu dem in der Tabelle angegebenen Einstellungsdatum unterstützt.

        Alter Messwertname Neuer Messwertname Supportdatum
        earnings estimatedRevenue 10. August 2017
        adEarnings estimatedAdRevenue 4. November 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4. November 2016
        impressionBasedCpm cpm 4. November 2016
        impressions adImpressions 4. November 2016

        Der Messwert earnings war ein Hauptmesswert und wird ab dem Datum dieser Ankündigung ein Jahr lang unterstützt. Die anderen Messwerte, bei denen es sich nicht um Kernmesswerte handelte, werden drei Monate lang bis zum 4. November 2016 unterstützt.

        Bis zum 4. November 2016 kann in einer API-Anfrage beispielsweise der Messwert impressionBasedCpm, cpm oder beides angegeben werden. Danach wird jedoch nur noch der Messwert cpm unterstützt.

      • Die Dimension insightTrafficSourceType unterstützt zwei neue Dimensionswerte:
        • CAMPAIGN_CARD: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Es zeigt an, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, mit denen der Rechteinhaber den angesehenen Inhalt beworben hat.
        • END_SCREEN: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.

        Du kannst für beide neuen Zugriffsquellen auch einen traffic source detail-Bericht abrufen. In beiden Fällen gibt die Dimension insightTrafficSourceDetail das Video an, von dem der Zuschauer verwiesen wurde.

      • Die Dimension „adType“ unterstützt jetzt den Wert auctionBumperInstream, der sich auf eine nicht überspringbare Videoanzeige von bis zu sechs Sekunden bezieht, die abgespielt wird, bevor ein Video wiedergegeben werden kann.

    • YouTube Reporting API (Bulk-Berichte)

      • Für die Dimension „traffic_source_type“ werden jetzt folgende Werte unterstützt:
        • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Es zeigt an, dass die Aufrufe von beanspruchten, von Nutzern hochgeladenen Videos stammen, mit denen der Rechteinhaber den angesehenen Inhalt beworben hat.
        • 20: Die Daten beziehen sich auf Aufrufe über den Abspann eines anderen Videos.

        Bei beiden neuen Zugriffsquellen gibt die Dimension traffic_source_detail das Video an, über das der Zuschauer verwiesen wurde.

      • Die Liste der Kernmesswerte der API wurde korrigiert: estimated_partner_revenue als Hauptmesswert aufgeführt. earnings wird nun aus der Liste entfernt. Der Messwert earnings wurde in der YouTube Reporting API noch nie unterstützt.

      • Die Dimension „ad_type“ unterstützt jetzt den Wert „19“, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen, die bis zu sechs Sekunden dauern und vor der Wiedergabe eines Videos wiedergegeben werden.

    18. Juli 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (gezielte Suchanfragen)

      • Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten nun Kartenmesswerte. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Überarbeitungsverlauf für dieses Datum wird die Änderung genauer erläutert. Folgende Berichte sind verfügbar:
        • Grundlegende Nutzeraktivität in US-Bundesstaaten
        • Nutzeraktivität in US-Bundesstaaten für bestimmte Zeiträume
        • Nutzeraktivität nach Bundesland
        • Nutzeraktivitäten nach Abostatus
        • Nutzeraktivitäten nach Abostatus für Provinzen
        • Top-Videos nach Bundesstaat
        • Top-Videos für Zuschauer mit und ohne Abo
      • Die Filterlisten für die Berichte zur Zuschauerbindung und für die Berichte zur Zuschauerbindung wurden korrigiert, um zu verdeutlichen, dass der Filter video erforderlich ist und der Filter group nicht unterstützt wird.

        Bisher wurde in der Dokumentation für beide Berichte fälschlicherweise angegeben, dass der Bericht mit einem dieser beiden Filter oder mit keinem dieser Filter abgerufen werden kann.

    • YouTube Reporting API (Bulk-Berichte)

      • Im Abschnitt API-Übersicht wird im Abschnitt zum Abrufen der Download-URL eines Berichts erklärt, dass YouTube herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten eine Kopfzeile, aber keine zusätzlichen Daten. Diese Informationen wurden bereits am 12. April 2016 im Abschnitt Berichtsmerkmale desselben Dokuments aktualisiert.
      • Die Liste der Dimensionen im Bericht „content_owner_asset_cards_a1“ wurde korrigiert, um zu zeigen, dass im Bericht die Dimension „card_id“ verwendet wird. Bisher wurde in der Dokumentation fälschlicherweise der Dimensionsname als card_title aufgeführt.

    28. Juni 2016

    Die Dokumentation zur YouTube Analytics API wurde aktualisiert, um die Unterstützung für Infokartenmesswerte in zahlreichen Berichten zu Kanälen und Rechteinhabern zu berücksichtigen. Folgende Messwerte werden neu unterstützt:

    Die Messwerte werden in den folgenden Berichtstypen unterstützt:

    22. Juni 2016

    Diese Aktualisierung enthält die folgenden Änderungen an der YouTube Reporting API. Die erste Änderung betrifft allgemein die API, die übrigen Änderungen nur Berichte zu Rechteinhabern:

    • Der Abschnitt Berichtsmerkmale der API-Übersicht wurde aktualisiert, um zu verdeutlichen, dass Berichte ab ihrer Erstellung 180 Tage lang über die API verfügbar sind.

      Bisher stand in der Dokumentation fest, dass Berichte bis zu 180 Tage vor dem Datum verfügbar sind, an dem die API-Anfrage gesendet wurde. Der Originaltext ist zwar auch technisch gesehen richtig, bestenfalls aber ziemlich verwirrend.

    • Die API unterstützt neue Versionen von drei Berichten. Zwei dieser Berichte enthalten auch neue und umbenannte Messwerte:

      • Der Bericht „content_owner_ad_rates_a1“ ist die neue Version des Berichts „content_owner_ad_performance_a1“. Der neu umbenannte Bericht ist mit der vorherigen Version identisch.

      • Zwei Berichte in neuen Versionen wurden umbenannt:

        • Die neue Version des Berichts „content_owner_estimated_earnings_a1“ heißt content_owner_estimated_revenue_a1.
        • Die neue Version des Berichts „content_owner_asset_estimated_earnings_a1“ heißt content_owner_asset_estimated_revenue_a1.

        Die beiden neu umbenannten Berichte unterscheiden sich in folgenden Punkten von ihren Vorgängerversionen:

      Wenn Sie bereits Aufträge zum Erstellen einer der älteren Versionen dieser Berichte haben, müssen Sie neue Aufträge für die umbenannten Berichte erstellen. Im Zusammenhang mit der Veröffentlichung der neuen Berichtsversionen wurden die Berichte content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 und content_owner_asset_estimated_earnings_a1 eingestellt.

      Wenn Sie Jobs für einen dieser Berichte haben, sollten Sie nicht davon ausgehen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Die generierten Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.

    • Die Definition der id-Property der Ressource reportType wurde aktualisiert, um die aktuell verfügbaren Berichte widerzuspiegeln.

    • Die Namen von zwei Messwerten wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Hierbei handelt es sich um eine reine Dokumentationskorrektur, die keine Änderung des tatsächlichen Berichtsinhalts widerspiegelt:

      • Der Name des Messwerts estimated_partner_adsense_revenue wurde zu estimated_partner_ad_sense_revenue geändert. Dieser Messwert erscheint jedoch nur in zwei Berichten, die mit diesem Update eingestellt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen der Berichte in estimated_partner_ad_auction_revenue umbenannt.
      • Der Name des Messwerts estimated_partner_doubleclick_revenue wurde zu estimated_partner_double_click_revenue geändert. Dieser Messwert erscheint nur in zwei Berichten, die mit diesem Update eingestellt werden. Wie oben beschrieben wurde dieser Messwert in neueren Versionen der Berichte in estimated_partner_ad_reserved_revenue umbenannt.

    • Die Dokumentation zu Dimensionen für die Reporting API wurde aktualisiert. Die Properties elapsed_video_time_percentage und audience_retention_type werden jetzt nicht mehr aufgeführt. Diese Dimensionen werden derzeit in keinen Berichten unterstützt, die über die API verfügbar sind.

    19. Mai 2016

    Diese Aktualisierung umfasst die folgenden Änderungen an der YouTube Reporting API:

    • Die API unterstützt eine neue Version des Berichts zur Nutzeraktivität für Rechteinhaber. Die Berichtstyp-ID für den neuen Bericht lautet content_owner_basic_a2. Im Gegensatz zur vorherigen Version des Berichts, content_owner_basic_a1, unterstützt die neue Version die Messwerte likes und dislikes.

      Auch wenn Sie bereits einen Job zum Erstellen des Berichts content_owner_basic_a1 haben, müssen Sie einen neuen Job für den Bericht content_owner_basic_a2 erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion und erstellt auch nicht automatisch einen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen kann das Aussehen eines neuen, unerwarteten Jobs zu einer funktionsgefährdenden Änderung führen.

      Im Zusammenhang mit der Veröffentlichung des neuen Berichts wurde der content_owner_basic_a1-Bericht eingestellt. Wenn Sie über einen Job für diesen Bericht verfügen, sollten Sie nicht davon ausgehen, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job generiert. Die generierten Berichte sind ab dem Zeitpunkt ihrer Erstellung 180 Tage lang verfügbar.

    • Die Ressourcen reportType, job und report unterstützen alle eine neue Property, die angibt, ob es sich bei der zugehörigen Ressource um einen eingestellten Berichtstyp handelt:

      • Die Eigenschaft deprecateTime der Ressource reportType gibt an, mit welchem Datum und zu welcher Uhrzeit der Berichtstyp eingestellt wird. Diese Property hat nur einen Wert für Berichte, die als eingestellt bekannt gegeben wurden, und der Wert gibt das Datum an, ab dem YouTube keine Berichte dieses Typs mehr erstellt.

        Nachdem ein Berichtstyp als eingestellt angekündigt wird, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. Mit dieser Aktualisierung am 19. Mai 2016 wird beispielsweise die Einstellung des Berichts content_owner_basic_a1 angekündigt. Daher gibt deprecateTime für diesen Berichtstyp den 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr erstellt.

      • Das Attribut expireTime der Ressource job gibt mit Datum und Uhrzeit an, wann der Job abgelaufen ist oder abläuft. Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp veraltet ist oder wenn für den Job generierte Berichte über einen längeren Zeitraum nicht heruntergeladen wurden. Das Datum gibt den Zeitpunkt an, nach dem YouTube keine neuen Berichte für den Job mehr erstellt.

      • Die jobExpireTime-Property der report-Ressource gibt mit Datum und Uhrzeit an, wann der mit dem Bericht verknüpfte Job entweder abgelaufen ist oder abläuft. Diese Eigenschaft enthält denselben Wert wie das Attribut expireTime in der Ressource job, wie im vorherigen Element in dieser Liste beschrieben.

    • Die Methode jobs.create gibt jetzt einen 400-HTTP-Antwortcode (Bad Request) zurück, wenn Sie versuchen, einen Job für einen verworfenen Bericht zu erstellen. Darüber hinaus werden in der Dokumentation der Methode jetzt mehrere weitere Gründe aufgelistet, die zum Scheitern einer API-Anfrage führen.

    12. April 2016

    Diese Aktualisierung umfasst die folgenden Änderungen, die alle nur die YouTube Reporting API betreffen:

    • YouTube generiert jetzt Daten für die 180 Tage vor der Planung eines Berichterstellungsjobs. Bisher wurden über die Reporting API keine Verlaufsdaten ausgegeben. Diese Änderung betrifft alle Jobs, auch diejenigen, die vor dieser Ankündigung erstellt wurden.

      Berichte zu bisherigen Daten werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle historischen Daten für einen Job veröffentlicht wurden. Sie haben also einen Monat nach der Planung eines Berichterstellungsjobs Zugriff auf Daten von etwa sieben Monaten. (Alle Verlaufsdaten für Jobs, die vor dieser Ankündigung erstellt wurden, sollten innerhalb eines Monats nach der Ankündigung veröffentlicht werden.)

      Verlaufsdaten stehen erst seit dem 1. Juli 2015 zur Verfügung. Daher weisen Stellen, die vor dem 28. Dezember 2015 geschaffen wurden, Verlaufsdaten von weniger als 180 Tagen auf.

      Alle diese Änderungen werden im neuen Abschnitt Verlaufsdaten in der Übersicht über die Reporting API erläutert.

    • Im Abschnitt Berichteigenschaften der Übersicht über die YouTube Reporting API wurden folgende Änderungen vorgenommen:

      • Aus der Dokumentation geht jetzt hervor, dass Berichte 180 Tage nach ihrer Erstellung für API-Clients zum Download verfügbar sind. Zuvor stand in der Dokumentation bis zu sechs Monate vor dem Datum, an dem die API-Anfrage gesendet wurde, Berichte zur Verfügung.

      • Die Dokumentation wurde aktualisiert, um die Tatsache zu berücksichtigen, dass die API jetzt herunterladbare Berichte für Tage generiert, an denen keine Daten verfügbar waren. Diese Berichte enthalten zwar Kopfzeilen, jedoch keine zusätzlichen Daten.

    • Die YouTube Reporting API unterstützt demnächst eine Reihe automatisch erstellter, systemverwalteter Berichte, die Daten zu Werbeeinnahmen oder YouTube Red-Aboeinnahmen enthalten. Rechteinhaber, die in YouTube Creator Studio bereits auf manuell herunterladbare Umsatzberichte zugreifen können, stehen die Berichte zur Verfügung. Die neue API-Funktion bietet also programmatischen Zugriff auf diese Daten.

      Als Vorbereitung auf die Einführung der systemverwalteten Berichte werden die folgenden API-Änderungen angekündigt:

      • Die neue systemManaged-Property der job-Ressource gibt an, ob die Ressource einen Job beschreibt, der systemverwaltete Berichte generiert. YouTube erstellt automatisch vom System verwaltete Berichte für YouTube-Rechteinhaber. Rechteinhaber können Jobs, die diese Berichte erstellen, nicht ändern oder löschen.

      • Der neue includeSystemManaged-Parameter der Methode jobs.list gibt an, ob die API-Antwort Jobs für systemverwaltete Berichte enthalten soll. Der Standardwert des Parameters ist false.

      • Der neue startTimeAtOrAfter-Parameter der Methode jobs.reports.list gibt an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht dem angegebenen Datum entsprechen oder danach liegen. Ebenso gibt der Parameter startTimeBefore an, dass die API-Antwort nur Berichte enthalten soll, wenn die frühesten Daten im Bericht vor dem angegebenen Datum liegen.

        Im Gegensatz zum Parameter createdAfter der Methode, der sich auf den Erstellungszeitpunkt des Berichts bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht.

      • Die neue systemManaged-Property der reportType-Ressource gibt an, ob die Ressource einen vom System verwalteten Bericht beschreibt.

      • Der neue includeSystemManaged-Parameter der Methode reportTypes.list gibt an, ob die API-Antwort vom System verwaltete Berichte enthalten soll. Der Standardwert des Parameters ist false.

    28. März 2016

    Das YouTube Reporting API und das YouTube Analytics API geben jetzt Statistiken zu Aufrufen für verschiedene zusätzliche Dienste zum Teilen von Inhalten zurück.

    • In der YouTube Reporting API werden für die Dimension sharing_service die folgenden neuen Werte unterstützt:
      • 82: Dialogfeld zur iOS-Systemaktivität
      • 83: Google-Posteingang
      • 84: Android Messenger
    • In der YouTube Analytics API werden für die Dimension sharingService die folgenden neuen Werte unterstützt:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google-Posteingang
      • IOS_SYSTEM_ACTIVITY_DIALOG: Dialogfeld zur iOS-Systemaktivität

    16. März 2016

    Diese Aktualisierung umfasst die folgenden Änderungen, die sowohl die YouTube Reporting API als auch die YouTube Analytics API betreffen:

    YouTube Reporting API

    • Die Dimension playback_location_type unterstützt zwei neue Dimensionswerte:
      • 7: Die Daten beziehen sich auf Aufrufe auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder mit einer anderen YouTube-Suchfunktion.
      • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
    • Die Dimension „traffic_source_type“ unterstützt jetzt „18“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp 14. Dieser gibt an, dass die Aufrufe erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde.

    YouTube Analytics API

    • Die Dimension insightPlaybackLocationType unterstützt zwei neue Dimensionswerte:
      • BROWSE: Die Daten beziehen sich auf Aufrufe auf der Startseite oder dem Startbildschirm von YouTube, im Abofeed des Nutzers oder mit einer anderen YouTube-Suchfunktion.
      • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite erfolgten.
    • Die Dimension „insightTrafficSourceType“ unterstützt jetzt „YT_PLAYLIST_PAGE“ als Dimensionswert. Dieser Wert gibt an, dass die Videoaufrufe von einer Seite stammen, auf der alle Videos einer Playlist aufgeführt sind. Diese Quelle unterscheidet sich vom Quelltyp PLAYLIST. Dieser gibt an, dass die Aufrufe erfolgt sind, während das Video als Teil einer Playlist wiedergegeben wurde.

    8. Februar 2016

    Die Liste der unterstützten Messwerte für die YouTube Analytics API wurde aktualisiert. Infokartenmesswerte werden jetzt nicht mehr als unterstützte Messwerte für diese API aufgeführt. (Keiner der Berichte dieser API wurde dokumentiert, dass er einen der Kartenmesswerte unterstützt.)

    Du kannst Infokartenmesswerte weiterhin über die YouTube Reporting API abrufen, die diese Messwerte für zahlreiche Berichte zu Kanälen und Rechteinhabern unterstützt.

    6. Januar 2016

    Sowohl die YouTube Reporting API als auch die YouTube Analytics API identifizieren jetzt speziell Aufrufe, die über Chromecast erfolgen.

    • In der YouTube Reporting API wird für die Dimension „operating_system“ der Wert „21“ verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen.
    • In der YouTube Analytics API wird für die Dimension operatingSystem der Wert CHROMECAST verwendet, um Aufrufe zu identifizieren, die über Chromecast erfolgen.

    21. Dezember 2015

    In der Dokumentation wurden die Namen der Messwerte annotation_clickable_impressions und annotation_closable_impressions aktualisiert, damit sie mit den Namen übereinstimmen, die in den Berichten zurückgegeben werden. Bisher wurden die Namen als clickable_annotation_impressions und closable_annotation_impressions dokumentiert.

    18. Dezember 2015

    Gemäß den Gesetzen der Europäischen Union (EU) müssen Endnutzern in der EU bestimmte Informationen offengelegt und Einwilligungen dieser Endnutzer eingeholt werden. Endnutzer in der Europäischen Union müssen daher die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben einen Hinweis auf diese Anforderung in unseren Nutzungsbedingungen für die YouTube API hinzugefügt.

    15. Dezember 2015

    Diese Aktualisierung umfasst die folgenden Änderungen, die alle die YouTube Analytics API betreffen:

    • Die YouTube Analytics API unterstützt jetzt drei neue Dimensionen für Wiedergabedetails, die in verschiedenen Berichten zu Kanälen und Rechteinhabern verwendet werden können:

      • liveOrOnDemand: Diese Dimension gibt an, ob die Daten im Bericht Nutzeraktivitäten während einer Liveübertragung beschreiben.
      • subscribedStatus: Diese Dimension gibt an, ob die Messwerte zur Nutzeraktivität in den Daten mit Zuschauern verknüpft sind, die den Kanal des Videos oder der Playlist abonniert haben.
      • youtubeProduct: Diese Dimension gibt die YouTube-Property an, auf der die Nutzeraktivität stattgefunden hat. Mögliche Werte sind die YouTube-Website (oder YouTube App), YouTube Gaming und YouTube Kids.

      Die Dokumentation wurde aktualisiert und enthält jetzt neue Berichte zu Wiedergabedetails, die für Kanäle und Rechteinhaber zur Verfügung stehen. Außerdem wurden viele weitere Berichte aktualisiert. Sie können jetzt optional eine oder mehrere dieser Dimensionen als Dimensionen und/oder Filter in diesen Berichten verwenden.

    • Das Format der Tabellen, in denen die Berichte erklärt werden, wurde geändert, damit Sie gültige Kombinationen aus Dimensionen, Messwerten und Filtern einfacher ermitteln können, mit denen die einzelnen Berichte abgerufen werden können. In der folgenden Tabelle wird das neue Format für den Bericht „Gerätetyp“ für Channels erläutert:

      Inhalt
      Abmessungen:
      Erforderlich deviceType
      0 oder mehr verwenden day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Messwerte:
      Mindestens 1 verwenden Aufrufe, estimatedMinutesWatched
      Filter:
      „0“ oder „1“ verwenden Land, Provinz, Kontinent, subContinent
      „0“ oder „1“ verwenden Video, Gruppe
      0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Die Terminologie, die erforderliche und optionale Felder beschreibt, wird in der Dokumentation zu Berichten zu Kanälen und Rechteinhabern erläutert.

    • Die YouTube Analytics API löscht jetzt automatisch Entitäten, für die der API-Nutzer keine Daten aus Filtern abrufen kann, die mehrere Werte unterstützen (video, playlist und channel). Bisher hat der API-Server nur einen Fehler zurückgegeben, wenn der API-Nutzer für mindestens eines der angegebenen Elemente nicht auf die Daten zugreifen konnte.

      Angenommen, ein Nutzer sendet eine API-Anfrage, in der der Filter video 20 Video-IDs auflistet. Der Nutzer ist Eigentümer von 18 dieser Videos. Eine Video-ID identifiziert jedoch ein Video, das einem anderen Kanal gehört, während eine andere ID ein Video identifiziert, das gelöscht wurde und daher nicht mehr existiert. In diesem Fall gibt der API-Server jetzt nicht mehr einen Fehler zurück, sondern löscht jetzt die beiden Videos, auf die der Nutzer nicht zugreifen kann. Die API-Antwort enthält dann Daten für die 18 Videos, die dem API-Nutzer gehören.

    • Wenn du Daten für einen leeren YouTube Analytics-group anforderst, gibt die API jetzt einen leeren Datensatz anstelle eines Fehlers zurück.

    • Die groupItems.insert-Methode der YouTube Analytics API gibt jetzt einen nicht autorisierten Fehler (403-HTTP-Antwortcode) zurück, wenn du versuchst, einer Gruppe eine Entität hinzuzufügen, aber keinen Zugriff auf diese Entität hast. Bisher war es über die API möglich, die Entität der Gruppe hinzuzufügen. Später wurde jedoch ein nicht autorisierter Fehler zurückgegeben, als Sie versucht haben, Berichtsdaten für diese Gruppe abzurufen.

    • Die groups.list-Methode der YouTube Analytics API unterstützt jetzt die Paginierung. Wenn die API-Antwort nicht alle verfügbaren Gruppen enthält, gibt der Parameter nextPageToken der Antwort ein Token an, mit dem die nächste Ergebnisseite abgerufen werden kann. Setzen Sie den Parameter pageToken der Methode auf diesen Wert, um zusätzliche Ergebnisse abzurufen.

    10. November 2015

    Dieses Update enthält die folgenden Änderungen:

    29. Oktober 2015

    Dieses Update enthält die folgenden Änderungen:

    • In der Dokumentation für die Dimension „date“ der YouTube Reporting API wurde korrigiert, dass sie sich auf den 24-Stunden-Zeitraum ab 00:00 Uhr Pacific Time (UTC-8) bezieht. Zuvor wurde in der Dokumentation angegeben, dass das Datum um 00:00 Uhr (GMT) begann.

      Außerdem wurde die Dokumentation zur YouTube Analytics API aktualisiert. Alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) beziehen sich nun auf Datumsangaben, die um 00:00 Uhr Pacific Time (UTC-8) beginnen.

    • Die jobs.reports.list()-Methode der YouTube Reporting API unterstützt jetzt den Abfrageparameter createdAfter. Wenn dieser Parameter angegeben ist, gibt er an, dass in der API-Antwort nur Berichte aufgeführt werden sollen, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit Daten-Backfill. Der Parameterwert bezieht sich auf den Erstellungszeitpunkt des Berichts und nicht auf das Datum, das den zurückgegebenen Daten zugeordnet ist.

      Der Parameterwert ist ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Mikrosekunden. Beispiel: "2015-10-02T15:01:23.045678Z".

      Die Best Practices für die YouTube Reporting API wurden ebenfalls aktualisiert. Darin wird erklärt, wie du mit dem createdAfter-Parameter die wiederholte Verarbeitung desselben Berichts vermeiden kannst.

    • Die Definitionen der Attribute createTime der Ressource job und der Eigenschaften startTime, endTime und createTime der Ressource report wurden korrigiert, um zu gewährleisten, dass die Eigenschaftswerte auf Mikrosekunden und nicht auf Nanosekunden genau sind. Außerdem spiegeln alle Definitionen nun korrekt wider, dass der Attributwert ein Zeitstempel ist.

    8. Oktober 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumentation für die Dimension „sharingService“ der YouTube Analytics API wurde aktualisiert und um eine Liste möglicher Dimensionswerte ergänzt. Die Liste enthält eine Reihe neuer unterstützter Dienste.

      Die Definition der Dimension „sharing_service“ der YouTube Reporting API wurde ebenfalls aktualisiert, um die neu unterstützten Werte aufzulisten. Die enum-Werte, die größer als 59 sind, sind die neuen Werte in der Liste.

    24. September 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die neue YouTube Reporting API ruft Bulk-Datenberichte ab, die YouTube Analytics-Daten für einen Kanal oder einen Rechteinhaber enthalten. Es wurde für Anwendungen entwickelt, die große Datasets importieren und Tools zum Filtern, Sortieren und Mining dieser Daten bereitstellen können.

      Jeder Bericht der YouTube Reporting API enthält vordefinierte Dimensionen und Messwerte. Für YouTube Analytics API-Berichte werden auch Messwerte und Dimensionen verwendet. In einem Bericht enthält jede Datenzeile eine eindeutige Kombination von Dimensionswerten. Sie können Daten zeilenübergreifend auf der Grundlage von Dimensionswerten aggregieren, um Messwerte für einzelne Videos, Länder, Livevideos, abonnierte Nutzer usw. zu berechnen.

      Mit der API kannst du Berichterstellungsjobs planen, von denen jeder einen Bericht identifiziert, der von YouTube generiert werden soll. Sobald Sie einen Job eingerichtet haben, erstellt YouTube täglich einen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen einzelnen 24-Stunden-Zeitraum.

    • Es handelt sich zwar um unterschiedliche APIs, aber mit der YouTube Analytics API und der YouTube Reporting API können Entwickler YouTube Analytics-Daten abrufen. Da die beiden APIs Zugriff auf ähnliche Datensätze ermöglichen, wird die Dokumentation für die beiden APIs als ein einziger Dokumentationssatz veröffentlicht.

      • Der Tab Leitfäden in der Dokumentation enthält allgemeine Informationen zu beiden APIs, einschließlich einer Anleitung zum Autorisieren von API-Anfragen.
      • Der Tab Bulk-Berichte enthält Referenzdokumentation und weitere Inhalte speziell für die YouTube Reporting API.
      • Der Tab Gezielte Suchanfragen enthält Referenzdokumentation und weitere Inhalte speziell für die YouTube Analytics API.
      • Auf dem Tab Beispiele finden Sie Codebeispiele, die für jede der beiden APIs verfügbar sind.
      • Auf dem Tab Tools finden Sie zusätzliche Ressourcen, die Entwicklern bei der Implementierung einer der beiden APIs helfen können.

    20. August 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API-Dokumentation wurde neu strukturiert, um die API leichter verständlich zu machen. Daher beziehen sich diese Änderungen nicht auf neue Funktionen:

      • Die Dokumentation enthält jetzt eine Seite mit allen verfügbaren Kanalberichten und eine weitere Seite mit allen verfügbaren Berichten von Rechteinhabern. Bisher enthielt die Dokumentation separate Seiten für Berichte zu Kanalvideos und zu Kanalplaylists.

      • Die neue Datenmodellübersicht bietet eine klarere Einführung in die Funktionsweise der API. In diesem Dokument wird insbesondere erläutert, wie YouTube Messwerte, Dimensionen und Filter zur Berechnung von Berichtwerten verwendet.

      • Die Methode reports.query der API, die Sie zum Abrufen von Berichten verwenden, ist jetzt separat dokumentiert. Die Informationen auf dieser Seite befanden sich zuvor auf einigen anderen Seiten. Auf der neuen Seite können Sie leichter erkennen, welche Informationen Sie zum Abrufen eines Berichts senden müssen.

    22. Juli 2015

    Diese Aktualisierung umfasst mehrere Änderungen, die alle nur für Rechteinhaber gelten:

    • Der neue Messwert adEarnings enthält die geschätzten Gesamteinnahmen (Nettoumsatz) aus allen von Google verkauften Werbequellen. Er ist kein zentraler Messwert. Die API unterstützt den Messwert adEarnings für alle Berichte, die den Messwert earnings bereits unterstützt haben.

      Außerdem wurde die Definition des Messwerts earnings korrigiert, da er nun die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen sowie aus nicht werbebezogenen Quellen enthält. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Werbequellen umfasste.

    • Der Messwert „primaryAdGrossRevenue“ wurde eingestellt. Verwende stattdessen den Messwert „grossRevenue“, um Umsatzdaten abzurufen.

    • Zusätzlich zum eingestellten Messwert primaryAdGrossRevenue werden in Berichten zur Anzeigenleistung die Messwerte monetizedPlaybacks und playbackBasedCpm nicht mehr unterstützt. In mehreren Videoberichten werden diese Messwerte jedoch weiterhin unterstützt.

    1. Juni 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt zwei neue Messwerte für Videoberichte: videosAddedToPlaylists und videosRemovedFromPlaylists. Die Listen der Videoberichte für Kanäle und Rechteinhaber wurden aktualisiert, um zu ermitteln, welche Berichte die neuen Messwerte unterstützen.

      • videosAddedToPlaylists: Gibt an, wie oft Videos im Gültigkeitsbereich der Anfrage YouTube-Playlists hinzugefügt wurden. Die Videos können der Playlist des Videoinhabers oder den Playlists anderer Kanäle hinzugefügt werden.
      • videosRemovedFromPlaylists: Gibt an, wie oft Videos, die in der Suchanfrage enthalten waren, aus YouTube-Playlists entfernt wurden. Möglicherweise wurden die Videos aus der Playlist des Videoinhabers oder aus den Playlists anderer Kanäle entfernt.

      Beide Messwerte umfassen Standardplaylists wie die Playlist „Später ansehen“. Dabei werden jedoch keine Playlists berücksichtigt, denen ein Video automatisch hinzugefügt wird. Das gilt zum Beispiel für die Playlist „Uploads“ eines Kanals oder den Wiedergabeverlauf eines Nutzers. Beachten Sie auch, dass diese Messwerte die absolute Anzahl der Hinzufügungen und Löschungen widerspiegeln. Wenn also ein Nutzer ein Video zu einer Playlist hinzufügt, es dann entfernt und anschließend wieder hinzufügt, zeigen die Messwerte an, dass das Video zu zwei Playlists hinzugefügt und aus einer entfernt wurde.

      Daten für diese Messwerte stehen seit dem 1. Oktober 2014 zur Verfügung.

    31. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die Messwerte favoritesAdded und favoritesRemoved werden ab dieser Ankündigung nicht mehr unterstützt. Beides sind Kernmesswerte und unterliegen der in den Nutzungsbedingungen festgelegten Richtlinie zur Einstellung von Produkten und Diensten.

    16. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit dem neuen Parameter currency können Sie Messwerte zu Einnahmen in einer anderen Währung als US-Dollar (USD) abrufen. Wenn der Parameter festgelegt ist, wandelt die API die Werte für die Messwerte earnings, grossRevenue, playbackBasedCpm und impressionBasedCpm in die angegebene Währung um. Die zurückgegebenen Werte sind Schätzungen, die anhand von Wechselkursen berechnet wurden, die sich täglich ändern.

      Der Parameterwert ist ein dreistelliger Währungscode gemäß ISO 4217. Der Standardwert ist USD. Die Parameterdefinition enthält eine Liste der unterstützten Währungscodes.

    25. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit der API können jetzt YouTube Analytics-Gruppen erstellt und verwaltet sowie Berichtsdaten für diese Gruppen abgerufen werden.

      • Gruppen erstellen und verwalten

        Dieses Update enthält die Ressourcen group und groupItem zum Erstellen und Verwalten von Gruppen.

        • Die Ressource group steht für eine Analytics-Gruppe, eine benutzerdefinierte Sammlung von bis zu 200 Kanälen, Videos, Playlists oder Assets. Die API unterstützt die Methoden list, insert, update und delete für diese Ressource.
        • Die Ressource groupItem steht für ein Element in einer Analytics-Gruppe. Die API unterstützt die Methoden list, insert und delete für diese Ressource.

        Sie können also beispielsweise eine Gruppe mit der Methode groups.insert erstellen und dieser Gruppe dann mit der Methode groupItems.insert Elemente hinzufügen.

      • Berichtsdaten für eine Gruppe abrufen

        Die Dokumentation zu Dimensionen wurde aktualisiert und um die Dimension group ergänzt, die als Filter für viele Channelberichte und Berichte zu Rechteinhabern verwendet werden kann. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Mit der API können derzeit keine Berichte für Asset-Gruppen erstellt werden.

      Weitere Informationen zu Gruppen in YouTube Analytics findest du in der YouTube-Hilfe.

    13. Februar 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt die Dimension show nicht mehr.

    28. August 2014

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt die Möglichkeit, mehrere Werte für die Dimensionen video, playlist, channel und show anzugeben, wenn diese Dimensionen als Filter verwendet werden. Wenn du mehrere Werte angeben möchtest, setze den Wert des Parameters filters auf eine durch Kommas getrennte Liste der Video-, Playlist-, Kanal- oder Sendungs-IDs, für die die API-Antwort gefiltert werden soll. Für den Parameterwert können bis zu 200 IDs angegeben werden.

      Wenn Sie mehrere Werte für denselben Filter angeben, können Sie diesen Filter auch in die Liste der Dimensionen aufnehmen, die Sie für die Anfrage angeben. Das gilt auch dann, wenn der Filter für einen bestimmten Bericht nicht als unterstützte Dimension aufgeführt ist. Wenn Sie den Filter der Liste der Dimensionen hinzufügen, verwendet die API die Filterwerte auch zur Gruppierung der Ergebnisse.

      Ausführliche Informationen zu dieser Funktion finden Sie in der Parameterdefinition filters.

    16. Juli 2014

    Dieses Update enthält die folgenden Änderungen:

    • Beim Abrufen eines Channelberichts kannst du jetzt Daten für den Kanal des authentifizierten Nutzers abrufen, indem du den Wert des Parameters ids auf channel==MINE setzt. Sie können den Parameter ids auch weiterhin auf channel==CHANNEL_ID setzen, um Daten für den angegebenen Kanal abzurufen.

    • Die API unterstützt jetzt Playlist-Berichte, die Statistiken zu Videoaufrufen im Kontext einer Playlist enthalten. Playlist-Berichte sind für Kanäle und Rechteinhaber verfügbar.

      Alle Playlist-Berichte unterstützen die Messwerte views und estimatedMinutesWatched, einige auch den Messwert averageViewDuration.

      Außerdem unterstützen alle Playlist-Berichte die folgenden neuen Messwerte. Jeder dieser Messwerte bezieht sich nur auf Playlist-Aufrufe im Web.

      • playlistStarts: Gibt an, wie oft die Wiedergabe einer Playlist durch Zuschauer gestartet wurde.
      • viewsPerPlaylistStart: Die durchschnittliche Anzahl an Videoaufrufen, die nach dem Start einer Playlist stattfanden.
      • averageTimeInPlaylist: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer sich Videos in einer Playlist angesehen hat, nachdem die Playlist gestartet wurde.

      Alle Anfragen zum Abrufen eines Playlist-Berichts müssen den Filter isCurated verwenden, der auf 1 (isCurated==1) festgelegt sein muss.

    • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird gemessen, wie gut ein Video sein Publikum binden kann. Mit der neuen Dimension „elapsedVideoTimeRatio“ des Berichts wird die Zeit gemessen, die im Video für die entsprechenden Messwerte verstrichen ist:

      • Der Messwert audienceWatchRatio gibt das absolute Verhältnis der Zuschauer an, die sich das Video an einer bestimmten Stelle im Video ansehen. Das Verhältnis wird berechnet, indem die Häufigkeit, mit der ein Teil eines Videos angesehen wurde, mit der Gesamtzahl der Aufrufe des Videos verglichen wird.

        Beachte, dass ein Teil eines Videos pro Videoaufruf mehrmals oder gar nicht angesehen werden kann. Wenn Nutzer beispielsweise ein Video mehrmals zurückspulen und denselben Teil eines Videos ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als 1 sein.

      • Der Messwert relativeRetentionPerformance gibt an, wie gut die Zuschauerbindung während der Wiedergabe eines Videos im Vergleich zu allen YouTube-Videos ähnlicher Länge ist. Ein Wert von 0 bedeutet, dass die Nutzerbindung über das Video schlechter als jedes andere Video ähnlicher Länge ist. Ein Wert von 1 bedeutet, dass die Nutzer mit dem Video eine bessere Bindung haben als jedes andere Video ähnlicher Länge. Ein Medianwert von 0,5 gibt an, dass die Hälfte der Videos ähnlicher Länge die Zuschauer besser anspricht, während die andere Hälfte die Zuschauer schlechter hält.

      Sie können auch den audienceType-Filter verwenden, damit der Bericht nur Daten zurückgibt, die mit organischen Aufrufen, Aufrufen über TrueView In-Stream-Anzeigen oder über TrueView In-Display-Anzeigen verknüpft sind. (Organische Aufrufe sind das direkte Ergebnis einer Nutzeraktion, z. B. einer Suche nach einem Video oder einem Klick auf ein vorgeschlagenes Video.)

    • Die API unterstützt mehrere neue Messwerte im Zusammenhang mit Annotationen. Die unten aufgeführten Messwerte können mit allen Berichten abgerufen werden, in denen zuvor die Messwerte annotationClickThroughRate und annotationCloseRate unterstützt wurden.

      Alle neuen Messwerte sind Kernmesswerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Daten für die neuen Messwerte sind jedoch ab dem 16. Juli 2013 verfügbar. (Daten zu den Messwerten annotationClickThroughRate und annotationCloseRate stehen seit dem 10. Juni 2012 zur Verfügung.)

    • GOOGLE_SEARCH“ wird nicht mehr als separater Wert für die Dimension „insightTrafficSourceType“ erfasst. Verweise aus Google-Suchergebnissen werden jetzt stattdessen dem Besucherquellentyp „EXT_URL“ zugeordnet. Daher ist es nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, bei dem der insightTrafficSourceType-Filter auf GOOGLE_SEARCH gesetzt ist.

    31. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    16. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Das Dokument zu Beispielanfragen wurde umgestaltet, sodass Beispiele in Kategorien gruppiert werden. Dabei wird ein Tab-Format verwendet, das dem vor Kurzem für Kanal- und Rechteinhaberberichte veröffentlichten Format ähnelt. Mit dem neuen Design werden die Beispiele in die folgenden Kategorien gruppiert:

      • Grundlegende Statistiken
      • Zeitbasiert
      • Zielregion
      • Wiedergabeort
      • Zugriffsquelle
      • Gerät/Betriebssystem
      • Demografische Gruppe
      • Sozial
      • Einnahmen/Anzeigen (nur für Rechteinhaber-Berichte)

    • Das Dokument zu Beispielanfragen enthält jetzt neue Beispiele für das Abrufen von Daten zu Provinzen in Kanalberichten oder Berichten zu Rechteinhabern.

      • Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.: Mit diesem Bericht wird eine Aufschlüsselung der Aufrufzahlen nach Provinz nach Provinz sowie andere Statistiken zu den Videos eines Kanals abgerufen. Die Daten beziehen sich auf US-Bundesstaaten und Washington D.C. Im Beispiel werden die Dimension province und der Parameter filters verwendet, um die Antwort auf Ergebnisse für die USA einzuschränken.

      • 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 Videos eines Kanals angesehen haben. In Berichten von Rechteinhabern werden außerdem Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern abgerufen, auf die Anspruch erhoben wurde. In diesem Beispiel wird der Parameter filters verwendet, damit die Antwort nur Daten für eine bestimmte Provinz enthält.

    • Die Definition der Dimension „province“ wurde aktualisiert: Wenn „province“ im Parameterwert dimensions enthalten ist, müssen die Daten in der Anfrage auch auf die USA beschränkt werden. Dazu wird country==US in den Parameterwert filters aufgenommen.

    6. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumente, in denen die unterstützten Berichte zu Kanälen und Rechteinhabern aufgeführt sind, wurden neu gestaltet. Anstatt eine Tabelle bereitzustellen, in der alle möglichen Berichte aufgelistet sind, werden die Berichte in jedem Dokument in Kategorien gruppiert:

      • Grundlegende Statistiken
      • Zeitbasiert
      • Zielregion
      • Wiedergabeort
      • Zugriffsquelle
      • Gerät/Betriebssystem
      • Demografische Gruppe
      • Sozial
      • Top-Videos

      In jedem Dokument werden diese Kategorien als Liste von Tabs angezeigt. Klicken Sie auf einen beliebigen Tab, um die unterstützten Berichte in dieser Kategorie zu sehen.

    • Die API unterstützt jetzt drei neue geografische Dimensionen: province, continent und subContinent.

      • Mit der Dimension province können Sie Statistiken für US-Bundesstaaten und für den Distrikt Kolumbien abrufen. Die API unterstützt zwei Verwendungsmöglichkeiten für diese Dimension:

        • Das API unterstützt zwei Berichte, in denen Statistiken für die einzelnen Bundesstaaten aufgeführt werden. Beide Berichte sind für Kanäle und Rechteinhaber verfügbar.

          • Der grundlegende Statistikbericht enthält verschiedene Statistiken, darunter die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
          • Der zeitbasierte Bericht stellt die gleichen Statistiken bereit, fasst die Daten jedoch täglich, 7 Tage, 30 Tage oder monatlich zusammen.

        • Mit dem Abfrageparameter filters können Sie festlegen, dass ein Bericht nur Statistiken für einen bestimmten Status enthält. Diese Art der Filterung wird in mehreren Berichten unterstützt, darunter Berichte nach Standort, Wiedergabeorten, Berichte zu Zugriffsquellen, Geräteberichte, Berichte zu Betriebssystem, Berichte zur Leistung nach demografischen Merkmalen und Berichte zu Top-Videos.

      • Die Dimension continent gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der einen Kontinent identifiziert. Diese Dimension kann nur als Filter verwendet werden.

      • Die Dimension subContinent gibt einen statistischen Regionscode der Vereinten Nationen (UN) an, der eine Subregion eines Kontinents angibt. Diese Dimension kann auch nur als Filter verwendet werden.

        Da jede Subregion nur einem Kontinent zugeordnet ist, ist es nicht erforderlich, auch den Filter continent zu verwenden, wenn Sie den Filter subContinent verwenden. Die API gibt einen Fehler zurück, wenn in einer Anfrage beide Dimensionen verwendet werden.

    • Die Dokumentation wurde korrigiert und die Dimension „insightTrafficSourceDetail“ enthält nun den insightTrafficSourceType-Wert PROMOTED nicht mehr als gültigen Filterwert.

    30. September 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die YouTube Analytics API unterliegt jetzt der Richtlinie zur Einstellung von Produkten und Diensten, wie in den Nutzungsbedingungen beschrieben. Die nicht auf Kernfunktionen bezogenen Dimensionen und Messwerte der API unterliegen jedoch nicht der Richtlinie zur Einstellung von Produkten und Diensten. Auf den Seiten Dimensionen und metrics werden nun die wichtigsten Dimensionen und Messwerte aufgeführt. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit zu identifizieren.

    • Die API unterstützt jetzt EXTERNAL_APP als Wert für die Dimension insightPlaybackLocationType. Im Zusammenhang mit diesem Update werden Wiedergaben seit dem 10. September 2013 nicht mehr als MOBILE-Wiedergaben kategorisiert. Wiedergaben auf Mobilgeräten, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin mit diesem Wert kategorisiert.

      Mit diesem Update werden mobile Wiedergaben jetzt je nach Art der App als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert.

    • Die API unterstützt jetzt PLAYLIST als Wert für die Dimension insightTrafficSourceType. Der Wert gibt an, dass Videoaufrufe über eine Playlist verwiesen wurden. Bisher wurden diese Aufrufe mit der Kategorie YT_OTHER_PAGE der Dimension klassifiziert.

    16. Juli 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt die Möglichkeit, Berichte nach mehreren Dimensionen und Messwerten zu sortieren. Das Beispielanfragendokument enthält ein neues Beispiel, Anfragen nach mehreren Dimensionen/Messwerten sortieren, in dem diese Funktionalität veranschaulicht wird. Die Anfrage ruft Besucherquellendaten ab und hat für den sort-Parameterwert day,-views. Die Ergebnisse werden chronologisch sortiert, aber innerhalb der Ergebnismenge für jeden Tag enthält die erste Zeile Daten für die Besucherquelle, die die meisten Aufrufe generiert hat, die zweite Zeile die Daten für die Quelle, die die nächsthöhere Anzahl an Aufrufen generiert hat usw.

    • Die API unterstützt jetzt zwei neue Dimensionen, deviceType und operatingSystem, mit denen Daten zu den Geräten abgerufen werden können, auf denen sich Zuschauer deine Videos ansehen. Die API unterstützt Berichte, in denen eine oder beide Dimensionen verwendet werden.

      • Im Bericht „deviceType“ findest du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen wie Computer, Smartphones und Tablets. Mit dem Filter „operatingSystem“ können Sie auch festlegen, dass der Bericht zu Gerätetypen nur Statistiken für Geräte mit einem bestimmten Betriebssystem enthält, z. B. Android oder iOS.

      • Im Bericht „operatingSystem“ findest du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS oder Linux. Mit dem Filter „deviceType“ können Sie den Betriebssystembericht so einschränken, dass er nur Statistiken für einen bestimmten Gerätetyp enthält, z. B. Mobilgeräte oder Tablets.

      Die neuen Berichte zu Gerätetyp und Betriebssystem sind für Kanäle und Rechteinhaber verfügbar.

    • Das Dokument zu Beispielanfragen wurde aktualisiert und enthält jetzt drei Geräteberichte für Kanäle und drei Geräteberichte für Rechteinhaber.

    • Für die Dimension „insightPlaybackLocationType“ kann der Wert YT_OTHER zurückgegeben werden. Damit werden Datenansichten angegeben, die nicht mit einem der anderen Werte der Dimension klassifiziert wurden.

    23. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das Dokument Berichte zu Rechteinhabern wurde aktualisiert. Jetzt kannst du den Bericht zu den erfolgreichsten Videos in absteigender Reihenfolge nach Einnahmen sortieren, um die Videos mit den höchsten Einnahmen zu ermitteln. Dieser Bericht ist der erste, der in der zweiten Tabelle im Bereich Berichte zu Nutzeraktivitäten und Einnahmen aufgeführt ist.

    10. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    6. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Mit der API können jetzt Messwerte zur Wiedergabezeit (estimatedMinutesWatched, averageViewDuration und averageViewPercentage) in Verbindung mit anderen Messwerten wie Aufruf-, Engagement-, Einnahme- und Anzeigenleistungsmesswerten abgerufen werden.

      Die Listen der verfügbaren Kanalberichte und Berichte zu Rechteinhabern wurden entsprechend aktualisiert. Die Listen sind jetzt kürzer, da die Messwerte zur Wiedergabezeit im Rahmen anderer aufgeführten Berichte abgerufen werden können.

      Das Dokument Beispiel für API-Anfragen wurde ebenfalls aktualisiert.

    • Die Berichte mit den Dimensionen insightPlaybackLocationDetail und insightTrafficSourceDetail wurden folgendermaßen optimiert:

      • Sie unterstützen jetzt den optionalen country-Filter.

      • Rechteinhaber können diese Berichte jetzt mit jeder der folgenden neuen filter-Kombinationen abrufen. Alle diese Kombinationen unterstützen auch den optionalen Filter country.

        • Details zum Wiedergabeort

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • Details zur Zugriffsquellen

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    3. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das neue Dokument Beispiel-API-Anfragen enthält Beispiele, die zeigen, wie viele verschiedene Berichtstypen mit dem YouTube Analytics API abgerufen werden können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der von der Anfrage abgerufen wird, und zeigt dann die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage an.

    • Für die Dimension „insightTrafficSourceType“ wird jetzt „SUBSCRIBER“ als gültiger Wert unterstützt. Dieser Wert ermittelt Videoaufrufe, die über Feeds auf der YouTube-Startseite oder über YouTube-Abofunktionen generiert wurden. Wenn Sie nach dieser Besucherquelle filtern, gibt das Feld insightTrafficSourceDetail den Startseitenfeed oder eine andere Seite an, von der die Aufrufe weitergeleitet wurden.

    28. März 2013

    Dieses Update enthält die folgenden Änderungen:

    21. März 2013

    Dieses Update enthält die folgenden Änderungen:

    • Die API unterstützt jetzt Messwerte zu Einnahmen und Anzeigenleistung sowie neue Berichte zur Anzeigenleistung. Die Messwerte und Berichte sind nur für YouTube-Contentpartner verfügbar, die am YouTube-Partnerprogramm teilnehmen.

      • Die neu unterstützten Berichte unterstützen wiedergabebasierte Messwerte zur Anzeigenleistung und impressionsbasierte Messwerte zur Anzeigenleistung. Weitere Informationen zu Berichten zur Anzeigenleistung findest du in der Dokumentation zu Berichten zu Rechteinhabern.

      • Die neuen unterstützten Messwerte sind unten aufgeführt. Die Liste der Berichte zu Rechteinhabern wurde aktualisiert und enthält jetzt die Berichte, die diese Messwerte unterstützen. Dazu gehören auch die beiden neuen Berichte.

        • earnings: Die geschätzten Gesamteinnahmen aus allen von Google verkauften Werbequellen.
        • grossRevenue: geschätzter Bruttoumsatz von Google oder DoubleClick-Partnern.
        • primaryAdGrossRevenue: Der geschätzte Bruttoumsatz von Google oder DoubleClick-Partnern, summiert und unter dem primären Anzeigentyp für die Videowiedergaben, die im Bericht behandelt werden, klassifiziert.
        • monetizedPlaybacks: Das ist die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression zu sehen war.
        • playbackBasedCpm: geschätzter Bruttoumsatz pro 1.000 Wiedergaben.
        • impressions: Dieser Wert gibt die Anzahl der erzielten verifizierten Anzeigenimpressionen an.
        • impressionBasedCpm: geschätzter Bruttoumsatz pro 1.000 Anzeigenimpressionen.

        Hinweis:Ausführliche Informationen finden Sie in den Definitionen der Messwerte.

      • Jede Anfrage zum Abrufen von Messwerten zu Einnahmen oder Anzeigenleistung muss ein Autorisierungstoken senden, das Zugriff mit dem neuen Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt.

    • Die API-Dokumentation wurde umstrukturiert, sodass verschiedene Berichtstypen auf separaten Seiten erläutert werden. Daher gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Berichten zu Rechteinhabern erläutert werden.

    4. Februar 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das API-Referenzhandbuch enthält nun einen Abschnitt Beispiele mit Codebeispielen, die zeigen, wie die API mithilfe der Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgerufen wird. Das JavaScript-Codebeispiel ist derselbe, der in der Dokumentation der Beispielanwendung ausführlich erläutert wird.

    14. November 2012

    Dieses Update enthält die folgenden Änderungen:

    • Das API-Referenzhandbuch enthält jetzt die APIs Explorer, mit der Sie die API aufrufen, die API-Anfrage ansehen und echte Daten aus der Antwort abrufen können.

    • Die API unterstützt eine Reihe neuer Berichte für Kanäle und Rechteinhaber, die im Folgenden beschrieben werden. Jeder Bericht ist als Kanalbericht oder Bericht zu Rechteinhabern verfügbar. Die Seiten Dimensionen und metrics wurden ebenfalls entsprechend aktualisiert.

      • Der Bericht zum Wiedergabeort gibt die Anzahl der Videoaufrufe an, die auf verschiedenen Arten von Seiten oder Apps stattgefunden haben.

      • Im Detailbericht zum Wiedergabeort werden die eingebetteten Player angegeben, die für ein bestimmtes Video die meisten Aufrufe generiert haben. Er bietet eine detailliertere Ansicht als der Bericht zu Wiedergabeorten, da die URLs der am häufigsten eingebetteten Player identifiziert werden.

      • Der Bericht zu Zugriffsquellen gibt die Anzahl der Videoaufrufe an, die über verschiedene Arten von Verweis-URLs generiert wurden.

      • Im Detailbericht zu Zugriffsquellen werden die Verweis-URLs aufgeführt, die für ein bestimmtes Video und einen bestimmten Zugriffsquellentyp die meisten Aufrufe generiert haben. In diesem Bericht kannst du beispielsweise die ähnlichen Videos sehen, über die die meisten Zugriffe auf ein bestimmtes Video erzielt wurden. Dieser Bericht wird für verschiedene Zugriffsquellen unterstützt.

      • Die Berichte zur Wiedergabezeit geben an, wie lange Zuschauer damit verbracht haben, deine Inhalte anzusehen. In den Berichten können Daten für einen bestimmten Zeitraum – Tag, letzte 7 Tage, vorherige 30 Tage usw. – oder ein Land zusammengefasst werden. Wenn in einem Bericht Daten nach Tag oder Land zusammengefasst werden, kann er auch die durchschnittliche Länge jedes Videoaufrufs sowie den durchschnittlichen Prozentsatz jedes Videos angeben, den die Nutzer angesehen haben.

    2. Oktober 2012

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt im Bereich Dienste in APIs console aktivieren, ohne vorher Zugriff anfordern zu müssen.

    • Im neuen Abschnitt Erste Schritte werden die Voraussetzungen und grundlegenden Schritte zum Erstellen einer Anwendung beschrieben, die das YouTube Analytics API verwendet.

    12. September 2012

    Dieses Update enthält die folgenden Änderungen:

    • Der neue Abschnitt Informationen zur Kontingentnutzung enthält Richtlinien zur Optimierung Ihrer API-Kontingentnutzung. Der API-Server berechnet für jede Anfrage die Abfragekosten, die von Ihrem API-Nutzungskontingent abgezogen werden. Da bei verschiedenen Berichtstypen unter Umständen stark unterschiedliche Abfragekosten anfallen, sollten Sie Ihr Kontingent effizient nutzen und Ihre Anwendung nur die Messwerte und Daten anfordern, die sie tatsächlich benötigt.

    • Der Bereich Zeitliche Dimensionen wurde aktualisiert, um zu verdeutlichen, dass in einem Analytics-Bericht Daten basierend auf einem bestimmten Zeitraum aggregiert werden sollen. Die API unterstützt jetzt die folgenden zusätzlichen zeitlichen Dimensionen:

      • 7DayTotals: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile Daten für einen Zeitraum von sieben Tagen enthält.
      • 30DayTotals: Die Daten im Bericht werden zusammengefasst, sodass jede Zeile Daten für einen Zeitraum von 30 Tagen enthält.
      • month: Die Daten im Bericht werden nach Kalendermonat zusammengefasst.

      Auch der Bereich Verfügbare Berichte wurde aktualisiert, um zu verdeutlichen, dass die API Berichte mit diesen Dimensionen unterstützt.

    • Der Abschnitt Dimensionen für Berichtselemente wurde aktualisiert. Bei API-Anfragen zum Abrufen von Rechteinhaberberichten müssen Daten entweder anhand einer dieser Dimensionen (video, channel oder show) oder einer unterstützten Kombination der Dimensionen claimedStatus und uploaderType gefiltert werden.

    • Die API unterstützt jetzt zwei neue Sortieroptionen für Berichte zu den beliebtesten Videos. Diese Berichte, die als Kanalberichte oder Berichte zu Rechteinhabern verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) pro Land und schlüsseln diese Messwerte nach Video auf. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die einen Kanal über die Wiedergabeseite des Videos abonniert oder gekündigt haben.

    • Die Definitionen der metrics subscribersGained und subscribersLost wurden aktualisiert, um zu verdeutlichen, dass ein Kanal Abonnenten an verschiedenen Stellen gewinnen oder verlieren kann, z. B. auf der Videowiedergabe-, der Kanalseite und der Übersicht, die auf der YouTube-Startseite angezeigt wird. Wenn diese Messwerte in einem videospezifischen Bericht erscheinen, enthalten sie nur Statistiken von der Wiedergabeseite des angegebenen Videos.