Historia wersji

Na tej stronie znajdziesz listę zmian w interfejsach API oraz aktualizacje dokumentacji interfejsu API YouTube do raportowania i YouTube Analytics API. Oba interfejsy API umożliwiają programistom dostęp do danych Statystyk YouTube, ale na różne sposoby. Subskrybuj ten dziennik zmian. Subskrybuj

22 września 2025 r.

Wycofanie raportów, o którym informowaliśmy wcześniej, zostało opóźnione z 30 września 2025 r. na 31 października 2025 r. Poprzednie wersje raportów zaktualizowane pod kątem zmian w liczbie wyświetleń filmów Short będą nadal dostępne do tego czasu, z wyjątkiem raportu o roszczeniach w wersji 1.0 (content_owner_active_claims_a1) i raportu o roszczeniach w wersji 1.1 (content_owner_active_claims_a2), które zostaną wycofane 30 września.

24 czerwca 2025 r.

Zgodnie z zapowiedzią z 26 marca 2025 r. interfejs Bulk Reports API zostanie zaktualizowany w ramach nowej zmiany liczby wyświetleń filmów Short. Wprowadziliśmy te zmiany:

  • Dla każdego raportu, który zawiera wyświetlenia (czyli większości raportów), utworzyliśmy nowe wersje. Wersja każdego raportu, którego dotyczy problem, została zwiększona o 1, np. z a2 na a3.
  • W przypadku filmów Short wyświetlenia będą teraz odzwierciedlać, ile razy rozpoczęto lub ponowiono odtwarzanie filmu Short. W przypadku filmów nic się nie zmienia.
  • Zaktualizowane raporty będą zawierać nową kolumnę engaged_views, która będzie odzwierciedlać poprzednią metodę zliczania wyświetleń.

W przypadku interfejsu Bulk Reports API zmiany te zaczną obowiązywać 30 czerwca 2025 r. Pamiętaj, aby odpowiednio dostosować przetwarzanie raportu.

Poprzednie wersje raportu będą dostępne do 30 września 2025 r. Po 30 września 2025 r. poprzednie wersje zostaną wycofane. Pamiętaj, aby przejść na najnowsze wersje.

Na koniec pamiętaj, aby podczas przetwarzania raportów stosować sprawdzone metody. Dzięki temu unikniesz sytuacji, w której przyszłe zmiany w raportach spowodują przerwanie potoków przetwarzania.

W tabelach poniżej znajdziesz nowe wersje raportów dla każdego typu raportu:

Raporty danych zbiorczych w Statystykach YouTube

Raporty dotyczące kanału – raporty o filmach
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywność użytkownika channel_basic_a2 channel_basic_a3
Aktywność użytkowników według województwa channel_province_a2 channel_province_a3
Miejsca odtwarzania channel_playback_location_a2 channel_playback_location_a3
Źródła wizyt channel_traffic_source_a2 channel_traffic_source_a3
Typ urządzenia i system operacyjny channel_device_os_a2 channel_device_os_a3
Napisy channel_subtitles_a2 channel_subtitles_a3
Połączony channel_combined_a2 channel_combined_a3
Raporty dotyczące kanału – raporty dotyczące playlist
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywność użytkownika playlist_basic_a1 playlist_basic_a2
Aktywność użytkowników według województwa playlist_province_a1 playlist_province_a2
Miejsca odtwarzania playlist_playback_location_a1 playlist_playback_location_a2
Źródła wizyt playlist_traffic_source_a1 playlist_traffic_source_a2
Typ urządzenia i system operacyjny playlist_device_os_a1 playlist_device_os_a2
Połączony playlist_combined_a1 playlist_combined_a2
Raporty właścicieli treści – raporty dotyczące filmów
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywność użytkownika content_owner_basic_a3 content_owner_basic_a4
Aktywność użytkowników według województwa content_owner_province_a2 content_owner_province_a3
Miejsca odtwarzania content_owner_playback_location_a2 content_owner_playback_location_a3
Źródła wizyt content_owner_traffic_source_a2 content_owner_traffic_source_a3
Typ urządzenia i system operacyjny content_owner_device_os_a2 content_owner_device_os_a3
Napisy content_owner_subtitles_a2 content_owner_subtitles_a3
Połączony content_owner_combined_a2 content_owner_combined_a3
Raporty właścicieli treści – raporty dotyczące playlist
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywność użytkownika content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
Aktywność użytkowników według województwa content_owner_playlist_province_a1 content_owner_playlist_province_a2
Miejsca odtwarzania content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Źródła wizyt content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Typ urządzenia i system operacyjny content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Połączony content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
Raporty właściciela treści – raporty o zasobach
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywność użytkownika content_owner_asset_basic_a2 content_owner_asset_basic_a3
Aktywność użytkowników według województwa content_owner_asset_province_a2 content_owner_asset_province_a3
Miejsca odtwarzania filmów content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Źródła wizyt content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Typ urządzenia i system operacyjny content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Połączony content_owner_asset_combined_a2 content_owner_asset_combined_a3

Raporty zarządzane przez system – finansowe (inne niż muzyczne)

Raporty właściciela treści – raporty dotyczące filmów Short (inne niż muzyczne)
Nazwa raportu Poprzednia wersja Najnowsza wersja
Podsumowanie globalnych przychodów z reklam content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Dzienne podsumowanie przychodów z reklam content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Podsumowanie przychodów z reklam w poszczególnych krajach content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Podsumowanie przychodów z reklam content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Raporty zarządzane przez system – dane niefinansowe

Raporty właścicieli treści – raporty o roszczeniach
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywne roszczenia content_owner_active_claims_a2 content_owner_active_claims_a3
Raporty właścicieli treści – raporty o metadanych filmów
Nazwa raportu Poprzednia wersja Najnowsza wersja
Metadane filmu content_owner_video_metadata_a3 content_owner_video_metadata_a4
Raporty właściciela treści – raporty o zasobach
Nazwa raportu Poprzednia wersja Najnowsza wersja
Zasoby content_owner_asset_a2 content_owner_asset_a3
Konflikty dotyczące zasobów content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 kwietnia 2025 r.

Zgodnie z zapowiedzią z 26 marca 2025 r. interfejs Targeted Queries API zostanie zaktualizowany w ramach nowej zmiany w liczeniu wyświetleń filmów Short:

  • W przypadku filmów Short liczba views będzie teraz odzwierciedlać, ile razy rozpoczęto lub ponowiono odtwarzanie filmu Short.
  • Nowy wskaźnik engagedViews będzie odzwierciedlać poprzednią metodę zliczania wyświetleń. engagedViews będzie dostępna we wszystkich raportach razem z views.

W przypadku interfejsu Targeted Queries API zmiany zaczną obowiązywać 30 kwietnia 2025 r. Pamiętaj, aby odpowiednio dostosować zapytania.

Z tej historii zmian dowiesz się, jakie zmiany zostaną wprowadzone w interfejsie Bulk Reports API i kiedy to nastąpi.

22 kwietnia 2025 r.

Zgodnie z informacją z 7 kwietnia 2024 r. wymiar isCurated został wycofany z raportów o kanałach i raportów o playlistach właściciela treści. Od 31 grudnia 2024 r. ten wymiar nie będzie już obsługiwany. Wymiar został usunięty z raportów i dokumentacji.

26 marca 2025 r.

Ta aktualizacja zawiera następującą zmianę związaną z interfejsami API do raportowania i Statystyk YouTube:

Od 31 marca 2025 r. YouTube zmieni sposób zliczania wyświetleń filmów Short. W przeszłości wyświetlenie filmu Short było zliczane po odtworzeniu go przez określoną liczbę sekund. Wyświetlenia będą teraz odzwierciedlać, ile razy rozpoczęto lub ponowiono odtwarzanie filmu Short, bez minimalnego czasu oglądania. Więcej informacji

W interfejsach API Statystyk YouTube (zapytania kierowane) i do raportowania (raporty zbiorcze) wprowadzimy te zmiany:

  • W przypadku filmów Short views zliczamy, ile razy rozpoczęto lub ponowiono odtwarzanie filmu Short.
  • Udostępnimy nowy wskaźnik engagedViews, który będzie odzwierciedlać poprzednią metodę zliczania wyświetleń.
  • Jeśli jesteś właścicielem kanału lub masz uprawnienia do dostępu do danych kanału, możesz wysyłać zapytania zarówno o zaktualizowane, jak i zaangażowane wyświetlenia.

Raporty Zapytania kierowane zostaną zaktualizowane do 30 kwietnia, a raporty zbiorcze – do 30 czerwca. Do tego czasu wyświetlenia będą liczone według starej metodologii. Wyświetlenia filmów Short i kanału nie będą zgodne ze statystykami w Studio.

Dodatkowo wcześniej zapowiedziane wycofanie raportu Codzienne roszczenia (wersja 1.0) zostało opóźnione.

Z tej historii zmian dowiesz się, kiedy wprowadzane są zmiany w interfejsach API.

3 marca 2025 r.

Ta aktualizacja zawiera następującą zmianę dotyczącą interfejsu YouTube Reporting API:

Uwaga: to jest ogłoszenie o wycofaniu.

Raport Codzienne roszczenia (wersja 1.0) został wycofany dla partnerów. Po 30 kwietnia 2025 r. nie będzie już obsługiwana. Definicja tego raportu została odpowiednio zaktualizowana. Zamiast niego użyj najnowszego raportu Dzienny raport roszczeń.

15 listopada 2024 r.

Uwaga: poniższa zmiana obowiązuje od 18 listopada 2024 r.

Zaktualizowaliśmy dokumentację interfejsu YouTube Analytics (zapytania kierowane), aby poinformować, że w przypadku raportów o źródłach wizyt metoda reports.query interfejsu API zwraca teraz błąd, jeśli iloczyn liczby filmów, których dotyczy zapytanie i liczby dni w zakresie dat przekracza 50 000. Na przykład zapytanie, które pobiera dane dotyczące 500 identyfikatorów filmów, może żądać danych z maksymalnie 100 dni.

Ta zmiana wpływa na raporty dotyczące zarówno kanałów, jak i właścicieli treści.

Aby zmniejszyć liczbę wierszy zwracanych przez żądanie, podziel zapytanie na kilka zapytań, które określają mniejszą liczbę filmów lub krótsze zakresy dat. Z reguły raporty zbiorcze są zalecane w przypadku dużych zbiorów danych.

6 maja 2024 r.

Interfejs YouTube Analytics API (kierowane zapytania) obsługuje 3 nowe raporty dotyczące kanałów:

Poza tym ulepszyliśmy raport Utrzymanie uwagi odbiorców, dodając do niego 3 nowe dane:

7 kwietnia 2024 r.

W interfejsie YouTube Analytics API (kierowane zapytania) wprowadziliśmy kilka zmian związanych z raportami dotyczącymi playlist właścicieli treści. Są to te same zmiany, które zostały ogłoszone 19 stycznia 2024 r. i dotyczą raportów o playlistach na kanale.

Poniższy wpis w historii zmian zawiera niemal te same informacje co wpis z 19 stycznia 2024 r. Pamiętaj jednak, że raporty dotyczące playlist właścicieli treści będą obsługiwać wymiar isCurated do 31 grudnia 2024 r., a raporty dotyczące playlist kanału – do 30 czerwca 2024 r.

  • Uwaga: to jest ogłoszenie o wycofaniu.

    Wymiar isCurated został wycofany w przypadku raportów dotyczących playlist właścicieli treści. Po 31 grudnia 2024 roku nie będzie już obsługiwana. Definicja tego wymiaru została odpowiednio zaktualizowana.

    Aby zachować zgodność wsteczną po usunięciu wymiaru isCurated, musisz też zaktualizować kod, aby pobierać dane playlistViews zamiast danych views tylko w przypadku raportów dotyczących playlist. viewsDane są nadal obsługiwane w raportach dotyczących playlist, ale mają inne znaczenie, więc interfejs API będzie nadal zwracać dane, jeśli nie zaktualizujesz nazwy danych. Oczywiście możesz zmodyfikować aplikację, aby pobierała i wyświetlała zarówno views, jak i playlistViews.

    Oprócz wymiaru isCurated w nowych raportach nie są już obsługiwane te funkcje interfejsu API:

    • Filtry lokalizacji, takie jak continent i subcontinent, nie są obsługiwane w przypadku nowych raportów o playlistach na kanale.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w przypadku nowych raportów dotyczących playlist na kanale. Te dane nie były dostępne w YouTube Studio, więc ta zmiana dostosowuje funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach o playlistach na kanale. Te filtry nie były dostępne w YouTube Studio, więc ta zmiana dostosowuje funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Zaktualizowaliśmy sekcję Raporty dotyczące playlist w dokumentacji raportów dla właścicieli treści, aby dokładniej wyjaśnić typy danych obsługiwanych w raportach dotyczących playlist:

    • Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach, które są zbierane dla wszystkich filmów na playlistach właściciela treści, które są również jego własnością. Zagregowane dane o filmach są obsługiwane tylko w przypadku żądań interfejsu API, które nie używają wymiaru isCurated.
    • Dane na playliście odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane obejmują również wyświetlenia filmów, które nie należą do Ciebie, ale znajdują się na playliście, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • W sekcji Obsługiwane dane dotyczące playlist znajdziesz zbiorcze dane filmów i dane dotyczące playlist, które są obsługiwane w raportach o playlistach.

  • W przypadku raportów dotyczących playlist właścicieli treści obsługiwane są te nowe dane na playliście: Pamiętaj, że te dane są obsługiwane tylko wtedy, gdy żądanie API dotyczące pobierania raportów nie używa wymiaru isCurated. Definicje poszczególnych rodzajów danych znajdziesz w dokumentacji rodzajów danych:

  • Zachowanie danych views zależy teraz od tego, czy w żądaniu interfejsu API, które pobrało raport o playlistach, użyto wymiaru isCurated:

    • Gdy żądanie zawiera wymiar isCurated, dane views są danymi dotyczącymi playlisty, które wskazują, ile razy filmy były wyświetlane w kontekście playlist właściciela treści.
    • Gdy żądanie nie zawiera wymiaru isCurated, dane views to zagregowane dane dotyczące filmów, które określają łączną liczbę odtworzeń filmów na playlistach właściciela treści, niezależnie od tego, czy odtworzenia te miały miejsce w kontekście playlisty. Łączna suma obejmuje tylko wyświetlenia filmów, które należą do właściciela treści powiązanego z kanałem, do którego należy playlista.

      W tych raportach, które nie korzystają z wymiaru isCurated, dane playlistViews wskazują, ile razy filmy zostały wyświetlone w kontekście playlisty. Ta wartość obejmuje wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W dokumentacji raportów właściciela treści dotyczącej każdego raportu o playlistach znajdują się teraz tabele z obsługiwanymi danymi w tym raporcie w zależności od tego, czy żądanie API zawiera wymiar isCurated. Przykład znajdziesz w sekcji definiującej raporty dotyczące playlisty oparte na czasie.

