Historia wersji

Ta strona zawiera listę zmian w interfejsach API i aktualizacji dokumentacji interfejsu API YouTube do raportowania oraz YouTube Analytics API. Oba interfejsy API umożliwiają deweloperom dostęp do danych Statystyk YouTube, ale na różne sposoby.

6 listopada 2026 r.

Dokumentacja dotycząca wymiarów miejsca odtwarzania została zaktualizowana zarówno w przypadku interfejsu API YouTube do raportowania, jak i YouTube Analytics API:

  • W tabeli wymiarów playback_location_type w interfejsie YouTube Reporting API są teraz dokumentowane wartości 11 (wyświetlenia, które miały miejsce na liście transmisji na żywo w pionie) i 12 (wyświetlenia, które miały miejsce na karcie Sample w YouTube Music).
  • W YouTube Analytics API definicja wymiaru insightPlaybackLocationType zawiera teraz wartości IMMERSIVE_LIVE_FEED (wyświetlenia, które miały miejsce na liście transmisji na żywo w pionie) i SHORTS_FEED (wyświetlenia, które miały miejsce na karcie YouTube Shorts).

4 listopada 2026 r.

Od 15 stycznia 2027 r. wersja 1.0 cotygodniowego raportu o plikach referencyjnych dla właścicieli treści (content_owner_active_references_a1) jest wycofana i została zastąpiona wersją 1.1 (content_owner_active_references_a2). Przed 15 stycznia 2027 r. przejdź na najnowszą wersję.

30 października 2026 r.

Interfejs API YouTube do raportowania obsługuje teraz te raporty zarządzane przez system dla właścicieli treści:

Kategoria Nazwa raportu Identyfikator typu raportu
Podsumowania finansowe Miesięczne podsumowanie korekt na poziomie kanału content_owner_channel_adjustments_summary_a1
Podsumowania finansowe Miesięczne przychody z transakcji dotyczących płatnych funkcji content_owner_transactions_paid_features_revenue_a1
Podsumowania finansowe Miesięczne przychody z transakcji TVOD według tytułu i kraju tvod_content_owner_country_title_tvod_revenue_a1
Podsumowania finansowe Miesięczne przychody z transakcji TVOD według kraju tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Miesięczne tworzenie zasobów filmów Short przez wytwórnie muzyczne music_content_owner_shorts_asset_creations_a1
Shorts Miesięczna liczba wyświetleń zasobów wytwórni muzycznej w Shorts music_content_owner_shorts_asset_views_a1
Shorts Miesięczne wykorzystanie zasobów wydawcy muzyki w filmach Short publisher_content_owner_shorts_asset_creations_a1
Shorts Miesięczne wyświetlenia zasobów filmów Short wydawcy muzyki publisher_content_owner_shorts_asset_views_a1
Podatki Miesięczny raport podsumowujący zwrot podatku podmiotów stowarzyszonych sieci wielokanałowej content_owner_affiliate_tax_refund_summary_a1
Assets Tygodniowy raport SRMF publisher_content_owner_weekly_srmf
Assets Raport dzienny o stanie próśb dotyczących oficjalnych kanałów wykonawców content_owner_oac_request_status_a1
Assets Codzienny raport jakości próśb o oficjalny kanał wykonawcy content_owner_oac_quality_status_a1

13 września 2026 r.

Interfejs API YouTube do raportowania obsługuje teraz wersję 1.1 cotygodniowego raportu o plikach referencyjnych dla właścicieli treści (content_owner_active_references_a2).

Wersja 1.1 wprowadza te zmiany:

  • Dodaje pole status_detail, które zawiera dodatkowe informacje lub powód stanu pliku referencyjnego.
  • Aktualizuje pole asset_owners, aby używać wyświetlanych nazw właścicieli treści lub identyfikatorów zewnętrznych zamiast kodów partnerów.

Poprzednia wersja raportu, Wersja 1.0 (content_owner_active_references_a1), jest nadal dostępna.

9 września 2026 r.

Dokumentacja interfejsu YouTube Analytics API i interfejsu API YouTube do raportowania została zaktualizowana o te dodatki i wyjaśnienia:

  • Gwarancja jakości usług dotycząca częstotliwości aktualizacji danych i opóźnień: dodaliśmy do modelu danych specjalną sekcję, w której wyjaśniamy opóźnienie przetwarzania danych wynoszące od 48 do 72 godzin oraz obcinanie daty zakończenia do ostatniego dnia, w którym dane zostały w pełni przetworzone. Zalecamy też metodę videos.list interfejsu YouTube Data API do uzyskiwania statystyk filmów w czasie rzeczywistym.

  • Dane finansowe w raportach dotyczących kanału: zaktualizowaliśmy dokumentację dotyczącą autoryzacji raportów dotyczących kanału, aby wyjaśnić, że dane dotyczące szacunkowych przychodów i wskaźników skuteczności reklam są obsługiwane w raportach dotyczących kanału autoryzowanych z zakresem https://www.googleapis.com/auth/yt-analytics-monetary.readonly, gdy kanał jest członkiem programu partnerskiego YouTube (YPP), a kanały, które nie zarabiają, zwracają błąd HTTP 403 Forbidden.

  • Ograniczenia zapytań i zgodność parametrów: dodaliśmy do artykułu Tabele raportów informację, że nieprawidłowe lub wzajemnie wykluczające się kombinacje wymiarów, danych i filtrów zwracają błąd HTTP 400 badRequest ("The query is not supported.").

  • Puste wartości wymiarów w raportach zbiorczych: zaktualizowaliśmy charakterystykę raportów interfejsu API YouTube do raportowania, aby wyjaśnić, że kolumny wymiarów, takie jak video_id lub channel_id, zawierają puste ciągi znaków, aby zachować zagregowane liczby danych dotyczących usuniętych zasobów i reprezentować zdarzenia na poziomie kanału.

27 sierpnia 2026 r.

YouTube ujednolici sposób zliczania wyświetleń publicznych we wszystkich formatach wideo: długich filmach, transmisjach na żywo i Shorts. YouTube będzie zliczać wyświetlenia publiczne od momentu rozpoczęcia odtwarzania filmu.

Nie ma to wpływu na możliwość zarabiania ani na większość podstawowych wskaźników skuteczności, ponieważ są one powiązane ze wskaźnikami zaangażowania. Zarobki twórców nadal będą zależeć od „wyświetleń filmów Short z zaangażowaniem” i „godzin czasu oglądania z zaangażowaniem”, które możesz sprawdzić w Statystykach YouTube > Tryb zaawansowany.

Wymagania dotyczące udziału w programie partnerskim YouTube pozostają bez zmian. Wymagania dotyczące udziału w programie partnerskim YouTube będą teraz określane jako „kwalifikujące się wyświetlenia filmów Short” i „kwalifikujący się czas oglądania w godzinach” (wcześniej „zweryfikowane wyświetlenia publicznych filmów Short” i „zweryfikowane godziny czasu oglądania publicznych filmów”).

Więcej informacji znajdziesz w artykule Analiza skuteczności treści w YouTube.

Wskaźnik Stan Aktywator Używane do
Wyświetl Zaktualizowano Film jest odtwarzany od pierwszej klatki (obejmuje to autoodtwarzanie, najechanie kursorem i kliknięcie/dotknięcie, aby odtworzyć). Standardowa liczba wyświetleń publicznych.
Wyświetlenie angażujące Bez zmian Odtwarzanie trwa dłużej niż pierwsza klatka lub użytkownik klika, aby odtworzyć. Zarabianie w ramach programu partnerskiego YouTube, większość podstawowych statystyk (współczynnik klikalności, średni czas oglądania) i raporty dotyczące zaangażowania.
Wyświetlenie miniatury Bez zmian Miniatura jest wyświetlana bez interakcji lub autoodtwarzania. Mierzy ekspozycję i opakowanie na poziomie kanału.

Aktualizacje dokumentacji API: zaktualizowaliśmy definicję wskaźnika engagedViews w dokumentacji YouTube Analytics API i YouTube Reporting API.

25 czerwca 2026 r.

Dokumentacja interfejsu YouTube Analytics API (zapytania ukierunkowane) została zaktualizowana, aby usunąć raport Aktywność użytkowników według miasta dla właścicieli treści. Ten raport nie jest obsługiwany w przypadku właścicieli treści. Zapytania właścicieli treści dotyczące aktywności użytkowników według miasta zwrócą puste wyniki.

9 marca 2026 r.

Wymiary ageGroup (YouTube Analytics API) i age_group (interfejs API YouTube do raportowania) obejmują teraz użytkowników, którzy według szacunków YouTube mają mniej niż 18 lat.

15 stycznia 2026 r.

Interfejs YouTube Reporting API obsługuje teraz raporty dotyczące zasięgu dla kanałów i właścicieli treści. Raporty dotyczące zasięgu zawierają statystyki dotyczące wyświetleń miniatur filmów i współczynników klikalności.

  • Raporty channel_reach_basic_a1 i channel_reach_combined_a1 są dostępne dla kanałów.
  • Raporty content_owner_reach_basic_a1 i content_owner_reach_combined_a1 są dostępne dla właścicieli treści.

