Überarbeitungsverlauf

Auf dieser Seite werden API-Änderungen und Dokumentationsaktualisierungen für die YouTube Reporting API und die YouTube Analytics API aufgeführt. Beide APIs ermöglichen Entwicklern den Zugriff auf YouTube Analytics-Daten, allerdings auf unterschiedliche Weise. Dieses Änderungsprotokoll abonnieren. Abonnieren

15. Dezember 2022

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

  • Ein neuer Bericht enthält Nutzeraktivitäten nach Stadt. Dieser Bericht ist für Kanäle und Rechteinhaber verfügbar. Dieser Bericht enthält die neue Dimension city, mit der YouTube die Stadt schätzt, in der die Nutzeraktivität stattgefunden hat.

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

    Die Dimension creatorContentType wird als optionale Dimension für alle Videoberichte von Kanälen und Rechteinhabern unterstützt.

  • Im Leitfaden zu Beispielanfragen in der YouTube Analytics API findest du 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 (Targeted Abfragen) und die YouTube Reporting API (Bulk Reports) unterstützen beide einen neuen Wert für die Zugriffsquelle:

  • Wenn in der YouTube Analytics API (Targeting-Abfragen) der Wert der Dimension insightTrafficSourceType den Wert SUBSCRIBER hat, kann der Wert insightTrafficSourceDetail auf podcasts gesetzt werden. Dies bedeutet, dass der Traffic von der Podcasts-Landingpage weitergeleitet wurde.
  • Wenn in der YouTube Reporting API (Bulk-Berichte) der Wert der Dimension traffic_source_type 3 lautet, 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. Dies könnte eine nicht abwärtskompatible Änderung an Ihrer API-Implementierung sein. Gemäß dem Abschnitt Nicht abwärtskompatible Änderungen in den Nutzungsbedingungen der YouTube API-Dienste wird diese Änderung sechs Monate vor Inkrafttreten wirksam. Aktualisieren Sie Ihre API-Implementierung vor dem 11. August 2022, um einen nahtlosen Übergang zu den neuen Werten zu gewährleisten.

Folgende Änderungen werden vorgenommen:

  • In der YouTube Analytics API (Targeting-Abfragen) 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-Berichte) 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

Am 13. Dezember 2021 wurden zwei Messwerte aktualisiert, um Zugriffe über Loop-Clips auszuschließen. Diese Änderung betrifft sowohl die YouTube Analytics API (Zielabfragen) als auch die YouTube Reporting API (Bulk-Berichte).

2. Februar 2022

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

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

Für diesen Zugriffsquellentyp wird mit der Dimension traffic_source_detail die Kanal-ID angegeben, über die der Nutzer weitergeleitet wurde.

23. September 2020

Diese YouTube Analytics API (Zielabfragen) und die YouTube Reporting API (Bulk-Berichte) unterstützen jetzt einen neuen Dimensionswert für Zugriffsquellen, der darauf hinweist, dass der Zuschauer durch vertikales Wischen in YouTube Shorts aufgerufen wurde:

  • In der YouTube Analytics API (Targeting-Abfragen) 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 zur Zugriffsquellenquelle“ (insightTrafficSourceDetail in der YouTube Analytics API oder traffic_source_detail in der YouTube Reporting API) wird für diesen neuen Zugriffsquellentyp nicht ausgefüllt.

20. Juli 2020

Dieses Update umfasst zwei Änderungen, die sich auf die YouTube Analytics API (Zielgerichtete Abfragen) auswirken:

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

13. Februar 2020

Dieses Update umfasst die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (Targeted Abfragen) und der YouTube Reporting API (Bulk Reports). Weitere Informationen zu diesen Änderungen findest du in der YouTube-Hilfe.

In beiden APIs ändert sich die mögliche Anzahl von Zugriffsquellendetails für Benachrichtigungen. In Zielabfragen werden Benachrichtigungen als insightTrafficSourceType=NOTIFICATION gemeldet. In Bulk-Berichten werden Benachrichtigungen als traffic_source_type=17 gemeldet.

Die neuen Werte teilen die Benachrichtigungen zu hochgeladenen Videos und Livestreams, die zuvor als uploaded gemeldet wurden, in zwei Kategorien auf:

  • uploaded_push: Die Aufrufe stammen aus Push-Benachrichtigungen, die beim Hochladen eines Videos an Abonnenten gesendet wurden.
  • uploaded_other: Die Aufrufe stammen aus Nicht-Push-Benachrichtigungen wie E-Mails oder dem Posteingang, die an Abonnenten gesendet wurden, als ein Video hochgeladen wurde.

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

Zur Erinnerung: Diese Werte repräsentieren nicht selbst Benachrichtigungen, sondern vielmehr die Zugriffsquellen, die bestimmte YouTube-Aufrufe generiert haben. Wenn in einer Berichtszeile beispielsweise views=3, traffic_source_type=17 (NOTIFICATION) und traffic_source_detail=uploaded_push angegeben sind, gibt die Zeile an, dass drei Aufrufe von Zuschauern stammen, die auf Push-Benachrichtigungen geklickt haben, die beim Hochladen des Videos gesendet wurden.

15. Oktober 2019

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (Zielgerichtete Abfragen):

  • Hinweis: Dies ist eine Mitteilung zur Einstellung von Produkten und Diensten.

    YouTube unterstützt die Dimensionen 7DayTotals und 30DayTotals nicht mehr. Sie können noch bis zum 15. April 2020 Daten mit diesen Dimensionen abrufen. An oder nach diesem Datum wird versucht, Berichte mit der Dimension 7DayTotals oder 30DayTotals abzurufen.

    Beachten Sie, dass Nutzer einen Teil der Daten für diese Dimensionen reproduzieren können. Dazu werden sie mit der Dimension day abgefragt und Daten über einen Zeitraum von 7 oder 30 Tagen zusammengefasst oder abgeleitet. Beispiel:

    • Sie können die Anzahl der Aufrufe für einen Zeitraum von sieben Tagen berechnen, indem Sie die Anzahl der Aufrufe für jeden Tag dieses Zeitraums zusammenfassen.
    • Der „Zuschauer-Prozentsatz“ für einen Zeitraum von sieben Tagen kann berechnet werden, indem die Anzahl der Aufrufe pro Tag multipliziert mit dem Wert „Betrachter (%)“ für diesen Tag multipliziert wird, um die Anzahl der Zuschauer zu ermitteln, die beim Ansehen des Videos an diesem Tag angemeldet waren. Anschließend wird die Anzahl der angemeldeten Zuschauer für den gesamten Zeitraum addiert und durch die Gesamtzahl der Aufrufe für diesen Zeitraum geteilt.
    • Die Anzahl der einzelnen Nutzer für einen Zeitraum von sieben Tagen kann nicht berechnet werden, da ein einzelner Nutzer an verschiedenen Tagen als einzelner Zuschauer berechnet werden könnte. Möglicherweise können Sie jedoch die Dimension „month“ anstelle der Dimension „30DayTotals“ verwenden, um Daten zur Anzahl der einzelnen Zuschauer über einen Zeitraum von 30 Tagen zu extrapolieren. Die Dimension month bezieht sich auf Kalendermonate, während die Dimension 30DayTotals die 30-Tage-Zeiträume anhand des angegebenen Start- und Enddatums berechnet.

27. Juni 2019

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (Zielgerichtete Abfragen):

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

1. November 2018

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (Zielgerichtete Abfragen):

  • Version 1 der API wurde verworfen. Falls noch nicht geschehen, aktualisieren Sie bitte Ihre API-Clients so bald wie möglich auf Version 2 der API, um Dienstunterbrechungen zu minimieren. Weitere Informationen finden Sie im Migrationsleitfaden.

    Die Einstellung dieser Einstellung wurde ursprünglich am 26. April 2018 angekündigt.

17. September 2018

Dieses Update enthält die folgenden Änderungen im Zusammenhang mit der YouTube Analytics API (Zielgerichtete Abfragen):

  • Im Abschnitt Anonymisierung von Daten im Übersichtsbericht Datenmodell wird erklärt, dass einige YouTube Analytics-Daten eingeschränkt sind, wenn Messwerte einen bestimmten Grenzwert nicht erreichen. Das kann in verschiedenen Fällen passieren. In der Praxis bedeutet dies, dass ein Bericht in den folgenden Fällen möglicherweise nicht (oder überhaupt) Ihre Daten enthält:

    1. ein Video oder ein Kanal nur über einen festgelegten Zeitraum verfügt,

      oder

    2. Sie haben einen Filter oder eine Dimension ausgewählt, z. B. Zugriffsquelle oder Land, für die bestimmte Werte nicht erreicht werden.

    Im 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 und berücksichtigen, dass die Messwerte redViews und estimatedRedMinutesWatched für Wiedergabeorte, Zugriffsquellen und Gerätetypberichte/Betriebssystemberichte nicht mehr unterstützt werden.