19 stycznia 2024 r.

W interfejsie YouTube Analytics API (kierowane zapytania) wprowadziliśmy kilka zmian związanych z raportami dotyczącymi playlist kanału. Aktualizacje obejmują wycofany wymiar oraz kilka nowych i zaktualizowanych rodzajów danych:

  • Uwaga: to jest ogłoszenie o wycofaniu.

    Wymiar isCurated został wycofany w przypadku raportów o kanałach. Po 30 czerwca 2024 r. nie będzie już obsługiwana. Definicja tego wymiaru została odpowiednio zaktualizowana.

    Aby zachować zgodność wsteczną po usunięciu wymiaru isCurated, musisz też zaktualizować kod, aby pobierać dane playlistViews zamiast danych views tylko w przypadku raportów dotyczących playlist. viewsDane są nadal obsługiwane w raportach dotyczących playlist, ale mają inne znaczenie, więc interfejs API będzie nadal zwracać dane, jeśli nie zaktualizujesz nazwy danych. Oczywiście możesz zmodyfikować aplikację, aby pobierała i wyświetlała zarówno views, jak i playlistViews.

    Oprócz wymiaru isCurated w nowych raportach nie są już obsługiwane te funkcje interfejsu API:

    • Filtry lokalizacji, takie jak continent i subcontinent, nie są obsługiwane w przypadku nowych raportów o playlistach na kanale.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w przypadku nowych raportów dotyczących playlist na kanale. Te dane nie były dostępne w YouTube Studio, więc ta zmiana dostosowuje funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach o playlistach na kanale. Te filtry nie były dostępne w YouTube Studio, więc ta zmiana dostosowuje funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Zaktualizowaliśmy sekcję raportów dotyczących playlist w dokumentacji raportów o kanale, aby dokładniej wyjaśnić typy danych obsługiwanych w raportach dotyczących playlist:

    • Zbiorcze dane filmów zawierają dane o aktywności użytkowników i wyświetleniach, które są agregowane dla wszystkich filmów na playlistach kanału, które są też własnością tego kanału. Zagregowane dane o filmach są obsługiwane tylko w przypadku żądań interfejsu API, które nie używają wymiaru isCurated.
    • Dane na playliście odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane obejmują również wyświetlenia filmów, które nie należą do Ciebie, ale znajdują się na playliście, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • W sekcji Obsługiwane dane dotyczące playlist znajdziesz zbiorcze dane filmów i dane dotyczące playlist, które są obsługiwane w raportach o playlistach.

  • W raportach dotyczących playlist kanałów obsługiwane są te nowe dane na playliście: Te dane nie są jeszcze obsługiwane w raportach właścicieli treści. Pamiętaj, że te dane są obsługiwane tylko wtedy, gdy żądanie API dotyczące pobierania raportów nie używa wymiaru isCurated. Definicje poszczególnych rodzajów danych znajdziesz w dokumentacji rodzajów danych:

  • Zachowanie danych views zależy teraz od tego, czy w żądaniu interfejsu API, które pobrało raport o playlistach, użyto wymiaru isCurated:

    • Gdy żądanie zawiera wymiar isCurated, dane views są danymi na playliście, które wskazują liczbę wyświetleń filmów w kontekście playlist kanału.
    • Gdy żądanie nie zawiera wymiaru isCurated, dane views to zagregowane dane dotyczące filmu, które określają łączną liczbę wyświetleń tego filmu na playlistach kanału, niezależnie od tego, czy miały one miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko wyświetlenia filmów, które należą do kanału będącego właścicielem playlisty.

      W tych raportach, które nie korzystają z wymiaru isCurated, dane playlistViews wskazują, ile razy filmy zostały wyświetlone w kontekście playlisty. Ta wartość obejmuje wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W przypadku każdego raportu dotyczącego playlist dokumentacja raportów o kanale zawiera teraz tabele z obsługiwanymi rodzajami danych w danym raporcie w zależności od tego, czy żądanie API zawiera wymiar isCurated. Przykład znajdziesz w sekcji definiującej raporty dotyczące playlisty oparte na czasie.

4 grudnia 2023 r.

Zaktualizowaliśmy interfejs YouTube Analytics API (kierowane zapytania), aby połączyć 2 wartości wymiaru insightTrafficSourceType. Wcześniej wymiar rozróżniał filmy odtwarzane w ramach playlisty (PLAYLIST) i wyświetlenia pochodzące ze strony, na której znajdują się wszystkie filmy z playlisty (YT_PLAYLIST_PAGE). W przyszłości oba rodzaje wyświetleń będą powiązane z wartością wymiaru PLAYLIST.

15 grudnia 2022 r.

Interfejs YouTube Analytics API (kierowane zapytania) obsługuje 2 nowe wymiary i 1 nowy raport:

  • Nowy raport zawiera dane o aktywności użytkowników według miast. Ten raport jest dostępny w przypadku kanałów i właścicieli treści. Ten raport zawiera nowy wymiar city, który określa szacunkową lokalizację użytkownika (miasto), w której miała miejsce aktywność.

  • Nowy wymiar creatorContentType określa typ treści w YouTube, który jest powiązany z danymi aktywności użytkownika w wierszu danych. Obsługiwane wartości to LIVE_STREAM, SHORTS, STORY i VIDEO_ON_DEMAND.

    Wymiar creatorContentType jest obsługiwany jako wymiar opcjonalny we wszystkich raportach o filmach na kanale i właściciela treści.

  • Przewodnik przykładowych żądań interfejsu YouTube Analytics API zawiera teraz przykłady dla obu nowych wymiarów.

  • Odniesienia do wymiarów 7DayTotals i 30DayTotals zostały usunięte z dokumentacji. Wycofanie tych wymiarów zostało ogłoszone w październiku 2019 r.

26 sierpnia 2022 r.

Interfejs API Statystyk YouTube (zapytania kierowane) i interfejs API YouTube do raportowania (raporty zbiorcze) obsługują nową wartość szczegółową źródła wizyt:

  • W interfejsie YouTube Analytics API (zapytania kierowane) jeśli wartość wymiaru insightTrafficSourceType to SUBSCRIBER, wartość insightTrafficSourceDetail można ustawić na podcasts, co oznacza, że ruch pochodzi ze strony docelowej Podcastów.
  • Jeśli w interfejsie YouTube Reporting (raporty zbiorcze) wartość wymiaru traffic_source_type to 3, wartość traffic_source_detail można ustawić na podcasts, co oznacza, że ruch pochodzi ze strony docelowej podcastów.

11 lutego 2022 r.

Zestaw prawidłowych wartości wymiaru gender zmieni się 11 sierpnia 2022 r. lub później. Może to być zmiana w implementacji interfejsu API, która nie jest zgodna wstecznie. Zgodnie z sekcją Zmiany niezgodne wstecznie Warunków usługi YouTube API ogłaszamy tę zmianę 6 miesięcy przed jej wejściem w życie. Aby zapewnić płynne przejście na nowy zestaw wartości, zaktualizuj implementację interfejsu API przed 11 sierpnia 2022 r.

Wprowadzane zmiany:

  • W interfejsie YouTube Analytics API (kierowane zapytania) wymiar gender obecnie obsługuje 2 wartości: female i male. Od 11 sierpnia 2022 r. ten wymiar będzie obsługiwać 3 wartości: female, male i user_specified.
  • W interfejsie API YouTube do raportowania (raporty zbiorcze) wymiar gender obecnie obsługuje 3 wartości: FEMALE, MALE i GENDER_OTHER. 11 sierpnia 2022 r. lub później zestaw obsługiwanych wartości zmieni się na FEMALE, MALE i USER_SPECIFIED.

9 lutego 2022 r.

13 grudnia 2021 r. zaktualizowaliśmy 2 rodzaje danych, aby wykluczyć z nich ruch pochodzący z zapętlonych klipów. Ta zmiana dotyczy zarówno interfejsu YouTube Analytics API (kierowane zapytania), jak i interfejsu API YouTube do raportowania (raporty zbiorcze).

2 lutego 2022 r.

Interfejs YouTube Reporting API (raporty zbiorcze) obsługuje nową wartość wymiaru źródła wizyt, która wskazuje, że wyświetlenia pochodzą z przekierowań na żywo:

  • W interfejsie API YouTube do raportowania (raporty zbiorcze) wymiar traffic_source_type obsługuje wartość 28.

W przypadku tego typu źródła wizyt wymiar traffic_source_detail określa identyfikator kanału, z którego pochodzi widz.

23 września 2020 r.

Interfejs YouTube Analytics API (kierowane zapytania) i interfejs YouTube Reporting API (raporty zbiorcze) obsługują nową wartość wymiaru źródła wizyt, która wskazuje, że widz został przekierowany przez przesunięcie palcem w górę w trakcie oglądania filmu Short w YouTube:

  • W interfejsie YouTube Analytics API (kierowane zapytania) wymiar insightTrafficSourceType obsługuje wartość SHORTS.
  • W interfejsie API YouTube do raportowania (raporty zbiorcze) wymiar traffic_source_type obsługuje wartość 24.

Wymiar szczegółów źródła wizyt –insightTrafficSourceDetailw interfejsie YouTube Analytics API lubtraffic_source_detailw interfejsie YouTube Reporting API – nie jest wypełniany w przypadku tego nowego typu źródła wizyt.

20 lipca 2020 r.

Ta aktualizacja obejmuje 2 zmiany, które mają wpływ na interfejs YouTube Analytics API (kierowane zapytania):

  • Maksymalny rozmiar grupy raportowania w Statystykach YouTube został zwiększony z 200 do 500 elementów.
  • Parametr reports.query metody filters określa listę filtrów, które powinny być stosowane podczas pobierania danych Statystyk YouTube. Parametr umożliwia podawanie wielu wartości w przypadku filtrów video, playlist i channel. Maksymalna liczba identyfikatorów, które można podać w przypadku tych filtrów, wzrosła z 200 do 500.

13 lutego 2020 r.

Ta aktualizacja zawiera następujące zmiany dotyczące interfejsu YouTube Analytics API (kierowane zapytania) i interfejsu API YouTube do raportowania (raporty zbiorcze). Więcej informacji o tych zmianach znajdziesz w Centrum pomocy YouTube.

W obu interfejsach API zmienia się zestaw możliwych wartości szczegółów źródła wizyt w przypadku powiadomień. W zapytaniach kierowanych powiadomienia są raportowane jako insightTrafficSourceType=NOTIFICATION. W raportach zbiorczych powiadomienia są oznaczane jako traffic_source_type=17.

Nowe wartości dzielą powiadomienia dotyczące przesłanych filmów i transmisji na żywo, które wcześniej były raportowane jako uploaded, na 2 kategorie:

  • uploaded_push – wyświetlenia pochodzące z powiadomień push wysłanych do subskrybentów po przesłaniu filmu.
  • uploaded_other – wyświetlenia pochodzące z powiadomień innych niż push, np. e-maili lub powiadomień w skrzynce odbiorczej, wysyłanych do subskrybentów po przesłaniu filmu.

Te wartości są zwracane w przypadku zakresu dat rozpoczynającego się 13 stycznia 2020 r.

Przypominamy też, że te wartości nie reprezentują samych powiadomień, ale źródła wizyt, które wygenerowały określone wyświetlenia w YouTube. Jeśli na przykład wiersz raportu zawiera wartości views=3, traffic_source_type=17 (NOTIFICATION) i traffic_source_detail=uploaded_push, oznacza to, że 3 wyświetlenia pochodzą od widzów, którzy kliknęli powiadomienia push wysłane po przesłaniu filmu.