Te raporty obsługują te nowe dane:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 września 2025 r.

Wcześniej ogłoszone wycofanie raportów zostało przesunięte z 30 września 2025 r. na 31 października 2025 r. Do tego czasu będą dostępne poprzednie wersje raportów zaktualizowanych pod kątem zmian w liczbie wyświetleń filmów Short, z wyjątkiem raportu dotyczącego roszczeń w wersji 1.0 (content_owner_active_claims_a1) i raportu dotyczącego roszczeń 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 API raportów zbiorczych zostanie zaktualizowany w ramach nowej zmiany dotyczącej liczby wyświetleń filmów Short. Wprowadziliśmy te zmiany:

  • Nowe wersje raportów zostały utworzone dla każdego raportu, który zawiera wyświetlenia, czyli dla większości raportów. Wersja każdego raportu, którego dotyczy problem, została zwiększona o 1, np. z wersji a2 do wersji a3.
  • W przypadku Shorts wyświetlenia będą teraz odzwierciedlać, ile razy rozpoczęto lub ponowiono odtwarzanie filmu Short. W przypadku filmów nie ma żadnych zmian.
  • 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 te zmiany zaczną obowiązywać 30 czerwca 2025 r. Pamiętaj, aby odpowiednio dostosować przetwarzanie raportów.

Poprzednie wersje raportów 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, aby uniknąć przyszłych zmian w raportach, które mogłyby zakłócić działanie potoków przetwarzania.

W tabelach poniżej znajdziesz nowe wersje raportów dla poszczególnych typów raportów:

Raporty danych zbiorczych w Statystykach YouTube

Raporty dotyczące kanałów – Raporty dotyczące filmów
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łów – 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ściciela treści – raporty wideo
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ściciela 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 (niemuzyczne)

Raporty właściciela treści – raporty dotyczące filmów Short (niemuzyczne)
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 według kraju 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 – niefinansowe

Raporty właściciela treści – Raporty Roszczenia
Nazwa raportu Poprzednia wersja Najnowsza wersja
Aktywne roszczenia content_owner_active_claims_a2 content_owner_active_claims_a3
Raporty właściciela treści – raporty dotyczące 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.

Jak ogłosiliśmy 26 marca 2025 r., interfejs API zapytań ukierunkowanych zostanie zaktualizowany w ramach nowej zmiany dotyczącej liczby wyświetleń filmów Short:

  • W przypadku filmów Short 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ń. Wymiar engagedViews będzie dostępny we wszystkich raportach razem z wymiarem views.

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

Sprawdź tę historię zmian, aby dowiedzieć się, jakie zmiany i kiedy zostaną wprowadzone w interfejsie API raportów zbiorczych.

22 kwietnia 2025 r.

Zgodnie z ogłoszeniem z 7 kwietnia 2024 r. wymiar isCurated został wycofany w raportach dotyczących kanałów i playlist właścicieli treści. Od 31 grudnia 2024 r. ten wymiar nie jest już obsługiwany. Wymiar został usunięty z raportów i dokumentacji.

26 marca 2025 r.

Ta aktualizacja zawiera następującą zmianę dotyczącą interfejsu Statystyk YouTube i interfejsu API do raportowania:

Od 31 marca 2025 r. YouTube zmieni sposób zliczania wyświetleń filmów Short. W przeszłości w przypadku filmów Short wyświetlenie było zliczane, gdy film był odtwarzany przez określoną liczbę sekund. Teraz liczba wyświetleń będzie wskazywała to, ile razy użytkownicy rozpoczęli lub ponowili odtwarzanie filmu Short, bez wymogu minimalnego czasu oglądania. Więcej informacji

Interfejsy API Statystyk YouTube (zapytania ukierunkowane) i interfejs API YouTube do raportowania (raporty zbiorcze) zostaną zaktualizowane o następujące zmiany:

  • W przypadku filmów Short views odzwierciedlają, 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 dotyczące zarówno zaktualizowanych wyświetleń, jak i wyświetleń zamierzonych.

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

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

Sprawdź tę historię zmian, aby dowiedzieć się, kiedy wprowadzono 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 funkcji.

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

15 listopada 2024 r.

Uwaga: ta zmiana obowiązuje od 18 listopada 2024 r.

Zaktualizowaliśmy dokumentację interfejsu YouTube Analytics (Targeted Queries) API, aby poinformować, że w przypadku raportów dotyczących źródeł 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 dla 500 identyfikatorów filmów, może żądać danych z maksymalnie 100 dni.

Ta zmiana dotyczy raportów zarówno dla 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. Zasadniczo w przypadku dużych zbiorów danych zalecamy raporty zbiorcze.

6 maja 2024 r.

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

Dodatkowo raport Utrzymanie uwagi odbiorców został ulepszony i obsługuje teraz 3 nowe rodzaje danych:

7 kwietnia 2024 r.

Interfejs Statystyk YouTube API (zapytania ukierunkowane) zawiera kilka aktualizacji dotyczących raportów o playlistach właścicieli treści. Aktualizacje są takie same jak te dotyczące raportów o playlistach kanału, które zostały ogłoszone 19 stycznia 2024 r.

Ten wpis w historii zmian zawiera prawie takie same informacje jak wpis z 19 stycznia 2024 r. Pamiętaj jednak, że raporty dotyczące playlist właściciela treści będą obsługiwać wymiar isCurated do 31 grudnia 2024 r., a raporty dotyczące playlist kanału będą obsługiwać ten wymiar do 30 czerwca 2024 r.

  • Uwaga: to jest ogłoszenie o wycofaniu funkcji.

    Wymiar isCurated został wycofany w raportach dotyczących playlist właściciela treści. Od 31 grudnia 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. Dane views są nadal obsługiwane w raportach dotyczących playlist, choć mają inne znaczenie, więc interfejs API będzie nadal zwracać dane, jeśli nie zaktualizujesz nazwy danych. Możesz oczywiście 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 nowych raportach dotyczących playlist kanału.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist kanału. 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 dotyczących playlist kanału. 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.

  • Sekcja raportów dotyczących playlist w dokumentacji raportów właściciela treści została zaktualizowana, aby dokładniej wyjaśnić rodzaje 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 również należą do tego właściciela treści. Zbiorcze dane dotyczące filmów są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru isCurated.
    • Dane dotyczące playlist odzwierciedlają aktywność użytkownika i zaangażowanie w kontekście strony playlisty. Te dane obejmują też wyświetlenia filmów, które nie należą do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • Sekcja obsługiwanych danych dotyczących playlist zawiera zbiorcze dane dotyczące filmów i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.

  • W raportach dotyczących playlist dla 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 do interfejsu API dotyczące pobrania raportów nie używa wymiaru isCurated. Definicje poszczególnych danych znajdziesz w dokumentacji dotyczącej danych:

  • Działanie danych views zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport dotyczący playlisty, używało 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 są zagregowanymi danymi dotyczącymi filmów, które określają łączną liczbę wyświetleń filmów na playlistach właściciela treści, niezależnie od tego, czy te wyświetlenia miały miejsce w kontekście playlisty. Łączna liczba 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. Te dane obejmują wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W przypadku każdego raportu dotyczącego playlisty dokumentacja raportów właściciela treści zawiera teraz tabele z obsługiwanymi danymi dla tego raportu w zależności od tego, czy żądanie do interfejsu API zawiera wymiar isCurated. Przykład znajdziesz w sekcji dotyczącej raportów o playlistach opartych na czasie.

19 stycznia 2024 r.

Interfejs Statystyki YouTube API (zapytania ukierunkowane) zawiera kilka aktualizacji związanych z raportami dotyczącymi playlist kanału. Aktualizacje obejmują wycofany wymiar oraz kilka nowych i zaktualizowanych danych:

  • Uwaga: to jest ogłoszenie o wycofaniu funkcji.

    Wymiar isCurated został wycofany z raportów dotyczących kanałów. Od 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. Dane views są nadal obsługiwane w raportach dotyczących playlist, choć mają inne znaczenie, więc interfejs API będzie nadal zwracać dane, jeśli nie zaktualizujesz nazwy danych. Możesz oczywiście 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 nowych raportach dotyczących playlist kanału.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist kanału. 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 dotyczących playlist kanału. 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.

  • Sekcja raportów dotyczących playlist w dokumentacji raportów kanału została zaktualizowana, aby dokładniej wyjaśnić rodzaje 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 kanału, które również należą do tego kanału. Zbiorcze dane dotyczące filmów są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru isCurated.
    • Dane dotyczące playlist odzwierciedlają aktywność użytkownika i zaangażowanie w kontekście strony playlisty. Te dane obejmują też wyświetlenia filmów, które nie należą do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • Sekcja obsługiwanych danych dotyczących playlist zawiera zbiorcze dane dotyczące filmów i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.

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

  • Działanie danych views zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport dotyczący playlisty, używało wymiaru isCurated:

    • Gdy żądanie zawiera wymiar isCurated, dane views są danymi dotyczącymi playlisty, które wskazują, ile razy filmy zostały wyświetlone w kontekście playlist kanału.
    • Jeśli żądanie nie zawiera wymiaru isCurated, dane views są zagregowanymi danymi dotyczącymi filmów, które określają łączną liczbę wyświetleń filmów z playlist kanału, niezależnie od tego, czy te wyświetlenia miały miejsce w kontekście playlisty. Łączna liczba 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. Te dane obejmują wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W przypadku każdego raportu dotyczącego playlisty dokumentacja raportów dotyczących kanału zawiera teraz tabele z obsługiwanymi danymi dla tego raportu w zależności od tego, czy żądanie do interfejsu API zawiera wymiar isCurated. Przykład znajdziesz w sekcji dotyczącej raportów o playlistach opartych na czasie.