18. Juni 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics API (Targeted Surveys):

  • Die Anforderungen an 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:
      • für den https://www.googleapis.com/auth/youtube-Bereich
        oder
      • https://www.googleapis.com/auth/youtube.readonlyUmfang
        und
        https://www.googleapis.com/auth/yt-analytics.readonly Bereich

      Die erste Option verwendet einen Bereich, bei dem es sich um einen Lese-/Schreibbereich handelt, während die zweite Option zwei schreibgeschützte Bereiche umfasst.

23. Mai 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics API (Targeted Surveys):

  • Die API-Übersicht enthält den neuen Abschnitt Zusammengefasste Messwerte und gelöschte Elemente, der erklärt, wie API-Antworten mit Daten umgehen, die mit gelöschten Ressourcen wie Videos, Playlists oder Kanälen verknüpft sind.
  • Der Abschnitt Best Practices der API-Übersicht wurde aktualisiert, um dich daran zu erinnern, dass du die YouTube Data API verwenden kannst, um zusätzliche Metadaten für Ressourcen abzurufen, die in YouTube Analytics API-Antworten identifiziert wurden. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen entweder löschen oder aktualisieren.

22. Mai 2018

Dieses Update umfasst die folgenden Änderungen im Zusammenhang mit der YouTube Reporting API (Bulk-Berichte):

  • Die folgenden Änderungen sind derzeit für Juli 2018 geplant. Die neuen Richtlinien gelten weltweit für alle Berichte und Berichtsjobs.

    • Nach der Änderung sind die meisten API-Berichte, einschließlich Backfill-Berichte, ab ihrer Erstellung 60 Tage lang verfügbar. Berichte mit Verlaufsdaten sind jedoch ab dem Zeitpunkt der Erstellung 30 Tage lang verfügbar.

      Vor dieser Ankündigung waren alle API-Berichte ab ihrer Erstellung 180 Tage lang verfügbar. Hinweis: Wenn die Richtlinienänderung in Kraft tritt, können Sie nicht mehr über die API auf Berichte zu Verlaufsdaten zugreifen, die älter als 30 Tage sind. Alle anderen Berichte, die älter als 60 Tage sind, sind dann ebenfalls nicht mehr verfügbar. Die Dokumentation, die vor der Richtlinienänderung erstellt wurde, ist jetzt bis zu 180 Tage lang verfügbar.

    • Nach der Änderung generiert YouTube bei der Planung eines Berichtsauftrags ab diesem Tag Berichte für den 30-tägigen Zeitraum vor der Planung des Jobs. Vor der Änderung generiert YouTube bei der Planung eines Berichtsauftrags Berichte für den 180-tägigen Zeitraum 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 den Berichten identifizierte Ressourcen abrufen kannst. Gemäß den Richtlinien für Entwickler der YouTube API-Dienste (Abschnitte III.E.4.b bis III.E.4.d) müssen API-Clients gespeicherte Ressourcenmetadaten nach 30 Tagen entweder löschen oder aktualisieren.

  • Der Bereich Berichtseigenschaften wurde aktualisiert. Berichte mit Daten, die Daten ab einem 1. Juni 2018 enthalten, enthalten zwar keine Daten, die mindestens 30 Tage vor der Erstellung des Berichts gelöscht wurden.

  • Der Abschnitt Historische Daten der API-Übersicht wurde aktualisiert. Bei der Planung eines neuen Berichtsauftrags werden die bisherigen Berichte in der Regel innerhalb weniger Tage veröffentlicht. Bisher wurde in der Dokumentation angegeben, dass es bis zu 30 Tage dauern kann, bis solche Berichte verfügbar sind.

  • Der Abschnitt Backfill-Daten in der API-Übersicht wurde aktualisiert, um Backfill-Daten als einen Datensatz zu ersetzen, der einen zuvor bereitgestellten Satz ersetzt.

26. April 2018

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

  • Die API V2 ist fast identisch mit der API V1. Allerdings müssen Sie Ihren Code wahrscheinlich entsprechend den unten aufgeführten Änderungen aktualisieren. Alle 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. Parameternamen, die Bindestriche enthalten, z. B. end-date in der v1 API, werden in der API v2 verwendet. Durch diese Änderung sind Parameternamen in der gesamten API konsistent, da die API-Methoden zum Erstellen und Verwalten von Gruppen, in denen bereits Kamelnamen für Parameternamen verwendet werden, verwendet werden.
    • Die API V2 unterstützt keine Batchanfragen, die an den globalen HTTP-Batchendpunkt (www.googleapis.com/batch) gesendet werden. Wenn Sie Batchanfragen in der API V2 senden, müssen Sie stattdessen den Endpunkt https://youtubeanalytics.googleapis.com/v2 verwenden.

    Außerdem werden einige V1-Funktionen in Version 2 der API 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 unterstützt, die aus Anfragen an verschiedene APIs bestehen. Ein Batch kann jedoch aus Anfragen an verschiedene Methoden derselben API bestehen. Diese Einstellung hat nichts mit der YouTube Analytics API zu tun, da Google den globalen Batchendpunkt für alle zugehörigen APIs einstellt.
    • Die v2 API unterstützt das JSON-RPC-Protokoll, das in API v1 unterstützt wurde, nicht. Diese Einstellung gilt nicht nur für die YouTube Analytics API.

  • Hinweis: Dies ist eine Mitteilung zur Einstellung von Produkten und Diensten.

    Version 1 der API (v1) ist veraltet und wird bis zum 31. Oktober 2018 unterstützt. Alle Anfragen an die API V1 funktionieren nach diesem Datum nicht mehr. Daher ist ein Upgrade auf Version 2 der API bis spätestens 31. Oktober 2018 erforderlich, um Unterbrechungen beim Zugriff auf YouTube Analytics-Daten über die API zu vermeiden.

21. Februar 2018

Dieses Update umfasst die folgenden Änderungen an der YouTube Analytics API (Targeted Surveys):

  • In den Berichten zur Leistung nach demografischen Merkmalen werden die statistischen Werte für die Altersgruppe und das Geschlecht der Zuschauer zusammengefasst. Die Dimension youtubeProduct, mit der der YouTube-Dienst erfasst wurde, auf dem die Nutzeraktivität stattgefunden hat, wird nicht mehr unterstützt.

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 identifiziert, auf dem Aufrufe erfolgt sind, unterstützt jetzt den folgenden Wert:
      • 25: KaiOS

  • YouTube Analytics API (Zielgerichtete Abfragen)

20. Dezember 2017

Dieses Update enthält zwei Änderungen im Zusammenhang mit der YouTube Reporting API:

  • Der API-Server unterstützt jetzt die gzip-Komprimierung für Anfragen, mit denen Berichte heruntergeladen werden. Die gzip-Komprimierung wird für andere API-Anfragen nicht unterstützt. Durch Aktivieren der gzip-Komprimierung wird die für jede API-Antwort benötigte Bandbreite reduziert. Und während Ihre Anwendung zusätzliche CPU-Zeit benötigt, um API-Antworten zu dekomprimieren, ist der Vorteil, dass weniger Netzwerkressourcen verbraucht werden, normalerweise schwerer als

    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 der Eigenschaft downloadUrl der Ressource report erläutert.

  • Die Dokumentation der Dimensionen age group und gender wurde korrigiert, um die tatsächlichen Werte anzuzeigen, die von der API für diese Dimensionen zurückgegeben werden. Beachten Sie, dass dies eine Dokumentationskorrektur ist und keine Änderungen an der API-Funktionalität oder am API-Verhalten widerspiegelt. Insbesondere haben sich die folgenden Werte geändert:

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

10. August 2017

Am 10. August 2016 wurde in dieser Dokumentation die Einstellung des Messwerts earnings der YouTube Analytics API angekündigt. Gleichzeitig wurde die Unterstützung eines neuen Messwerts mit dem Namen estimatedRevenue hinzugefügt, der dieselben Daten bereitstellt.

Da der Messwert earnings ein Hauptmesswert war, wurde er ab der Ankündigung ein Jahr lang unterstützt. Da der einjährige Zeitraum nun aber beendet ist, wird der Messwert earnings nicht mehr unterstützt. Daher geben API-Anfragen, die den Messwert earnings angeben, jetzt einen 400-HTTP-Antwortcode zurück. Falls Sie Ihre App nicht bereits für die Verwendung des Messwerts estimatedRevenue anstelle des Messwerts earnings aktualisiert haben, tun Sie dies bitte baldmöglichst.

In der API-Dokumentation wurden die verbleibenden Verweise auf den Messwert earnings entfernt.