15 października 2019 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu YouTube Analytics API (kierowane zapytania):

  • Uwaga: to jest ogłoszenie o wycofaniu.

    YouTube wycofuje obsługę wymiarów 7DayTotals i 30DayTotals. Do 15 kwietnia 2020 r. możesz nadal pobierać dane za pomocą tych wymiarów. Po tej dacie próby pobrania raportów z użyciem wymiaru 7DayTotals lub 30DayTotals będą zwracać błąd.

    Pamiętaj, że użytkownicy mogą odtworzyć niektóre dane dla tych wymiarów, wysyłając zapytania z użyciem wymiaru day i zbierając lub wyprowadzając dane z okresów 7- lub 30-dniowych. Na przykład:

    • Liczbę wyświetleń w 7-dniowym okresie można obliczyć, sumując liczbę wyświetleń z każdego dnia tego okresu.
    • Wartość viewerPercentage za okres 7 dni można obliczyć, mnożąc liczbę wyświetleń w każdym dniu przez wartość viewerPercentage w tym dniu, aby uzyskać liczbę widzów, którzy byli zalogowani podczas oglądania filmu w tym dniu. Następnie można dodać liczbę zalogowanych widzów z całego okresu i podzielić ją przez łączną liczbę wyświetleń w tym okresie, aby uzyskać wartość viewerPercentage dla całego okresu.
    • Nie można obliczyć liczby unikalnych widzów w ciągu 7 dni, ponieważ ten sam widz może być liczony jako unikalny widz w różnych dniach. Zamiast wymiaru 30DayTotals możesz jednak użyć wymiaru month, aby ekstrapolować dane o liczbie unikalnych widzów w ciągu 30 dni. Pamiętaj, że wymiar month odnosi się do miesięcy kalendarzowych, a wymiar 30DayTotals oblicza 30-dniowe okresy na podstawie określonej daty rozpoczęcia i zakończenia.

27 czerwca 2019 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu YouTube Analytics API (kierowane zapytania):

  • Wersja 1 interfejsu API została już całkowicie wycofana, dlatego zaktualizowaliśmy dokumentację, aby usunąć odniesienia do tej wersji, w tym powiadomienie o wycofaniu i przewodnik migracji wyjaśniający, jak przejść na wersję 2.

1 listopada 2018 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu YouTube Analytics API (kierowane zapytania):

  • Wersja 1 interfejsu API została wycofana. Jeśli jeszcze tego nie zrobiono, jak najszybciej zaktualizuj klienty interfejsu API, aby korzystały z wersji 2 interfejsu API. Pozwoli to zminimalizować zakłócenia w działaniu usługi. Więcej informacji znajdziesz w przewodniku po migracji.

    Harmonogram wycofania został pierwotnie ogłoszony 26 kwietnia 2018 r.

17 września 2018 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu YouTube Analytics API (kierowane zapytania):

  • W nowej sekcji anonimizacja danych w dokumencie z omówieniem modelu danych wyjaśniamy, że niektóre dane w Statystykach YouTube są ograniczone, ponieważ nie przekraczają one odpowiednich progów. Może się to zdarzyć w różnych sytuacjach. W praktyce oznacza to, że raport może nie zawierać wszystkich danych (lub żadnych danych), jeśli:

    1. film lub kanał ma ograniczony ruch w określonym okresie,

      lub

    2. wybrano filtr lub wymiar, np. źródło wizyt lub kraj, w przypadku których wartości nie osiągnęły określonego progu.

    W nowej sekcji omawiamy też rodzaje danych, które mogą być ograniczone w raportach Statystyk YouTube.

  • Dokumenty raporty dotyczące kanału i raporty dotyczące właściciela treści zostały zaktualizowane, aby odzwierciedlać fakt, że dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w przypadku raportów dotyczących lokalizacji odtwarzania, źródła wizyt i typu urządzenia lub systemu operacyjnego.

18 czerwca 2018 r.

Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Analytics API (kierowane zapytania):

  • Wymagania dotyczące zakresu w przypadku tych metod uległy zmianie:
    • Żądania wysyłane do metody reports.query muszą mieć dostęp do zakresu https://www.googleapis.com/auth/youtube.readonly.
    • Żądania wysyłane do metody groupItems.list muszą mieć dostęp do jednego z tych elementów:
      • zakres https://www.googleapis.com/auth/youtube
        lub
      • https://www.googleapis.com/auth/youtube.readonly zakres
        i
        https://www.googleapis.com/auth/yt-analytics.readonly zakres

      Pierwsza opcja używa jednego zakresu, który jest zakresem do odczytu i zapisu, a druga opcja używa dwóch zakresów tylko do odczytu.

23 maja 2018 r.

Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Analytics API (kierowane zapytania):

  • W sekcji Omówienie interfejsu API dodaliśmy nową sekcję Dane zbiorcze i usunięte elementy, w której wyjaśniamy, jak odpowiedzi interfejsu API obsługują dane powiązane z usuniętymi zasobami, takimi jak filmy, playlisty czy kanały.
  • Sekcja Najlepsze praktyki w omówieniu interfejsu API została zaktualizowana, aby przypomnieć, że możesz używać YouTube Data API do pobierania dodatkowych metadanych zasobów zidentyfikowanych w odpowiedziach YouTube Analytics API. Zgodnie z zasadami dla deweloperów usług YouTube API (sekcje III.E.4.b–III.E.4.d) klienci API muszą usunąć lub odświeżyć przechowywane metadane zasobów z tego interfejsu API po 30 dniach.

22 maja 2018 r.

Ta aktualizacja zawiera następujące zmiany dotyczące interfejsu YouTube Reporting API (raporty zbiorcze):

  • Poniższe zmiany mają wejść w życie w lipcu 2018 r. Nowe zasady obowiązują na całym świecie w przypadku wszystkich raportów i zadań raportowania.

    • Po wprowadzeniu tej zmiany większość raportów API, w tym raporty dotyczące wypełniania, będzie dostępna przez 60 dni od momentu ich wygenerowania. Raporty zawierające dane historyczne będą jednak dostępne przez 30 dni od momentu ich wygenerowania.

      Przed tym ogłoszeniem wszystkie raporty API były dostępne przez 180 dni od momentu ich wygenerowania. Gdy ta zmiana zasad wejdzie w życie, raporty z danymi historycznymi starsze niż 30 dni nie będą już dostępne w interfejsie API. Nie będzie też dostępu do pozostałych raportów starszych niż 60 dni. W związku z tym w dokumentacji podano, że raporty utworzone przed zmianą zasad będą dostępne przez maksymalnie 180 dni.

    • Po zmianie, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty od tego dnia, obejmujące 30-dniowy okres poprzedzający czas zaplanowania zadania. Przed wprowadzeniem tej zmiany, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty obejmujące okres 180 dni poprzedzających czas zaplanowania zadania.

  • Zaktualizowaliśmy sekcję Sprawdzone metody, aby przypomnieć Ci, że możesz używać interfejsu YouTube Data API do pobierania dodatkowych metadanych zasobów zidentyfikowanych w raportach. Zgodnie z zasadami dla deweloperów usług YouTube API (sekcje III.E.4.b–III.E.4.d) klienci API muszą usunąć lub odświeżyć przechowywane metadane zasobów z tego interfejsu API po 30 dniach.

  • Zaktualizowaliśmy sekcję Charakterystyka raportu, aby poinformować, że chociaż dane w raporcie nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. lub późniejszego nie będą zawierać żadnych odniesień do zasobów YouTube, które zostały usunięte co najmniej 30 dni przed datą wygenerowania raportu.

  • W sekcji danych historycznych w omówieniu interfejsu API dodaliśmy informację, że gdy zaplanujesz nowe zadanie raportowania, raporty historyczne są zwykle publikowane w ciągu kilku dni. Wcześniej w dokumentacji podawaliśmy, że udostępnienie takich raportów może potrwać do 30 dni.

  • Sekcja Dane uzupełniające w omówieniu interfejsu API została zaktualizowana, aby dokładniej zdefiniować dane uzupełniające jako zbiór danych, który zastępuje wcześniej przesłany zbiór.

26 kwietnia 2018 r.

Wersja 2 interfejsu YouTube Analytics (kierowane zapytania) API (v2) jest już publicznie dostępna. Poniższa lista zawiera zmiany w usługach i dokumentacji związane z nową wersją interfejsu API:

  • Interfejs API w wersji 2 jest niemal identyczny z interfejsem API w wersji 1. Prawdopodobnie jednak konieczne będzie zaktualizowanie kodu, aby odzwierciedlić zmiany wymienione poniżej. Wszystkie te zmiany zostały szczegółowo opisane w nowym przewodniku po migracji.

    • Wersja interfejsu API zmieniła się z v1 na v2.
    • Podstawowy adres URL żądań interfejsu API został zmieniony z https://www.googleapis.com/youtube/analytics/v1 na https://youtubeanalytics.googleapis.com/v2.
    • Kilka parametrów metody reports.query ma teraz nowe nazwy. W szczególności nazwy parametrów zawierające łączniki, np. end-date w interfejsie API w wersji 1, w interfejsie API w wersji 2 używają notacji camel case (endDate) zamiast łączników. Dzięki tej zmianie nazwy parametrów w całym interfejsie API będą spójne, ponieważ metody interfejsu API służące do tworzenia grup i zarządzania nimi już używały notacji camel case w przypadku nazw parametrów.
    • Interfejs API w wersji 2 nie obsługuje żądań zbiorczych wysyłanych do globalnego punktu końcowego HTTP Google (www.googleapis.com/batch). Jeśli wysyłasz żądania zbiorcze w interfejsie API w wersji 2, musisz używać punktu końcowego https://youtubeanalytics.googleapis.com/v2.

    Poza tym interfejs API w wersji 2 nie obsługuje kilku funkcji z wersji 1:

    • Metoda reports.query nie obsługuje już parametrów żądania alt, quotaUser i userIp.
    • Interfejs API w wersji 2 nie udostępnia punktu końcowego żądań zbiorczych, który obsługuje partie składające się z żądań do różnych interfejsów API. (Partia może jednak zawierać żądania do różnych metod tego samego interfejsu API). Wycofanie nie dotyczy tylko interfejsu YouTube Analytics API, ponieważ Google wycofuje globalny punkt końcowy operacji grupowych we wszystkich swoich interfejsach API.
    • Interfejs API w wersji 2 nie obsługuje protokołu JSON-RPC, który był obsługiwany w interfejsie API w wersji 1. Ponownie podkreślamy, że wycofanie nie dotyczy wyłącznie interfejsu YouTube Analytics API.

  • Uwaga: to jest ogłoszenie o wycofaniu.

    Wersja 1 interfejsu API (v1) jest już wycofana i będzie obsługiwana do 31 października 2018 r. Po tej dacie wszystkie żądania wysyłane do interfejsu API w wersji 1 przestaną działać. Aby uniknąć przerw w dostępie do danych YouTube Analytics za pomocą interfejsu API, zaktualizuj go do wersji 2 najpóźniej do 31 października 2018 r.

21 lutego 2018 r.

Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Analytics API (kierowane zapytania):

  • Raporty dotyczące danych demograficznych widzów, które zawierają zagregowane statystyki oglądania na podstawie wieku i płci widzów, nie obsługują już wymiaru youtubeProduct, który identyfikuje usługę YouTube, w której wystąpiła aktywność użytkownika.

18 stycznia 2018 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • Wymiar operating_system, który identyfikuje system oprogramowania urządzenia, na którym wystąpiły wyświetlenia, obsługuje teraz tę wartość:
      • 25: KaiOS

  • YouTube Analytics API (kierowane zapytania)

20 grudnia 2017 r.

Aktualizacja ta obejmuje 2 zmiany dotyczące interfejsu YouTube API do raportowania:

  • Serwer interfejsu API obsługuje teraz kompresję gzip w przypadku żądań pobierania raportów. Pamiętaj, że kompresja gzip nie jest obsługiwana w przypadku innych typów żądań interfejsu API. Włączenie kompresji gzip zmniejsza przepustowość potrzebną do obsługi każdej odpowiedzi interfejsu API. Dekompresja odpowiedzi interfejsu API wymaga dodatkowego czasu pracy procesora, jednak korzyść w postaci mniejszego zużycia zasobów sieciowych zwykle przeważa nad tym kosztem.

    Aby otrzymać odpowiedź zakodowaną w formacie gzip, ustaw nagłówek żądania HTTP Accept-Encoding na gzip, jak pokazano w tym przykładzie:

    Accept-Encoding: gzip

    Ta funkcja jest opisana w omówieniu interfejsu API oraz w definicji właściwości downloadUrl zasobu report.

  • W dokumentacji wymiarów age group i gender wprowadziliśmy poprawki, aby pokazywać rzeczywiste wartości zwracane przez interfejs API w przypadku tych wymiarów. Pamiętaj, że jest to korekta w dokumentacji, która nie odzwierciedla zmiany w funkcjonalności ani działaniu interfejsu API. Zmieniły się te wartości:

    • Wartości wymiaru age_group są zapisywane wielkimi literami, zawierają podkreślenia między słowem AGE a liczbami w grupie wiekowej oraz używają podkreśleń zamiast łączników. W związku z tym wartości takie jak age13-17 i age18-24 zostały poprawione odpowiednio na AGE_13_17 i AGE_18_24.
    • Wartości wymiaru gender są zapisywane wielkimi literami. Wartości female, male i gender_other zostały skorygowane do FEMALE, MALE i GENDER_OTHER.

10 sierpnia 2017 r.

10 sierpnia 2016 r. w tej dokumentacji ogłosiliśmy wycofanie wskaźnika earnings z YouTube Analytics API. (Jednocześnie interfejs API zyskał obsługę nowych danych o nazwie estimatedRevenue, które dostarczają tych samych informacji).