4 grudnia 2023 r.

Interfejs API Statystyk YouTube (zapytania ukierunkowane) został zaktualizowany, aby scalić 2 wartości wymiaru insightTrafficSourceType. Wcześniej wymiar rozróżniał filmy odtwarzane w ramach playlisty (PLAYLIST) i wyświetlenia pochodzące ze strony zawierającej listę wszystkich filmów na playliście (YT_PLAYLIST_PAGE). Od teraz oba rodzaje wyświetleń będą powiązane z wartością wymiaru PLAYLIST.

15 grudnia 2022 r.

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

  • Nowy raport zawiera informacje o aktywności użytkowników według miasta. Ten raport jest dostępny dla kanałów i właścicieli treści. Ten raport zawiera nowy wymiar city, który określa szacowane przez YouTube miasto, w którym miała miejsce aktywność użytkownika.

  • Nowy wymiar creatorContentType określa typ treści w YouTube powiązanych z danymi o 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 opcjonalny we wszystkich raportach dotyczących filmów na kanale i należących do właściciela treści.

  • Przewodnik po przykładowych żądaniach interfejsu YouTube Analytics API zawiera teraz przykłady 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.

Zarówno interfejs API Statystyk YouTube (zapytania ukierunkowane), jak i interfejs API YouTube do raportowania (raporty zbiorcze) obsługują nową wartość szczegółów źródła wizyt:

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

11 lutego 2022 r.

Zbiór 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 zapewnia zgodności wstecznej. Zgodnie z sekcją Zmiany powodujące brak zgodności wstecznej Warunków korzystania z usług YouTube API ogłaszamy tę zmianę na 6 miesięcy przed jej wejściem w życie. Zaktualizuj implementację interfejsu API przed 11 sierpnia 2022 r., aby zapewnić płynne przejście na nowy zestaw wartości.

Wprowadzamy te zmiany:

  • W interfejsie YouTube Analytics API (zapytania ukierunkowane) wymiar gender obsługuje obecnie 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 YouTube Reporting (raporty zbiorcze) API wymiar gender obsługuje obecnie 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ć ruch z zapętlonych klipów. Ta zmiana dotyczy zarówno interfejsu API Statystyk YouTube (zapytania ukierunkowane), jak i interfejsu API YouTube do raportowania (raporty zbiorcze).

2 lutego 2022 r.