6. Juli 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Analytics API (Zielgerichtete Abfragen)

    • In der API-Dokumentation wurde die Tatsache aktualisiert, dass API-Antworten Daten bis zum letzten Tag des angeforderten Zeitraums enthalten, für den alle abgefragten Messwerte verfügbar sind.

      Wenn in einer Anfrage beispielsweise das Enddatum 5. Juli 2017 angegeben ist und die Werte für alle angeforderten Messwerte nur bis zum 3. Juli 2017 verfügbar sind, wird das Datum als letztes Datum in die Antwort aufgenommen. 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. Damit wird eine nicht überspringbare Videoanzeige von bis zu 6 Sekunden bezeichnet, die vor der Wiedergabe eines Videos abgespielt wird. Das Anzeigenformat entspricht der Anzeige auctionBumperInstream, bezieht sich aber auf Anzeigen, die auf Reservierungsbasis statt per Auktion verkauft werden.

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension ad_type unterstützt jetzt den Wert 20. Er bezieht sich auf Bumper-Anzeigen, die auf reservierte Weise verkauft werden. Bumper-Anzeigen sind bis zu sechs Sekunden lange, die vor dem Ansehen eines Videos wiedergegeben werden. Der Wert 19 für diese Dimension bezieht sich auch auf Bumper-Anzeigen, die auf Auktionsbasis und nicht auf reservierter Basis verkauft werden.

    • Berichtsjobs 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 Berichte mehr für sie erstellt. Bereits generierte Berichte waren noch 180 Tage lang verfügbar. Daher waren einige Berichte erst ab dem 15. Juni 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die damit verbundenen Jobs nicht erforderlich.

24. Mai 2017

Alle Berichtsjobs 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 und nach dem 22. September 2016 wurden keine Berichte mehr für sie erstellt. Bereits generierte Berichte waren noch 180 Tage lang verfügbar. Daher waren einige Berichte erst ab dem 22. März 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die damit verbundenen Jobs nicht erforderlich.

22. Mai 2017

Dieses Update enthält die folgenden Änderungen:

  • YouTube Reporting API (Bulk-Berichte)

    • Die Dimension sharing_service, die den Dienst zum Freigeben von Videos identifiziert, unterstützt jetzt die folgenden Werte:

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

      Außerdem wurde der Name, mit dem der Wert 52 identifiziert wird, in der Dokumentation zu Kakao (Kakao Talk) aktualisiert, 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 (Zielgerichtete Abfragen)

    • Die Dimension sharingService unterstützt jetzt die folgenden Werte:

      • 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 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 beide mit den YouTube Red-Zuschauerzahlen zusammenhängen. Die API unterstützt diese Messwerte bereits seit einiger Zeit. In der YouTube Reporting API werden bereits beide Messwerte unterstützt, wie am 15. September 2016 angekündigt.

    • Der Messwert redViews gibt an, wie oft YouTube Red-Abonnenten ein Video aufgerufen haben.
    • Der Messwert estimatedRedMinutesWatched gibt an, wie lange YouTube Red-Abonnenten ein Video angesehen haben.

    Die Dokumentation für Kanalberichte und Rechteinhaberberichte wurde aktualisiert und enthält nun die Berichte, die die beiden neuen Messwerte unterstützen. Sie werden in allen Berichten unterstützt, in denen die Messwerte views und estimatedMinutesWatched bereits unterstützt wurden.

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 auf den Zeitraum von 00:00 Uhr Pacific Time bis 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr. Je nach Jahreszeit ist die pazifische Zeit entweder UTC-7 oder UTC-8.

      Datumsangaben stellen in der Regel einen 24-Stunden-Zeitraum dar, Daten, bei denen die Uhrzeit nach vorne eingestellt wird, sind 23 Stunden. In der Dokumentation wurde angegeben, dass jedes Datum für einen eindeutigen 24-Stunden-Zeitraum steht und dass die Zeitzone Pacific Time immer UTC-8 war.

      Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Dimension operating_system, die das Softwaresystem des Geräts identifiziert, auf dem Aufrufe erfolgt sind, unterstützt jetzt die folgenden Werte:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Alle Berichtsjobs für den Berichtstyp content_owner_basic_a1 wurden gelöscht. Dieser Berichtstyp wurde zum 19. August 2016 vollständig eingestellt. Bisher erstellte content_owner_basic_a1-Berichte waren jedoch noch 180 Tage lang verfügbar. Daher waren einige Berichte erst ab dem 19. Februar 2017 verfügbar. Da die Berichte jedoch nicht mehr verfügbar sind, sind auch die damit verbundenen Jobs nicht erforderlich.

  • YouTube Analytics API (Zielgerichtete Abfragen)

    • Die Beschreibung von Dimensionen für time periods wurde korrigiert. Der Dimensionswert bezieht sich auf den Zeitraum von 00:00 Uhr Pacific Time bis 23:59 Uhr Pacific Time am angegebenen Tag, Monat und Jahr. Je nach Jahreszeit ist die pazifische Zeit entweder UTC-7 oder UTC-8.

      Datumsangaben stellen in der Regel einen 24-Stunden-Zeitraum dar, Daten, bei denen die Uhrzeit nach vorne eingestellt wird, sind 23 Stunden. In der Dokumentation wurde angegeben, dass die Zeitzone „Pacific Time“ UTC-8 war und nicht erwähnt wurde, dass ein Tag keinen 24-Stunden-Zeitraum darstellen kann.

      Diese Korrektur stellt keine Änderung des tatsächlichen API-Verhaltens dar.

    • Die Dokumentation für Channelberichte wurde aktualisiert und enthält jetzt keine Einnahmen- oder Anzeigenleistungsmesswerte mehr. Daher wird im Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly derzeit kein Zugriff auf monetäre Daten in Channelberichten gewährt.

    • 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 Berichten zu Rechteinhabern relevant.