Ponieważ earnings były podstawowymi danymi, były one obsługiwane przez rok od daty ogłoszenia. Ten roczny okres dobiegł już jednak końca, więc dane earnings nie są już obsługiwane. W rezultacie żądania do interfejsu API, które określają parametr earnings, zwracają teraz kod odpowiedzi HTTP 400. Jeśli nie masz jeszcze zaktualizowanej aplikacji, aby używać metryki estimatedRevenue zamiast metryki earnings, zrób to jak najszybciej.

Dokumentacja interfejsu API została zaktualizowana, aby usunąć pozostałe odniesienia do rodzaju danych earnings.

6 lipca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API (kierowane zapytania)

    • Zaktualizowaliśmy dokumentację interfejsu API, aby odzwierciedlała fakt, że odpowiedzi interfejsu API zawierają dane do ostatniego dnia w zakresie dat, dla którego dostępne są wszystkie dane, o które pytasz.

      Jeśli na przykład w żądaniu podano datę zakończenia 5 lipca 2017 r., a wartości wszystkich żądanych danych są dostępne tylko do 3 lipca 2017 r., będzie to ostatnia data, dla której dane zostaną uwzględnione w odpowiedzi. (Dotyczy to nawet sytuacji, gdy dane niektórych rodzajów informacji są dostępne za 4 lipca 2017 r.).

    • Wymiar adType obsługuje teraz wartość reservedBumperInstream, która odnosi się do niemożliwej do pominięcia reklamy wideo trwającej do 6 sekund, która wyświetla się, zanim rozpocznie się odtwarzanie filmu. Format reklamy jest identyczny jak w przypadku reklamy auctionBumperInstream, ale ten typ odnosi się do reklam sprzedawanych w systemie rezerwacji, a nie w ramach aukcji.

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • Wymiar ad_type obsługuje teraz wartość 20, która odnosi się do reklam typu bumper sprzedawanych na zasadach rezerwacji. Bumpery reklamowe to reklamy wideo niemożliwe do pominięcia, które trwają do 6 sekund i muszą być wyświetlone, zanim rozpocznie się odtwarzanie filmu. Pamiętaj, że wartość 19 w przypadku tego wymiaru odnosi się też do reklam typu bumper sprzedawanych na aukcji, a nie w systemie rezerwacji.

    • Zadania raportowania dotyczące tych raportów interfejsu YouTube Reporting API zostały usunięte:

      • 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

      Te typy raportów zostały wycofane 15 września 2016 r., a po 15 grudnia 2016 r. nie były już generowane. Wcześniej wygenerowane raporty były dostępne przez 180 dni od momentu ich wygenerowania. Dlatego niektóre raporty były dostępne jeszcze 15 czerwca 2017 r. Jednak ponieważ raporty nie są już dostępne, nie są też potrzebne powiązane z nimi zadania.

24 maja 2017 r.

Wszystkie zadania raportowania dotyczące tych raportów interfejsu YouTube Reporting API zostały usunięte:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Te typy raportów zostały ogłoszone jako wycofane 22 czerwca 2016 r., a po 22 września 2016 r. nie były już generowane. Wcześniej wygenerowane raporty były dostępne przez 180 dni od momentu ich wygenerowania. Dlatego niektóre raporty były dostępne jeszcze 22 marca 2017 roku. Jednak ponieważ raporty nie są już dostępne, nie są też potrzebne powiązane z nimi zadania.

22 maja 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • Wymiar sharing_service, który identyfikuje usługę używaną do udostępniania filmów, obsługuje teraz te wartości:
      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Dodatkowo w dokumentacji zaktualizowaliśmy nazwę używaną do identyfikowania wartości 52 na Kakao (Kakao Talk), aby wyraźniej odróżnić ją od wartości 73 (Kakao Story). Ta zmiana nie odzwierciedla żadnych zmian w działaniu interfejsu API ani w klasyfikacji filmów udostępnianych w tych usługach.

  • YouTube Analytics API (kierowane zapytania)

    • Wymiar sharingService obsługuje teraz te wartości:
      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 marca 2017 r.

Właściciele kanałów, którzy mają dostęp do danych o przychodach w Statystykach YouTube w Studio twórców, mogą teraz uzyskać te dane również za pomocą YouTube Analytics API:

17 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

3 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • Definicja wymiaru date została poprawiona. Wartość wymiaru odnosi się do okresu rozpoczynającego się o godzinie 00:00 czasu pacyficznego i kończącego się o godzinie 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny to UTC-7 lub UTC-8.

      Chociaż daty zwykle reprezentują okres 24-godzinny, daty, w których zegary są przestawiane do przodu, reprezentują okres 23-godzinny, a daty, w których zegary są przestawiane do tyłu, reprezentują okres 25-godzinny. (Wcześniej w dokumentacji podawano, że każda data reprezentuje unikalny 24-godzinny okres, a czas pacyficzny to zawsze UTC-8).

      Pamiętaj, że ta korekta nie oznacza zmiany w działaniu interfejsu API.

    • Wymiar operating_system, który identyfikuje system oprogramowania urządzenia, na którym wystąpiły wyświetlenia, obsługuje teraz te wartości:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Wszystkie zadania raportowania dla typu raportu content_owner_basic_a1 zostały usunięte. Ten typ raportu został całkowicie wycofany 19 sierpnia 2016 r., ale wygenerowane wcześniej raporty content_owner_basic_a1 były nadal dostępne przez 180 dni od momentu ich wygenerowania. Dlatego niektóre raporty były dostępne jeszcze 19 lutego 2017 roku. Jednak ponieważ raporty nie są już dostępne, nie są też potrzebne powiązane z nimi zadania.

  • YouTube Analytics API (kierowane zapytania)

    • Opis wymiarów związanych z time periods został poprawiony. Wskazuje on, że wartość wymiaru odnosi się do okresu rozpoczynającego się o 00:00 czasu pacyficznego i kończącego się o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny to UTC-7 lub UTC-8.

      Chociaż daty zwykle reprezentują okres 24-godzinny, daty, w których zegary są przestawiane do przodu, reprezentują okres 23-godzinny, a daty, w których zegary są przestawiane do tyłu, reprezentują okres 25-godzinny. (Wcześniej w dokumentacji podawano, że czas pacyficzny to UTC-8, i nie wspominano o tym, że dzień może nie reprezentować 24-godzinnego okresu).

      Pamiętaj, że ta korekta nie oznacza zmiany w działaniu interfejsu API.

    • Zaktualizowaliśmy dokumentację raportów o kanałach, aby poinformować, że obecnie nie zawierają one danych o zarobkach ani skuteczności reklam. W związku z tym zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie daje obecnie dostępu do danych pieniężnych w raportach dotyczących kanału.

    • Wymiar operatingSystem obsługuje 3 nowe wartości wymiaru:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 lutego 2017 r.

Interfejs YouTube Analytics API obsługuje teraz opcjonalny parametr include-historical-channel-data. Pamiętaj, że ten parametr jest istotny tylko w przypadku pobierania raportów właściciela treści.

Ten parametr umożliwia właścicielowi treści wskazanie, że odpowiedź interfejsu API powinna zawierać dane o czasie oglądania i wyświetleniach kanałów z okresu przed powiązaniem kanałów z właścicielem treści. Domyślna wartość parametru to false, co oznacza, że domyślnie odpowiedź interfejsu API zawiera tylko dane o czasie oglądania i wyświetleniach z okresu, w którym kanały były powiązane z właścicielem treści.

Te reguły obowiązują też, gdy żądanie interfejsu API pobiera dane z wielu kanałów:

  • Jeśli wartość parametru to false, dane o czasie oglądania i wyświetleniach zwracane dla danego kanału są oparte na dacie powiązania tego kanału z właścicielem treści.

    Pamiętaj, że różne kanały mogły zostać powiązane z właścicielem treści w różnych terminach. Jeśli żądanie API pobiera dane z wielu kanałów, a wartość parametru to false, odpowiedź API zawiera dane o czasie oglądania i wyświetleniach na podstawie daty połączenia każdego kanału.
  • Jeśli wartość parametru to true, odpowiedź zwraca dane o czasie oglądania i wyświetleniach wszystkich kanałów na podstawie daty rozpoczęcia i zakończenia określonych w żądaniu API.

15 grudnia 2016 r.

Te raporty interfejsu YouTube Reporting API nie są już obsługiwane i zostały usunięte z dokumentacji. Dostępna jest nowsza wersja każdego raportu. (Ogłoszenie o wycofaniu tych raportów zostało opublikowane 15 września 2016 r.).

Zaktualizowaliśmy też listę obecnych typów raportów w dokumentacji referencyjnej interfejsu API.

11 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

Interfejs API YouTube do raportowania obsługuje 3 nowe raporty dotyczące ekranów końcowych, a także nowe wymiary i dane w tych raportach. Raporty zawierają statystyki wyświetleń i kliknięć ekranów końcowych, które wyświetlają się po zakończeniu odtwarzania filmu.

8 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany w YouTube Analytics API:

  • Dane na poniższej liście zostały całkowicie wycofane i nie są już obsługiwane. Zgodnie z ogłoszeniem z 10 sierpnia 2016 r. obsługiwane są już nowe rodzaje danych odnoszące się do tych samych informacji. W tabeli poniżej znajdziesz wycofaną nazwę rodzaju danych i nową nazwę:

    Wycofane dane Nowy wskaźnik
    adEarnings estimatedAdRevenue
    impressionBasedCpm cpm
    impressions adImpressions
    redPartnerRevenue estimatedRedPartnerRevenue

27 października 2016 r.

YouTube automatycznie generuje teraz zestaw raportów o przychodach z reklam zarządzanych przez system dla właścicieli treści, którzy mają dostęp do odpowiednich raportów w sekcji Raporty w Studio twórców YouTube. Nowe raporty API zarządzane przez system zostały zaprojektowane tak, aby zapewniać automatyczny dostęp do danych, które są też dostępne w raportach Studio twórców pobieranych ręcznie.

W omówieniu raportów zarządzanych przez system znajdziesz krótkie omówienie nowych raportów i wyjaśnienie procesu ich pobierania za pomocą interfejsu API. Ten proces nieco różni się od pobierania raportów zbiorczych w Statystykach YouTube, ponieważ partnerzy nie muszą planować zadań generowania raportów.

Właściwość id zasobu reportType została zaktualizowana i zawiera listę raportów zarządzanych przez system, do których możesz uzyskać dostęp za pomocą interfejsu API:

  • Miesięczne przychody z reklam na całym świecie na film
  • Dzienne przychody z reklam na film w poszczególnych krajach
  • Miesięczne przychody z reklam na całym świecie na komponent
  • Dzienne przychody z reklam w poszczególnych krajach na zasób
  • Roszczenia (ten raport nie zawiera danych o przychodach)

27 września 2016 r.

Uwaga: to jest ogłoszenie o wycofaniu.

Wskaźnik uniques w YouTube Analytics API został wycofany. Nie są to podstawowe dane i będą one obsługiwane do 31 października 2016 r.

15 września 2016 r.

Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Reporting API:

19 sierpnia 2016 r.

Ta aktualizacja zawiera następującą zmianę w interfejsie YouTube Reporting API:

  • Raport content_owner_basic_a1 został całkowicie wycofany i usunięty z dokumentacji. YouTube nie będzie już generować nowych raportów tego typu, ale wygenerowane już raporty będą nadal dostępne przez 180 dni od momentu ich wygenerowania.

    Raport content_owner_basic_a1 został zastąpiony raportem content_owner_basic_a2, co wyjaśniono w historii zmian z 19 maja 2016 roku.

11 sierpnia 2016 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowe Warunki korzystania z usług YouTube API („zaktualizowane warunki”), które zostały szczegółowo omówione na blogu YouTube dla inżynierów i deweloperów, zawierają wiele aktualizacji obecnych Warunków korzystania z usługi. Oprócz zaktualizowanych warunków, które wejdą w życie 10 lutego 2017 r., ta aktualizacja obejmuje kilka dokumentów pomocniczych, które wyjaśniają zasady, których deweloperzy muszą przestrzegać.

    Pełny zestaw nowych dokumentów opisano w historii zmian zaktualizowanych Warunków. Ponadto w historii zmian będą wyjaśniane przyszłe zmiany Zaktualizowanych warunków lub dokumentów pomocniczych. Możesz zasubskrybować kanał RSS z listą zmian w historii wersji, korzystając z linku w tym dokumencie.

10 sierpnia 2016 r.