Interfejs YouTube Reporting API (raporty zbiorcze) obsługuje nową wartość wymiaru związanego ze źródłami wizyt, która wskazuje, że wyświetlenia pochodzą z Live Redirects:

  • W interfejsie YouTube Reporting API (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 widz został przekierowany.

23 września 2020 r.

Zarówno interfejs YouTube Analytics API (zapytania ukierunkowane), jak i interfejs API YouTube do raportowania (raporty zbiorcze) obsługują nową wartość wymiaru związanego ze źródłami wizyt, która wskazuje, że widz został przekierowany przez przesunięcie palcem w pionie podczas oglądania YouTube Shorts:

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

Wymiar szczegółów źródła wizyt – insightTrafficSourceDetail w interfejsie YouTube Analytics API lub traffic_source_detail w interfejsie API YouTube do raportowania – 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 (zapytania ukierunkowane):

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

13 lutego 2020 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu API Statystyk YouTube (zapytania ukierunkowane) i interfejsu API YouTube do raportowania (raporty zbiorcze). Więcej informacji na temat tych zmian 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 ukierunkowanych powiadomienia są raportowane jako insightTrafficSourceType=NOTIFICATION. W raportach zbiorczych powiadomienia są raportowane 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ż powiadomienia push, takich jak e-maile lub powiadomienia w skrzynce odbiorczej, wysyłanych do subskrybentów po przesłaniu filmu.

Te wartości są zwracane dla zakresu czasu 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 powiadomienie push wysłane po przesłaniu filmu.

15 października 2019 r.

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

  • Uwaga: to jest ogłoszenie o wycofaniu funkcji.

    YouTube wycofuje obsługę wymiarów 7DayTotals i 30DayTotals. Do 15 kwietnia 2020 r. możesz nadal pobierać dane za pomocą tych wymiarów. Od tego dnia próby pobrania raportów z wymiarem 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 zapytanie za pomocą wymiaru day i agregując lub uzyskując dane z okresów 7- lub 30-dniowych. Na przykład:

    • Liczbę wyświetleń w okresie 7 dni można obliczyć, sumując liczbę wyświetleń z każdego dnia tego okresu.
    • Wartość viewerPercentage dla okresu 7 dni można obliczyć, mnożąc liczbę wyświetleń z każdego dnia przez wartość viewerPercentage z tego dnia, aby uzyskać liczbę widzów, którzy byli zalogowani podczas oglądania filmu w danym dniu. Następnie można dodać liczbę zalogowanych widzów w całym okresie 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 okresie 7 dni, ponieważ ten sam widz może zostać policzony jako unikalny widz w różne dni. Możesz jednak użyć wymiaru month zamiast wymiaru 30DayTotals, aby ekstrapolować dane o liczbie unikalnych widzów w okresie 30 dni. Pamiętaj, że wymiar month odnosi się do miesięcy kalendarzowych, a wymiar 30DayTotals oblicza okresy 30-dniowe 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 (zapytania ukierunkowane):

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

1 listopada 2018 r.

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

  • 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ć przerwy w działaniu usługi. Szczegółowe informacje znajdziesz w przewodniku po migracji.

    Pamiętaj, że harmonogram wycofywania został pierwotnie ogłoszony 26 kwietnia 2018 r.

17 września 2018 r.

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

  • Nowa sekcja Anonimizacja danych w dokumencie z omówieniem modelu danych wyjaśnia, że niektóre dane w Statystykach YouTube są ograniczone, gdy nie przekraczają określonego progu. Może się tak zdarzyć w różnych przypadkach. W praktyce oznacza to, że raport może nie zawierać części danych lub być całkiem pusty, 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.

    Nowa sekcja zawiera też omówienie typów danych, które mogą być ograniczone w raportach Statystyk YouTube.

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

18 czerwca 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics API (zapytania ukierunkowane):

  • Zmieniły się wymagania dotyczące zakresu w przypadku tych metod:
    • Żądania do metody reports.query muszą mieć dostęp do zakresu https://www.googleapis.com/auth/youtube.readonly.
    • Żądania do metody groupItems.list muszą mieć dostęp do:
      • zakres https://www.googleapis.com/auth/youtube
        lub
      • zakres https://www.googleapis.com/auth/youtube.readonly
        oraz
        zakres https://www.googleapis.com/auth/yt-analytics.readonly

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

23 maja 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics API (zapytania ukierunkowane):

  • Przegląd interfejsu API zawiera nową sekcję Dane zbiorcze i usunięte elementy, która wyjaśnia, jak odpowiedzi interfejsu API obsługują dane powiązane z usuniętymi zasobami, takimi jak filmy, playlisty czy kanały.
  • Sekcja Sprawdzone metody w Przeglądzie interfejsu API została zaktualizowana, aby przypomnieć, że możesz używać interfejsu YouTube Data API do pobierania dodatkowych metadanych zasobów zidentyfikowanych w odpowiedziach interfejsu YouTube Analytics API. Zgodnie z Zasadami dla deweloperów korzystających z 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 te zmiany związane z interfejsem YouTube Reporting (raporty zbiorcze) API:

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

    • Po wprowadzeniu zmiany większość raportów z interfejsu API, w tym raporty z danymi historycznymi, 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 interfejsu API były dostępne przez 180 dni od momentu ich wygenerowania. Po wejściu w życie tej zmiany raporty z danymi historycznymi, które mają więcej niż 30 dni, nie będą już dostępne przez interfejs API. Wszystkie pozostałe raporty, które mają więcej niż 60 dni, również nie będą już dostępne. W związku z tym w dokumentacji znajduje się teraz informacja, że raporty utworzone przed zmianą zasad będą dostępne przez maksymalnie 180 dni.

    • Po wprowadzeniu zmiany, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty od tego dnia i obejmujące 30-dniowy okres przed zaplanowaniem zadania. Przed wprowadzeniem zmiany, gdy zaplanujesz zadanie raportowania, YouTube wygeneruje raporty obejmujące okres 180 dni przed zaplanowaniem zadania.

  • Sekcja Sprawdzone metody została zaktualizowana, aby przypomnieć, że możesz używać interfejsu YouTube Data API do pobierania dodatkowych metadanych zasobów zidentyfikowanych w raportach. Zgodnie z Zasadami dla deweloperów korzystających z 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 mimo iż dane do raportu nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. nie będą zawierać żadnych odniesień do zasobów YouTube, które zostały usunięte co najmniej 30 dni przed datą wygenerowania raportu.

  • Zaktualizowaliśmy sekcję danych historycznych w omówieniu interfejsu API, aby poinformować, że po zaplanowaniu nowego zadania 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 wyraźniej zdefiniować dane uzupełniające jako zbiór danych, który zastępuje wcześniej dostarczony zbiór.

26 kwietnia 2018 r.

Wersja 2 interfejsu YouTube Analytics (Targeted Queries) API (v2) jest teraz dostępna publicznie. Poniżej znajdziesz listę zmian w usłudze i dokumentacji związanych z nową wersją interfejsu API:

  • Interfejs API w wersji 2 jest prawie identyczny z interfejsem API w wersji 1. Prawdopodobnie trzeba będzie jednak zaktualizować kod, 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ń do interfejsu API został zmieniony z https://www.googleapis.com/youtube/analytics/v1 na https://youtubeanalytics.googleapis.com/v2.
    • Zaktualizowano nazwy kilku parametrów metody reports.query. W szczególności nazwy parametrów, które zawierają łączniki, takie jak end-date w interfejsie API w wersji 1, w interfejsie API w wersji 2 używają camelCase (endDate) zamiast łączników. Ta zmiana ujednolica nazwy parametrów w całym interfejsie API, ponieważ metody interfejsu API do tworzenia grup i zarządzania nimi używały już camelCase w nazwach parametrów.
    • Interfejs API w wersji 2 nie obsługuje żądań zbiorczych wysyłanych do globalnego punktu końcowego żądań zbiorczych HTTP Google (www.googleapis.com/batch). Jeśli wysyłasz żądania zbiorcze w interfejsie API w wersji 2, musisz użyć punktu końcowego https://youtubeanalytics.googleapis.com/v2.

    Dodatkowo kilka funkcji wersji 1 nie jest obsługiwanych w interfejsie API w wersji 2:

    • 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 obsługującego żądania zbiorcze składające się z żądań do różnych interfejsów API. (Partia może jednak składać się z żądań do różnych metod tego samego interfejsu API). To wycofanie nie dotyczy tylko interfejsu YouTube Analytics API, ponieważ Google wycofuje globalny punkt końcowy zbiorczy 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. Przypominamy, że to wycofanie nie dotyczy wyłącznie interfejsu YouTube Analytics API.

  • Uwaga: to jest ogłoszenie o wycofaniu funkcji.

    Wersja 1 interfejsu API (v1) została 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ć. Dlatego pamiętaj, aby przejść na interfejs API w wersji 2 najpóźniej do 31 października 2018 r. Dzięki temu unikniesz przerw w dostępie do danych Statystyk YouTube przez interfejs API.

21 lutego 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics API (zapytania ukierunkowane):

  • Raporty demograficzne dotyczące widzów, które zawierają zagregowane statystyki oglądalności na podstawie grupy wiekowej i płci widzów, nie obsługują już wymiaru youtubeProduct, który identyfikuje usługę YouTube, w której miała miejsce aktywność użytkownika.

18 stycznia 2018 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Reporting API (raporty zbiorcze)

    • Wymiar operating_system, który identyfikuje system oprogramowania urządzenia, na którym obejrzano materiał, obsługuje teraz tę wartość:
      • 25: KaiOS

  • YouTube Analytics API (zapytania ukierunkowane)

20 grudnia 2017 r.

Ta aktualizacja zawiera 2 zmiany dotyczące interfejsu YouTube Reporting API:

  • 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ń do interfejsu API. Włączenie kompresji gzip zmniejsza przepustowość potrzebną do obsługi odpowiedzi interfejsu API. Chociaż aplikacja będzie potrzebować dodatkowego czasu pracy procesora na dekompresję odpowiedzi interfejsu API, korzyści wynikające z mniejszego zużycia zasobów sieciowych zwykle przewyższają ten koszt.

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

    Accept-Encoding: gzip

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

  • Poprawiliśmy dokumentację wymiarów age group i gender, aby wyświetlała rzeczywiste wartości zwracane przez interfejs API w przypadku tych wymiarów. Pamiętaj, że jest to poprawka w dokumentacji, która nie odzwierciedla zmiany w funkcjonalności ani działaniu interfejsu API. Zmieniliśmy te wartości:

    • Wartości wymiaru age_group zawierają wielkie litery, podkreślenia między słowem AGE i liczbami w grupie wiekowej oraz podkreślenia zamiast łączników. 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 poprawione na FEMALE, MALE i GENDER_OTHER.

10 sierpnia 2017 r.

10 sierpnia 2016 r. w tej dokumentacji ogłosiliśmy wycofanie danych earnings interfejsu YouTube Analytics API. (Jednocześnie interfejs API zaczął obsługiwać nowe dane o nazwie estimatedRevenue, które dostarczają tych samych informacji).

Dane earnings były danymi podstawowymi, więc były obsługiwane przez rok od daty ogłoszenia. Ten okres już się zakończył, więc dane earnings nie są już obsługiwane. W rezultacie żądania do interfejsu API, które określają dane earnings, zwracają teraz kod odpowiedzi HTTP 400. Jeśli Twoja aplikacja nie została jeszcze zaktualizowana, aby używać danych estimatedRevenue zamiast earnings, zrób to jak najszybciej.

Dokumentacja API została zaktualizowana, aby usunąć pozostałe odniesienia do wskaźnika earnings.

6 lipca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API (zapytania ukierunkowane)

    • Dokumentacja interfejsu API została zaktualizowana, aby odzwierciedlić fakt, że odpowiedzi interfejsu API zawierają dane do ostatniego dnia w żądanym zakresie dat, dla którego dostępne są wszystkie wyszukiwane dane.

      Jeśli na przykład żądanie określa datę zakończenia na 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 również sytuacji, gdy dane dotyczące niektórych z wybranych danych są dostępne dla 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 maksymalnie 6 sekund, która wyświetla się przed filmem. Format reklamy jest identyczny z reklamą auctionBumperInstream, ale ten typ odnosi się do reklam sprzedawanych w systemie rezerwacji, a nie w systemie aukcyjnym.

  • YouTube Reporting API (raporty zbiorcze)

    • Wymiar ad_type obsługuje teraz wartość 20, która odnosi się do bumperów reklamowych sprzedawanych na zasadzie rezerwacji. Bumpery reklamowe to niemożliwe do pominięcia reklamy wideo trwające maksymalnie 6 sekund, które widzowie muszą obejrzeć przed filmem. Pamiętaj, że wartość 19 tego wymiaru odnosi się też do bumperów reklamowych 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

      15 września 2016 r. ogłosiliśmy, że te typy raportów zostaną wycofane. Po 15 grudnia 2016 r. raporty tego typu nie były już generowane. Wygenerowane wcześniej raporty były nadal dostępne przez 180 dni od momentu ich wygenerowania. W związku z tym niektóre raporty były dostępne jeszcze do 15 czerwca 2017 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z raportami również nie są potrzebne.

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. Wygenerowane wcześniej raporty były nadal dostępne przez 180 dni od momentu ich wygenerowania. Dlatego niektóre raporty były dostępne jeszcze 22 marca 2017 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z raportami również nie są potrzebne.

22 maja 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Reporting API (raporty zbiorcze)

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

      Dodatkowo nazwa używana do identyfikacji wartości 52 została w dokumentacji zmieniona 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 klasyfikacji filmów udostępnianych w tych usługach.

  • YouTube Analytics API (zapytania ukierunkowane)

    • 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ć dostęp do tych danych również za pomocą interfejsu 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:

  • YouTube Reporting API (raporty zbiorcze)

    • Poprawiliśmy definicję wymiaru date, aby wskazać, że 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.

      Daty zwykle reprezentują okres 24-godzinny, ale 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 podawaliśmy, że każda data reprezentuje unikalny okres 24-godzinny, a czas pacyficzny to zawsze UTC-8).

      Pamiętaj, że ta poprawka nie oznacza zmiany rzeczywistego działania interfejsu API.

    • Wymiar operating_system, który identyfikuje system oprogramowania urządzenia, na którym obejrzano materiał, 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 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z raportami również nie są potrzebne.

  • YouTube Analytics API (zapytania ukierunkowane)

    • Poprawiliśmy opis wymiarów związanych z time periods, aby zaznaczyć, że 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.

      Daty zwykle reprezentują okres 24-godzinny, ale 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 podawaliśmy, że czas pacyficzny to UTC-8, i nie wspominaliśmy o tym, że dzień może nie odpowiadać okresowi 24-godzinnemu).

      Pamiętaj, że ta poprawka nie oznacza zmiany rzeczywistego działania interfejsu API.

    • Zaktualizowaliśmy dokumentację raportów dotyczących kanałów, 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 finansowych w raportach dotyczących kanałów.

    • Wymiar operatingSystem obsługuje 3 nowe wartości:
      • 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 podczas pobierania raportów właściciela treści.