Mit diesem Parameter kann ein Rechteinhaber angeben, dass eine API-Antwort die Wiedergabezeit und die Daten für den Zeitraum vor der Verknüpfung der Kanäle mit dem Rechteinhaber enthalten soll. Der Standardparameterwert lautet false. Die API-Antwort enthält also standardmäßig nur Wiedergabezeit und Aufrufe ab dem Zeitpunkt, zu dem 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 Wiedergabezeit- und Aufrufdaten für einen bestimmten Kanal auf dem Datum, an dem dieser Kanal mit dem Rechteinhaber verknüpft wurde.

    Wichtig ist, dass verschiedene Kanäle möglicherweise mit verschiedenen Datumsangaben mit einem Rechteinhaber verknüpft sind. Wenn die API-Anfrage Daten für mehrere Kanäle abruft und der Parameterwert false lautet, enthält die API-Antwort Wiedergabezeit- und Aufrufdaten basierend auf dem Verknüpfungsdatum für jeden Kanal.
  • Wenn der Parameterwert true lautet, gibt die Antwort die Wiedergabezeit und die 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 wurden aus der Dokumentation entfernt. Eine neuere Version jedes Berichts ist verfügbar. Die Ankündigung für diese Berichte wurde am 15. September 2016 vorgenommen.

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 Statistiken zu Impressionen und Klicks für Abspanne, die nach dem Ende eines Videos angezeigt werden.

    8. November 2016

    Dieses Update 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 neue Messwerte, die auf dieselben Daten verweisen, bereits unterstützt. In der folgenden Tabelle sehen Sie den eingestellten und den neuen Namen des Messwerts:

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

    27. Oktober 2016

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

    In der Übersicht zu vom System verwalteten Berichten erhalten Sie einen kurzen Überblick über die neuen Berichte und erfahren, wie Sie diese Berichte über die API abrufen. Dieser Prozess unterscheidet sich leicht von dem zum Abrufen von Bulk-Berichten für YouTube Analytics, da Partner keine Jobs zum Generieren der Berichte planen müssen.

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

    • Monatlicher Werbeumsatz pro Video weltweit
    • Täglicher Werbeumsatz pro Video pro Land
    • Monatlicher Werbeumsatz pro Asset weltweit
    • Tägliche Werbeeinnahmen pro Land und Asset
    • Ansprüche (dieser Bericht enthält keine Umsatzdaten)

    27. September 2016

    Hinweis: Dies ist eine Mitteilung zur Einstellung von Produkten und Diensten.

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

    15. September 2016

    Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API:

    19. August 2016

    Dieses Update enthält die folgende Änderung an der YouTube Reporting API:

    • Der content_owner_basic_a1-Bericht wurde vollständig eingestellt und aus der Dokumentation entfernt. YouTube generiert keine neuen Berichte dieses Typs mehr. Bereits generierte Berichte sind jedoch noch 180 Tage lang verfügbar.

      Als Ersatz für den Bericht content_owner_basic_a1 wird der Bericht content_owner_basic_a2 verwendet, wie im Eintrag im Überarbeitungsverlauf vom 19. Mai 2016 erläutert.

    11. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • Die neu veröffentlichten Nutzungsbedingungen für die YouTube API-Dienste („aktualisierte Nutzungsbedingungen“) werden im YouTube-Blog für Entwickler und Entwickler ausführlich beschrieben und enthalten umfassende Aktualisierungen der aktuellen Nutzungsbedingungen. Zusätzlich zu den aktualisierten Nutzungsbedingungen, die am 10. Februar 2017 in Kraft treten, enthält diese Aktualisierung mehrere unterstützende Dokumente, in denen die Richtlinien erläutert werden, die Entwickler einhalten müssen.

      Eine vollständige Liste der neuen Dokumente finden Sie im Überarbeitungsverlauf der aktualisierten Nutzungsbedingungen. Darüber hinaus werden künftige Änderungen an den aktualisierten Bedingungen oder an den entsprechenden Dokumenten auch im Überarbeitungsverlauf erläutert. Über einen Link in diesem Dokument können Sie Änderungen an diesem RSS-Feed abonnieren.

    10. August 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (Zielgerichtete Abfragen)

      • Hinweis: Dies ist eine Mitteilung zur Einstellung von Produkten und Diensten.

        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. Die YouTube Analytics API unterstützt jedoch beide Messwertnamen bis zu dem in der Tabelle aufgeführten Datum der Einstellung.

        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 Kernmesswert und wird daher ab dem Datum dieser Ankündigung für ein Jahr unterstützt. Die anderen Messwerte, die keine wichtigen Messwerte waren, werden bis zum 4. November 2016 drei Monate lang unterstützt.

        Zum Beispiel kann bis zum 4. November 2016 in einer API-Anfrage der Messwert impressionBasedCpm, der Messwert cpm oder beides angegeben werden. Nach diesem Datum 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 gibt an, dass die Aufrufe von Videos mit Ansprüchen stammen, die der Nutzer hochgeladen hat.
        • END_SCREEN: Die Daten betreffen Aufrufe, die vom Abspann eines anderen Videos stammen.

        Für beide neuen Besucherquellen kannst du 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. Damit wird eine nicht überspringbare Videoanzeige von bis zu 6 Sekunden bezeichnet, die vor der Wiedergabe eines Videos abgespielt wird.

    • YouTube Reporting API (Bulk-Berichte)

      • Die Dimension traffic_source_type unterstützt jetzt die folgenden Werte:
        • 19: Diese Zugriffsquelle wird nur für Rechteinhaberberichte unterstützt. Es gibt an, dass die Aufrufe von Videos mit Ansprüchen stammen, die der Nutzer hochgeladen hat.
        • 20: Die Daten betreffen Aufrufe, die vom Abspann eines anderen Videos stammen.

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

      • Die Liste der Kernmesswerte der API wurde korrigiert, sodass estimated_partner_revenue als Hauptmesswert aufgeführt wird und earnings aus dieser Liste entfernt wird. Der Messwert earnings wurde in der YouTube Reporting API noch nicht unterstützt.

      • Die Dimension ad_type unterstützt jetzt den Wert 19, der sich auf Bumper-Anzeigen bezieht. Das sind nicht überspringbare Videoanzeigen von bis zu 6 Sekunden, die vor der Wiedergabe eines Videos abgespielt werden.

    18. Juli 2016

    Dieses Update enthält die folgenden Änderungen:

    • YouTube Analytics API (Zielgerichtete Abfragen)

      • Die Listen der unterstützten Messwerte für die folgenden Kanalberichte wurden aktualisiert und enthalten jetzt Kartenmesswerte. Die Unterstützung für Kartenmesswerte in diesen Berichten wurde am 28. Juni 2016 hinzugefügt. Im Überarbeitungsverlaufseintrag für dieses Datum wird die Änderung ausführlicher erläutert. Die Berichte sind:
        • Grundlegende Nutzeraktivitäten für US-Bundesstaaten
        • Nutzeraktivität in US-Bundesstaaten für bestimmte Zeiträume
        • Nutzeraktivität nach Bundesland
        • Nutzeraktivität nach Status „Abonniert“
        • Nutzeraktivität nach Status „Abonniert“ für Provinzen
        • Top-Videos nach Bundesstaat
        • Top-Videos für Zuschauer ohne Abo

      • Die Listen mit Filtern wurden sowohl für Berichte zur Zuschauerbindung als auch für die Berichte zur Zuschauerbindung von Rechteinhabern korrigiert, um darauf hinzuweisen, 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 der beiden Filter abgerufen werden kann.

    • YouTube Reporting API (Bulk-Berichte)

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

    28. Juni 2016

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

    Die Messwerte werden in den folgenden Berichtstypen unterstützt:

    22. Juni 2016

    Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API. Die erste Änderung betrifft die API im Allgemeinen. Die verbleibenden Änderungen betreffen nur Berichte zu Rechteinhabern:

    • Der Abschnitt Berichtseigenschaften der API-Übersicht wurde aktualisiert, um klarzustellen, dass Berichte für 180 Tage ab ihrer Erstellung über die API verfügbar sind.

      Bisher wurde in der Dokumentation angegeben, dass Berichte für einen Zeitraum von bis zu 180 Tagen vor dem Datum der API-Anfrage verfügbar sind. Der ursprüngliche Text war zwar technisch zutreffend, im besten Fall aber verwirrend.

    • Die API unterstützt neue Versionen von drei Berichten. Zwei dieser Berichte enthalten ebenfalls 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 mit 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.

        Beide neu umbenannten Berichte unterscheiden sich folgendermaßen von ihren Vorgängern:

      Wenn Sie bereits Jobs haben, um eine der älteren Versionen dieser Berichte zu erstellen, müssen Sie für die umbenannten Berichte neue Jobs erstellen. In Verbindung 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 du Jobs für einen dieser Berichte hast, solltest du nicht damit rechnen, dass YouTube nach dem 22. September 2016 neue Berichte für diese Jobs erstellt. Erstellte Berichte sind noch 180 Tage lang verfügbar, nachdem sie generiert wurden.

    • Die Definition der id-Property der Ressource „reportType“ wurde entsprechend den aktuellen Berichten aktualisiert.

    • Die Namen zweier Messwerte wurden in der Dokumentation korrigiert, damit sie mit den Namen in Berichten übereinstimmen. Dies ist 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 nach der Aktualisierung eingestellt werden. Wie oben beschrieben, wurde dieser Messwert in neueren Versionen dieser 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. Wie bereits erwähnt, erscheint dieser Messwert nur in zwei Berichten, die nach der Aktualisierung eingestellt werden. Wie oben beschrieben, wurde dieser Messwert in neueren Versionen dieser Berichte in estimated_partner_ad_reserved_revenue umbenannt.

    • In der Dokumentation zu Dimensionen für die Reporting API wurden die Properties elapsed_video_time_percentage und audience_retention_type nicht mehr aufgeführt. Diese Dimensionen werden derzeit nicht in Berichten unterstützt, die über die API verfügbar sind.

    19. Mai 2016

    Dieses Update enthält die folgenden Änderungen an der YouTube Reporting API:

    • Die API unterstützt eine neue Version des Berichts zur Nutzeraktivität für Rechteinhaber. Die ID des Berichtstyps 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.

      Wenn Sie bereits einen Job zum Erstellen des Berichts content_owner_basic_a1 haben, müssen Sie trotzdem einen neuen Job für den Bericht content_owner_basic_a2 erstellen. YouTube migriert Rechteinhaber nicht automatisch zur neuen Berichtsversion oder erstellt automatisch einen Job zum Generieren der neuen Berichtsversion. In einigen Implementierungen könnte das Auftreten eines neuen, unerwarteten Jobs eine nicht abwärtskompatible Änderung darstellen.

      In Verbindung mit der Veröffentlichung des neuen Berichts wurde der content_owner_basic_a1-Bericht eingestellt. Wenn du einen Job für diesen Bericht hast, solltest du nicht damit rechnen, dass YouTube nach dem 19. August 2016 neue Berichte für diesen Job erstellt. Erstellte Berichte sind noch 180 Tage lang verfügbar, nachdem sie generiert wurden.

    • Die Ressourcen reportType, job und report unterstützen alle eine neue Property, die angibt, ob die zugehörige Ressource einen eingestellten Berichtstyp darstellt:

      • Die Eigenschaft deprecateTime der Ressource reportType gibt das Datum und die Uhrzeit an, zu der der Berichtstyp eingestellt wird. Diese Property hat nur einen Wert für Berichte, die als veraltet angekündigt wurden, und der Wert gibt das Datum an, an dem YouTube keine Berichte dieses Typs mehr erstellen wird.

        Nachdem ein Berichtstyp eingestellt wurde, erstellt YouTube weitere drei Monate lang Berichte dieses Typs. Durch diese Aktualisierung wurde beispielsweise am 19. Mai 2016 die Einstellung des Berichts content_owner_basic_a1 angekündigt. Der deprecateTime für diesen Berichtstyp gibt daher einen Zeitpunkt am 19. August 2016 an, nach dem YouTube keine Berichte dieses Typs mehr generiert.

      • Das Attribut expireTime der Ressource job gibt das Datum und die Uhrzeit an, zu dem der Job abgelaufen ist oder abläuft. Diese Eigenschaft hat einen Wert, wenn der mit dem Job verknüpfte Berichtstyp veraltet ist oder wenn Berichte, die für den Job generiert wurden, ü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 generiert.

      • Die Eigenschaft jobExpireTime der Ressource report gibt das Datum und die Uhrzeit an, zu der der mit dem Bericht verknüpfte Job entweder abgelaufen ist oder abläuft. Dieses Attribut 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 den HTTP-Antwortcode 400 (Bad Request) zurück, wenn Sie versuchen, einen Job für einen verworfenen Bericht zu erstellen. Außerdem sind in der Dokumentation der Methode jetzt mehrere weitere Gründe aufgeführt, warum eine API-Anfrage fehlschlägt.

    12. April 2016

    Dieses Update umfasst die folgenden Änderungen, die sich alle nur auf die YouTube Reporting API auswirken:

    • YouTube generiert jetzt Daten für den 180-tägigen Zeitraum vor der Planung eines Berichtsauftrags. Bisher hat die Reporting API keine Verlaufsdaten bereitgestellt. Diese Änderung betrifft alle Jobs, einschließlich der Jobs, die vor dieser Ankündigung erstellt wurden.

      Historische Berichte werden veröffentlicht, sobald sie verfügbar sind. Es dauert jedoch etwa einen Monat, bis alle bisherigen Daten für einen Job veröffentlicht wurden. Einen Monat nach der Planung eines Berichtsauftrags haben Sie also Zugriff auf die 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.

      Bisherige Daten sind erst seit dem 1. Juli 2015 verfügbar. Daher stehen für Jobs, die vor dem 28. Dezember 2015 erstellt wurden, weniger als 180 Tage bisherige Daten zur Verfügung.

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

    • Der Abschnitt Berichtseigenschaften in der YouTube Reporting API wurde aktualisiert und enthält folgende Änderungen:

      • Die Dokumentation besagt jetzt, dass Berichte für einen Zeitraum von 180 Tagen nach ihrer Erstellung verfügbar sind und dementsprechend für API-Clients zum Download verfügbar sind. Bisher wurde in der Dokumentation angegeben, dass Berichte für einen Zeitraum von bis zu sechs Monaten vor dem Datum verfügbar sind, an dem die API-Anfrage gesendet wurde.

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

    • Die YouTube Reporting API unterstützt demnächst eine Reihe automatisch generierter, vom System verwalteter Berichte, die Daten zum Werbeumsatz oder zum YouTube Red-Aboumsatz enthalten. Die Berichte stehen Rechteinhabern zur Verfügung, die bereits auf manuell herunterladbare Umsatzberichte im YouTube Studio zugreifen können. Die neue API-Funktion bietet daher programmatischen Zugriff auf diese Daten.

      Die folgenden API-Änderungen werden jetzt zur Vorbereitung auf vom System verwaltete Berichte angekündigt:

      • Das neue Attribut systemManaged der Ressource job gibt an, ob die Ressource einen Job beschreibt, der vom System verwaltete 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 Parameter includeSystemManaged der Methode jobs.list gibt an, ob die API-Antwort Jobs für vom System verwaltete 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 am oder nach dem angegebenen Datum liegen. Entsprechend 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, die sich auf den Zeitpunkt der Berichterstellung bezieht, beziehen sich die neuen Parameter auf die Daten im Bericht.

      • Das neue Attribut systemManaged der Ressource reportType 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

    Die YouTube Reporting API und die YouTube Analytics API geben jetzt Aufrufstatistiken für mehrere zusätzliche Dienste zum Teilen von Inhalten zurück.

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

    16. März 2016

    Dieses Update umfasst die folgenden Änderungen, die sich sowohl auf die YouTube Reporting API als auch auf die YouTube Analytics API auswirken:

    YouTube Reporting API

    • Die Dimension playback_location_type unterstützt zwei neue Dimensionswerte:
      • 7: Die Daten beziehen sich auf Aufrufe auf der YouTube-Startseite oder -Startseite, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.
      • 8: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben.
    • 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, der angibt, dass die Aufrufe während der Wiedergabe des Videos im Rahmen einer Playlist aufgetreten sind.

    YouTube Analytics API

    • Die Dimension insightPlaybackLocationType unterstützt zwei neue Dimensionswerte:
      • BROWSE: Die Daten beziehen sich auf Aufrufe auf der YouTube-Startseite oder -Startseite, im Abofeed des Nutzers oder in einer anderen YouTube-Suchfunktion.
      • SEARCH: Die Daten beziehen sich auf Aufrufe, die direkt auf der YouTube-Suchergebnisseite stattgefunden haben.
    • 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 PLAYLIST-Quelltyp, der angibt, dass die Aufrufe während der Wiedergabe des Videos als Teil einer Playlist stattfanden.

    8. Februar 2016

    Die Liste der für die YouTube Analytics API unterstützten Messwerte wurde aktualisiert, sodass Kartenmesswerte nicht mehr als unterstützte Messwerte für diese API aufgeführt sind. (Keiner der Berichte dieser API war dokumentiert, die einen der Messwerte der Karte unterstützen.)

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

    6. Januar 2016

    Die YouTube Reporting API und die YouTube Analytics API identifizieren jetzt speziell Aufrufe, die über einen Chromecast erfolgen.

    • In der YouTube Reporting API verwendet die Dimension operating_system den Wert 21, um Aufrufe über Chromecast zu identifizieren.
    • In der YouTube Analytics API wird mit der Dimension operatingSystem der Wert CHROMECAST verwendet, um Aufrufe über Chromecast zu identifizieren.

    21. Dezember 2015

    In der Dokumentation wurden die Namen der Messwerte annotation_clickable_impressions und annotation_closable_impressions entsprechend den Namen in den Berichten aktualisiert. 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 bestimmte Offenlegungen an Endnutzer in der EU offengelegt werden. Daher müssen Sie für Endnutzer in der Europäischen Union die Richtlinie zur Einwilligung der Nutzer in der EU einhalten. Wir haben diese Anforderung in unseren YouTube API-Nutzungsbedingungen hinzugefügt.

    15. Dezember 2015

    Dieses Update umfasst die folgenden Änderungen, die alle die YouTube Analytics API betreffen:

    • In der YouTube Analytics API werden jetzt drei neue Dimensionen für Wiedergabedetails unterstützt, die in verschiedenen Berichten für Kanäle und Rechteinhaber 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, in der die Nutzeraktivität stattgefunden hat. Mögliche Werte sind die YouTube-Website (oder die 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 verfügbar sind. Darüber hinaus wurden viele weitere Berichte aktualisiert. Eine oder mehrere dieser Dimensionen können in diesen Berichten optional als Dimensionen und/oder Filter verwendet werden.

    • Das Format der Tabellen, in denen die Berichte erläutert werden, wurde geändert, damit Sie gültige Kombinationen von Dimensionen, Messwerten und Filtern, die zum Abrufen der einzelnen Berichte verwendet werden können, leichter erkennen können. In der folgenden Tabelle wird der Bericht „Gerätetyp“ für Kanäle erläutert und das neue Format dargestellt:

      Inhalt
      Abmessungen:
      Erforderlich Gerätetyp
      0 oder mehr verwenden Tag, liveOrOnDemand, subscribedStatus, youtubeProduct
      Messwerte:
      Mindestens eine verwenden Aufrufe, estimatedMinutesWatched
      Filter:
      0 oder 1 verwenden country, province, continent, subContinent
      0 oder 1 verwenden Video, Gruppe
      0 oder mehr verwenden operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Die Terminologie, die Pflichtfelder und optionale Felder beschreibt, wird in der Dokumentation für Kanalberichte und Rechteinhaberberichte erläutert.

    • Die YouTube Analytics API entfernt 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 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, bei der der Filter video 20 Video-IDs auflistet. Der Nutzer ist Eigentümer von 18 Videos. Allerdings identifiziert eine Video-ID ein Video, das zu einem anderen Kanal gehört, und eine andere ID, um ein Video zu identifizieren, das gelöscht wurde und daher nicht mehr existiert. In diesem Fall löscht der API-Server anstelle eines Fehlers jetzt die beiden Videos, auf die der Nutzer nicht zugreifen kann, und die API-Antwort enthält Daten für die 18 Videos, die dem API-Nutzer gehören.

    • Wenn Sie Daten für ein leeres YouTube Analytics-group anfordern, gibt die API jetzt einen leeren Datensatz statt eines Fehlers zurück.

    • Die Methode groupItems.insert 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, du aber keinen Zugriff auf diese Entität hast. Bisher konnten Sie über die API die Entität zur Gruppe hinzufü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. Legen Sie den pageToken-Parameter der Methode auf diesen Wert fest, 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:

    • Die Dokumentation für die Dimension date der YouTube Reporting API wurde korrigiert, sodass sich diese Datumsangaben auf den 24-Stunden-Zeitraum beziehen, der um 00:00 Uhr Pacific Time (UTC-8) beginnt. Bisher wurde in der Dokumentation angegeben, dass das Datum um 00:00 Uhr (GMT) begonnen habe.

      Außerdem wurde die YouTube Analytics API-Dokumentation dahingehend aktualisiert, dass sich alle datumsbezogenen Dimensionen (day, 7DayTotals, 30DayTotals und month) auf Daten ab 00:00 Uhr Pacific Time (UTC-8) beziehen.

    • Die jobs.reports.list()-Methode der YouTube Reporting API unterstützt jetzt den Abfrageparameter createdAfter. Wenn angegeben, gibt dieser Parameter an, dass die API-Antwort nur Berichte anzeigen soll, die nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, einschließlich neuer Berichte mit Backfill-Daten. Der Parameterwert bezieht sich auf die Zeit, zu der der Bericht erstellt wird, und nicht auf die Daten, die mit den zurückgegebenen Daten verknüpft sind.

      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. Sie enthalten jetzt Informationen dazu, wie Sie den Parameter createdAfter verwenden können, um die wiederholte Verarbeitung desselben Berichts zu vermeiden.

    • Die Definitionen der Attribute createTime der job-Ressource und der Attribute startTime, endTime und createTime der report-Ressource wurden korrigiert. Die Werte der Attribute sind auf Mikrosekunden genau und nicht auf Nanosekunden festgelegt. Außerdem spiegeln alle Definitionen jetzt genau 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 enthält nun eine Liste möglicher Dimensionswerte. Die Liste enthält einige neu unterstützte Dienste.

      In der Definition der Dimension sharing_service der YouTube Reporting API wurden auch die neu unterstützten Werte aktualisiert. Die Aufzählungswerte, die größer als 59 sind, sind die neuen Werte in der Liste.

    24. September 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit der neuen YouTube Reporting API kannst du Berichte zu Bulk-Daten abrufen, die YouTube Analytics-Daten zu einem Kanal oder Rechteinhaber enthalten. Es wurde für Anwendungen entwickelt, die große Datensätze importieren können und Tools zum Filtern, Sortieren und Minen dieser Daten bieten.

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

      Mit der API kannst du Berichtsjobs planen, die jeweils einen Bericht identifizieren, den YouTube generieren soll. Sobald Sie einen Job eingerichtet haben, generiert YouTube einen täglichen Bericht, der asynchron heruntergeladen werden kann. Jeder Bericht enthält Daten für einen eindeutigen Zeitraum von 24 Stunden.

    • Obwohl es sich dabei um verschiedene APIs handelt, können Entwickler mit der YouTube Analytics API und der YouTube Reporting API YouTube Analytics-Daten abrufen. Da die APIs beide Zugriff auf ähnliche Datensätze bieten, wird die Dokumentation für die beiden APIs als einzelne Dokumentation veröffentlicht.

      • Der Tab Leitfäden in der Dokumentation enthält Informationen zu beiden APIs, einschließlich Anleitungen zur Autorisierung von API-Anfragen.
      • Der Tab Bulk-Berichte enthält eine Referenzdokumentation und andere Inhalte speziell für die YouTube Reporting API.
      • Der Tab Zielgerichtete Abfragen enthält eine Referenzdokumentation und andere Inhalte speziell für die YouTube Analytics API.
      • Auf dem Tab Beispiele sind Codebeispiele aufgeführt, die für eine der beiden APIs verfügbar sind.
      • Auf dem Tab Tools sind zusätzliche Ressourcen aufgeführt, die Entwickler bei der Implementierung der beiden APIs unterstützen.

    20. August 2015

    Dieses Update enthält die folgenden Änderungen:

    • Die API-Dokumentation wurde umstrukturiert, damit sie einfacher zu verstehen ist. Diese Änderungen beschreiben daher keine neuen Funktionen:

      • Die Dokumentation enthält jetzt eine Seite mit allen verfügbaren Kanalberichten und eine weitere Seite mit allen verfügbaren Rechteinhaberberichten. Bisher enthielt die Dokumentation separate Seiten für Kanalvideoberichte, Kanalplaylistberichte usw.

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

      • Die reports.query-Methode der API, mit der Sie Berichte abrufen, ist jetzt separat dokumentiert. Die Informationen auf dieser Seite waren zuvor auf einigen anderen Seiten vorhanden. Auf der neuen Seite finden Sie leichter die Informationen, die Sie zum Abrufen eines Berichts senden müssen.

    22. Juli 2015

    Dieses Update 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. Dies ist kein Hauptmesswert. Die API unterstützt den Messwert adEarnings für alle Berichte, die den Messwert earnings bereits unterstützen.

      Darüber hinaus wurde die Definition des Messwerts earnings korrigiert, um zu verdeutlichen, dass der Wert die geschätzten Gesamteinnahmen aus allen von Google verkauften Anzeigenquellen sowie Quellen, die keine Werbeanzeigen sind, enthält. Bisher wurde in der Definition fälschlicherweise angegeben, dass der Messwert nur Einnahmen aus Werbequellen enthielt.

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

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

    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 beide aktualisiert, um die Berichte zu identifizieren, die die neuen Messwerte unterstützen.

      • videosAddedToPlaylists: Gibt an, wie oft Videos im Bereich der Abfrage einer YouTube-Playlist hinzugefügt wurden. Möglicherweise wurden die Videos zur Playlist des Rechteinhabers oder zu Playlists anderer Kanäle hinzugefügt.
      • videosRemovedFromPlaylists: Gibt an, wie oft Videos im Geltungsbereich der Anfrage aus YouTube-Playlists entfernt wurden. Möglicherweise wurden die Videos aus der Playlist des Rechteinhabers oder aus den Playlists anderer Kanäle entfernt.

      Beide Messwerte umfassen Standardplaylists wie die Playlist „Später ansehen“. Allerdings werden dabei keine Playlists berücksichtigt, denen ein Video automatisch hinzugefügt wurde. Dazu zählen unter anderem die Upload-Playlist eines Kanals oder der Wiedergabeverlauf eines Nutzers. Beachten Sie auch, dass diese Messwerte die absolute Anzahl der Hinzufügungen und Löschungen widerspiegeln. Wenn ein Nutzer also ein Video in eine Playlist einfügt, entfernt und anschließend wieder hinzufügt, bedeutet die Metrik, dass das Video zu zwei Playlists hinzugefügt und aus einer Playlist 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:

    16. März 2015

    Dieses Update enthält die folgenden Änderungen:

    • Mit dem neuen currency-Parameter können Sie Messwerte zu Einnahmen in einer anderen Währung als US-Dollar (USD) abrufen. Wenn der Parameter festgelegt ist, konvertiert die API die Werte für die Messwerte earnings, grossRevenue, playbackBasedCpm und impressionBasedCpm in die angegebene Währung. Bei den zurückgegebenen Werten handelt es sich um Schätzungen, bei denen sich die Wechselkurse ändern, die sich täglich ändern.

      Der Parameterwert ist ein dreistelliger ISO 4217-Währungscode. 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:

    • Die API unterstützt jetzt das Erstellen und Verwalten von YouTube Analytics-Gruppen sowie das Abrufen von Berichtsdaten für diese Gruppen.

      • Gruppen erstellen und verwalten

        Mit diesem Update werden die Ressourcen group und groupItem zum Erstellen und Verwalten von Gruppen eingeführt.

        • Die Ressource group stellt eine Analytics-Gruppe dar. Sie ist 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 beispielsweise eine Gruppe mit der Methode groups.insert erstellen und dann Elemente mit der Methode groupItems.insert hinzufügen.

      • Berichtsdaten für eine Gruppe abrufen

        Die Dokumentation zu Dimensionen wurde aktualisiert und enthält jetzt die Dimension group, die als Filter für viele Kanalberichte und Rechteinhaberberichte verwendet werden kann. Wenn Sie den Filter group verwenden, gibt die API Daten für alle Elemente in dieser Gruppe zurück. Derzeit ist es in der API nicht möglich, Berichte für Asset-Gruppen zu erstellen.

      Weitere Informationen zu YouTube Analytics-Gruppen finden Sie 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:

    • In der API können jetzt mehrere Werte für die Dimensionen video, playlist, channel und show angegeben werden, wenn diese Dimensionen als Filter verwendet werden. Wenn du mehrere Werte angeben möchtest, setze den Parameterwert filters auf eine durch Kommas getrennte Liste der Videos, Playlists, Kanäle oder Serien-IDs, nach denen die API-Antwort gefiltert werden soll. Der Parameterwert kann bis zu 200 IDs angeben.

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

      Ausführliche Informationen zu dieser Funktion finden Sie in der Parameterdefinition von 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. Setze dazu den Wert des Parameters ids auf channel==MINE. Du kannst auch den Parameter ids 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 Zusammenhang mit einer Playlist enthalten. Playlist-Berichte sind für Kanäle und Rechteinhaber verfügbar.

      In allen Playlist-Berichten werden die Messwerte views und estimatedMinutesWatched unterstützt, in einigen auch der Messwert averageViewDuration.

      Außerdem unterstützen alle Playlist-Berichte die folgenden neuen Messwerte: Beachte, dass jeder dieser Messwerte nur Playlist-Aufrufe im Web wiedergibt.

      • playlistStarts: Gibt an, wie häufig die Wiedergabe einer Playlist durch Zuschauer gestartet wurde.
      • viewsPerPlaylistStart: Die durchschnittliche Anzahl der Videoaufrufe, die bei jedem Start einer Playlist erfolgt sind.
      • averageTimeInPlaylist: Die geschätzte durchschnittliche Zeit in Minuten, die ein Zuschauer Videos in einer Playlist angesehen hat, nachdem die Playlist initiiert wurde.

      Jede Anfrage zum Abrufen eines Playlist-Berichts muss den Filter isCurated verwenden, der auf 1 (isCurated==1) gesetzt werden muss.

    • Die API unterstützt jetzt einen Bericht zur Zuschauerbindung. In diesem Bericht wird die Fähigkeit eines Videos gemessen, seine Zielgruppe zu halten. Mit der neuen Dimension elapsedVideoTimeRatio des Berichts wird der Anteil des Videos ermittelt, das für die entsprechenden Messwerte verstrichen ist:

      • Der Messwert audienceWatchRatio gibt das absolute Verhältnis der Zuschauer an, die sich das Video zum jeweiligen Zeitpunkt 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.

        Ein Teil eines Videos kann in einer Videowiedergabe mehrmals (oder überhaupt nicht) angesehen werden. Wenn Nutzer beispielsweise denselben Teil eines Videos mehrmals zurückspulen und ansehen, kann das absolute Verhältnis für diesen Teil des Videos größer als 1 sein.

      • Der Messwert relativeRetentionPerformance gibt an, wie gut ein Video bei der Wiedergabe im Vergleich zu allen YouTube-Videos ähnlicher Länge bleibt. Der Wert 0 gibt an, dass die Zuschauerbindung bei einem Video länger ist als bei allen anderen Videos mit ähnlicher Länge. Der Wert 1 bedeutet, dass die Zuschauerbindung besser ist als bei anderen Videos mit ähnlicher Länge. Ein Medianwert von 0,5 gibt an, dass die Hälfte der Videos mit ähnlicher Länge die Zuschauer besser und die Hälfte schlechter hält.

      Sie können auch den audienceType-Filter verwenden, damit der Bericht nur Daten zu organischen Aufrufen, zu Aufrufen über TrueView In-Stream-Anzeigen oder zu Aufrufen aus TrueView In-Display-Anzeigen zurückgibt. (Organische Aufrufe sind die direkte Folge der Nutzeraktion, beispielsweise die Suche nach einem Video oder der 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, die zuvor die Messwerte annotationClickThroughRate und annotationCloseRate unterstützt haben.

      Alle neuen Messwerte sind wichtige Messwerte und unterliegen der Richtlinie zur Einstellung von Produkten und Diensten. Für die neuen Messwerte stehen seit dem 16. Juli 2013 allerdings Daten zur Verfügung. (Daten für die Messwerte 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 gemeldet. Stattdessen werden Verweise aus Google-Suchergebnissen jetzt dem Besucherquellentyp EXT_URL zugeordnet. Daher ist es auch nicht mehr möglich, einen insightTrafficSourceDetail-Bericht abzurufen, bei dem der Filter insightTrafficSourceType 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 Beispielanfragen wurde umgestaltet, um Beispiele zu Gruppen in Kategorien zu gruppieren. Es wurde ein Tabformat verwendet, das dem vor Kurzem veröffentlichten Format für Kanal- und Rechteinhaberberichte entspricht. Im neuen Design sind Beispiele in die folgenden Kategorien unterteilt:

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

    • Das Dokument Beispielanfragen enthält jetzt neue Beispiele für den Abruf regionsspezifischer Daten in Kanal- oder Rechteinhaberberichten.

      • Provinzspezifische Messwerte für US-Bundesstaaten und Washington D.C.: In diesem Bericht wird die Aufschlüsselung der Aufrufe nach Provinz und andere Werte für die Videos eines Kanals aufgeschlüsselt. Die Daten umfassen US-Bundesstaaten und Washington D.C. In diesem Beispiel wird die Dimension province und der Parameter filters verwendet, um die Antwort so einzuschränken, dass nur Ergebnisse für die USA eingeschlossen werden.

      • Demografische Merkmale der Zuschauer in Kalifornien (Altersgruppe und Geschlecht): In diesem Bericht werden Statistiken zur Altersgruppe und zum Geschlecht von Zuschauern in Kalifornien abgerufen, die sich die Videos eines Kanals angesehen oder, sofern der Rechteinhaber die Inhalte eines Rechteinhabers beansprucht hat. In diesem Beispiel wird mit dem Parameter filters dafür gesorgt, dass die Antwort nur Daten für eine bestimmte Provinz enthält.

    • Die Definition der Dimension province wurde aktualisiert und enthält jetzt den Hinweis: Wenn province im Parameterwert dimensions enthalten ist, muss die Anfrage auch Daten auf die USA beschränken, indem country==US in den Parameterwert filters aufgenommen wird.

    6. Januar 2014

    Dieses Update enthält die folgenden Änderungen:

    • Die Dokumente mit den unterstützten Berichten für Kanäle und Rechteinhaber wurden überarbeitet. Anstatt eine Tabelle zu erstellen, in der alle möglichen Berichte aufgeführt sind, gruppiert jedes Dokument die Berichte in Kategorien:

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

      Jedes Dokument zeigt diese Kategorien als Liste von Tabs an. Sie können auf einen beliebigen Tab klicken, um die unterstützten Berichte in dieser Kategorie aufzurufen.

    • 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 den Distrikt Kolumbiens abrufen. Die API unterstützt zwei Anwendungsfälle für diese Dimension:

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

          • Der zentrale Statistikbericht bietet mehrere Statistiken, unter anderem die Anzahl der Aufrufe und die geschätzte Wiedergabezeit in Minuten.
          • Der zeitbasierte Bericht enthält dieselben Statistiken, sammelt jedoch Daten auf Tages-, 7-, 30- oder Monatsbasis.

        • Mit dem Abfrageparameter filters können Sie einen Bericht so einschränken, dass er nur Statistiken für einen bestimmten Bundesstaat enthält. Verschiedene Berichte unterstützen diese Art der Filterung, einschließlich geografischer Berichte, Berichte zu Wiedergabeorten, Zugriffsquellenberichten, Geräteberichten, Betriebssystemberichten, Berichten zur Leistung nach demografischen Merkmalen und Top-Video-Berichten.

      • Die Dimension continent gibt den 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 Unterregion eines Kontinents identifiziert. Diese Dimension kann auch nur als Filter verwendet werden.

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

    • Die Dokumentation wurde korrigiert, sodass die Dimension insightTrafficSourceDetail den insightTrafficSourceType-Wert PROMOTED nicht als gültigen Filterwert enthält.

    30. September 2013

    Dieses Update enthält die folgenden Änderungen:

    • Für die YouTube Analytics API gilt jetzt die Richtlinie zur Einstellung von Produkten und Diensten, die in den Nutzungsbedingungen beschrieben wird. Die Nicht-Kern-Dimensionen und Nicht-Kernmesswerte der API unterliegen jedoch nicht der Einstellungsrichtlinie. Die Seiten Dimensionen und Messwerte wurden aktualisiert und enthalten nun die wichtigsten Dimensionen und Messwerte. Außerdem wurden die Definitionen auf diesen Seiten aktualisiert, um Kerndimensionen und -messwerte explizit zu kennzeichnen.

    • Die API unterstützt jetzt EXTERNAL_APP als Wert für die Dimension insightPlaybackLocationType. Seit dem 10. September 2013 werden Wiedergaben von Wiedergaben nicht mehr als MOBILE-Wiedergaben kategorisiert. Mobile Wiedergaben, die vor diesem Datum stattgefunden haben, werden jedoch weiterhin mit diesem Wert kategorisiert.

      Mit diesem Update werden mobile Wiedergaben jetzt als WATCH-, EMBEDDED- oder EXTERNAL_APP-Wiedergaben klassifiziert, je nachdem, um welche Art von App es sich handelt.

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

    16. Juli 2013

    Dieses Update enthält die folgenden Änderungen:

    • In der API können jetzt Berichte nach mehreren Dimensionen und Messwerten sortiert werden. Das Beispieldokument zu Anfragen enthält ein neues Beispiel, das diese Funktion zeigt: Anfragen nach mehreren Dimensionen/Messwerten sortieren. Die Anfrage ruft Daten zu Besucherquellen ab und hat den sort-Parameterwert day,-views. Die Ergebnisse werden chronologisch sortiert, aber in der Ergebnismenge für jeden Tag enthält die erste Zeile Daten für die Zugriffsquelle, die die meisten Aufrufe generiert hat, die zweite Zeile enthält Daten für die Quelle, die die zweithöchste Anzahl an Aufrufen generiert hat usw.

    • Die API unterstützt jetzt zwei neue Dimensionen, deviceType und operatingSystem, mit denen Daten zu 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 deviceType-Bericht kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Gerätetypen abrufen, einschließlich Computer, Smartphones und Tablets. Sie können auch den operatingSystem-Filter verwenden, um den Gerätetypbericht so einzuschränken, dass er nur Statistiken für Geräte mit einem bestimmten Betriebssystem wie Android oder iOS enthält.

      • Im Bericht operatingSystem kannst du die Anzahl der Aufrufe und die geschätzte Wiedergabezeit für verschiedene Betriebssysteme wie Android, iOS und Linux abrufen. Sie können auch den Filter deviceType verwenden, um den Bericht zum Betriebssystem so zu beschränken, dass nur Statistiken für einen bestimmten Gerätetyp wie Mobilgeräte oder Tablets angezeigt werden.

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

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

    • Die Dimension insightPlaybackLocationType gibt möglicherweise den Wert YT_OTHER zurück, der Aufrufe identifiziert, die nicht mit einem der anderen Werte der Dimension klassifiziert wurden.

    23. Mai 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das Dokument Rechteinhaberberichte wurde aktualisiert, um anzuzeigen, dass du den Top-Videobericht in absteigender Reihenfolge der Einnahmen sortieren kannst, um die Videos mit den höchsten Einnahmen zu ermitteln. Dieser Bericht ist der erste Bericht, der in der zweiten Tabelle im Abschnitt 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:

    • Die API unterstützt jetzt das Abrufen von Messwerten zur Wiedergabezeit – estimatedMinutesWatched, averageViewDuration und averageViewPercentage – in Verbindung mit anderen Messwerten wie Aufrufen, Interaktionen, Einnahmen und Anzeigenleistung.

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

      Das Dokument Beispiel-API-Anfragen wurde ebenfalls aktualisiert.

    • Die Berichte mit den Dimensionen insightPlaybackLocationDetail und insightTrafficSourceDetail wurden auf folgende Weise optimiert:

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

      • Rechteinhaber können diese Berichte jetzt mit einer der folgenden filter-Kombinationen abrufen. Beachten Sie, dass alle diese Kombinationen auch den optionalen Filter country unterstützen.

        • 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:

    • Im neuen Dokument Beispiel-API-Anfragen finden Sie Beispiele dafür, wie Sie mit YouTube Analytics API verschiedene Arten von Berichten abrufen können. Jedes Beispiel enthält eine kurze Beschreibung des Berichts, der von der Anfrage abgerufen wird. Anschließend werden die Dimensionen, Messwerte, Filter und Sortierparameter für die Anfrage angezeigt.

    • Die Dimension insightTrafficSourceType unterstützt jetzt SUBSCRIBER als gültigen Wert. Dieser Wert gibt die Videoaufrufe an, die über Feeds auf der YouTube-Startseite oder über die YouTube-Abofunktionen erfolgt sind. Wenn Sie nach dieser Besucherquelle filtern, wird im Feld insightTrafficSourceDetail der Startseitenfeed oder eine andere Seite angegeben, von der aus Aufrufe erfolgt sind.

    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 zur Anzeigenleistung sowie neue Berichte zur Anzeigenleistung. Die Messwerte und Berichte stehen nur YouTube-Content-Partnern zur Verfügung, die am YouTube-Partnerprogramm teilnehmen.

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

      • Die neu unterstützten Messwerte sind unten aufgeführt. Die Liste der Rechteinhaberberichte wurde aktualisiert und enthält nun die Berichte, einschließlich der beiden neuen Berichte, die diese Messwerte unterstützen.

        • earnings: Geschätzte Gesamteinnahmen aus allen von Google verkauften Anzeigenquellen.
        • grossRevenue: Geschätzter Bruttoumsatz von Google- oder DoubleClick-Partnern.
        • primaryAdGrossRevenue: geschätzter Bruttoumsatz, summiert und klassifiziert unter dem primären Anzeigentyp der Videowiedergaben, die im Bericht von Google- oder DoubleClick-Partnern erfasst werden
        • monetizedPlaybacks: Die Anzahl der Wiedergaben, bei denen mindestens eine Anzeigenimpression ausgeliefert wurde.
        • playbackBasedCpm: Geschätzter Bruttoumsatz pro 1.000 Wiedergaben.
        • impressions: Anzahl der verifizierten Anzeigenimpressionen
        • impressionBasedCpm: Geschätzter Bruttoumsatz pro 1.000 Anzeigenimpressionen.

        Hinweis:Ausführliche Informationen finden Sie in den Messwertdefinitionen.

      • Alle Anfragen, über die Einnahmen oder Messwerte zur Anzeigenleistung abgerufen werden, müssen ein Autorisierungstoken senden, das Zugriff auf den neuen Bereich https://www.googleapis.com/auth/yt-analytics-monetary.readonly gewährt.

    • Die API-Dokumentation wurde neu strukturiert, sodass auf verschiedenen Seiten verschiedene Arten von Berichten erläutert werden. Daher gibt es jetzt separate Seiten, auf denen die verschiedenen Arten von Kanalberichten und Rechteinhaberberichten erläutert werden.

    4. Februar 2013

    Dieses Update enthält die folgenden Änderungen:

    • Das Referenzhandbuch der API enthält jetzt einen Beispielabschnitt mit Codebeispielen, die zeigen, wie die API mit den Java-, JavaScript-, Python- und Ruby-Clientbibliotheken aufgerufen wird. Das JavaScript-Codebeispiel ist mit dem Beispiel identisch, das in der Beispielanwendungsdokumentation ausführlich beschrieben wird.

    14. November 2012

    Dieses Update enthält die folgenden Änderungen:

    • Im API-Referenzhandbuch findest du jetzt das APIs Explorer, mit dem du die API aufrufen, die API-Anfrage ansehen und echte Daten in der Antwort abrufen kannst.

    • 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 als Rechteinhaberbericht verfügbar. Auch die Seiten Dimensionen und Messwerte wurden entsprechend aktualisiert.

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

      • Der Detailbericht zur Wiedergabeorte gibt die eingebetteten Player an, die die meisten Aufrufe für ein bestimmtes Video generiert haben. Sie bietet eine detailliertere Ansicht als der Bericht zu Wiedergabeorten, da die URLs identifiziert werden, die den am häufigsten eingebetteten Playern zugeordnet sind.

      • Der Bericht zu Zugriffsquellen gibt die Anzahl der Videoaufrufe an, die von verschiedenen Verweis-URLs stammen.

      • Der Bericht zu den Zugriffsquellendetails gibt die Verweis-URLs an, die die meisten Aufrufe für ein bestimmtes Video und einen bestimmten Zugriffsquellentyp generiert haben. In diesem Bericht sind z. B. die ähnlichen Videos zu sehen, die die meisten Zugriffe auf ein bestimmtes Video generiert haben. Dieser Bericht wird für mehrere Zugriffsquellen unterstützt.

      • Berichte zur Wiedergabezeit geben Aufschluss darüber, wie lange Zuschauer sich deine Inhalte angesehen haben. Die Berichte können Daten für einen bestimmten Zeitraum – Tag, vorherige sieben Tage, vorherige 30 Tage usw. – oder Land zusammenfassen. Wenn in einem Bericht Daten nach Tag oder Land zusammengefasst werden, können Sie auch die durchschnittliche Länge jedes Videoaufrufs sowie den durchschnittlichen Prozentsatz jedes Videos angeben, das sich Nutzer angesehen haben.

    2. Oktober 2012

    Dieses Update enthält die folgenden Änderungen:

    • Die YouTube Analytics API ist jetzt für alle Entwickler verfügbar. Sie können die API für Ihr Projekt ohne Zugriffsanfrage über den Bereich Dienste im APIs console aktivieren.

    • Der neue Abschnitt Erste Schritte enthält die Voraussetzungen und grundlegenden Schritte zum Erstellen einer Anwendung, die YouTube Analytics API verwendet.

    12. September 2012

    Dieses Update enthält die folgenden Änderungen:

    • Im neuen Abschnitt Informationen zur Kontingentnutzung finden Sie Richtlinien zur Optimierung der API-Kontingentnutzung. Der API-Server berechnet für jede Anfrage eine Abfrage, die von Ihrem API-Nutzungskontingent abgezogen wird. Da verschiedene Arten von Berichten sehr unterschiedliche Abfragekosten haben können, sollten Sie Ihr Kontingent effizient nutzen. Ihre Anwendung sollte nur die Messwerte und Daten anfordern, die sie tatsächlich benötigen.

    • Der Abschnitt Zeitliche Dimensionen wurde aktualisiert und erklärt jetzt, dass in diesen Dimensionen angezeigt wird, dass in einem Analytics-Bericht Daten basierend auf einem 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.

      Außerdem wurde der Bereich Verfügbare Berichte aktualisiert, um zu zeigen, dass die API Berichte mit diesen Dimensionen unterstützt.

    • Der Abschnitt Dimensionen für Berichtseinheiten wurde aktualisiert. API-Anfragen zum Abrufen von Berichten des Rechteinhabers müssen Daten nach einer dieser Dimensionen (video, channel oder show) oder einer unterstützten Kombination aus den Dimensionen claimedStatus und uploaderType filtern.

    • Die API unterstützt jetzt zwei neue Sortieroptionen für Top-Video-Berichte. Diese Berichte, die als Kanal- oder Rechteinhaberberichte verfügbar sind, enthalten Messwerte (Aufrufe, Kommentare, „Mag ich“-Bewertungen usw.) für einzelne Länder und schlüsseln diese Messwerte nach Video auf. Du kannst diese Berichte jetzt nach der Anzahl der Nutzer sortieren, die einen Kanal auf der Wiedergabeseite des Videos abonniert oder das Abo dafür beendet haben.

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