Ta aktualizacja obejmuje następujące zmiany:

  • YouTube Analytics API (kierowane zapytania)

    • Uwaga: to jest ogłoszenie o wycofaniu.

      Dane w tej tabeli zostaną wycofane. Jednocześnie wprowadzamy nowe dane odnoszące się do tych samych informacji. Oznacza to, że stare dane są zmieniane, ale interfejs YouTube Analytics API będzie obsługiwać obie nazwy danych do dat wycofania podanych w tabeli.

      Stara nazwa danych Nazwa nowych danych Data pomocy
      earnings estimatedRevenue 10 sierpnia 2017 r.
      adEarnings estimatedAdRevenue 4 listopada 2016 r.
      redPartnerRevenue estimatedRedPartnerRevenue 4 listopada 2016 r.
      impressionBasedCpm cpm 4 listopada 2016 r.
      impressions adImpressions 4 listopada 2016 r.

      Pamiętaj, że dane earnings były podstawowymi danymi, więc będą obsługiwane przez rok od daty tego ogłoszenia. Pozostałe dane, które nie były podstawowymi danymi, będą obsługiwane przez 3 miesiące, do 4 listopada 2016 r.

      Na przykład do 4 listopada 2016 r. żądanie API może określać dane impressionBasedCpm, dane cpm lub oba te rodzaje danych. Po tym dniu obsługiwane będą tylko dane cpm.

    • Wymiar insightTrafficSourceType obsługuje 2 nowe wartości wymiaru:
      • CAMPAIGN_CARD: to źródło wizyt jest obsługiwane tylko w przypadku raportów właścicieli treści. Oznacza to, że wyświetlenia pochodzą z objętych roszczeniem filmów przesłanych przez użytkowników, których właściciel treści użył do promowania oglądanych treści.
      • END_SCREEN: Dane dotyczą wyświetleń, które pochodzą z ekranu końcowego innego filmu.

      W przypadku obu nowych źródeł wizyt możesz też pobrać traffic source detailraport. W obu przypadkach wymiar insightTrafficSourceDetail identyfikuje film, z którego pochodzi widz.

    • Wymiar adType obsługuje teraz wartość auctionBumperInstream, która odnosi się do niemożliwej do pominięcia reklamy wideo trwającej do 6 sekund, która wyświetla się, zanim rozpocznie się odtwarzanie filmu.

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • Wymiar traffic_source_type obsługuje teraz te wartości:
      • 19: to źródło wizyt jest obsługiwane tylko w przypadku raportów właścicieli treści. Oznacza to, że wyświetlenia pochodzą z objętych roszczeniem filmów przesłanych przez użytkowników, których właściciel treści użył do promowania oglądanych treści.
      • 20: Dane dotyczą wyświetleń, które pochodzą z ekranu końcowego innego filmu.

      W przypadku obu nowych źródeł wizyt wymiar traffic_source_detail wskazuje film, z którego pochodzi widz.

    • Lista podstawowych danych interfejsu API została poprawiona. Dodano do niej estimated_partner_revenue, a usunięto z niej earnings. (Dane earnings nigdy nie były obsługiwane w interfejsie YouTube Reporting API).

    • Wymiar ad_type obsługuje teraz wartość 19, która odnosi się do bumperów reklamowych, czyli reklam wideo niemożliwych do pominięcia, które trwają do 6 sekund i są odtwarzane, zanim rozpocznie się odtwarzanie filmu.

18 lipca 2016 r.

Ta aktualizacja obejmuje następujące zmiany:

  • YouTube Analytics API (kierowane zapytania)

    • Zaktualizowaliśmy listy obsługiwanych danych w tych raportach o kanałach, aby uwzględniały dane dotyczące kart. Obsługa rodzajów danych dotyczących kart została dodana do tych raportów 28 czerwca 2016 r., a wpis w historii zmian z tej daty zawiera szczegółowe wyjaśnienie tej zmiany. Raporty to:
      • Podstawowa aktywność użytkowników w stanach USA
      • Aktywność użytkowników w stanach USA w określonych przedziałach czasu
      • Aktywność użytkowników według województwa
      • Aktywność użytkowników według stanu subskrypcji
      • Aktywność użytkowników według stanu subskrypcji w przypadku prowincji
      • Najpopularniejsze filmy według stanu
      • Najpopularniejsze filmy wśród subskrybentów i osób, które nie subskrybują kanału

    • Listy filtrów zostały poprawione zarówno w przypadku raportów o utrzymaniu uwagi odbiorców na kanale, jak i raportów o utrzymaniu uwagi odbiorców właściciela treści. Odzwierciedlają one, że filtr video jest wymagany, a filtr group nie jest obsługiwany.

      Wcześniej w dokumentacji obu raportów błędnie podano, że raport można pobrać za pomocą jednego z tych 2 filtrów lub bez użycia żadnego z nich.

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

    • W omówieniu interfejsu API poprawiliśmy sekcję, która wyjaśnia, jak pobrać adres URL raportu. Teraz informuje ona, że YouTube generuje raporty do pobrania za dni, w których nie były dostępne żadne dane. Raporty te zawierają wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji Charakterystyka raportu tego samego dokumentu w dniu 12 kwietnia 2016 r.
    • Lista wymiarów w raporcie content_owner_asset_cards_a1 została poprawiona, aby odzwierciedlała fakt, że raport korzysta z wymiaru card_id. Wcześniej w dokumentacji błędnie podano nazwę wymiaru jako card_title.

28 czerwca 2016 r.

Zaktualizowaliśmy dokumentację YouTube Analytics API, aby odzwierciedlała obsługę danych dotyczących kart w wielu raportach kanału i właściciela treści. Nowo obsługiwane dane to:

Te dane są obsługiwane w tych typach raportów:

22 czerwca 2016 r.

Ta aktualizacja zawiera te zmiany w interfejsie YouTube Reporting API: Pierwsza zmiana dotyczy interfejsu API ogólnie, a pozostałe zmiany wpływają tylko na raporty właścicieli treści:

  • Zaktualizowaliśmy sekcję Charakterystyka raportu w omówieniu interfejsu API, aby wyjaśnić, że raporty są dostępne w interfejsie API przez 180 dni od momentu ich wygenerowania.

    Wcześniej w dokumentacji podawaliśmy, że raporty są dostępne przez okres do 180 dni przed datą wysłania żądania do interfejsu API. Chociaż jest to technicznie prawdą, oryginalny tekst był co najmniej dość mylący.

  • Interfejs API obsługuje nowe wersje 3 raportów. 2 z tych raportów zawierają też nowe i zmienione dane:

    • Raport content_owner_ad_rates_a1 to nowa wersja raportu content_owner_ad_performance_a1. Nowy raport jest identyczny z poprzednią wersją.

    • Dwa raporty, które mają nowe wersje, zostały przemianowane:

      • Nowa wersja raportu content_owner_estimated_earnings_a1 ma nazwę content_owner_estimated_revenue_a1.
      • Nowa wersja raportu content_owner_asset_estimated_earnings_a1 ma nazwę content_owner_asset_estimated_revenue_a1.

      Oba raporty po zmianie nazwy różnią się od swoich poprzedników w tych aspektach:

    Pamiętaj, że jeśli masz już zadania tworzenia starszych wersji tych raportów, musisz utworzyć nowe zadania dla raportów o zmienionych nazwach. Wraz z wprowadzeniem nowych wersji raportów wycofaliśmy raporty content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 i content_owner_asset_estimated_earnings_a1.

    Jeśli masz zadania dotyczące tych raportów, po 22 września 2016 r. YouTube nie będzie generować nowych raportów dla tych zadań. Wygenerowane raporty będą nadal dostępne przez 180 dni od momentu ich wygenerowania.

  • Definicja właściwości reportType zasobu id została zaktualizowana, aby odzwierciedlać bieżący zestaw dostępnych raportów.

  • W dokumentacji poprawiliśmy nazwy 2 rodzajów danych, aby były zgodne z nazwami wyświetlanymi w raportach. Jest to tylko poprawka w dokumentacji, która nie odzwierciedla zmiany rzeczywistej zawartości raportu:

    • Nazwa rodzaju danych estimated_partner_adsense_revenue została zmieniona na estimated_partner_ad_sense_revenue. Pamiętaj jednak, że te dane pojawiają się tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak wspomnieliśmy powyżej, w nowszych wersjach tych raportów te dane zostały zmienione na estimated_partner_ad_auction_revenue.
    • Nazwa rodzaju danych estimated_partner_doubleclick_revenue została zmieniona na estimated_partner_double_click_revenue. Pamiętaj, że te dane pojawiają się tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak wspomnieliśmy powyżej, w nowszych wersjach tych raportów te dane zostały zmienione na estimated_partner_ad_reserved_revenue.

  • Dokumentacja wymiarów interfejsu Reporting API została zaktualizowana i nie zawiera już właściwości elapsed_video_time_percentage i audience_retention_type. Te wymiary nie są obecnie obsługiwane przez żadne raporty dostępne w ramach interfejsu API.

19 maja 2016 r.

Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Reporting API:

  • Interfejs API obsługuje nową wersję raportu o aktywności użytkowników dla właścicieli treści. Identyfikator typu nowego raportu to content_owner_basic_a2. W odróżnieniu od poprzedniej wersji raportu content_owner_basic_a1 nowa wersja obsługuje dane likes i dislikes.

    Jeśli masz już zadanie tworzenia raportu content_owner_basic_a1, musisz utworzyć nowe zadanie dla raportu content_owner_basic_a2. YouTube nie przenosi automatycznie właścicieli treści do nowej wersji raportu ani nie tworzy automatycznie zadania generowania nowej wersji raportu. W niektórych implementacjach pojawienie się nowego, nieoczekiwanego zadania może być zmianą powodującą niezgodność.

    Wraz z wprowadzeniem nowego raportu content_owner_basic_a1 został wycofany. Jeśli masz zadanie dla tego raportu, po 19 sierpnia 2016 r. YouTube nie będzie generować nowych raportów dla tego zadania. Wygenerowane raporty będą nadal dostępne przez 180 dni od momentu ich wygenerowania.

  • Zasoby reportType, job i report obsługują nową właściwość, która określa, czy powiązany zasób reprezentuje wycofany typ raportu:

    • W zasobie reportType właściwość deprecateTime określa datę i godzinę wycofania typu raportu. Ta właściwość ma wartość tylko w przypadku raportów, które zostały ogłoszone jako wycofane. Wartość ta oznacza datę, kiedy YouTube przestanie generować raporty tego typu.

      Po ogłoszeniu wycofania danego typu raportu YouTube generuje raporty tego typu przez kolejne 3 miesiące. Na przykład ta aktualizacja z 19 maja 2016 r. informuje o wycofaniu raportu content_owner_basic_a1. W przypadku tego typu raportu symbol deprecateTime oznacza datę 19 sierpnia 2016 r., po której YouTube przestanie generować raporty tego typu.

    • W zasobie job właściwość expireTime określa datę i godzinę wygaśnięcia lub wygaśnięcia zadania. Ta właściwość ma wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub jeśli raporty wygenerowane dla zadania nie były pobierane przez dłuższy czas. Data ta oznacza moment, po którym YouTube nie będzie już generować nowych raportów dla danego zadania.

    • Właściwość jobExpireTime zasobu report określa datę i godzinę wygaśnięcia lub planowanego wygaśnięcia zadania powiązanego z raportem. Ta właściwość zawiera tę samą wartość co właściwość expireTime w zasobie job, jak opisano w poprzednim punkcie tej listy.

  • Metoda jobs.create zwraca teraz kod odpowiedzi HTTP 400 (Bad Request), jeśli spróbujesz utworzyć zadanie dla wycofanego raportu. Dodatkowo w dokumentacji metody znajdziesz teraz kilka innych powodów, dla których żądanie interfejsu API może się nie powieść.

12 kwietnia 2016 r.

Ta aktualizacja zawiera te zmiany, które dotyczą tylko interfejsu YouTube Reporting API:

  • YouTube generuje teraz dane obejmujące okres 180 dni przed pierwszym zaplanowaniem zadania raportowania. Wcześniej interfejs Reporting API nie dostarczał żadnych danych historycznych. Ta zmiana dotyczy wszystkich zadań, w tym tych utworzonych przed ogłoszeniem tej informacji.

    Raporty historyczne są publikowane, gdy tylko są dostępne, ale opublikowanie wszystkich danych historycznych dotyczących danego zadania zajmuje około miesiąca. Oznacza to, że miesiąc po zaplanowaniu zadania raportowania będziesz mieć dostęp do danych z okresu około 7 miesięcy. (Wszystkie dane historyczne dotyczące zadań utworzonych przed tym ogłoszeniem powinny zostać opublikowane w ciągu miesiąca od ogłoszenia).

    Pamiętaj, że dane historyczne są dostępne tylko od 1 lipca 2015 r. W związku z tym zadania utworzone przed 28 grudnia 2015 r. będą miały mniej niż 180 dni danych historycznych.

    Wszystkie te zmiany zostały opisane w nowej sekcji danych historycznych w omówieniu interfejsu Reporting API.

  • W sekcji Charakterystyka raportu w omówieniu interfejsu YouTube Reporting API wprowadziliśmy te zmiany:

    • W dokumentacji jest teraz napisane, że raporty są dostępne przez 180 dni od momentu ich wygenerowania, a tym samym mogą być pobierane przez klientów API. Wcześniej w dokumentacji podawaliśmy, że raporty są dostępne za okres do 6 miesięcy przed datą wysłania żądania interfejsu API.

    • Dokumentacja została zaktualizowana, aby odzwierciedlać fakt, że interfejs API generuje teraz raporty do pobrania za dni, w których nie były dostępne żadne dane. Raporty te będą zawierać wiersze nagłówka, ale nie będą zawierać dodatkowych danych.

  • Interfejs YouTube Reporting API będzie wkrótce obsługiwać zestaw automatycznie generowanych raportów zarządzanych przez system, które zawierają dane o przychodach z reklam lub przychodach z subskrypcji YouTube Red. Raporty będą dostępne dla właścicieli treści, którzy mają już dostęp do ręcznie pobieranych raportów o przychodach w Studio twórców w YouTube. Dzięki temu nowe funkcje interfejsu API zapewnią programowy dostęp do tych danych.

    W związku z wprowadzeniem raportów zarządzanych przez system ogłaszamy teraz te zmiany w interfejsie API:

    • Nowa właściwość systemManaged zasobu job wskazuje, czy zasób opisuje zadanie, które generuje raporty zarządzane przez system. YouTube automatycznie generuje raporty zarządzane przez system dla właścicieli treści w YouTube. Właściciele treści nie mogą modyfikować ani usuwać zadań, które tworzą te raporty.

    • Nowy parametr includeSystemManaged metody jobs.list wskazuje, czy odpowiedź interfejsu API powinna zawierać zadania dotyczące raportów zarządzanych przez system. Wartość domyślna parametru to false.

    • Nowy parametr startTimeAtOrAfter metody jobs.reports.list wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty, w których najwcześniejsze dane są dostępne od określonej daty. Podobnie parametr startTimeBefore wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty, w których najwcześniejsze dane są wcześniejsze niż podana data.

      W odróżnieniu od parametru createdAfter metody, który odnosi się do czasu utworzenia raportu, nowe parametry dotyczą danych w raporcie.

    • Nowa właściwość systemManaged zasobu reportType wskazuje, czy zasób opisuje raport zarządzany przez system.

    • Nowy parametr includeSystemManaged metody reportTypes.list wskazuje, czy odpowiedź interfejsu API powinna zawierać raporty zarządzane przez system. Wartość domyślna parametru to false.