Parametr ten pozwala właścicielowi treści wskazać, że odpowiedź interfejsu API powinna zawierać dane o czasie oglądania i wyświetleniach kanałów z okresu, zanim kanały zostały połączone z właścicielem treści. Domyślna wartość parametru to false, co oznacza, że domyślnie odpowiedź interfejsu API zawiera tylko dane dotyczące czasu oglądania i wyświetleń od momentu, gdy kanały zostały połączone z właścicielem treści.

Te reguły obowiązują również, gdy żądanie do interfejsu API pobiera dane dla wielu kanałów:

  • Jeśli wartość parametru to false, dane dotyczące czasu oglądania i wyświetleń zwracane dla danego kanału są oparte na dacie, kiedy ten kanał został połączony z właścicielem treści.

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

15 grudnia 2016 r.

Te raporty interfejsu API YouTube do raportowania 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ę bieżących typów raportów w dokumentacji API.

11 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

Interfejs YouTube Reporting API obsługuje 3 nowe raporty dotyczące ekranów końcowych oraz nowe wymiary i dane w tych raportach. Raporty zawierają statystyki wyświetleń i klikalności ekranów końcowych, które wyświetlają się po zakończeniu odtwarzania filmu.

8 listopada 2016 r.

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

  • Dane z tej listy zostały całkowicie wycofane i nie są już obsługiwane. Zgodnie z zapowiedzią z 10 sierpnia 2016 r. nowe dane odnoszące się do tych samych informacji są już obsługiwane. W tabeli poniżej znajdziesz wycofane i nowe nazwy danych:

    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 interfejsu API zarządzane przez system mają na celu zapewnienie automatycznego dostępu do danych, które są również dostępne w raportach Studio twórców do pobrania ręcznego.

Przegląd raportów zarządzanych przez system zawiera krótkie omówienie nowych raportów i wyjaśnia proces ich pobierania za pomocą interfejsu API. Ten proces różni się nieco od pobierania raportów zbiorczych w Statystykach YouTube, ponieważ partnerzy nie muszą planować zadań, aby wygenerować raporty.

Właściwość id zasobu reportType została zaktualizowana i zawiera teraz 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 zasób
  • Dzienne przychody z reklam na zasób według kraju
  • Roszczenia (ten raport nie zawiera danych o przychodach)

27 września 2016 r.

Uwaga: to jest ogłoszenie o wycofaniu funkcji.

Dane uniques w interfejsie YouTube Analytics API zostały wycofane. Nie są to podstawowe dane i będą obsługiwane do 31 października 2016 r.

15 września 2016 r.

Ta aktualizacja zawiera te 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 raporty, które zostały już wygenerowane, 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, jak wyjaśniono we wpisie w historii zmian z 19 maja 2016 r.

11 sierpnia 2016 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowo opublikowane Warunki korzystania z usług YouTube API („Zaktualizowane warunki”), szczegółowo omówione na blogu YouTube Engineering and Developers, zawierają wiele zmian w obecnych Warunkach korzystania z usługi. Oprócz Zaktualizowanych warunków, które wejdą w życie 10 lutego 2017 roku, ta aktualizacja obejmuje kilka dokumentów pomocniczych, które wyjaśniają zasady, jakich muszą przestrzegać deweloperzy.

    Pełny zestaw nowych dokumentów znajdziesz w historii zmian zaktualizowanych Warunków. W historii zmian będą też wyjaśniane przyszłe zmiany w Zaktualizowanych warunkach lub dokumentach pomocniczych.

10 sierpnia 2016 r.

Ta aktualizacja obejmuje te zmiany:

  • YouTube Analytics API (zapytania ukierunkowane)

    • Uwaga: to jest ogłoszenie o wycofaniu funkcji.

      Dane w tabeli poniżej zostaną wycofane. Jednocześnie wprowadzamy nowe dane odnoszące się do tych samych informacji. W praktyce oznacza to, że stare dane zostaną przemianowane, 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 danymi podstawowymi, więc będą obsługiwane przez rok od daty tego ogłoszenia. Pozostałe dane, które nie były danymi podstawowymi, będą obsługiwane przez 3 miesiące, czyli do 4 listopada 2016 r.

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

    • Wymiar insightTrafficSourceType obsługuje 2 nowe wartości:
      • CAMPAIGN_CARD: to źródło wizyt jest obsługiwane tylko w raportach właściciela treści. Wskazuje, ż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 wyświetlanych 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ć raport traffic source detail. W obu przypadkach wymiar insightTrafficSourceDetail identyfikuje film, z którego widz został przekierowany.

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

  • YouTube Reporting API (raporty zbiorcze)

    • Wymiar traffic_source_type obsługuje teraz te wartości:
      • 19: to źródło wizyt jest obsługiwane tylko w raportach właściciela treści. Wskazuje, ż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 wyświetlanych 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 identyfikuje film, z którego widz został przekierowany.

    • Lista podstawowych danych interfejsu API została poprawiona, aby zawierała estimated_partner_revenue jako dane podstawowe i nie zawierała 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 niemożliwych do pominięcia reklam wideo trwających do 6 sekund, które wyświetlają się przed filmem.

18 lipca 2016 r.

Ta aktualizacja obejmuje te zmiany:

  • YouTube Analytics API (zapytania ukierunkowane)

    • Listy obsługiwanych danych w tych raportach dotyczących kanałów zostały zaktualizowane i zawierają teraz dane dotyczące kart. Obsługa danych dotyczących kart w tych raportach została dodana 28 czerwca 2016 r. Wpis w historii zmian z tego dnia zawiera więcej informacji o tej zmianie. Są 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 prowincjach
      • Najpopularniejsze filmy według stanu
      • Najpopularniejsze filmy wśród subskrybentów i widzów bez subskrypcji

    • Listy filtrów zostały poprawione zarówno w przypadku raportów utrzymania uwagi odbiorców kanału, jak i raportów utrzymania uwagi odbiorców właściciela treści, aby odzwierciedlić, ż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ć, używając jednego z tych 2 filtrów lub nie używając żadnego z nich.

  • YouTube Reporting API (raporty zbiorcze)

    • W omówieniu interfejsu API poprawiliśmy sekcję wyjaśniającą, jak pobrać adres URL raportu. Teraz zawiera ona informację, że YouTube generuje raporty do pobrania za dni, w których nie były dostępne żadne dane. Te raporty zawierają wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji Charakterystyka raportu w tym samym dokumencie 12 kwietnia 2016 r.
    • Lista wymiarów w raporcie content_owner_asset_cards_a1 została poprawiona, aby odzwierciedlała fakt, że raport używa wymiaru card_id. Wcześniej w dokumentacji nieprawidłowo podano nazwę wymiaru jako card_title.

28 czerwca 2016 r.

Dokumentacja interfejsu YouTube Analytics API została zaktualizowana, aby uwzględnić obsługę danych kart w wielu raportach dotyczących kanałów i właścicieli treści. Nowe obsługiwane dane:

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 dotyczą tylko raportów właściciela treści:

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

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

  • Interfejs API obsługuje nowe wersje 3 raportów. Dwa 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 o zmienionej nazwie jest identyczny z poprzednią wersją.

    • Zmieniliśmy nazwy 2 raportów, które mają nowe wersje:

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

      Oba raporty o nowych nazwach różnią się od swoich poprzedników w następujący sposób:

    Pamiętaj, że jeśli masz już zadania tworzenia starszych wersji tych raportów, musisz utworzyć nowe zadania dla raportów o zmienionych nazwach. W związku z wydaniem 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 id zasobu reportType została zaktualizowana, aby odzwierciedlała bieżący zestaw dostępnych raportów.

  • Nazwy 2 rodzajów danych zostały poprawione w dokumentacji, aby odpowiadały nazwom widocznym w raportach. Jest to wyłącznie poprawka w dokumentacji, która nie odzwierciedla zmiany w rzeczywistej zawartości raportu:

    • Nazwa 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 opisano powyżej, w nowszych wersjach tych raportów nazwa tych danych została zmieniona na estimated_partner_ad_auction_revenue.
    • Nazwa 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 opisano powyżej, w nowszych wersjach tych raportów nazwa tych danych została zmieniona na estimated_partner_ad_reserved_revenue.

  • Dokumentacja wymiarów w interfejsie 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 przez interfejs API.

19 maja 2016 r.

Ta aktualizacja zawiera te zmiany w interfejsie YouTube Reporting API:

  • Interfejs API obsługuje nową wersję raportu aktywności użytkownika 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 spowodować zmianę powodującą niezgodność.

    W związku z udostępnieniem nowego raportu raport 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łaściwość deprecateTime zasobu reportType 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 reprezentuje datę, kiedy YouTube przestanie generować raporty tego typu.

      Po ogłoszeniu, że dany typ raportu został wycofany, 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. Dlatego wartość deprecateTime dla tego typu raportu określa czas 19 sierpnia 2016 r., po którym YouTube przestanie generować raporty tego typu.

    • Właściwość expireTime zasobu job określa datę i godzinę 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 oznacza moment, po którym YouTube nie generuje już nowych raportów dla 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, zgodnie z opisem w poprzednim elemencie na tej liście.

  • Jeśli spróbujesz utworzyć zadanie dla wycofanego raportu, metoda jobs.create zwraca teraz kod odpowiedzi HTTP 400 (Bad Request). Dodatkowo w dokumentacji metody wymieniono teraz kilka innych przyczyn niepowodzenia żądania do interfejsu API.