28 marca 2016 r.

Interfejs API YouTube do raportowania i YouTube Analytics API zwracają teraz statystyki wyświetleń w przypadku kilku dodatkowych usług udostępniania.

  • W interfejsie YouTube Reporting API wymiar sharing_service obsługuje te nowe wartości:
    • 82: okno aktywności systemowej iOS
    • 83: Google Inbox
    • 84: Android Messenger
  • W interfejsie YouTube Analytics API wymiar sharingService obsługuje te nowe wartości:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • IOS_SYSTEM_ACTIVITY_DIALOG: okno aktywności systemowej iOS

16 marca 2016 r.

Ta aktualizacja zawiera te zmiany, które mają wpływ zarówno na interfejs API YouTube do raportowania, jak i na YouTube Analytics API:

Interfejs API YouTube do raportowania

  • Wymiar playback_location_type obsługuje 2 nowe wartości wymiaru:
    • 7: dane dotyczą wyświetleń, które miały miejsce na stronie głównej YouTube lub ekranie głównym, w aktywności z subskrypcji użytkownika lub w innej funkcji przeglądania YouTube.
    • 8: dane dotyczą wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.
  • Wymiar traffic_source_type obsługuje teraz wartość 18. Ta wartość oznacza, że wyświetlenia filmu pochodzą ze strony, na której znajdują się wszystkie filmy z playlisty. To źródło różni się od typu źródła 14, który wskazuje, że wyświetlenia miały miejsce podczas odtwarzania filmu w ramach playlisty.

YouTube Analytics API

  • Wymiar insightPlaybackLocationType obsługuje 2 nowe wartości wymiaru:
    • BROWSE: dane dotyczą wyświetleń, które miały miejsce na stronie głównej YouTube lub ekranie głównym, w aktywności z subskrypcji użytkownika lub w innej funkcji przeglądania YouTube.
    • SEARCH: dane dotyczą wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.
  • Wymiar insightTrafficSourceType obsługuje teraz wartość YT_PLAYLIST_PAGE. Ta wartość oznacza, że wyświetlenia filmu pochodzą ze strony, na której znajdują się wszystkie filmy z playlisty. To źródło różni się od typu źródła PLAYLIST, który wskazuje, że wyświetlenia miały miejsce podczas odtwarzania filmu w ramach playlisty.

8 lutego 2016 r.

Zaktualizowaliśmy listę danych obsługiwanych przez interfejs YouTube Analytics API, tak aby dane dotyczące kart nie były już wymienione jako obsługiwane przez ten interfejs. (Żaden z raportów tego interfejsu API nie był udokumentowany jako obsługujący którykolwiek z rodzajów danych na karcie).

Pamiętaj, że nadal możesz pobierać dane dotyczące kart za pomocą interfejsu YouTube Reporting API, który obsługuje te dane w przypadku wielu raportów dotyczących kanałów i właścicieli treści.

6 stycznia 2016 r.

Interfejs API YouTube do raportowania i YouTube Analytics API identyfikują teraz wyświetlenia, które występują na urządzeniu Chromecast.

  • W interfejsie YouTube Reporting API wymiar operating_system używa wartości 21 do identyfikowania wyświetleń, które mają miejsce za pomocą Chromecasta.
  • W interfejsie YouTube Analytics API wymiar operatingSystem używa wartości CHROMECAST do identyfikowania wyświetleń, które mają miejsce za pomocą Chromecasta.

21 grudnia 2015 r.

W dokumentacji nazwy danych annotation_clickable_impressions i annotation_closable_impressions zostały zaktualizowane, aby odpowiadały nazwom zwracanym w raportach. Wcześniej nazwy były oznaczane jako clickable_annotation_impressions i closable_annotation_impressions.

18 grudnia 2015 r.

Przepisy Unii Europejskiej (UE) wymagają, aby użytkownicy w UE otrzymywali określone informacje i wyrażali zgodę na wykorzystanie danych. W związku z tym w przypadku użytkowników z Unii Europejskiej musisz przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy informację o tym wymaganiu do Warunków korzystania z interfejsu API YouTube.

15 grudnia 2015 r.

Ta aktualizacja zawiera następujące zmiany, które mają wpływ na YouTube Analytics API:

  • Interfejs YouTube Analytics API obsługuje teraz 3 nowe wymiary szczegółów odtwarzania, które można wykorzystywać w różnych raportach dotyczących kanałów i właścicieli treści:

    • liveOrOnDemand: ten wymiar wskazuje, czy dane w raporcie opisują aktywność użytkowników, która miała miejsce podczas transmisji na żywo.
    • subscribedStatus: ten wymiar wskazuje, czy dane dotyczące aktywności użytkowników są powiązane z widzami, którzy subskrybowali kanał filmu lub playlisty.
    • youtubeProduct: ten wymiar określa usługę YouTube, w której wystąpiła aktywność użytkownika. Możliwe wartości to główna witryna YouTube (lub aplikacja YouTube), YouTube Gaming i YouTube Kids.

    Zaktualizowaliśmy dokumentację, aby uwzględnić nowe raporty ze szczegółami odtwarzania dostępne dla kanałów i właścicieli treści. W wielu innych raportach dodaliśmy też informację, że w tych raportach można opcjonalnie używać co najmniej jednego z tych wymiarów jako wymiaru lub filtra.

  • Format tabel wyjaśniających raporty został zmieniony, aby ułatwić Ci identyfikowanie prawidłowych kombinacji wymiarów, danych i filtrów, których można używać do pobierania poszczególnych raportów. Tabela poniżej, która zawiera wyjaśnienie raportu „Typ urządzenia” dla kanałów, pokazuje nowy format:

    Spis treści
    Wymiary:
    Wymagane deviceType
    Użyj wartości 0 lub większej day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Dane:
    Użyj co najmniej 1 views, estimatedMinutesWatched
    Filtry:
    Użyj 0 lub 1 country, province, continent, subContinent
    Użyj 0 lub 1 film, grupa
    Użyj wartości 0 lub większej operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

    Terminologia opisująca pola wymagane i opcjonalne jest wyjaśniona w dokumentacji raportów kanał i właściciel treści.

  • Interfejs YouTube Analytics API automatycznie usuwa teraz z filtrów obsługujących wiele wartości (video, playlist i channel) elementy, dla których użytkownik interfejsu API nie może pobrać danych. Wcześniej serwer interfejsu API zwracał błąd, jeśli użytkownik nie miał dostępu do danych dotyczących co najmniej jednego z określonych elementów.

    Załóżmy na przykład, że użytkownik przesyła żądanie do interfejsu API, w którym video lista filtrów zawiera 20 identyfikatorów filmów. Użytkownik jest właścicielem 18 filmów. Jeden identyfikator filmu wskazuje jednak film należący do innego kanału, a drugi identyfikator wskazuje film, który został usunięty i dlatego już nie istnieje. W takim przypadku serwer interfejsu API nie zwraca błędu, ale usuwa 2 filmy, do których użytkownik nie ma dostępu, a odpowiedź interfejsu API zawiera dane 18 filmów, których właścicielem jest użytkownik interfejsu API.

  • Jeśli poprosisz o dane z pustego konta group w Statystykach YouTube, interfejs API zwróci teraz pusty zbiór danych zamiast błędu.

  • Metoda groupItems.insert interfejsu YouTube Analytics API zwraca teraz błąd braku autoryzacji (403 kod odpowiedzi HTTP), jeśli spróbujesz dodać do grupy podmiot, do którego nie masz dostępu. Wcześniej interfejs API umożliwiał dodanie jednostki do grupy, ale później zwracał błąd braku autoryzacji, gdy użytkownik próbował pobrać dane raportu dla tej grupy.

  • Metoda groups.list interfejsu YouTube Analytics API obsługuje teraz stronicowanie. Jeśli odpowiedź API nie zawiera wszystkich dostępnych grup, parametr nextPageToken w odpowiedzi określa token, którego można użyć do pobrania następnej strony wyników. Aby pobrać dodatkowe wyniki, ustaw parametr pageToken metody na tę wartość.

10 listopada 2015 r.

Ta aktualizacja zawiera następujące zmiany:

29 października 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumentacja wymiaru date w interfejsie YouTube Reporting API została poprawiona. Teraz zawiera informację, że daty odnoszą się do 24-godzinnego okresu rozpoczynającego się o godzinie 00:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji podawano, że data zaczyna się o 00:00 (GMT).

    Dodatkowo zaktualizowaliśmy dokumentację YouTube Analytics API, aby zaznaczyć, że wszystkie wymiary związane z datą (day, 7DayTotals, 30DayTotals i month) odnoszą się do dat rozpoczynających się o północy czasu pacyficznego (UTC-8).

  • Metoda jobs.reports.list() interfejsu API YouTube do raportowania obsługuje teraz parametr zapytania createdAfter. Jeśli ten parametr jest określony, oznacza to, że odpowiedź interfejsu API powinna zawierać tylko raporty utworzone po określonej dacie i godzinie, w tym nowe raporty z danymi uzupełnionymi wstecznie. Pamiętaj, że wartość parametru odnosi się do czasu utworzenia raportu, a nie do dat powiązanych ze zwróconymi danymi.

    Wartość parametru to sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z".

    Zaktualizowaliśmy też sprawdzone metody dotyczące interfejsu YouTube Reporting API, aby wyjaśnić, jak używać parametru createdAfter, aby uniknąć wielokrotnego przetwarzania tego samego raportu.

  • Definicje właściwości createTime zasobu job oraz właściwości startTime, endTime i createTime zasobu report zostały poprawione, aby uwzględnić informację, że wartości właściwości są dokładne do mikrosekund, a nie nanosekund. Dodatkowo wszystkie definicje odzwierciedlają teraz fakt, że wartość właściwości jest sygnaturą czasową.

8 października 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumentacja wymiaru sharingService w YouTube Analytics API została zaktualizowana i zawiera teraz listę możliwych wartości wymiaru. Lista zawiera kilka nowo obsługiwanych usług.

    Zaktualizowaliśmy też definicję wymiaru sharing_service w interfejsie YouTube Reporting API, aby uwzględnić nowo obsługiwane wartości. Wartości wyliczeniowe większe niż 59 to nowe wartości na liście.

24 września 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowy interfejs API YouTube do raportowania pobiera raporty zbiorcze zawierające dane ze Statystyk YouTube dotyczące kanału lub właściciela treści. Jest on przeznaczony dla aplikacji, które mogą importować duże zbiory danych i zapewniać narzędzia do filtrowania, sortowania i wydobywania tych danych.

    Każdy raport interfejsu YouTube Reporting API zawiera wstępnie zdefiniowany zestaw wymiarów i rodzajów danych. (Raporty YouTube Analytics API też korzystają z danych i wymiarów). W raporcie każdy wiersz danych ma unikalną kombinację wartości wymiarów. Możesz agregować dane w wierszach na podstawie wartości wymiarów, aby obliczać dane dotyczące poszczególnych filmów, krajów, filmów na żywo, subskrybujących użytkowników itp.

    Za pomocą interfejsu API możesz planować zadania raportowania. Każde z nich określa raport, który ma wygenerować YouTube. Po skonfigurowaniu zadania YouTube generuje dzienny raport, który można pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego 24-godzinnego okresu.

  • YouTube Analytics API i interfejs API YouTube do raportowania to różne interfejsy API, ale oba umożliwiają programistom pobieranie danych Statystyk YouTube. Ponieważ oba interfejsy API zapewniają dostęp do podobnych zbiorów danych, dokumentacja obu interfejsów API jest publikowana jako jeden zestaw dokumentów.

    • Karta Przewodniki w zestawie dokumentacji zawiera informacje wspólne dla obu interfejsów API, w tym instrukcje autoryzowania żądań interfejsu API.
    • Karta Raporty zbiorcze zawiera dokumentację referencyjną i inne materiały dotyczące interfejsu YouTube Reporting API.
    • Karta Kierowane zapytania zawiera dokumentację i inne materiały dotyczące interfejsu YouTube Analytics API.
    • Na karcie Przykłady znajdziesz przykłady kodu dostępne dla każdego z tych 2 interfejsów API.
    • Na karcie Narzędzia znajdziesz dodatkowe zasoby, które pomogą deweloperom w implementacji jednego z tych interfejsów API.

20 sierpnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Zmieniliśmy strukturę dokumentacji interfejsu API, aby ułatwić jego zrozumienie. W związku z tym te zmiany nie opisują nowych funkcji:

    • Dokumentacja zawiera teraz 2 strony: jedną z listą wszystkich dostępnych raportów o kanale i drugą z listą wszystkich dostępnych raportów o właścicielu treści. Wcześniej dokumentacja zawierała osobne strony dotyczące raportów o filmach na kanale, raportów o playlistach na kanale itp.

    • Nowy przegląd modelu danych ma na celu bardziej przejrzyste wprowadzenie do działania interfejsu API. W tym dokumencie wyjaśniamy, jak YouTube używa danych, wymiarów i filtrów do obliczania wartości raportów.

    • Metoda reports.query interfejsu API, której używasz do pobierania raportów, jest teraz udokumentowana osobno. Informacje na tej stronie były wcześniej dostępne na innych stronach. Nowa strona została zaprojektowana tak, aby ułatwić Ci identyfikowanie informacji, które musisz przesłać, aby pobrać raport.

22 lipca 2015 r.

Ta aktualizacja zawiera kilka zmian, które dotyczą tylko właścicieli treści:

  • Nowe dane adEarnings obejmują łączne szacunkowe zarobki (przychody netto) ze wszystkich źródeł reklam sprzedawanych przez Google. Nie jest to podstawowy rodzaj danych. Interfejs API obsługuje dane adEarnings w przypadku każdego raportu, który obsługuje już dane earnings.

    Dodatkowo poprawiliśmy definicję danych earnings, aby odzwierciedlała fakt, że ich wartość obejmuje łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google, a także ze źródeł innych niż reklamowe. Wcześniej definicja błędnie wskazywała, że dane obejmują tylko zarobki ze źródeł reklamowych.

  • Dane primaryAdGrossRevenue zostały wycofane. Zamiast tego użyj danych grossRevenue, aby pobrać dane o przychodach.

  • Oprócz wycofanych danych primaryAdGrossRevenue raporty skuteczności reklam nie obsługują już danych monetizedPlaybacks i playbackBasedCpm. Jednak kilka raportów dotyczących filmów nadal obsługuje te dane.

1 czerwca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz 2 nowe dane w raportach o filmach: videosAddedToPlaylists i videosRemovedFromPlaylists. Listy raportów o filmach dla kanałów i właścicieli treści zostały zaktualizowane, aby wskazywać raporty, które obsługują nowe dane.

    • videosAddedToPlaylists – liczba razy, gdy filmy objęte zapytaniem zostały dodane do dowolnych playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.
    • videosRemovedFromPlaylists – liczba usunięć filmów objętych zapytaniem z dowolnych playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist innych kanałów.

    Oba rodzaje danych obejmują domyślne playlisty, takie jak „Do obejrzenia”. Nie uwzględniają one jednak playlist, do których film jest dodawany automatycznie, np. playlisty z przesłanymi filmami na kanale lub historii oglądania użytkownika. Pamiętaj też, że te dane odzwierciedlają bezwzględną liczbę dodanych i usuniętych elementów. Jeśli więc użytkownik doda film do playlisty, a następnie go usunie i ponownie doda, dane będą wskazywać, że film został dodany do 2 playlist i usunięty z 1.

    Dane tych rodzajów są dostępne od 1 października 2014 roku.

31 marca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

16 marca 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowy parametr currency umożliwia pobieranie danych o zarobkach w walucie innej niż dolary amerykańskie (USD). Jeśli ten parametr jest ustawiony, interfejs API przekształca wartości danych earnings, grossRevenue, playbackBasedCpm i impressionBasedCpm na określoną walutę. Zwracane wartości są szacunkowe i obliczane na podstawie kursów wymiany, które zmieniają się codziennie.

    Wartość parametru to trzyliterowy kod waluty w formacie ISO 4217. Wartością domyślną jest USD. Definicja parametru zawiera listę obsługiwanych kodów walut.

25 lutego 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz tworzenie grup w Statystykach YouTube i zarządzanie nimi, a także pobieranie danych raportu dotyczących tych grup.

    • Tworzenie grup i zarządzanie nimi

      Wprowadziliśmy zasoby group i groupItem do tworzenia grup i zarządzania nimi.

      • Zasób group reprezentuje grupę w Statystykach, czyli niestandardową kolekcję zawierającą maksymalnie 200 kanałów, filmów, playlist lub zasobów. Interfejs API obsługuje metody list, insert, update i delete dla tego zasobu.
      • Zasób groupItem reprezentuje element w grupie Analytics. Interfejs API obsługuje w przypadku tego zasobu metody list, insert i delete.

      Możesz na przykład utworzyć grupę za pomocą metody groups.insert, a następnie dodać do niej elementy za pomocą metody groupItems.insert.

    • Pobieranie danych raportu dotyczących grupy

      Zaktualizowaliśmy dokumentację wymiarów, dodając do niej wymiar group, którego można używać jako filtra w wielu raportach dotyczących kanałów i raportach dotyczących właścicieli treści. Gdy użyjesz filtra group, interfejs API zwróci dane wszystkich elementów w tej grupie. Pamiętaj, że interfejs API nie obsługuje obecnie tworzenia raportów dotyczących grup plików.

    Więcej informacji o grupach w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.

13 lutego 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API nie obsługuje już wymiaru show.

28 sierpnia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz możliwość określania wielu wartości wymiarów video, playlist, channel i show, gdy są one używane jako filtry. Aby określić wiele wartości, ustaw wartość parametru filters na rozdzieloną przecinkami listę identyfikatorów filmów, playlist, kanałów lub programów, dla których ma być filtrowana odpowiedź interfejsu API. Wartość parametru może zawierać maksymalnie 200 identyfikatorów.

    Jeśli określisz wiele wartości tego samego filtra, możesz też dodać ten filtr do listy wymiarów, które określasz w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony jako obsługiwany wymiar w przypadku danego raportu. Jeśli dodasz filtr do listy wymiarów, interfejs API będzie też używać wartości filtra do grupowania wyników.

    Szczegółowe informacje o tej funkcji znajdziesz w definicji parametru filters.

16 lipca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Podczas pobierania raportu o kanale możesz teraz pobierać dane o kanale uwierzytelnionego użytkownika, ustawiając wartość parametru ids na channel==MINE. (Możesz też ustawić parametr ids na channel==CHANNEL_ID, aby pobrać dane dotyczące określonego kanału).

  • Interfejs API obsługuje teraz raporty dotyczące playlist, które zawierają statystyki związane z wyświetleniami filmów w kontekście playlisty. Raporty dotyczące playlist są dostępne dla kanałów i właścicieli treści.

    Wszystkie raporty dotyczące playlist obsługują dane views i estimatedMinutesWatched, a niektóre także dane averageViewDuration.

    Dodatkowo wszystkie raporty dotyczące playlist obsługują te nowe dane: Pamiętaj, że te dane odzwierciedlają tylko wyświetlenia playlist w internecie.

    • playlistStarts: liczba rozpoczętych przez widzów odtworzeń playlisty.
    • viewsPerPlaylistStart: średnia liczba wyświetleń filmu, która nastąpiła za każdym razem, gdy została uruchomiona playlista.
    • averageTimeInPlaylist: szacowany średni czas w minutach, jaki widz spędził na oglądaniu filmów z playlisty po jej uruchomieniu.

    Każde żądanie pobrania raportu o playlistach musi zawierać filtr isCurated, który musi mieć wartość 1 (isCurated==1).

  • Interfejs API obsługuje teraz raport Utrzymanie uwagi odbiorców. Ten raport pokazuje, w jakim stopniu film utrzymuje uwagę odbiorców. Nowy wymiar elapsedVideoTimeRatio w raporcie mierzy czas, który upłynął od rozpoczęcia odtwarzania filmu, w przypadku odpowiednich wartości danych:

    • Wskaźnik audienceWatchRatio określa bezwzględny odsetek widzów oglądających film w danym momencie. Współczynnik ten oblicza się, porównując liczbę obejrzeń fragmentu filmu z łączną liczbą wyświetleń filmu.

      Pamiętaj, że w ramach jednego wyświetlenia filmu jego fragment może zostać obejrzany więcej niż raz (lub wcale). Jeśli na przykład użytkownicy przewijają i oglądają tę samą część filmu kilka razy, bezwzględny współczynnik dla tej części filmu może być większy niż 1.

    • Wskaźnik relativeRetentionPerformance pokazuje, w jakim stopniu film utrzymuje uwagę widzów podczas odtwarzania w porównaniu z filmami w YouTube o podobnej długości. Wartość 0 oznacza, że film utrzymuje uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości, a wartość 1 oznacza, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Mediana 0,5 oznacza, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.

    Możesz też użyć audienceType filtra, aby raport zawierał tylko dane związane z wyświetleniami organicznymi, wyświetleniami z reklam TrueView In-Stream lub wyświetleniami z reklam TrueView In-Display. (Wyświetlenia uzyskane bezpłatnie są bezpośrednim wynikiem działania użytkownika, np. wyszukania filmu lub kliknięcia sugerowanego filmu).

  • Interfejs API obsługuje kilka nowych rodzajów danych związanych z adnotacjami. Wymienione poniżej dane można pobrać z dowolnych raportów, które wcześniej obsługiwały dane annotationClickThroughRate i annotationCloseRate.

    Wszystkie nowe dane są danymi podstawowymi i podlegają zasadom wycofywania. Pamiętaj jednak, że dane dotyczące nowych rodzajów danych są dostępne od 16 lipca 2013 r. (Dane dotyczące wskaźników annotationClickThroughRate i annotationCloseRate są dostępne od 10 czerwca 2012 r.).

  • Wartość GOOGLE_SEARCH nie jest już raportowana jako oddzielna wartość w przypadku wymiaru insightTrafficSourceType. Zamiast tego odesłania z wyników wyszukiwania w Google są teraz przypisywane do typu źródła wizyt EXT_URL. W związku z tym nie można już pobrać raportu insightTrafficSourceDetail, w którym filtr insightTrafficSourceType jest ustawiony na GOOGLE_SEARCH.

31 stycznia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

16 stycznia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokument przykładowe żądania został przeprojektowany tak, aby przykłady były pogrupowane w kategorie. Użyto formatu kart podobnego do tego, który został niedawno udostępniony w przypadku raportów dotyczących kanałów i właścicieli treści. W nowej wersji przykłady są pogrupowane w tych kategoriach:

    • Podstawowe statystyki
    • Zależne od czasu
    • Geografia
    • Miejsce odtwarzania
    • Źródło wizyt
    • Urządzenie/system operacyjny
    • Grupa demograficzna
    • Sieci społecznościowe
    • Zarobki/reklamy (tylko w przypadku raportów właścicieli treści)

  • Dokument przykładowe żądania zawiera teraz nowe przykłady pobierania danych dotyczących poszczególnych prowincji w raportach o kanałach lub raportach właścicieli treści.

    • Dane dotyczące poszczególnych prowincji w przypadku stanów w USA i Waszyngtonu: Ten raport zawiera podział liczby wyświetleń i innych statystyk filmów na kanale według prowincji. Dane obejmują stany USA i Waszyngton. W przykładzie użyto wymiaru province, a także parametru filters, aby ograniczyć odpowiedź tylko do wyników dotyczących Stanów Zjednoczonych.

    • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć): ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy obejrzeli filmy na kanale lub, w przypadku raportów właściciela treści, treści objęte roszczeniem właściciela treści. W tym przykładzie używamy parametru filters, aby mieć pewność, że odpowiedź zawiera tylko dane dotyczące konkretnego województwa.

  • Definicja wymiaru province została zaktualizowana. Zawiera teraz informację, że jeśli w wartości parametru dimensions znajduje się province, w żądaniu należy też ograniczyć dane do Stanów Zjednoczonych, dodając country==US do wartości parametru filters.

6 stycznia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumenty z listą obsługiwanych raportów dotyczących kanałów i właścicieli treści zostały przeprojektowane. Zamiast tabeli z listą wszystkich możliwych raportów każdy dokument zawiera raporty pogrupowane w kategorie:

    • Podstawowe statystyki
    • Zależne od czasu
    • Geografia
    • Miejsce odtwarzania
    • Źródło wizyt
    • Urządzenie/system operacyjny
    • Grupa demograficzna
    • Sieci społecznościowe
    • Najpopularniejsze filmy

    W każdym dokumencie te kategorie są wyświetlane jako lista kart. Możesz kliknąć dowolną kartę, aby wyświetlić obsługiwane raporty w danej kategorii.

  • Interfejs API obsługuje teraz 3 nowe wymiary geograficzne: province, continent i subContinent.

    • Wymiar province umożliwia pobieranie statystyk dotyczących stanów w USA i Dystryktu Kolumbii. Interfejs API obsługuje 2 zastosowania tego wymiaru:

      • Interfejs API obsługuje 2 raporty, które zawierają statystyki podzielone według stanu. Oba raporty są dostępne dla kanałów i właścicieli treści.

        • Raport z podstawowymi statystykami zawiera kilka statystyk, w tym liczbę wyświetleń i szacunkową liczbę minut oglądania.
        • Raport oparty na czasie zawiera te same statystyki, ale dane są w nim agregowane codziennie, co 7 dni, co 30 dni lub co miesiąc.

      • Za pomocą parametru zapytania filters możesz ograniczyć raport tak, aby zawierał tylko statystyki dotyczące konkretnego stanu. Ten typ filtrowania obsługuje kilka raportów, m.in. raporty geograficzne, raporty o miejscach odtwarzania, raporty o źródłach wizyt, raporty o urządzeniach, raporty o systemach operacyjnych, raporty demograficzne i raporty o najpopularniejszych filmach.

    • Wymiar continent określa kod regionu statystycznego ONZ, który identyfikuje kontynent. Tego wymiaru można używać tylko jako filtra.

    • Wymiar subContinent określa kod regionu statystycznego ONZ, który identyfikuje podregion kontynentu. Tego wymiaru można używać tylko jako filtra.

      Każdy podregion jest powiązany tylko z jednym kontynentem, więc jeśli używasz filtra subContinent, nie musisz też używać filtra continent. (W rzeczywistości interfejs API zwróci błąd, jeśli żądanie będzie używać obu tych wymiarów).

  • W dokumentacji wprowadziliśmy poprawkę, aby wymiar insightTrafficSourceDetail nie zawierał wartości insightTrafficSourceType PROMOTED jako prawidłowej wartości filtra.