12 kwietnia 2016 r.

Ta aktualizacja zawiera następujące 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 utworzonych przed tym ogłoszeniem.

    Raporty historyczne są publikowane, gdy tylko są dostępne, ale opublikowanie wszystkich danych historycznych dotyczących zadania zajmuje około miesiąca. Dlatego miesiąc po zaplanowaniu zadania raportowania będziesz mieć dostęp do danych z 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 rezultacie zadania utworzone przed 28 grudnia 2015 r. będą miały dane historyczne z mniej niż 180 dni.

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

  • Sekcja Charakterystyka raportów w omówieniu interfejsu YouTube Reporting API została zaktualizowana o te zmiany:

    • W dokumentacji jest teraz podane, że raporty są dostępne przez 180 dni od ich wygenerowania i w tym czasie klienci interfejsu API mogą je pobierać. Wcześniej w dokumentacji podawaliśmy, że raporty są dostępne przez okres do 6 miesięcy przed datą wysłania żądania do interfejsu API.

    • Dokumentacja została zaktualizowana, aby odzwierciedlić 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, zarządzanych przez system raportów, 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 raportów Przychody do pobrania ręcznie w Studio twórców YouTube. Nowa funkcja interfejsu API zapewni więc zautomatyzowany dostęp do tych danych.

    W ramach przygotowań do wprowadzenia raportów zarządzanych przez system ogłaszamy 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, a 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, jeśli najwcześniejsze dane w raporcie pochodzą z określonej daty lub późniejszej. Podobnie parametr startTimeBefore wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty, jeśli najwcześniejsze dane w raporcie pochodzą sprzed określonej daty.

      W odróżnieniu od parametru createdAfter metody, który dotyczy 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ń dla kilku dodatkowych usług udostępniania.

  • W interfejsie YouTube Reporting API wymiar sharing_service obsługuje te nowe wartości:
    • 82: okno aktywności systemu 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 systemu iOS

16 marca 2016 r.

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

YouTube Reporting API

  • Wymiar playback_location_type obsługuje 2 nowe wartości:
    • 7: dane dotyczą wyświetleń, które miały miejsce na stronie głównej lub ekranie głównym YouTube, na karcie Subskrypcje 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 na YouTube.
  • Wymiar traffic_source_type obsługuje teraz wartość 18. Ta wartość wskazuje, że wyświetlenia filmu pochodzą ze strony, na której znajduje się lista wszystkich filmów na playliście. To źródło różni się od typu źródła 14, który wskazuje, że wyświetlenia miały miejsce, gdy film był odtwarzany w ramach playlisty.

YouTube Analytics API

  • Wymiar insightPlaybackLocationType obsługuje 2 nowe wartości:
    • BROWSE: dane dotyczą wyświetleń, które miały miejsce na stronie głównej lub ekranie głównym YouTube, na karcie Subskrypcje 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 na YouTube.
  • Wymiar insightTrafficSourceType obsługuje teraz wartość YT_PLAYLIST_PAGE. Ta wartość wskazuje, że wyświetlenia filmu pochodzą ze strony, na której znajduje się lista wszystkich filmów na playliście. 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.

Lista danych obsługiwanych przez YouTube Analytics API została zaktualizowana, więc dane kart nie są już wymienione jako obsługiwane przez ten interfejs API. (Żaden z raportów tego interfejsu API nie został udokumentowany jako obsługujący którekolwiek z danych karty).

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

6 stycznia 2016 r.

Interfejsy YouTube Reporting API i YouTube Analytics API identyfikują teraz wyświetlenia, które miały miejsce na urządzeniu Chromecast.

  • W interfejsie YouTube Reporting API wymiar operating_system używa wartości 21 do identyfikowania wyświetleń, które miały miejsce na urządzeniu Chromecast.
  • W YouTube Analytics API wymiar operatingSystem używa wartości CHROMECAST do identyfikowania wyświetleń, które miały miejsce na urządzeniu Chromecast.

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 dokumentowane jako clickable_annotation_impressions i closable_annotation_impressions.

18 grudnia 2015 r.

Przepisy Unii Europejskiej (UE) wymagają przekazania użytkownikom w UE określonych informacji i uzyskania od nich zgody. Dlatego w przypadku użytkowników z Unii Europejskiej musisz przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy powiadomienie o tym wymaganiu w Warunkach 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órych można używać 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żytkownika, która miała miejsce podczas transmisji na żywo.
    • subscribedStatus: ten wymiar wskazuje, czy dane o aktywności użytkownika są powiązane z widzami, którzy subskrybowali kanał, na którym znajduje się film lub playlista.
    • youtubeProduct: ten wymiar określa usługę YouTube, w której miała miejsce aktywność użytkownika. Możliwe wartości to główna strona YouTube (lub aplikacja YouTube), YouTube Gaming i YouTube Kids.

    Dokumentacja została zaktualizowana, aby uwzględnić nowe raporty szczegółowe dotyczące odtwarzania, które są dostępne dla kanałów i właścicieli treści. Oprócz tego wiele innych raportów zostało zaktualizowanych, aby zaznaczyć, że co najmniej 1 z tych wymiarów może być opcjonalnie używany jako wymiar lub filtr w tych raportach.

  • Zmieniliśmy format tabel objaśniających raporty, 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. W tabeli poniżej, która objaśnia raport „Typ urządzenia” dotyczący kanałów, przedstawiono nowy format:

    Właściwość Wartość
    Wymiary:
    Wymagane deviceType
    Użyj wartości 0 lub większej day, liveOrOnDemand, subscribedStatus, youtubeProduct
    Dane:
    Użyj co najmniej 1 znaku views, estimatedMinutesWatched
    Filtry:
    Użyj wartości 0 lub 1. country, province, continent, subContinent
    Użyj wartości 0 lub 1. video, group
    Użyj wartości 0 lub większej operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

  • Interfejs YouTube Analytics API automatycznie usuwa teraz elementy, dla których użytkownik interfejsu API nie może pobrać danych, z filtrów obsługujących wiele wartości (video, playlist i channel). Wcześniej serwer interfejsu API zwracał błąd, jeśli użytkownik interfejsu API nie mógł uzyskać dostępu do danych 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 filtr video zawiera 20 identyfikatorów filmów. Użytkownik jest właścicielem 18 filmów. Jednak jeden identyfikator filmu wskazuje film należący do innego kanału, a inny identyfikator wskazuje film, który został usunięty i już nie istnieje. W takim przypadku zamiast zwracać błąd, serwer interfejsu API odrzuca 2 filmy, do których użytkownik nie ma dostępu, a odpowiedź interfejsu API zawiera dane dotyczące 18 filmów, których właścicielem jest użytkownik interfejsu API.

  • Jeśli poprosisz o dane dla pustego elementu group Statystyk YouTube, interfejs API zwróci teraz pusty zbiór danych, a nie błąd.

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

  • Metoda groups.list interfejsu YouTube Analytics API obsługuje teraz podział na strony. Jeśli odpowiedź interfejsu API nie zawiera wszystkich dostępnych grup, parametr nextPageToken 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 interfejsu YouTube Reporting API została poprawiona, aby odzwierciedlała fakt, że daty odnoszą się do 24-godzinnego okresu rozpoczynającego się o godzinie 00:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji podawaliśmy, że data zaczyna się o godzinie 00:00 (GMT).

    Zaktualizowaliśmy też 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 godzinie 00:00 czasu pacyficznego (UTC-8).

  • Metoda jobs.reports.list() interfejsu YouTube Reporting API obsługuje teraz parametr zapytania createdAfter. Jeśli ten parametr jest określony, wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty utworzone po określonej dacie i godzinie, w tym nowe raporty z uzupełnionymi danymi. Pamiętaj, że wartość parametru odnosi się do czasu utworzenia raportu, a nie do dat powiązanych ze zwracanymi 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 można używać parametru createdAfter, aby uniknąć wielokrotnego przetwarzania tego samego raportu.

  • Poprawiliśmy definicje właściwości createTime zasobu job oraz właściwości startTime, endTime i createTime zasobu report, aby wskazać, że wartości właściwości są dokładne do mikrosekund, a nie nanosekund. Dodatkowo wszystkie definicje dokładnie odzwierciedlają teraz, że wartość właściwości jest sygnaturą czasową.

8 października 2015 r.