30 września 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs YouTube Analytics API podlega teraz zasadom wycofywania opisanym w Warunkach korzystania z usługi. Jednak wymiary i dane niepodstawowe interfejsu API nie podlegają zasadom wycofywania. Strony Wymiary i Dane zostały zaktualizowane i zawierają teraz listę podstawowych wymiarów i danych. Dodatkowo definicje na tych stronach zostały zaktualizowane, aby wyraźnie wskazywać podstawowe wymiary i dane.

  • Interfejs API obsługuje teraz wartość EXTERNAL_APP w przypadku wymiaru insightPlaybackLocationType. W związku z tą zmianą od 10 września 2013 r. odtworzenia nie są już klasyfikowane jako MOBILE odtworzenia, chociaż odtworzenia na urządzeniach mobilnych, które miały miejsce przed tą datą, nadal będą klasyfikowane z tą wartością.

    Po tej aktualizacji odtworzenia na urządzeniach mobilnych są klasyfikowane jako odtworzenia WATCH, EMBEDDED lub EXTERNAL_APP w zależności od typu aplikacji, w której występują.

  • Interfejs API obsługuje teraz wartość PLAYLIST w przypadku wymiaru insightTrafficSourceType. Wartość wskazuje, że wyświetlenia filmu pochodzą z playlisty. Wcześniej te wyświetlenia byłyby klasyfikowane w kategorii YT_OTHER_PAGE wymiaru.

16 lipca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API umożliwia teraz sortowanie raportów według wielu wymiarów i danych. Dokument z przykładowymi żądaniami zawiera nowy przykład Sortowanie żądań według wielu wymiarów lub danych, który pokazuje tę funkcję. Żądanie pobiera dane o źródłach wizyt i ma wartość parametru sort ustawioną na day,-views. Wyniki są posortowane chronologicznie, ale w zbiorze wyników dla każdego dnia pierwszy wiersz zawiera dane o źródle wizyty, które wygenerowało najwięcej wyświetleń, drugi wiersz zawiera dane o źródle, które wygenerowało kolejną największą liczbę wyświetleń, i tak dalej.

  • Interfejs API obsługuje teraz 2 nowe wymiary: deviceType i operatingSystem. Możesz ich używać do pobierania danych o urządzeniach, na których widzowie oglądają Twoje filmy. Interfejs API obsługuje raporty, które używają obu tych wymiarów lub tylko jednego z nich.

    • Raport deviceType umożliwia pobieranie liczby wyświetleń i szacowanego czasu oglądania na różnych typach urządzeń, w tym komputerach, urządzeniach mobilnych i tabletach. Możesz też użyć filtra operatingSystem, aby ograniczyć raport dotyczący typu urządzenia tylko do statystyk urządzeń z określonym systemem operacyjnym, np. Android lub iOS.

    • operatingSystem umożliwia pobieranie liczby wyświetleń i szacowanego czasu oglądania w przypadku różnych systemów operacyjnych, takich jak Android, iOS, Linux i inne. Możesz też użyć filtra deviceType, aby ograniczyć raport dotyczący systemów operacyjnych do statystyk dotyczących tylko określonego typu urządzenia, np. urządzeń mobilnych lub tabletów.

    Nowe raporty dotyczące typu urządzenia i systemu operacyjnego są dostępne dla kanałów i właścicieli treści.

  • Zaktualizowaliśmy dokument przykładowe żądania, aby uwzględnić 3 raporty o urządzeniach dla kanałów i 3 raporty o urządzeniach dla właścicieli treści.

  • Wymiar insightPlaybackLocationType może zwracać wartość YT_OTHER, która identyfikuje wyświetlenia niezaklasyfikowane przy użyciu jednej z pozostałych wartości tego wymiaru.

23 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

10 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

6 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz możliwość pobierania danych o czasie oglądania – estimatedMinutesWatched, averageViewDuration i averageViewPercentage – w połączeniu z innymi danymi, w tym danymi o wyświetleniach, zaangażowaniu, zarobkach i skuteczności reklam.

    Listy dostępnych raportów o kanałach i raportów o właścicielach treści zostały zaktualizowane, aby uwzględnić tę zmianę. (Listy są teraz krótsze, ponieważ dane o czasie oglądania można pobrać w ramach innych wymienionych raportów).

    Zaktualizowaliśmy też dokument Przykładowe żądania do interfejsu API.

  • Raporty, które korzystają z wymiarów insightPlaybackLocationDetail i insightTrafficSourceDetail, zostały ulepszone w ten sposób:

    • Obsługują teraz opcjonalny filtr country.

    • Właściciele treści mogą teraz pobierać te raporty, korzystając z dowolnej z tych nowych kombinacji filter. Pamiętaj, że wszystkie te kombinacje obsługują też opcjonalny filtr country.

      • Szczegóły miejsca odtwarzania

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

      • Szczegóły źródła wizyt

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

3 maja 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowy dokument Przykładowe żądania interfejsu API zawiera przykłady pokazujące, jak pobierać wiele różnych typów raportów za pomocą interfejsu YouTube Analytics API. Każdy przykład zawiera krótki opis raportu, który jest pobierany przez żądanie, a następnie wymiary, dane, filtry i parametry sortowania żądania.

  • Wymiar insightTrafficSourceType obsługuje teraz wartość SUBSCRIBER. Ta wartość określa wyświetlenia filmów, które pochodzą z kart na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli zastosujesz filtr na podstawie tego źródła wizyt, w polu insightTrafficSourceDetail zostanie podana karta Główna lub inna strona, z której pochodzą wyświetlenia.

28 marca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

21 marca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz dane o zarobkach i skuteczności reklam, a także nowe raporty o skuteczności reklam. Dane i raporty są dostępne tylko dla partnerów YouTube, którzy uczestniczą w programie partnerskim YouTube.

    • Nowo obsługiwane raporty zawierają dane o skuteczności reklam oparte na odtworzeniach i wyświetleniach. Więcej informacji o raportach skuteczności reklam znajdziesz w dokumentacji dotyczącej raportów właściciela treści.

    • Poniżej znajdziesz listę nowo obsługiwanych danych. Zaktualizowaliśmy listę raportów właściciela treści, aby wskazać raporty, w tym 2 nowe, które obsługują te dane.

      • earnings – łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google.
      • grossRevenue – szacunkowe przychody brutto od Google lub partnerów DoubleClick.
      • primaryAdGrossRevenue – szacunkowe przychody brutto zsumowane i sklasyfikowane według głównego typu reklamy w przypadku odtworzeń filmu, których dotyczy raport, pochodzące od partnerów Google lub DoubleClick.
      • monetizedPlaybacks – liczba odtworzeń, w przypadku których wyświetlono co najmniej 1 reklamę.
      • playbackBasedCpm – szacunkowe przychody brutto na tysiąc odtworzeń.
      • impressions – liczba zrealizowanych zweryfikowanych wyświetleń reklam.
      • impressionBasedCpm – szacunkowe przychody brutto z tysiąca wyświetleń reklamy.

      Uwaga: szczegółowe informacje znajdziesz w definicjach danych.

    • Każde żądanie, które pobiera dane o zarobkach lub skuteczności reklam, musi wysyłać token autoryzacji przyznający dostęp za pomocą nowego zakresu https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • Dokumentacja interfejsu API została przeorganizowana, dzięki czemu różne typy raportów są wyjaśnione na osobnych stronach. Dlatego teraz dostępne są osobne strony z wyjaśnieniami dotyczącymi różnych typów raportów o kanałach i raportów właścicieli treści.

4 lutego 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • W przewodniku po interfejsie API jest teraz sekcja Przykłady, która zawiera przykłady kodu pokazujące, jak wywoływać interfejs API za pomocą bibliotek klienta w językach Java, JavaScript, Python i Ruby. Przykładowy kod JavaScript jest taki sam jak ten, który został szczegółowo omówiony w dokumentacji przykładowej aplikacji.

14 listopada 2012 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumentacja API zawiera teraz APIs Explorer, który umożliwia wywoływanie interfejsu API, wyświetlanie żądania API i pobieranie rzeczywistych danych w odpowiedzi.

  • Interfejs API obsługuje wiele nowych raportów dla kanałów i właścicieli treści, które zostały opisane poniżej. Każdy raport jest dostępny jako raport dotyczący kanału lub raport dotyczący właściciela treści. Zaktualizowaliśmy też odpowiednio strony Wymiary i Dane.

    • Raport o miejscach odtwarzania określa liczbę wyświetleń filmu, które miały miejsce na różnych typach stron lub w aplikacjach.

    • Raport szczegółowy dotyczący miejsca odtwarzania wskazuje odtwarzacze umieszczone na innych stronach, które wygenerowały najwięcej wyświetleń określonego filmu. Zawiera bardziej szczegółowe informacje niż raport Lokalizacja odtwarzania, ponieważ identyfikuje adresy URL powiązane z najpopularniejszymi odtwarzaczami umieszczonymi na innych stronach.

    • Raport Źródła wizyt określa liczbę wyświetleń filmów pochodzących z różnych rodzajów witryn odsyłających.

    • Raport szczegółowy dotyczący źródeł wizyt wskazuje witryny odsyłające, które wygenerowały najwięcej wyświetleń określonego filmu i określonego typu źródła wizyt. Na przykład ten raport może Ci pokazać filmy powiązane, które wygenerowały najwięcej wizyt w przypadku konkretnego filmu. Ten raport jest obsługiwany w przypadku kilku źródeł wizyt.

    • Raporty dotyczące czasu oglądania pokazują, ile czasu widzowie spędzili na oglądaniu Twoich treści. Raporty mogą agregować dane z określonego przedziału czasu (np. dnia, ostatnich 7 dni, ostatnich 30 dni) lub kraju. Jeśli raport zawiera dane zagregowane według dnia lub kraju, może też określać średnią długość każdego wyświetlenia filmu oraz średni odsetek każdego filmu, który obejrzeli użytkownicy.

2 października 2012 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API jest teraz dostępny dla wszystkich deweloperów. Możesz aktywować interfejs API w swoim projekcie bez konieczności wcześniejszego wysyłania prośby o dostęp. Wystarczy, że w panelu Usługi w APIs console klikniesz Aktywuj.

  • W nowej sekcji Pierwsze kroki znajdziesz wymagania wstępne i podstawowe czynności związane z tworzeniem aplikacji korzystającej z YouTube Analytics API.

12 września 2012 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowa sekcja Wykorzystanie limitu zawiera wskazówki dotyczące optymalizacji wykorzystania limitu interfejsu API. Serwer API oblicza koszt zapytania dla każdego żądania, a ten koszt jest odejmowany od limitu wykorzystania interfejsu API. Różne typy raportów mogą mieć bardzo różne koszty zapytań, dlatego należy planować efektywne wykorzystanie limitu. Aplikacja powinna wysyłać zapytania tylko o te dane i rodzaje informacji, których rzeczywiście potrzebuje.

  • Zaktualizowaliśmy sekcję Wymiary czasowe, aby wyjaśnić, że te wymiary wskazują, że raport Analytics powinien agregować dane na podstawie przedziału czasu. Interfejs API obsługuje teraz te dodatkowe wymiary czasowe:

    • 7DayTotals – dane w raporcie będą agregowane tak, aby każdy wiersz zawierał dane z 7-dniowego okresu.
    • 30DayTotals – dane w raporcie będą agregowane tak, aby każdy wiersz zawierał dane z 30-dniowego okresu.
    • month – dane w raporcie będą agregowane według miesiąca kalendarzowego.

    Podobnie zaktualizowaliśmy sekcję dostępne raporty, aby odzwierciedlała obsługę przez interfejs API raportów, które używają tych wymiarów.

  • W sekcji Wymiary jednostki raportującej dodaliśmy informację, że żądania interfejsu API dotyczące pobierania raportów właściciela treści muszą filtrować dane za pomocą jednego z tych wymiarów (video, channel lub show) albo obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

  • Interfejs API obsługuje teraz 2 nowe opcje sortowania raportów dotyczących najpopularniejszych filmów. Raporty te są dostępne jako raporty dotyczące kanału lub raporty właściciela treści. Zawierają dane (wyświetlenia, komentarze, polubienia itp.) dotyczące poszczególnych krajów i są podzielone według filmów. Możesz teraz sortować te raporty na podstawie liczby użytkowników, którzy zasubskrybowali lub anulowali subskrypcję kanału na stronie odtwarzania filmu.

  • Zaktualizowaliśmy definicje subscribersGained i subscribersLost danych, aby wyjaśnić, że kanał może zyskać lub stracić subskrybentów w kilku miejscach, m.in. na stronie odtwarzania filmu, stronie kanału i w przewodniku, który pojawia się na stronie głównej YouTube. Gdy te dane pojawiają się w raporcie dotyczącym konkretnego filmu, obejmują tylko statystyki ze strony odtwarzania tego filmu.