Ta aktualizacja zawiera następujące zmiany:

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

    Definicja wymiaru sharing_service w interfejsie YouTube Reporting API została zaktualizowana, aby uwzględnić nowo obsługiwane wartości. Wartości typu wyliczeniowego większe niż 59 są nowymi wartościami 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 przeznaczony do aplikacji, które mogą importować duże zbiory danych i udostępniają narzędzia do filtrowania, sortowania i eksploracji tych danych.

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

    Za pomocą interfejsu API możesz planować zadania raportowania, z których każde określa raport, jaki YouTube powinien wygenerować. Po skonfigurowaniu zadania YouTube generuje codzienny raport, który można pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego okresu 24 godzin.

  • Chociaż są to różne interfejsy API, zarówno YouTube Analytics API, jak i interfejs API YouTube do raportowania umożliwiają deweloperom pobieranie danych Statystyk YouTube. Oba interfejsy API zapewniają dostęp do podobnych zbiorów danych, dlatego dokumentacja obu interfejsów API jest publikowana jako jeden zestaw dokumentacji.

    • Karta Przewodniki w dokumentacji zawiera informacje wspólne dla obu interfejsów API, w tym instrukcje autoryzacji żądań do interfejsu API.
    • Karta Raporty zbiorcze zawiera dokumentację i inne treści dotyczące interfejsu YouTube Reporting API.
    • Karta Zapytania ukierunkowane zawiera dokumentację i inne treści dotyczące interfejsu YouTube Analytics API.
    • Na karcie Przykłady znajdziesz przykładowe kody dostępne dla obu interfejsów API.
    • Na karcie Narzędzia znajdziesz dodatkowe zasoby, które pomogą deweloperom we wdrożeniu obu interfejsów API.

20 sierpnia 2015 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumentacja API została przeorganizowana, aby ułatwić jego zrozumienie. Dlatego te zmiany nie opisują nowych funkcji:

    • Dokumentacja zawiera teraz jedną stronę z listą wszystkich dostępnych raportów dotyczących kanału i drugą z listą wszystkich dostępnych raportów dotyczących właściciela treści. Wcześniej dokumentacja zawierała osobne strony dotyczące raportów o filmach na kanale, raportów o playlistach na kanale itd.

    • Nowy przegląd modelu danych ma na celu dokładniejsze wyjaśnienie, jak działa interfejs API. W szczególności ten dokument ma na celu wyjaśnienie, jak YouTube wykorzystuje dane, wymiary i filtry 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 znajdowały się wcześniej na innych stronach. Nowa strona została zaprojektowana tak, aby ułatwić Ci znalezienie informacji, które musisz wysł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 są to podstawowe dane. Interfejs API obsługuje dane adEarnings w przypadku każdego raportu, który obsługiwał już dane earnings.

    Dodatkowo poprawiliśmy definicję danych earnings, aby odzwierciedlić fakt, że ich wartość obejmuje łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google, a także ze źródeł innych niż reklamy. 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 wideo 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 dotyczących filmów: videosAddedToPlaylists i videosRemovedFromPlaylists. Listy raportów wideo dotyczących kanałów i właścicieli treści zostały zaktualizowane, aby wskazywać raporty, które obsługują nowe dane.

    • videosAddedToPlaylists – liczba przypadków, gdy filmy objęte zakresem zapytania zostały dodane do playlist w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist innych kanałów.
    • videosRemovedFromPlaylists – liczba przypadków, gdy filmy objęte zakresem zapytania zostały usunięte z 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ą jednak playlist, do których film jest dodawany automatycznie, takich jak playlisty z przesłanymi filmami na kanale czy historia 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, potem go usunie, a następnie doda ponownie, dane będą wskazywać, że film został dodany do 2 playlist i usunięty z 1.

    Dane dotyczące tych danych są dostępne od 1 października 2014 r.

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 parametr jest ustawiony, interfejs API konwertuje 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 Statystyk YouTube i zarządzanie nimi, a także pobieranie danych raportów dotyczących tych grup.

    • Tworzenie grup i zarządzanie nimi

      Ta aktualizacja wprowadza zasoby group i groupItem do tworzenia grup i zarządzania nimi.

      • Zasób group reprezentuje grupę statystyk, 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 metody list, insert i delete dla tego zasobu.

      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 do raportu dla grupy

      Dokumentacja wymiarów została zaktualizowana i zawiera teraz wymiar group, który może być używany jako filtr w wielu raportach dotyczących kanałów i raportach dotyczących właścicieli treści. Gdy używasz filtra group, interfejs API zwraca dane dotyczące 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 te wymiary są używane jako filtry. Aby określić wiele wartości, ustaw wartość parametru filters na listę rozdzielonych przecinkami identyfikatorów filmów, playlist, kanałów lub programów, według których ma być filtrowana odpowiedź interfejsu API. Wartość parametru może zawierać maksymalnie 200 identyfikatorów.

    Jeśli podasz kilka wartości dla 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.

    Pełne informacje o tej funkcji znajdziesz w definicji parametru filters.

16 lipca 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Podczas pobierania raportu dotyczącego kanału możesz teraz pobrać dane dotyczące kanału uwierzytelnionego użytkownika, ustawiając wartość parametru ids na channel==MINE. (Możesz też ustawić parametr ids na channel==CHANNEL_ID, aby pobrać dane dla 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 każdy z tych rodzajów danych odzwierciedla tylko wyświetlenia playlist, które miały miejsce w internecie.

    • playlistStarts: liczba rozpoczętych przez widzów odtworzeń playlisty.
    • viewsPerPlaylistStart: średnia liczba wyświetleń filmu, które miały miejsce po każdym uruchomieniu playlisty.
    • averageTimeInPlaylist: szacowany średni czas (w minutach), jaki widzowie spędzili na oglądaniu filmów z playlisty po rozpoczęciu jej odtwarzania.

    Każde żądanie pobrania raportu dotyczącego playlisty musi używać filtra isCurated, który musi być ustawiony na 1 (isCurated==1).

  • Interfejs API obsługuje teraz raport Utrzymanie uwagi odbiorców. Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Nowy wymiar elapsedVideoTimeRatio w raporcie mierzy czas odtwarzania filmu dla odpowiednich wartości danych:

    • Dane audienceWatchRatio określają bezwzględny odsetek widzów oglądających film w danym momencie. Współczynnik ten jest obliczany przez porównanie liczby wyświetleń danego fragmentu filmu z łączną liczbą wyświetleń filmu.

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

    • Dane relativeRetentionPerformance pokazują, jak dobrze film utrzymuje uwagę widzów podczas odtwarzania w porównaniu ze wszystkimi filmami na 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 wynosząca 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ć filtra audienceType, aby raport zawierał tylko dane powiązane z wyświetleniami bezpłatnymi, wyświetleniami reklam TrueView In-Stream lub wyświetleniami reklam TrueView In-Display. (Bezpłatne wyświetlenia wynikają bezpośrednio z działania użytkownika, takiego jak wyszukanie filmu lub kliknięcie proponowanego filmu).

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

    Wszystkie nowe dane są danymi podstawowymi i podlegają zasadom wycofywania (funkcji lub usług). Pamiętaj jednak, że dane dotyczące nowych danych są dostępne od 16 lipca 2013 r. (Dane dotyczące danych annotationClickThroughRate i annotationCloseRate są dostępne od 10 czerwca 2012 r.).

  • Wartość GOOGLE_SEARCH nie jest już raportowana jako osobna wartość wymiaru insightTrafficSourceType. Zamiast tego odesłania z wyników wyszukiwania 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 z przykładowymi żądaniami został przeprojektowany, aby pogrupować przykłady w kategorie, używając formatu kart podobnego do tego, który został niedawno wprowadzony w raportach dotyczących kanałów i właścicieli treści. W nowym projekcie przykłady są pogrupowane w te kategorie:

    • Podstawowe statystyki
    • Czasowe
    • 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ściciela treści)

  • Dokument Przykładowe żądania zawiera teraz nowe przykłady pobierania danych dotyczących prowincji w raportach kanału lub raportach właściciela treści.

    • Dane dotyczące poszczególnych stanó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 oraz 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 oglądali 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żyto parametru filters, aby odpowiedź zawierała tylko dane dotyczące konkretnej prowincji.

  • Definicja wymiaru province została zaktualizowana, aby uwzględnić, że gdy province jest zawarty w wartości parametru dimensions, żądanie musi też ograniczać dane do Stanów Zjednoczonych przez uwzględnienie country==US w wartości parametru filters.

6 stycznia 2014 r.

Ta aktualizacja zawiera następujące zmiany:

  • Dokumenty zawierające listę obsługiwanych raportów kanału i właściciela treści zostały zmienione. Zamiast tabeli ze wszystkimi możliwymi raportami każdy dokument zawiera raporty pogrupowane według kategorii:

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

    Każdy dokument wyświetla te kategorie jako listę kart. Możesz kliknąć dowolną kartę, aby zobaczyć 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 USA i Dystryktu Kolumbii. Interfejs API obsługuje 2 zastosowania tego wymiaru:

      • Interfejs API obsługuje 2 raporty, które zawierają statystyki z podziałem na stany. Oba raporty są dostępne dla kanałów i właścicieli treści.

        • Raport Główne statystyki zawiera kilka rodzajów danych, w tym liczbę wyświetleń i szacunkowy czas oglądania.
        • Raport oparty na czasie zawiera te same statystyki, ale agreguje dane w ujęciu dziennym, 7-dniowym, 30-dniowym lub miesięcznym.

      • Możesz użyć parametru zapytania filters, aby ograniczyć raport do statystyk dotyczących konkretnego stanu. Ten typ filtrowania jest obsługiwany przez kilka raportów, w tym raporty geograficzne, raporty dotyczące miejsca odtwarzania, raporty dotyczące źródeł wizyt, raporty dotyczące urządzeń, raporty dotyczące systemów operacyjnych, raporty demograficzne i raporty dotyczące najpopularniejszych filmów.

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

    • Wymiar subContinent określa kod regionu statystycznego Organizacji Narodów Zjednoczonych (ONZ), który identyfikuje subregion kontynentu. Tego wymiaru można też używać tylko jako filtra.

      Każdy subregion jest powiązany tylko z jednym kontynentem, więc nie ma potrzeby używania filtra continent, gdy używasz filtra subContinent. (Jeśli żądanie będzie zawierać oba wymiary, interfejs API zwróci błąd).

  • Poprawiliśmy dokumentację, 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. Zasady wycofywania nie dotyczą jednak niepodstawowych wymiarów i danych interfejsu API. Strony Wymiary i Dane zostały zaktualizowane, aby zawierały podstawowe wymiary i podstawowe dane. 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 wymiarze insightPlaybackLocationType. W związku z tą zmianą od 10 września 2013 r. odtworzenia nie są już klasyfikowane jako odtworzenia MOBILE, ale 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 WATCH, EMBEDDED lub EXTERNAL_APP w zależności od typu aplikacji, w której nastąpiło odtworzenie.

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

16 lipca 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API obsługuje teraz możliwość sortowania 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/danych, który pokazuje tę funkcję. Żądanie pobiera dane o źródle wizyt i ma wartość parametru sort równą day,-views. Wyniki są sortowane 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ń itd.

  • Interfejs API obsługuje teraz 2 nowe wymiary: deviceType i operatingSystem, których można 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ą jednego lub obu wymiarów.

    • Raport deviceType umożliwia pobieranie liczby wyświetleń i szacowanego czasu oglądania dla różnych typów urządzeń, w tym komputerów, telefonów komórkowych i tabletów. Możesz też użyć filtra operatingSystem, aby ograniczyć raport o typie urządzenia do statystyk dotyczących urządzeń z określonym systemem operacyjnym, np. Android lub iOS.

    • Raport operatingSystem pozwala uzyskać liczbę wyświetleń i szacunkowy czas oglądania dla różnych systemów operacyjnych, takich jak Android, iOS, Linux i inne. Możesz też użyć filtra deviceType, aby ograniczyć raport o systemach operacyjnych do statystyk dotyczących konkretnego typu urządzenia, np. urządzeń mobilnych lub tabletów.

    Nowe raporty dotyczące typów urządzeń i systemów operacyjnych są dostępne dla kanałów i właścicieli treści.

  • Dokument Przykładowe żądania został zaktualizowany i zawiera teraz 3 raporty dotyczące urządzeń dla kanałów i 3 raporty dotyczące urządzeń dla właścicieli treści.

  • Wymiar insightPlaybackLocationType może zwracać wartość YT_OTHER, która identyfikuje wyświetlenia niesklasyfikowane za pomocą jednej z innych wartości 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 dotyczących czasu oglądania – estimatedMinutesWatched, averageViewDuration i averageViewPercentage – w połączeniu z innymi danymi, w tym danymi dotyczącymi wyświetleń, wskaźnikami zaangażowania, danymi dotyczącymi zarobków i wskaźnikami skuteczności reklam.

    Listy dostępnych raportów dotyczących kanałów i raportów dotyczących właścicieli treści zostały zaktualizowane, aby odzwierciedlić tę zmianę. (Listy są teraz krótsze, ponieważ dane dotyczące czasu oglądania można pobrać w ramach innych 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 następujący sposób:

    • Teraz obsługują opcjonalny filtr country.

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

      • Szczegóły dotyczące 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 do interfejsu API zawiera przykłady pokazujące, jak pobierać różne typy raportów za pomocą YouTube Analytics API. Każdy przykład zawiera krótki opis raportu, który jest pobierany przez żądanie, a następnie pokazuje 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 kanałów na stronie głównej YouTube lub z funkcji subskrypcji YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail będzie zawierać informacje o stronie głównej lub innej stronie, 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 wskaźnikach skuteczności reklam, a także nowe raporty skuteczności reklam. Dane i raporty są dostępne tylko dla partnerów treści YouTube, którzy uczestniczą w programie partnerskim YouTube.

    • Nowe raporty obsługują wskaźniki 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.

    • Nowe obsługiwane dane są wymienione poniżej. Lista raportów właściciela treści została zaktualizowana, 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 partnerów Google lub DoubleClick.
      • primaryAdGrossRevenue – szacunkowe przychody brutto, zsumowane i sklasyfikowane według głównego typu reklamy, z odtworzeń filmów, które obejmuje raport, od partnerów Google lub DoubleClick.
      • monetizedPlaybacks – liczba odtworzeń, podczas których wyświetliło się co najmniej 1 wyświetlenie reklamy.
      • playbackBasedCpm – szacunkowe przychody brutto na 1000 odtworzeń.
      • impressions – liczba zrealizowanych zweryfikowanych wyświetleń reklam.
      • impressionBasedCpm – szacunkowe przychody brutto na 1000 wyświetleń reklamy.

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

    • Każde żądanie, które pobiera dane o zarobkach lub wskaźnikach skuteczności reklam, musi wysyłać token autoryzacji, który przyznaje 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ą opisane na osobnych stronach. Dlatego teraz są osobne strony, na których wyjaśniamy różne rodzaje raportów dotyczących kanałów i raportów dotyczących właścicieli treści.

4 lutego 2013 r.

Ta aktualizacja zawiera następujące zmiany:

  • Przewodnik po interfejsie API zawiera teraz sekcję z przykładami, w której znajdziesz przykładowy kod pokazujący, 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:

  • Przewodnik po interfejsie API zawiera teraz APIs Explorer, który umożliwia wywołanie interfejsu API, wyświetlenie żądania do interfejsu API i pobranie rzeczywistych danych w odpowiedzi.

  • Interfejs API obsługuje szereg nowych raportów dotyczących zarówno kanałów, jak i właścicieli treści, które opisujemy poniżej. Każdy raport jest dostępny jako raport kanału lub raport właściciela treści. Strony Wymiary i Dane zostały odpowiednio zaktualizowane.

    • Raport dotyczący miejsca odtwarzania podaje liczbę wyświetleń filmu na różnych typach stron lub aplikacji.

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

    • Raport dotyczący źródeł wizyt pokazuje liczbę wyświetleń filmów, które pochodzą z różnych typów źródeł odesłań.

    • Raport szczegółowy dotyczący źródeł wizyt wskazuje strony odsyłające, które wygenerowały najwięcej wyświetleń określonego filmu i określonego typu źródła wizyt. Możesz na przykład sprawdzić, które podobne filmy wygenerowały największy ruch 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ą zawierać dane zbiorcze z określonego przedziału czasu (np. z danego dnia, ostatnich 7 dni, ostatnich 30 dni) lub z danego kraju. Jeśli raport zawiera dane zbiorcze według dnia lub kraju, może też podawać średni czas każdego wyświetlenia filmu oraz średni procentowy udział obejrzanej części filmu.

2 października 2012 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API już jest dostępna dla wszystkich deweloperów. Możesz aktywować interfejs API w swoim projekcie bez konieczności wcześniejszego wysyłania prośby o dostęp. Zrobisz to w panelu Usługi w APIs console.

  • Nowa sekcja Pierwsze kroki zawiera wymagania wstępne i podstawowe kroki tworzenia aplikacji, która korzysta z YouTube Analytics API.

12 września 2012 r.

Ta aktualizacja zawiera następujące zmiany:

  • Nowa sekcja Informacje o wykorzystaniu limitu zawiera wskazówki dotyczące optymalizacji wykorzystania limitu interfejsu API. Serwer interfejsu API oblicza koszt zapytania dla każdego żądania, a następnie odejmuje go od limitu wykorzystania interfejsu API. Różne typy raportów mogą mieć bardzo różne koszty zapytań, dlatego należy efektywnie wykorzystywać limit, a aplikacja powinna żądać tylko tych danych, 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 okresu. Interfejs API obsługuje teraz te dodatkowe wymiary czasowe:

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

    Podobnie sekcja Dostępne raporty została zaktualizowana, aby odzwierciedlić obsługę przez interfejs API raportów, które używają tych wymiarów.

  • Sekcja Wymiary podmiotu raportującego została zaktualizowana, aby poinformować, że żądania do 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) lub obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

  • Interfejs API obsługuje teraz 2 nowe opcje sortowania raportów o najpopularniejszych filmach. Te raporty, które są dostępne jako raporty kanału lub raporty właściciela treści, zawierają dane (wyświetlenia, komentarze, polubienia itp.) według kraju i dzielą te dane według filmu. Możesz teraz sortować te raporty według liczby użytkowników, którzy zasubskrybowali kanał lub anulowali jego subskrypcję na stronie odtwarzania filmu.

  • Definicje danych subscribersGained i subscribersLost zostały zaktualizowane, 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, zawierają tylko statystyki ze strony odtwarzania tego filmu.