Historia zmian

Na tej stronie znajdziesz informacje o zmianach w interfejsie API oraz aktualizacjach dokumentacji dotyczącej YouTube Reporting API i YouTube Analytics API. Oba interfejsy API dają deweloperom dostęp do danych Statystyk YouTube, ale na różne sposoby. Zasubskrybuj ten dziennik zmian. Subskrybuj.

6 maja 2024 r.

Interfejs API Statystyk YouTube (docelowych zapytań) obsługuje 3 nowe raporty dotyczące kanałów:

Ponadto w kolumnie Odbiorcy Raport Utrzymanie został ulepszony o 3 nowe rodzaje danych:

7 kwietnia 2024 r.

Wprowadzono kilka aktualizacji interfejsu YouTube Analytics (Targeted Queries) API, które dotyczą właścicieli treści w raportach dotyczących playlist. Są one takie same jak te dotyczące raportów na temat playlist kanału, która została ogłoszona 19 stycznia 2024 r.

Ten wpis historii zmian zapewnia prawie zawiera te same informacje co w artykule z 19 stycznia 2024 r. Pamiętaj jednak, że właściciel treści Raporty o playlistach będą obsługiwać isCurated wymiar do 31 grudnia 2024 r., a wymiar ten będzie obsługiwany w przypadku raportów dotyczących playlist kanału. 30 czerwca 2024 r.

  • Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

    isCurated z raportów dotyczących playlist właściciela treści. Już nie będzie obsługiwane od 31 grudnia 2024 r. Definicja tego wymiaru została zaktualizowana odpowiednio się zmienia.

    Aby zachować zgodność wsteczną po usunięciu interfejsu isCurated musisz też zaktualizować swój kod, aby pobierać dane playlistViews zamiast danych views tylko w raportach dotyczących playlist. Od views są wciąż obsługiwane w raportach dotyczących playlist. Mają jednak inne znaczenie, będą nadal zwracać dane, jeśli nie zaktualizujesz ich nazwy. Oczywiście możesz modyfikować aplikację aby pobrać i wyświetlić zarówno views, jak i playlistViews.

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

    • 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ż są obsługiwane jako filtry w raportach dotyczących playlist kanału. Te filtry są niedostępne w w YouTube Studio, więc ta zmiana pozwoliła dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Raporty dotyczące playlist w dokumentacji raportów właściciela treści została zaktualizowana w celu dokładniejszego wyjaśnienia rodzaje danych obsługiwane w raportach dotyczących playlist:

    • Zbiorcze dane o reklamach wideo zawierają zbiorcze dane o aktywności użytkowników i wyświetleniach dotyczące wszystkich filmów playlisty należące do właściciela treści. Zbiorcze dane o reklamach wideo obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru isCurated.
    • Dane dotyczące playlist odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane uwzględnij też wyświetlenia z filmów, które nie należą do Ciebie, ale tylko wtedy, gdy te wyświetlenia wystąpiły w kontekście playlisty.
    • Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i playlistach, które są obsługiwane w raportach dotyczących playlist.

  • W raportach o playlistach są obsługiwane następujące nowe dane dotyczące playlist właścicieli treści. Pamiętaj, że te dane są obsługiwane tylko wtedy, gdy żądanie pobrania do interfejsu API raporty nie korzystają z wymiaru isCurated. Zobacz danych: definicje poszczególnych danych:

  • Jak działa views zależy teraz od tego, czy żądanie do interfejsu API, które pobierało raport o playlistach, Wymiar isCurated:

    • Jeśli żądanie zawiera wymiar isCurated, funkcja Dane (views) to jedna z playlist który wskazuje, ile razy filmy zostały wyświetlone w kontekście playlistach należących do właściciela treści.
    • Jeśli żądanie nie zawiera wymiaru isCurated, parametr Dane views to zbiorcze dane wideo, które określają łączną liczbę wyświetleń filmów z playlist właściciela treści, niezależnie od tego, czy wyświetleń miało miejsce w kontekście playlisty. Łączna suma obejmuje tylko wyświetlenia Filmy należące 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, wymiar Dane playlistViews wskazują liczbę wyświetleń filmu w kontekście playlisty. Ta wartość zlicza wyświetlenia wszystkich filmów z tej playlisty, bez względu na to, do którego kanału należą.

  • Przy każdym raporcie o playlistach raporty właściciela treści dokumentacja zawiera teraz tabele zawierające obsługiwane dane dla danego raportu w zależności od czy żądanie do interfejsu API zawiera wymiar isCurated. Zapoznaj się z sekcją określającą raporty o playlistach według czasu .

19 stycznia 2024 r.

W interfejsie YouTube Analytics (Targeted Queries) wprowadziliśmy kilka aktualizacji związanych z playlistami kanału raportów. Aktualizacje obejmują wycofany wymiar oraz kilka nowych i zaktualizowanych danych:

  • Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

    isCurated został wycofany z raportów dotyczących kanałów. Nie będą już obsługiwane na ani po 30 czerwca 2024 r. Definicja tego wymiaru została odpowiednio zaktualizowana.

    Aby zachować zgodność wsteczną po usunięciu interfejsu isCurated musisz też zaktualizować swój kod, aby pobierać dane playlistViews zamiast danych views tylko w raportach dotyczących playlist. Od views są wciąż obsługiwane w raportach dotyczących playlist. Mają jednak inne znaczenie, będą nadal zwracać dane, jeśli nie zaktualizujesz ich nazwy. Oczywiście możesz modyfikować aplikację aby pobrać i wyświetlić zarówno views, jak i playlistViews.

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

    • 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ż są obsługiwane jako filtry w raportach dotyczących playlist kanału. Te filtry są niedostępne w w YouTube Studio, więc ta zmiana pozwoliła dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Raporty dotyczące playlist w dokumentacji raportów kanałów została zaktualizowana, aby dokładniej wyjaśnić, rodzaje danych obsługiwane w raportach dotyczących playlist:

    • Zbiorcze dane o reklamach wideo zawierają zbiorcze dane o aktywności użytkowników i wyświetleniach dotyczące wszystkich filmów playlisty na kanale, które również należą do niego. Zbiorcze dane o reklamach wideo obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru isCurated.
    • Dane dotyczące playlist odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane uwzględnij też wyświetlenia z filmów, które nie należą do Ciebie, ale tylko wtedy, gdy te wyświetlenia wystąpiły w kontekście playlisty.
    • Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i playlistach, które są obsługiwane w raportach dotyczących playlist.

  • W raportach dotyczących playlist dla kanałów obsługiwane są następujące nowe dane dotyczące playlist. Te dane nie są jeszcze obsługiwane w raportach dla właścicieli treści. Pamiętaj, że te dane jest obsługiwana tylko wtedy, gdy żądanie do interfejsu API umożliwiające pobranie raportów nie korzysta z parametru Wymiar isCurated. Zobacz danych: definicje poszczególnych danych:

  • Jak działa views zależy teraz od tego, czy żądanie do interfejsu API, które pobierało raport o playlistach, Wymiar isCurated:

    • Jeśli żądanie zawiera wymiar isCurated, funkcja Dane (views) to jedna z playlist który wskazuje, ile razy filmy zostały wyświetlone w kontekście na playlistach.
    • Jeśli żądanie nie zawiera wymiaru isCurated, parametr Dane views to zbiorcze dane wideo, które określają łączną liczbę wyświetleń danego filmu z playlist kanału, niezależnie od tego, wyświetleń miało miejsce w kontekście playlisty. Łączna suma obejmuje tylko wyświetlenia na kanale, do którego należy playlista.

      W tych raportach, które nie korzystają z wymiaru isCurated, wymiar Dane playlistViews wskazują liczbę wyświetleń filmu w kontekście playlisty. Ta wartość zlicza wyświetlenia wszystkich filmów z tej playlisty, bez względu na to, do którego kanału należą.

  • Przy każdym raporcie o playlistach znajdziesz raporty dotyczące kanału. dokumentacja zawiera teraz tabele zawierające obsługiwane dane dla danego raportu w zależności od czy żądanie do interfejsu API zawiera wymiar isCurated. Zapoznaj się z sekcją określającą raporty o playlistach według czasu .

4 grudnia 2023 r.

Zaktualizowaliśmy interfejs YouTube Analytics (Targeted Zapytania), aby połączyć 2 platformy insightTrafficSourceType wartości wymiarów. Wcześniej wymiar rozróżnił filmy odtwarzane jako część playlisty. (PLAYLIST) i wyświetlenia pochodzące ze strony zawierającej wszystkie filmy z playlisty (YT_PLAYLIST_PAGE). Od tej pory oba typy wyświetleń będą powiązane z Wartość wymiaru PLAYLIST.

15 grudnia 2022 r.

Interfejs API Statystyk YouTube (docelowych zapytań) obsługuje 2 nowe wymiary i 1 nowy raport:

  • Nowy raport przedstawia aktywność użytkowników według miasta. Ten raport jest dostępny dla channels oraz właścicielami treści. Ten raport zawiera nowe: city , który określa szacunkową wielkość miasta, w którym miała miejsce aktywność użytkownika.

  • Nowy creatorContentType określa rodzaj treści w YouTube, które są powiązane z aktywnością użytkownika. dane w wierszu danych. Obsługiwane wartości to LIVE_STREAM, SHORTS, STORY i VIDEO_ON_DEMAND.

    Wymiar creatorContentType jest obsługiwany jako opcjonalny dla wszystkich na kanale i w raportach 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 zostały usunięte z dokumentacji. Wycofanie tych wymiarów ogłosiliśmy w październiku 2019 r.

26 sierpnia 2022 r.

Interfejs YouTube Analytics (Targeted Queries) API i YouTube Reporting (zbiorcze raporty) API obsługują nową wartość szczegółów źródła wizyt:

  • W interfejsie YouTube Analytics API (Targeted Queries) API, jeśli insightTrafficSourceType ma wartość SUBSCRIBER, a następnie insightTrafficSourceDetail można ustawić na podcasts, co oznacza, że ruch został odesłany z Strona docelowa Podcastów.
  • Jeśli w interfejsie API YouTube do raportowania (raporty zbiorcze) traffic_source_type ma wartość 3, a następnie Wartość traffic_source_detail można ustawić jako podcasts, co oznacza, że ruch został odesłany z Strona docelowa Podcastów.

11 lutego 2022 r.

Zbiór prawidłowych wartości wymiaru gender zmieni się w sierpniu lub później 11 r. 2022 r. Może to być zmiana niekompatybilna wstecznie w Twojej implementacji interfejsu API. Zgodnie z Wstecz Niezgodne zmiany w Warunkach korzystania z usług YouTube API, ogłoszone na 6 miesięcy przed wejściem w życie tych przepisów. Zaktualizuj implementację interfejsu API przed 11 sierpnia 2022 r., aby umożliwić płynne przejście na nowy zbiór wartości.

Wprowadzane zmiany są następujące:

  • W interfejsie API Statystyk YouTube funkcja kierowania Obecnie gender wymiar obsługuje 2 wartości: female i male. 11 sierpnia 2022 r. lub później wymiar będzie obsługiwać 3 wartości: female, male oraz user_specified
  • W interfejsie API do raportowania (zbiorcze raporty) YouTube funkcja Obecnie gender wymiar obsługuje trzy 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.

Zaktualizowano 2 rodzaje danych, aby wykluczyć zapętlanie ruchu klipów z 13 grudnia 2021 r. Ta zmiana wpływa zarówno na interfejs YouTube Analytics (Targeted Queries), jak i API do raportowania (zbiorcze raporty) w YouTube.

2 lutego 2022 r.

Ten interfejs API do raportowania (zbiorcze raporty) YouTube obsługuje nową wartość wymiaru źródła wizyt, która wskazuje, że wyświetlenia pochodzące z Live Redirect:

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

W przypadku tego typu źródła wizyt traffic_source_detail określa identyfikator kanału, z którego trafił do widza.

23 września 2020 r.

Interfejs YouTube Analytics (Targeted Queries) API oraz YouTube Reporting (Bulk Reports) obsługują nową wartość wymiaru źródła wizyt, która wskazuje, że użytkownik został odesłany przez przesuń w pionie podczas oglądania YouTube Shorts:

  • W interfejsie YouTube Analytics API (Targeted Zapytania) narzędzie insightTrafficSourceType obsługuje wartość SHORTS.
  • W interfejsie API do raportowania (zbiorcze raporty) YouTube funkcja traffic_source_type obsługuje wartość 24.

Wymiar „Szczegóły źródła wizyt” – insightTrafficSourceDetail w interfejsie YouTube Analytics API; traffic_source_detail w interfejsie YouTube Reporting API – nie ma wartości dla tego nowego typu źródła wizyt.

20 lipca 2020 r.

Ta aktualizacja obejmuje 2 zmiany, które wpływają na interfejs YouTube Analytics (Targeted Queries) API:

  • Maksymalny rozmiar raportu w Statystykach YouTube grupa wzrosła z 200 do 500 elementów.
  • Metoda reports.query filters określa listę filtrów, które należy zastosować podczas pobierania Statystyk YouTube. i skalowalnych danych. Parametr umożliwia określenie wielu wartości dla video, playlist, i channel filtrów oraz maksymalna liczba identyfikatorów, które można określić dla tych filtrów, wzrosła z 200 do 500 identyfikatorów.

13 lutego 2020 r.

Ta aktualizacja wprowadza następujące zmiany związane ze Statystykami YouTube (zapytania kierowane) w interfejsie YouTube Reporting API (w raportach zbiorczych) oraz w interfejsie YouTube Reporting API. Więcej informacji o tych zmianach znajdziesz w Centrum pomocy YouTube.

W obu interfejsach API zmienia się zbiór możliwych wartości szczegółów źródła wizyt dla powiadomień. W zapytaniach objętych kierowaniem powiadomienia są zgłaszane jako insightTrafficSourceType=NOTIFICATION. W raporty zbiorcze, powiadomienia są zgłaszane jako traffic_source_type=17.

Nowe wartości rozdzielają powiadomienia dotyczące przesłanych filmów i transmisji na żywo, zgłoszone jako uploaded, podzielone na 2 kategorie:

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

Te wartości są zwracane dla zakresu czasowego od 13 stycznia 2020 r.

Przypominamy też, że te wartości nie reprezentują samych powiadomień, ale raczej ruchu. które przyniosły określone wyświetlenia w YouTube. Jeśli np. wiersz raportu zawiera wartość views=3, traffic_source_type=17 (NOTIFICATION) i traffic_source_detail=uploaded_push, wiersz wskazuje, że 3 wyświetlenia wynikało z kliknięć powiadomień push wysyłanych po przesłaniu filmu.

15 października 2019 r.

Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Zapytania) API:

  • Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

    YouTube wycofuje obsługę wymiarów 7DayTotals i 30DayTotals. Dane za pomocą tych wymiarów możesz pobierać do 15 kwietnia 2020 r. Tego dnia lub później próba pobrania raportów przy użyciu wymiaru 7DayTotals lub 30DayTotals spowoduje zwrócenie błędu.

    Pamiętaj, że użytkownicy mogą odtworzyć niektóre dane z tych wymiarów, wysyłając zapytania za pomocą wymiaru day, a potem agregując lub wykorzystując dane z okresów 7 lub 30 dni. Na przykład:

    • Liczba wyświetleń w okresie 7 dni można obliczyć, sumując liczbę wyświetleń z każdego dnia tego okresu.
    • Odsetek widzów w okresie 7 dni można obliczyć, mnożąc liczbę wyświetleń, które miały miejsce każdego dnia przez procentowy wyświetlenia w danym dniu, w celu uzyskania liczby widzów zalogowanych w związku z oglądaniem danego filmu tego dnia. Następnie możesz dodać liczbę zalogowanych widzów z całego okresu i podzielić ją przez łączną liczbę wyświetleń w tym okresie, aby uzyskać odsetek widzów z całego okresu.
    • Nie można obliczyć liczby unikalnych widzów w okresie 7 dni, ponieważ tego samego widza można zliczyć jako unikalnego widza w różnych dniach. Możesz jednak użyć wymiaru month zamiast wymiaru 30DayTotals, aby ekstrapolować dane dotyczące liczby 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 wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Zapytania) API:

  • Ponieważ wersja 1 interfejsu API została całkowicie wycofana, zaktualizowaliśmy dokumentację, aby usunąć do niej odniesienia, w tym powiadomienie o wycofaniu i przewodnik po migracji wyjaśniający, jak zaktualizować do wersji 2.

1 listopada 2018 r.

Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Zapytania) API:

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

    Przypominamy, że harmonogram wycofania tej funkcji został pierwotnie ogłoszony 26 kwietnia 2018 roku.

17 września 2018 r.

Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Zapytania) API:

  • W nowej sekcji dotyczącej anonimizacji danych w dokumencie Omówienie modelu danych wyjaśniamy, że niektóre dane w Statystykach YouTube są ograniczone, gdy dane nie osiągną określonego progu. To może się zdarzyć w różnych przypadkach. W praktyce oznacza to, że raport może nie zawierać wszystkich (lub wszystkich) danych, jeśli:

    1. liczba wizyt w filmie lub kanale w wybranym okresie jest ograniczona;

      lub

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

    W nowej sekcji omówiliśmy też typy danych, które mogą być ograniczone w raportach Statystyk YouTube.

  • Zaktualizowaliśmy dokumenty Raporty dotyczące kanału i Raporty właściciela treści, aby uwzględnić fakt, że dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w raportach o miejscu odtwarzania, źródłach wizyt ani typie urządzenia/systemie operacyjnym.

18 czerwca 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

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

      Pierwsza opcja używa 1 zakresu, który dziś jest zakresem do odczytu i zapisu, a druga korzysta z 2 zakresów tylko do odczytu.

23 maja 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

22 maja 2018 r.

Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Reporting API (raporty zbiorcze):

  • Podane niżej zmiany wejdą w życie w lipcu 2018 roku, a nowe zasady będą stosowane globalnie do wszystkich raportów i zadań raportowania.

    • Po zmianie większość raportów interfejsu API, w tym raporty o zapasach, będzie dostępna przez 60 dni od momentu ich wygenerowania. Jednak raporty zawierające dane historyczne będą 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. Dla jasności – gdy ta zmiana zasad wejdzie w życie, raporty z danymi historycznymi, które mają ponad 30 dni, również nie będą już dostępne w interfejsie API. Wszystkie pozostałe raporty starsze niż 60 dni również nie będą dostępne. W związku z tym w dokumentacji widnieje informacja, że raporty utworzone przed zmianą zasad będą dostępne maksymalnie przez 180 dni.

    • Po tej zmianie, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty od tego dnia i obejmujące 30 dni poprzedzających zaplanowanie zadania. Przed zaplanowaniem zadania raportowania przed tą zmianą YouTube wygeneruje raporty obejmujące okres 180 dni poprzedzających zaplanowanie zadania.

  • Zaktualizowaliśmy sekcję ze sprawdzonymi metodami, aby przypomnieć, że za pomocą interfejsu YouTube Data API można pobierać dodatkowe metadane dotyczące zasobów wymienionych w raportach. Zgodnie z zasadami dla deweloperów dotyczącymi usług interfejsu YouTube API (sekcje III.E.4.b do III.E.4.d) klienty interfejsu API muszą po 30 dniach usunąć lub odświeżyć zapisane metadane zasobów z tego interfejsu.

  • Zaktualizowaliśmy sekcję Cechy raportów, aby zaznaczyć, że chociaż dane z raportu nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. lub później nie będą zawierać żadnych odniesień do zasobów YouTube usuniętych co najmniej 30 dni przed datą wygenerowania raportu.

  • Zaktualizowaliśmy sekcję Dane historyczne w przeglądzie interfejsu API, aby zaznaczyć, że gdy planujesz nowe zadanie raportowania, raporty historyczne są zwykle publikowane w ciągu kilku dni. Wcześniej w dokumencie podano, że udostępnienie takich raportów może potrwać do 30 dni.

  • Zaktualizowaliśmy sekcję dotyczącą danych zapasowych w omówieniu interfejsu API, aby bardziej precyzyjnie definiować dane zapasowe 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 już dostępna publicznie. Poniższa lista zawiera zmiany w usługach i dokumentacji związane z nową wersją interfejsu API:

  • Interfejs API w wersji 2 jest prawie taki sam jak wersja 1. Konieczne może być jednak zaktualizowanie kodu, aby uwzględnić zmiany wymienione poniżej. Wszystkie te zmiany zostały szczegółowo wyjaśnione w nowym przewodniku po migracji.

    • Wersja interfejsu API została zmieniona z v1 na v2.
    • Podstawowy URL żądań do interfejsu API został zmieniony z https://www.googleapis.com/youtube/analytics/v1 na https://youtubeanalytics.googleapis.com/v2.
    • Nazwy niektórych parametrów metody reports.query zostały zaktualizowane. W szczególności nazwy parametrów, które zawierają łączniki, na przykład end-date w interfejsie API w wersji 1, używają wielkich liter (endDate), a nie łączników w interfejsie API w wersji 2. Ta zmiana sprawi, że nazwy parametrów staną się spójne w całym interfejsie API, ponieważ stosowane w interfejsie API metody tworzenia grup i zarządzania nimi używały już wielkich liter w nazwach parametrów.
    • Interfejs API w wersji 2 nie obsługuje żądań zbiorczych wysyłanych do globalnego punktu końcowego HTTP Google (www.googleapis.com/batch). Jeśli wysyłasz żądania zbiorcze za pomocą interfejsu API w wersji 2, musisz użyć punktu końcowego https://youtubeanalytics.googleapis.com/v2.

    Dodatkowo kilka funkcji dostępnych w wersji 1 nie jest obsługiwane przez interfejs API w wersji 2:

    • Metoda reports.query nie obsługuje już parametrów żądań alt, quotaUser i userIp.
    • Interfejs API w wersji 2 nie udostępnia wsadowego punktu końcowego, który obsługuje wsady złożone z żądań do różnych interfejsów API. (Wsad może jednak składać się z żądań skierowanych do różnych metod tego samego interfejsu API). Nie dotyczy to interfejsu YouTube Analytics API, ponieważ Google wycofuje globalny punkt końcowy wsadowy ze wszystkich swoich interfejsów API.
    • Interfejs API w wersji 2 nie obsługuje protokołu JSON-RPC, który był obsługiwany w interfejsie API w wersji 1. Pamiętaj, że wycofanie te nie dotyczy tylko interfejsu YouTube Analytics API.

  • Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

    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ć. Aby uniknąć przerw w dostępie do danych Statystyk YouTube przez ten interfejs, przejdź na wersję 2 API nie później niż 31 października 2018 r.

21 lutego 2018 r.

Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

  • raporty demograficzne widzów, które zbierają statystyki oglądania na podstawie grupa wiekowa i płeć, nie obsługują już wymiaru youtubeProduct identyfikującego usługę YouTube, w której miała miejsce aktywność użytkownika.

18 stycznia 2018 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs YouTube Reporting API (raporty zbiorcze)

    • Wymiar operating_system określający system oprogramowania urządzenia, na którym doszło do wyświetlenia, obsługuje teraz tę wartość:
      • 25: KaiOS

  • YouTube Analytics API (zapytania kierowane)

20 grudnia 2017 r.

Ta aktualizacja obejmuje 2 zmiany związane z interfejsem 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ą dla każdej odpowiedzi interfejsu API. Chociaż aplikacja wymaga dodatkowego czasu pracy procesora, aby zdekompresować odpowiedzi interfejsu API, korzyści zużywania mniejszej liczby zasobów sieciowych zwykle przewyższają ten koszt.

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

    Accept-Encoding: gzip

    Tę funkcję opisujemy w omówieniu interfejsu API oraz w definicji właściwości downloadUrl zasobu report.

  • Dokumentacja wymiarów age group i gender została poprawiona, aby pokazać rzeczywiste wartości zwracane przez interfejs API dla tych wymiarów. Pamiętaj, że jest to poprawka w dokumentacji i nie odzwierciedla zmian w działaniu ani działaniu interfejsu API. Zmieniły się te wartości:

    • Wartości wymiaru age_group zawierają wielkie litery, zawierają podkreślenia między słowem AGE a cyframi w grupie wiekowej oraz używają podkreśleń zamiast łączników. W związku z tym skorygowaliśmy wartości takie jak age13-17 i age18-24 odpowiednio na AGE_13_17 i AGE_18_24.
    • Wartości wymiaru gender zawierają wielkie litery. W związku z tym 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 z interfejsu YouTube Analytics API wartości earnings. Jednocześnie w interfejsie API dodano obsługę nowych danych o nazwie estimatedRevenue, które zawierają te same informacje.

Dane earnings były podstawowymi danymi, dlatego były obsługiwane przez rok od daty ogłoszenia. Ten roczny okres już się zakończył, ale dane earnings nie są już obsługiwane. W rezultacie żądania interfejsu API, które określają wskaźnik earnings, zwracają teraz kod odpowiedzi HTTP 400. Jeśli jeszcze nie korzystasz z danych estimatedRevenue zamiast earnings, zaktualizuj swoją aplikację jak najszybciej.

Zaktualizowaliśmy dokumentację interfejsu API, aby usunąć pozostałe odwołania do wskaźnika earnings.

6 lipca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API (zapytania kierowane)

    • Zaktualizowaliśmy dokumentację interfejsu API, aby odzwierciedlić fakt, że odpowiedzi interfejsu API zawierają dane do ostatniego dnia w żądanym zakresie dat, dla którego są dostępne wszystkie dane, których dotyczy zapytanie.

      Jeśli np. w żądaniu jest określona data końcowa 5 lipca 2017 r., a wartości wszystkich żądanych danych są dostępne tylko do 3 lipca 2017 r., będzie to ostatni dzień, którego dotyczy ta odpowiedź. Dzieje się tak nawet wtedy, gdy dane niektórych żądanych danych są dostępne od 4 lipca 2017 r.

    • Wymiar adType obsługuje teraz wartość reservedBumperInstream, która odnosi się do niemożliwej do pominięcia reklamy wideo, która trwa maksymalnie 6 sekund, zanim rozpocznie się odtwarzanie filmu. Format reklamy jest taki sam jak reklama auctionBumperInstream, ale ten typ odnosi się do reklam sprzedawanych na zasadzie rezerwacji, a nie na aukcji.

  • Interfejs YouTube Reporting API (raporty zbiorcze)

    • Wymiar ad_type obsługuje teraz wartość 20 odnoszącą się do bumperów reklamowych sprzedawanych na zasadzie rezerwacji. Bumpery reklamowe to reklamy wideo niemożliwe do pominięcia, które trwają do 6 sekund i są odtwarzane, zanim rozpocznie się odtwarzanie filmu. Pamiętaj, że wartość 19 dla tego wymiaru odnosi się też do bumperów reklamowych sprzedawanych na aukcji, a nie na zasadzie rezerwacji.

    • Usunęliśmy zadania raportowania w przypadku tych raportów interfejsu YouTube Reporting API:

      • 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 są wycofane. Po 15 grudnia 2016 r. raporty na ich temat nie są 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 od 15 czerwca 2017 r. Raporty nie są już jednak dostępne, więc powiązane z nimi zadania również nie są potrzebne.

24 maja 2017 r.

Wszystkie zadania raportowania w tych raportach interfejsu YouTube Reporting API zostały usunięte:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

22 czerwca 2016 r. ogłosiliśmy, że te typy raportów zostały wycofane. Od 22 września 2016 r. raporty na ich temat nie są 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 od 22 marca 2017 r. Raporty nie są już jednak dostępne, więc powiązane z nimi zadania również nie są potrzebne.

22 maja 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs YouTube Reporting API (raporty zbiorcze)

    • Wymiar sharing_service określający usługę, która była używana do udostępniania filmów, obsługuje teraz te wartości:

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

      Oprócz tego nazwa używana do identyfikacji wartości 52 w dokumentacji została zmieniona na Kakao (Kakao Talk), aby wyraźniej odróżnić ją od wartości 73 (Kakao Story). Nie odzwierciedla to zmian w działaniu interfejsów API ani klasyfikacji filmów udostępnianych tym usługom.

  • YouTube Analytics API (zapytania kierowane)

    • 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 Studiu twórców, mogą teraz również korzystać z tych danych 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:

  • Interfejs YouTube Reporting API (raporty zbiorcze)

    • Poprawiona definicja wymiaru date oznacza, że wartość wymiaru odnosi się do okresu rozpoczynającego się o 00:00 czasu pacyficznego i kończącego się o 23:59. Czas pacyficzny w danym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny to UTC-7 lub UTC-8.

      Choć daty zwykle reprezentują 24-godzinny okres, to daty, gdy zegary przestają być wyświetlane do przodu, przedstawiają okres 23-godzinny, a daty przesunięcia zegarów do tyłu przedstawiają okres 25-godzinny. Wcześniej w dokumentacji stwierdzono, że każda data reprezentuje unikalny okres 24-godzinny, a czas pacyficzny zawsze przedstawia czas UTC-8.

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

    • Wymiar operating_system określający system oprogramowania urządzenia, na którym doszło do wyświetlenia, obsługuje teraz te wartości:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • Wszystkie zadania raportowania w ramach raportu typu content_owner_basic_a1 zostały usunięte. Ten typ raportów 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. W związku z tym niektóre raporty były dostępne od 19 lutego 2017 r. Raporty nie są już jednak dostępne, więc powiązane z nimi zadania również nie są potrzebne.

  • YouTube Analytics API (zapytania kierowane)

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

      Choć daty zwykle reprezentują 24-godzinny okres, to daty, gdy zegary przestają być wyświetlane do przodu, przedstawiają okres 23-godzinny, a daty przesunięcia zegarów do tyłu przedstawiają okres 25-godzinny. Wcześniej w dokumentacji stwierdzono, że czas pacyficzny to UTC-8 i nie podano, że dzień może nie przedstawiać 24-godzinnego okresu.

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

    • Dokumentacja raportów dotyczących kanałów została zaktualizowana, aby zaznaczyć, że raporty dotyczące kanałów nie zawierają obecnie danych o zarobkach ani skuteczności reklam. W rezultacie zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie zapewnia 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. Ten parametr ma zastosowanie tylko wtedy, gdy pobierasz raporty właścicieli treści.

Ten parametr pozwala właścicielowi treści wskazać, że odpowiedź interfejsu API powinna zawierać łączny czas oglądania i dane z okresu poprzedzającego połączenie kanałów z właścicielem treści. Domyślna wartość parametru to false, co oznacza, że odpowiedź interfejsu API zawiera domyślnie tylko dane dotyczące czasu oglądania i wyświetleń uzyskane od momentu połączenia kanałów z właścicielem treści.

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

  • Jeśli wartością tego parametru jest false, to dane dotyczące czasu oglądania i wyświetleń zwracane dla dowolnego kanału zależą od daty połączenia kanału 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 dniach. Jeśli żądanie do interfejsu API pobiera dane dotyczące wielu kanałów, a wartość parametru to false, odpowiedź interfejsu API zawiera dane dotyczące czasu oglądania i wyświetleń oparte na dacie połączenia poszczególnych kanałów.
  • Jeśli wartością parametru jest true, odpowiedź zwróci czas oglądania i dane o wyświetleniach wszystkich kanałów na podstawie daty rozpoczęcia i zakończenia określonej w żądaniu do interfejsu API.

15 grudnia 2016 r.

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

Zaktualizowaliśmy też listę aktualnych typów raportów w dokumentacji interfejsu 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, a także nowe wymiary i dane w tych raportach. Raporty zawierają statystyki wyświetleń i klikalności ekranów końcowych, które pojawiają się po zakończeniu odtwarzania filmu.

    8 listopada 2016 r.

    Ta aktualizacja wprowadza te zmiany w YouTube Analytics API:

    • Dane na liście poniżej zostały w pełni wycofane i nie są już obsługiwane. Zgodnie z ogłoszeniem z 10 sierpnia 2016 r. obsługiwane są już nowe wskaźniki odwołujące się do tych samych danych. W tabeli poniżej znajdziesz nazwę wycofanego i nowego rodzaju danych:

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

    27 października 2016 r.

    YouTube automatycznie generuje teraz zestaw zarządzanych przez system raportów o przychodach z reklam dla właścicieli treści, którzy mają dostęp do powiązanych z nimi raportów w sekcji Raporty w Studiu twórców YouTube. Nowe raporty w interfejsie API zarządzanym przez system zostały zaprojektowane tak, aby zapewniać programowy dostęp do danych, które są też dostępne w raportach Studia twórców, które można pobrać ręcznie.

    Omówienie raportów zarządzanych przez system zawiera krótkie omówienie nowych raportów oraz wyjaśnia proces pobierania ich za pomocą interfejsu API. Ten proces różni się nieco od procesu pobierania raportów zbiorczych do Statystyk YouTube, ponieważ partnerzy nie muszą planować zleceń, by generować te raporty.

    Właściwość id zasobu reportType została zaktualizowana, aby uwzględnić 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 film (z całego świata)
    • Dzienne przychody z reklam na film wg kraju
    • Miesięczne, globalne przychody z reklam na zasób
    • Dzienne przychody z reklam na zasób wg kraju
    • Roszczenia (ten raport nie zawiera danych o przychodach)

    27 września 2016 r.

    Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

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

    15 września 2016 r.

    Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Reporting API:

    19 sierpnia 2016 r.

    Ta aktualizacja wprowadza te zmiany 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. Wygenerowane już raporty będą jednak dostępne przez 180 dni od momentu ich wygenerowania.

      Raportem content_owner_basic_a1, który zastąpił raport content_owner_basic_a2, jest wpis historii zmian z 19 maja 2016 roku.

    11 sierpnia 2016 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowo opublikowane Warunki korzystania z usług YouTube API („Zaktualizowane warunki”), które są szczegółowo omówione na blogu YouTube dla inżynierów i deweloperów, zawierają obszerny zestaw aktualizacji obecnych Warunków korzystania z usługi. Oprócz zaktualizowanych warunków, które zaczną obowiązywać 10 lutego 2017 roku, ta aktualizacja zawiera też dodatkowe dokumenty wyjaśniające zasady, których muszą przestrzegać deweloperzy.

      Pełny zestaw nowych dokumentów znajdziesz w historii zmian zaktualizowanych Warunków. Ponadto w historii zmian będą również wyjaśniane przyszłe zmiany w zaktualizowanych warunkach lub w dokumentach uzupełniających. Możesz zasubskrybować kanał RSS zawierający listę zmian w historii zmian, klikając link w tym dokumencie.

    10 sierpnia 2016 r.

    Ta aktualizacja obejmuje te zmiany:

    • YouTube Analytics API (zapytania kierowane)

      • Uwaga: to jest ogłoszenie o wycofaniu tej usługi.

        Wskaźniki w poniższej tabeli są wycofywane. Jednocześnie wprowadzamy nowe rodzaje danych, które odnoszą się do tych samych informacji. W efekcie spowoduje to zmianę nazw starych danych, ale YouTube Analytics API będzie obsługiwać obie te nazwy do daty wycofania wymienionej w tabeli.

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

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

        Na przykład do 4 listopada 2016 r. żądanie do interfejsu API może określać dane impressionBasedCpm, cpm lub oba. Po tej dacie będą jednak obsługiwane tylko dane cpm.

      • Wymiar insightTrafficSourceType obsługuje 2 nowe wartości:
        • CAMPAIGN_CARD: to źródło wizyt jest obsługiwane tylko w przypadku raportów właścicieli treści. Wskazuje on, że wyświetlenia pochodzą z filmów przesłanych przez użytkowników objętych roszczeniem, które właściciel treści wykorzystał do promowania wyświetlanych treści.
        • END_SCREEN: dane dotyczą wyświetleń pochodzących z ekranów końcowych innego filmu.

        W przypadku obu nowych źródeł wizyt możesz też pobrać raport traffic source detail. W obu przypadkach wymiar insightTrafficSourceDetail określa film, z którego trafił użytkownik.

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

    • Interfejs 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 przypadku raportów właścicieli treści. Wskazuje on, że wyświetlenia pochodzą z filmów przesłanych przez użytkowników objętych roszczeniem, które właściciel treści wykorzystał do promowania wyświetlanych treści.
        • 20: dane dotyczą wyświetleń pochodzących z ekranów końcowych innego filmu.

        W przypadku obu nowych źródeł wizyt wymiar traffic_source_detail określa film, z którego trafił użytkownik.

      • Lista podstawowych danych interfejsu API została zmieniona tak, aby wyświetlać estimated_partner_revenue jako podstawowe dane i usunąć z niej pozycję earnings. (dane earnings nigdy nie były obsługiwane w interfejsie YouTube Reporting API).

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

    18 lipca 2016 r.

    Ta aktualizacja obejmuje te zmiany:

    • YouTube Analytics API (zapytania kierowane)

      • Zaktualizowaliśmy listy obsługiwanych danych w raportach dotyczących kanałów, tak aby uwzględniały dane kart. Obsługa danych kart w tych raportach została dodana 28 czerwca 2016 roku, a wpis w historii zmian dla tej daty wyjaśnia tę zmianę bardziej szczegółowo. Raporty to:
        • Podstawowa aktywność użytkowników w stanach USA
        • Aktywność użytkowników w stanach USA w określonych okresach
        • Aktywność użytkowników według prowincji
        • Aktywność użytkowników według stanu subskrypcji
        • Aktywność użytkowników według stanu subskrypcji (prowincje)
        • Najpopularniejsze filmy według stanu
        • Najpopularniejsze filmy wśród subskrybentów i widzów bez subskrypcji

      • Skorygowaliśmy listy filtrów zarówno w raportach o utrzymaniu uwagi odbiorców kanału, jak i w raportach utrzymania uwagi odbiorców należących do właścicieli treści, aby uwzględnić, że wymagany jest filtr video, a filtr group nie jest obsługiwany.

        Wcześniej w dokumentacji obu raportów była błędna informacja, że można pobrać raport za pomocą jednego z tych filtrów lub przy użyciu żadnego z nich.

    • Interfejs YouTube Reporting API (raporty zbiorcze)

      • W sekcji Omówienie interfejsu API zmieniliśmy sekcję, która wyjaśnia, jak pobrać adres URL pobierania raportu, by informować, że YouTube generuje raporty do pobrania za dni, w których nie były dostępne żadne dane. Raporty te zawierają wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji charakter raportu tego samego dokumentu 12 kwietnia 2016 roku.
      • Lista wymiarów w raporcie content_owner_asset_cards_a1 została poprawiona, aby odzwierciedlała fakt, że raport korzysta z wymiaru card_id. Wcześniej w dokumentacji błędnie podana była nazwa wymiaru card_title.

    28 czerwca 2016 r.

    Zaktualizowaliśmy dokumentację interfejsu YouTube Analytics API, aby odzwierciedlić obsługę danych kart w wielu raportach dotyczących kanałów i właścicieli treści. Nowe obsługiwane dane to:

    Dane są obsługiwane w tych typach raportów:

    22 czerwca 2016 r.

    Ta aktualizacja zawiera poniższe zmiany w interfejsie YouTube Reporting API. Pierwsza zmiana dotyczy ogólnie interfejsu API, a pozostałe dotyczą tylko raportów właścicieli treści:

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

      Wcześniej w dokumentacji stwierdzono, że raporty są dostępne dla okresu do 180 dni przed datą wysłania żądania do interfejsu API. Choć technicznie rzecz biorąc, oryginalny tekst był co najwyżej skomplikowany.

    • Interfejs API obsługuje nowe wersje trzech raportów. Dwa z nich zawierają też nowe dane i ich nazwy:

      • Raport content_owner_ad_rates_a1 to nowa wersja raportu content_owner_ad_performance_a1. Raport o nowej nazwie jest identyczny z poprzednią wersją.

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

        • Nowa wersja raportu content_owner_estimated_earnings_a1 nazywa się content_owner_estimated_revenue_a1.
        • Nowa wersja raportu content_owner_asset_estimated_earnings_a1 nazywa się content_owner_asset_estimated_revenue_a1.

        Oba raporty o zmienionych nazwach różnią się od swoich poprzedników pod kilkoma względami:

      Pamiętaj, że jeśli masz już zadania tworzenia starszych wersji tych raportów, musisz utworzyć nowe zadania dla raportów ze zmienioną nazwą. W związku z udostępnieniem nowych wersji raportów raporty content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 i content_owner_asset_estimated_earnings_a1 zostały wycofane.

      Jeśli masz zadania związane z którymś z tych raportów, po 22 września 2016 roku YouTube nie będzie generować dla nich nowych raportów. Wygenerowane raporty będą nadal dostępne przez 180 dni od momentu ich wygenerowania.

    • Zaktualizowaliśmy definicję właściwości id zasobu reportType, aby odzwierciedlić obecny zestaw dostępnych raportów.

    • W dokumentacji poprawiliśmy nazwy 2 rodzajów danych, aby odpowiadały nazwom pojawiającym się w raportach. Jest to jedynie poprawka w dokumentacji i nie odzwierciedla zmian w rzeczywistej treści raportu:

      • Nazwa danych estimated_partner_adsense_revenue została zmieniona na estimated_partner_ad_sense_revenue. Te dane pojawiają się tylko w 2 raportach, które wycofujemy po tej aktualizacji. Zgodnie z opisem powyżej nazwa tych danych została zmieniona na estimated_partner_ad_auction_revenue w nowszych wersjach tych raportów.
      • Nazwa danych estimated_partner_doubleclick_revenue została zmieniona na estimated_partner_double_click_revenue. Te dane pojawiają się tylko w 2 raportach, które zostaną wycofane po tej aktualizacji. Zgodnie z opisem powyżej nazwa tych danych została zmieniona na estimated_partner_ad_reserved_revenue w nowszych wersjach tych raportów.

    • Zaktualizowaliśmy dokumentację wymiarów interfejsu API do raportowania, by nie wyświetlać już właściwości elapsed_video_time_percentage ani audience_retention_type. Te wymiary nie są obecnie obsługiwane w żadnym raporcie dostępnym poprzez interfejs API.

    19 maja 2016 r.

    Ta aktualizacja wprowadza 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 kategorie danych likes i dislikes.

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

      Wraz z udostępnieniem nowego raportu raport content_owner_basic_a1 został wycofany. Jeśli masz już zadanie związane z tym raportem, po 19 sierpnia 2016 r. YouTube wygeneruje dla niego nowe raporty. 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 wskazuje, czy powiązany zasób reprezentuje wycofany typ raportu:

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

        Po ogłoszeniu danego typu raportu jako wycofanego 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. Z tego względu wartość deprecateTime w przypadku tego typu raportu określa datę 19 sierpnia 2016 roku, po której YouTube przestanie generować raporty tego typu.

      • Właściwość expireTime zasobu job określa datę i godzinę wygaśnięcia lub wygaśnięcia zadania. Ta właściwość zawiera wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub jeśli raporty wygenerowane dla tego zadania nie były pobierane od dłuższego czasu. Data oznacza godzinę, po której YouTube nie będzie już generować nowych raportów na temat tego zadania.

      • Właściwość jobExpireTime zasobu report określa datę i godzinę, kiedy zadanie powiązane z raportem wygasło. Ta właściwość zawiera tę samą wartość co właściwość expireTime w zasobie job, zgodnie z opisem w poprzedniej pozycji na tej liście.

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

    12 kwietnia 2016 r.

    Ta aktualizacja wprowadza następujące zmiany, z których wszystkie będą miały wpływ tylko na interfejs YouTube Reporting API:

    • YouTube generuje teraz dane obejmujące 180 dni poprzedzających zaplanowanie pierwszego zadania raportowania. Wcześniej interfejs API do raportowania nie dostarczał żadnych danych historycznych. Ta zmiana ma wpływ na wszystkie zadania, w tym te utworzone przed tym ogłoszeniem.

      Raporty historyczne są publikowane od razu po ich udostępnieniu, ale opublikowanie wszystkich danych historycznych na temat oferty pracy zajmuje około miesiąca. Po upływie miesiąca od zaplanowania zadania raportowania będziesz mieć dostęp do danych z około siedmiu miesięcy. (Wszystkie dane historyczne dotyczące ofert pracy utworzonych przed tym ogłoszeniem powinny zostać opublikowane w ciągu miesiąca od jego ogłoszenia).

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

      Wszystkie te zmiany zostały opisane w nowej sekcji poświęconej danym historycznym w omówieniu interfejsu API do raportowania.

    • Zaktualizowaliśmy sekcję dotyczącą cechy raportów w podsumowaniu interfejsu YouTube Reporting API. Wprowadziliśmy te zmiany:

      • Według dokumentacji raporty są dostępne przez 180 dni od momentu wygenerowania, więc klienty interfejsu API mogą je pobrać. Wcześniej w dokumentacji stwierdzono, że raporty były dostępne przez okres do 6 miesięcy przed datą wysłania żądania do interfejsu API.

      • Zaktualizowaliśmy dokumentację, by uwzględnić fakt, że interfejs API generuje teraz raporty do pobrania dla 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 wkrótce będzie obsługiwać zestaw automatycznie generowanych raportów zarządzanych przez system. Będą one zawierać dane o przychodach z reklam lub subskrypcji YouTube Premium. Raporty będą dostępne dla właścicieli treści, którzy mają już dostęp do ręcznie możliwych do pobrania raportów o przychodach w Studiu twórców w YouTube. Dzięki temu nowa funkcja interfejsu API zapewni dostęp do tych danych w sposób automatyczny.

      W ramach przygotowań do udostępnienia raportów zarządzanych przez system ogłaszamy teraz wprowadzenie tych zmian w interfejsie API:

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

      • Nowy parametr includeSystemManaged metody jobs.list wskazuje, czy odpowiedź interfejsu API powinna zawierać zadania na potrzeby raportów zarządzanych przez system. Domyślną wartością parametru jest false.

      • Nowy parametr startTimeAtOrAfter metody jobs.reports.list wskazuje, że odpowiedź interfejsu API powinna zawierać raporty tylko wtedy, gdy najstarsze dane w raporcie przypadają w podanym dniu lub później. Podobnie parametr startTimeBefore wskazuje, że odpowiedź interfejsu API powinna zawierać raporty tylko wtedy, gdy najstarsze dane w raporcie przypadają przed określoną datą.

        W odróżnieniu od parametru createdAfter metody, który odnosi się do czasu utworzenia raportu, nowe parametry odnoszą się do 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. Domyślną wartością parametru jest false.

    28 marca 2016 r.

    Interfejs YouTube Reporting API oraz YouTube Analytics API zwracają teraz statystyki wyświetleń w kilku dodatkowych usługach udostępniania.

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

    16 marca 2016 r.

    Ta aktualizacja wprowadza poniższe zmiany, które mają wpływ zarówno na interfejs YouTube Reporting API, jak i na YouTube Analytics API:

    Interfejs API YouTube do raportowania

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

    Interfejs YouTube Analytics API

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

    8 lutego 2016 r.

    Zaktualizowaliśmy listę danych obsługiwanych przez YouTube Analytics API, dlatego dane karty 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 dane karty).

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

    6 stycznia 2016 r.

    Zarówno YouTube Reporting API, jak i YouTube Analytics API identyfikują wyświetlenia za pomocą Chromecasta.

    • W interfejsie YouTube Reporting API wymiar operating_system używa wartości 21 do identyfikowania wyświetleń realizowanych za pomocą Chromecasta.
    • W YouTube Analytics API wymiar operatingSystem wykorzystuje wartość CHROMECAST do identyfikowania wyświetleń realizowanych za pomocą Chromecasta.

    21 grudnia 2015 r.

    W dokumentacji zmieniliśmy nazwy danych annotation_clickable_impressions i annotation_closable_impressions, tak aby odpowiadały nazwom zwracanym w raportach. Wcześniej te nazwy były dokumentowane jako clickable_annotation_impressions i closable_annotation_impressions.

    18 grudnia 2015 r.

    Przepisy Unii Europejskiej (UE) wymagają udostępnienia określonych informacji użytkownikom z Unii Europejskiej i uzyskania ich 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 YouTube API.

    15 grudnia 2015 r.

    Ta aktualizacja wprowadza następujące zmiany, z których wszystkie mają wpływ na interfejs YouTube Analytics API:

    • Interfejs YouTube Analytics API obsługuje teraz trzy nowe wymiary szczegółów odtwarzania, których można używać w różnych raportach dotyczących kanałów i treści:

      • liveOrOnDemand: ten wymiar wskazuje, czy dane w raporcie opisują aktywność użytkowników, która miała miejsce podczas transmisji na żywo.
      • subscribedStatus: ten wymiar wskazuje, czy zawarte w danych dane o aktywności użytkowników są powiązane z widzami, którzy zasubskrybowali kanał z filmem lub playlistą.
      • youtubeProduct: ten wymiar określa usługę w YouTube, w której miała miejsce aktywność użytkownika. Możliwe wartości to podstawowa strona YouTube (lub aplikacja YouTube), YouTube Gaming i YouTube Kids.

      Zaktualizowaliśmy dokumentację, by dodać nowe raporty o szczegółach odtwarzania, które są dostępne dla kanałów i właścicieli treści. Oprócz tego w wielu innych raportach dodaliśmy informację, że co najmniej jeden z tych wymiarów może być opcjonalnie używany jako wymiar lub filtr w tych raportach.

    • Zmieniliśmy format tabel z objaśnieniami raportów, aby ułatwić Ci odnajdywanie prawidłowych kombinacji wymiarów, danych i filtrów, z których można korzystać do pobierania poszczególnych raportów. Tabela poniżej, która objaśnia „Typ urządzenia” w raporcie kanałów, pokazuje nowy format:

      Spis treści
      Wymiary:
      Wymagane deviceType
      Wpisz 0 lub więcej day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Dane:
      Użyj co najmniej 1 wyświetlenia, estimatedMinutesWatched
      Filtry:
      Wpisz 0 lub 1 kraj, prowincja, kontynent, subContinent
      Wpisz 0 lub 1 film, grupa
      Wpisz 0 lub więcej operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Terminologia opisująca pola wymagane i opcjonalne została omówiona w dokumentacji raportów dotyczących kanału i właściciela treści.

    • YouTube Analytics API automatycznie usuwa teraz elementy, w przypadku których użytkownik interfejsu API nie może pobierać danych, za pomocą filtrów obsługujących wiele wartości (video, playlist i channel). Wcześniej serwer interfejsu API zwracał po prostu błąd, jeśli użytkownik interfejsu API nie mógł uzyskać dostępu do danych dotyczących co najmniej jednego ze wskazanych 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. Jeden identyfikator filmu wskazuje jednak film należący do innego kanału, a inny – film, który został usunięty, więc już nie istnieje. W takim przypadku zamiast zwracać błąd, serwer interfejsu API pomija teraz 2 filmy, do których użytkownik nie ma dostępu, a odpowiedź interfejsu API zawiera dane o 18 filmach należących do tego użytkownika.

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

    • Metoda groupItems.insert interfejsu YouTube Analytics API zwraca teraz błąd nieautoryzowanego (kodu odpowiedzi HTTP 403), jeśli próbujesz dodać element do grupy, ale nie masz do niego dostępu. Wcześniej interfejs API pozwalał na dodanie elementu do grupy, ale później przy próbie pobrania danych raportu z tej grupy wystąpił nieautoryzowany błąd.

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

    10 listopada 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    29 października 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokumentacja wymiaru date w interfejsie YouTube Reporting API została poprawiona, aby uwzględniała tę datę, która odnosi się do 24-godzinnego okresu rozpoczynającego się o 00:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji podana była data rozpoczęcia tej daty o północy (GMT).

      Oprócz tego w dokumentacji interfejsu YouTube Analytics API została zaktualizowana informacja, że wszystkie wymiary związane z datą (day, 7DayTotals, 30DayTotals i month) odnoszą się do dat rozpoczynających się o północy czasu pacyficznego (UTC-8).

    • Metoda jobs.reports.list() w interfejsie YouTube Reporting API obsługuje teraz parametr zapytania createdAfter. Jeśli zostanie określony, ten parametr będzie wskazywać, że odpowiedź interfejsu API powinna uwzględniać 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 od dat powiązanych z zwróconymi danymi.

      Wartość parametru jest sygnaturą czasową w dokumencie RFC3339 (czas UTC „Zulu”) z dokładnością do mikrosekund. Przykład: "2015-10-02T15:01:23.045678Z".

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

    • Definicje właściwości createTime zasobu job oraz właściwości startTime, endTime i createTime zasobu report zostały poprawione, by zauważyć, że wartości właściwości są podawane w mikrosekundach, a nie w nanosekundach. Dodatkowo wszystkie definicje wskazują 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 w interfejsie YouTube Analytics API zawiera listę możliwych wartości wymiarów. Lista zawiera wiele nowych obsługiwanych usług.

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

    24 września 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowy YouTube Reporting API pobiera zbiorcze raporty zawierające dane ze Statystyk YouTube dotyczące kanału lub właściciela treści. Opracowano go z myślą o aplikacjach, które mogą importować duże zbiory danych i zapewniają narzędzia do filtrowania, sortowania i wydobywania tych danych.

      Każdy raport YouTube Reporting API 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 w wierszach na podstawie wartości wymiarów, aby obliczyć dane dotyczące poszczególnych filmów, krajów, transmisji na żywo, subskrybentów itd.

      Możesz używać interfejsu API do planowania zadań raportowania, z których każdy zawiera raport do wygenerowania przez YouTube. Po skonfigurowaniu zadania YouTube generuje raport dzienny, który można asynchronicznie pobrać. Każdy raport zawiera dane z unikalnego, 24-godzinnego okresu.

    • Chociaż są to różne interfejsy API, YouTube Analytics API i YouTube Reporting API umożliwiają programistom pobieranie danych Statystyk YouTube. Oba interfejsy API zapewniają dostęp do podobnych zbiorów danych, dlatego ich dokumentacja jest publikowana w formie pojedynczego zestawu.

      • Karta Przewodniki w zestawie dokumentacji zawiera informacje wspólne dla obu interfejsów API, w tym instrukcje autoryzacji żądań do interfejsu API.
      • Karta Raporty zbiorcze zawiera dokumentację referencyjną i inne materiały związane konkretnie z interfejsem YouTube Reporting API.
      • Karta Docelowe zapytania zawiera dokumentację referencyjną i inne materiały dotyczące YouTube Analytics API.
      • Karta Samples zawiera listę przykładowych kodów dostępnych w przypadku obu interfejsów API.
      • Na karcie Narzędzia znajdziesz dodatkowe materiały, które pomogą deweloperom wdrożyć dowolny z tych interfejsów API.

    20 sierpnia 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokumentacja interfejsu API została zmieniona w celu zwiększenia czytelności. Te zmiany nie dotyczą nowych funkcji:

      • Dokumentacja zawiera teraz jedną stronę z listą wszystkich dostępnych raportów dotyczących kanału oraz drugą stronę ze wszystkimi dostępnymi raportami dla właścicieli treści. Wcześniej w dokumentacji były osobne strony z raportami dotyczącymi filmów i playlist kanału itp.

      • Nowy omówienie modelu danych ma na celu dokładniejsze omówienie działania interfejsu API. Celem tego dokumentu jest wyjaśnienie, w jaki sposób YouTube wykorzystuje dane, wymiary i filtry do obliczania wartości w raportach.

      • Metoda reports.query interfejsu API, której używasz do pobierania raportów, jest teraz opisana oddzielnie. Informacje na tej stronie były wcześniej dostępne na innych stronach. Nowa strona ma na celu łatwiejsze wyszukiwanie informacji, które są niezbędne do uzyskania raportu.

    22 lipca 2015 r.

    Ta aktualizacja wprowadza kilka zmian, z których wszystkie 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ą one podstawowymi danymi. Interfejs API obsługuje dane adEarnings we wszystkich raportach, które obsługują już dane earnings.

      Dodatkowo poprawiliśmy definicję danych earnings, aby uwzględniała ona całkowite szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google, a także ze źródeł niezwiązanych z reklamami. Wcześniej definicja błędnie wskazywała, że dane obejmują tylko zarobki ze źródeł reklamowych.

    • Dane primaryAdGrossRevenue zostały wycofane. Zamiast tego do pobrania danych o przychodach użyj kategorii grossRevenue.

    • Oprócz wycofanych danych primaryAdGrossRevenue raporty skuteczności reklam nie obsługują już danych monetizedPlaybacks i playbackBasedCpm. Niektóre raporty o filmach nadal jednak obsługują te dane.

    1 czerwca 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API obsługuje teraz 2 nowe rodzaje danych w raportach dotyczących reklam wideo: videosAddedToPlaylists i videosRemovedFromPlaylists. Zaktualizowaliśmy listy raportów na temat filmów dla kanałów i właścicieli treści, aby identyfikować raporty, które obsługują nowe dane.

      • videosAddedToPlaylists – liczba przypadków, w których filmy objęte zapytaniem zostały dodane do dowolnej playlisty w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do innych kanałów. playlistach.
      • videosRemovedFromPlaylists – liczba przypadków usunięcia ze wszystkich playlist w YouTube filmów objętych zapytaniem. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z innych kanałów. playlistach.

      Oba wskaźniki obejmują domyślne playlisty, takie jak „Do obejrzenia”. na playliście. Nie są one jednak wliczane do playlist, do których film został automatycznie dodany (np. playlist przesłanych na kanał lub historii oglądania użytkownika). Pamiętaj też, że wskaźniki te odzwierciedlają bezwzględną liczbę dodanych i usunięć. Jeśli więc użytkownik doda film do playlisty, a potem usunie go i ponownie doda, dane wskazują, że film został dodany do 2 playlist, a następnie usunięty z jednej.

      Dane dla tych kategorii 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ż dolar amerykański (USD). Jeśli ten parametr jest skonfigurowany, interfejs API przelicza wartości danych earnings, grossRevenue, playbackBasedCpm i impressionBasedCpm na określoną walutę. Zwracane wartości to wartości szacunkowe obliczane na podstawie kursów wymiany walut, które zmieniają się codziennie.

      Wartością parametru jest trzyliterowy kod waluty zgodny z normą 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 umożliwia teraz tworzenie grup w Statystykach YouTube i zarządzanie nimi, a także pobieranie danych z raportów dotyczących tych grup.

      • Tworzenie grup i zarządzanie nimi

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

        • Zasób group reprezentuje grupę w Analytics, czyli niestandardową kolekcję 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 w przypadku tego zasobu.

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

      • Pobieranie danych raportu dla grupy

        Zaktualizowaliśmy dokumentację wymiarów, by uwzględnić wymiar group, którego można używać jako filtra w wielu raportach dotyczących kanałów i raportach właścicieli treści. Jeśli używasz filtra group, interfejs API zwraca dane dla wszystkich elementów w danej 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 umożliwia teraz określenie wielu wartości wymiarów video, playlist, channel i show, gdy te wymiary są używane jako filtry. Aby określić kilka wartości, jako wartość parametru filters ustaw rozdzieloną przecinkami listę identyfikatorów filmów, playlist, kanałów lub programów, w których przypadku odpowiedź interfejsu API ma być filtrowana. Wartość parametru może zawierać maksymalnie 200 identyfikatorów.

      Jeśli podasz wiele wartości dla tego samego filtra, możesz też dodać ten filtr do listy wymiarów wskazanej w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony jako obsługiwany wymiar w konkretnym raporcie. Jeśli dodasz filtr do listy wymiarów, interfejs API będzie używać wartości filtra do grupowania wyników.

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

    16 lipca 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

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

    • Interfejs API obsługuje teraz raporty o playlistach, które zawierają statystyki wyświetleń filmów w kontekście playlisty. Raporty o playlistach 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 również – averageViewDuration.

      Dodatkowo wszystkie raporty o playlistach obsługują nowe dane. Pamiętaj, że każdy z tych wskaźników dotyczy tylko wyświetleń playlist, które miały miejsce w internecie.

      • playlistStarts: liczba rozpoczętych przez widzów odtworzeń playlisty.
      • viewsPerPlaylistStart: średnia liczba wyświetleń filmu przy każdym zainicjowaniu playlisty.
      • averageTimeInPlaylist: szacowany średni czas (w minutach), przez jaki użytkownik oglądał filmy z playlisty po zainicjowaniu playlisty.

      Każde żądanie pobrania raportu o playlistach musi korzystać z filtra isCurated, który musi być ustawiony na 1 (isCurated==1).

    • Interfejs API obsługuje teraz raport Utrzymanie uwagi odbiorców. Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Nowy wymiar elapsedVideoTimeRatio w raporcie pozwala mierzyć czas, jaki upłynął od filmu, z uwzględnieniem odpowiednich wartości danych:

      • Dane audienceWatchRatio określają bezwzględny stosunek liczby widzów, którzy obejrzeli film w danym momencie. Współczynnik ten oblicza się, porównując liczbę obejrzeń danego filmu wideo z łączną liczbą wyświetleń tego filmu.

        Pamiętaj, że część filmu może być obejrzana więcej niż raz (lub wcale) w trakcie danego wyświetlenia filmu. Jeśli na przykład użytkownicy wielokrotnie przewijali film do tyłu i oglądali ten sam fragment filmu, 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 do wszystkich filmów w YouTube o podobnej długości. Wartość 0 oznacza, że film utrzymuje uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości. Wartość 1 oznacza, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Wartość mediany 0,5 oznacza, że połowa filmów o podobnej długości utrzymuje widzów lepiej, a połowa gorzej utrzymuje.

      Możesz też użyć filtra audienceType, by raport zawierał tylko dane związane z bezpłatnymi wyświetleniami, wyświetleniami reklam TrueView In-Stream lub reklamami TrueView In-Display. (bezpłatne wyświetlenia to bezpośredni efekt działań użytkownika, takich jak wyszukanie filmu lub kliknięcie sugerowanego filmu).

    • Interfejs API obsługuje kilka nowych wskaźników związanych z adnotacjami. Wymienione poniżej wskaźniki możesz pobrać za pomocą dowolnych raportów, które wcześniej obsługiwały dane annotationClickThroughRate i annotationCloseRate.

      Wszystkie nowe dane są podstawowymi danymi i podlegają zasadom wycofywania. Przypominamy, że nowe rodzaje danych są dostępne od 16 lipca 2013 r. (dane z annotationClickThroughRate i annotationCloseRate są dostępne od 10 czerwca 2012 r.).

    • Parametr GOOGLE_SEARCH nie jest już raportowany 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 z ustawieniem filtra insightTrafficSourceType 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ł zmieniony tak, aby grupował przykłady według kategorii. Zastosowano w nim format kart podobny do ostatnio wprowadzonego w raportach dla kanałów i właścicieli treści. W nowym interfejsie przykłady są podzielone na te kategorie:

      • Podstawowe statystyki
      • Według kryterium czasu
      • Geografia
      • Miejsce odtwarzania
      • Źródło wizyt
      • Urządzenie/system operacyjny
      • Grupa demograficzna
      • Sieci społecznościowe
      • Zarobki/reklamy (tylko raporty właściciela treści)

    • Dokument z przykładowymi żądaniami zawiera teraz nowe przykłady pobierania danych dotyczących poszczególnych prowincji w raportach dotyczących kanału lub właściciela treści.

      • Dane zależne od prowincji dla stanów w USA i Waszyngtonu: Ten raport umożliwia pobranie liczby wyświetleń z podziałem na prowincje oraz inne statystyki dotyczące filmów z kanału. Dane dotyczą stanów USA i Waszyngtonu. W przykładzie użyto wymiaru province oraz parametru filters, aby w odpowiedzi uwzględnić tylko wyniki dotyczące 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 z Kalifornii, którzy obejrzeli filmy z kanału lub – w przypadku raportów właściciela treści – treści objęte roszczeniem przez właściciela treści. W tym przykładzie użyto parametru filters, aby odpowiedź zawierała tylko dane dotyczące konkretnej prowincji.

    • Zaktualizowaliśmy definicję wymiaru province, aby zaznaczyć, że gdy w wartości parametru dimensions występuje wartość province, żą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:

    • Zmieniliśmy wygląd dokumentów zawierających informacje o obsługiwanych raportach kanału i właściciela treści. Zamiast tabeli z listą wszystkich możliwych raportów, każdy dokument grupuje raporty w kategorie:

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

      Każdy dokument zawiera te kategorie w formie listy kart. Klikając dowolną kartę, możesz wyświetlić listę obsługiwanych raportów z danej kategorii.

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

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

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

          • Główny raport ze statystykami zawiera kilka statystyk, w tym liczbę wyświetleń i szacowany czas oglądania.
          • Raport oparty na czasie zawiera te same statystyki, ale przedstawia dane zbiorcze z okresu 7 dni, 30 dni lub miesiąca.

        • Parametru zapytania filters możesz używać, aby w raporcie znalazły się tylko statystyki dotyczące określonego stanu. Niektóre raporty obsługują ten typ filtrowania, m.in. raporty geograficzne, na temat miejsc odtwarzania, źródeł wizyt, urządzeń, systemu operacyjnego, danych demograficznych i najpopularniejszych filmów.

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

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

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

    • Dokumentacja została poprawiona, dzięki czemu 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. Wymiary i dane spoza podstawowego zestawu danych interfejsu API nie podlegają jednak zasadom wycofywania. Zaktualizowaliśmy strony Wymiary i Dane, aby zawierały listę podstawowych wymiarów i podstawowych danych. Zaktualizowaliśmy też definicje tych stron, aby wyraźnie określać podstawowe wymiary i dane.

    • Interfejs API obsługuje teraz wartość EXTERNAL_APP dla wymiaru insightPlaybackLocationType. Po tej zmianie od 10 września 2013 roku odtworzenia nie są już zaliczane do MOBILE odtworzeń. Jednak odtworzenia na urządzeniach mobilnych sprzed tej daty będą nadal klasyfikowane z tą wartością.

      W ramach tej aktualizacji odtworzenia na urządzeniach mobilnych są teraz klasyfikowane jako WATCH, EMBEDDED lub EXTERNAL_APP w zależności od typu aplikacji, w której te odtworzenia mają miejsce.

    • Interfejs API obsługuje teraz wartość PLAYLIST dla wymiaru insightTrafficSourceType. Wartość wskazuje, że wyświetlenia filmów pochodzą z playlisty. Wcześniej te widoki były klasyfikowane według kategorii YT_OTHER_PAGE wymiaru.

    16 lipca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API umożliwia teraz sortowanie raportów według wielu wymiarów i danych. Dokument z przykładowymi żądaniami zawiera nowy przykład – Sortowanie żądań według wielu wymiarów/danych, który ilustruje tę funkcję. Żądanie pobiera dane o źródle wizyt i ma parametr sort o wartości day,-views. Wyniki są sortowane chronologicznie, ale w obrębie zestawu wyników dla każdego dnia pierwszy wiersz zawiera dane o źródle wizyt, które wygenerowało najwięcej wyświetleń, drugi wiersz zawiera dane dotyczące źródła, które wygenerowało największą liczbę wyświetleń itd.

    • Interfejs API obsługuje teraz 2 nowe wymiary: deviceType i operatingSystem, dzięki którym można uzyskiwać dane o urządzeniach, na których widzowie oglądają Twoje filmy. Interfejs API obsługuje raporty, które korzystają z jednego z tych wymiarów lub obu z nich.

      • Raport deviceType pozwala sprawdzić liczbę wyświetleń i szacowany czas oglądania na różnych typach urządzeń, w tym na komputerach, komórkach i tabletach. Możesz też użyć filtra operatingSystem, aby raport dotyczący typu urządzenia zawierał tylko statystyki dotyczące urządzeń z określonym systemem operacyjnym, np. Android lub iOS.

      • Raport operatingSystem pozwala sprawdzić liczbę wyświetleń i szacowany czas oglądania dla różnych systemów operacyjnych, takich jak Android, iOS czy Linux. Możesz też użyć filtra deviceType, aby w raporcie o systemie operacyjnym znalazły się tylko statystyki na temat urządzeń określonego typu, np. komórek lub tabletów.

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

    • Dokument z przykładowymi żądaniami został zmodyfikowany tak, by zawierał trzy raporty o urządzeniach dla kanałów i trzy raporty o urządzeniach dla właścicieli treści.

    • Wymiar insightPlaybackLocationType może zwrócić wartość YT_OTHER, która identyfikuje widoki, które nie zostały sklasyfikowane na podstawie jednej z pozostałych 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 umożliwia teraz pobieranie danych o czasie oglądania – estimatedMinutesWatched, averageViewDuration i averageViewPercentage – w połączeniu z innymi danymi, w tym danymi o wyświetlaniu, zaangażowaniu, zarobkach i skuteczności reklam.

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

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

    • Raporty korzystające z wymiarów insightPlaybackLocationDetail i insightTrafficSourceDetail zostały ulepszone:

      • Obsługuje teraz opcjonalny filtr country.

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

        • Szczegóły miejsca odtwarzania

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

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

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

    3 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • W nowym dokumencie Przykładowe żądania do interfejsu API znajdziesz przykłady pobierania różnych typów raportów za pomocą interfejsu YouTube Analytics API. Każdy przykład zawiera krótki opis raportu pobieranego przez żądanie oraz wymiary, dane, filtry i parametry sortowania związane z żądaniem.

    • Wymiar insightTrafficSourceType obsługuje teraz wartość SUBSCRIBER jako prawidłową wartość. Ta wartość określa wyświetlenia filmów, które pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji. Jeśli filtrujesz na podstawie tego źródła wizyt, pole insightTrafficSourceDetail będzie wskazywać kanał strony głównej lub inną stronę, z której pochodziły odesłania.

    28 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    21 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

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

      • Nowo obsługiwane raporty zawierają dane o skuteczności reklam według odtworzeń i liczby wyświetleń. Więcej informacji o raportach skuteczności reklam znajdziesz w dokumentacji raportów dla właścicieli treści.

      • Poniżej znajdziesz listę nowych obsługiwanych danych. Zaktualizowaliśmy listę raportów właścicieli treści, aby zidentyfikować raporty, w tym 2 nowe raporty, 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 zaklasyfikowane jako główny typ reklamy w odtworzeniach filmów, których dotyczy raport, od Google lub partnerów DoubleClick.
        • monetizedPlaybacks – liczba odtworzeń, w których wystąpiło co najmniej 1 wyświetlenie reklamy.
        • playbackBasedCpm – szacowany przychód brutto na tysiąc odtworzeń.
        • impressions – liczba zweryfikowanych wyświetleń reklamy.
        • impressionBasedCpm – szacowany przychód brutto na tysiąc wyświetleń reklamy.

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

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

    • Zmieniliśmy strukturę dokumentacji interfejsu API, tak aby różne typy raportów zostały objaśnione na osobnych stronach. Z tego powodu udostępniliśmy oddzielne strony wyjaśniające różne typy raportów dotyczących kanału i raportów 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, która zawiera przykładowy kod pokazujący, jak wywoływać interfejs API przy użyciu bibliotek klienta Java, JavaScript, Python i Ruby. Przykładowy kod JavaScript jest taki sam jak ten omówiony szczegółowo w dokumentacji przykładowej aplikacji.

    14 listopada 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Przewodnik po interfejsie API zawiera teraz sekcję APIs Explorer, która umożliwia wywoływanie interfejsu API, wyświetlanie żądania API i pobieranie w odpowiedzi rzeczywistych danych.

    • Interfejs API obsługuje szereg nowych raportów, które opisujemy poniżej. Dotyczy to zarówno kanałów, jak i właścicieli treści. Każdy raport jest dostępny jako raport kanału lub raport właściciela treści. Zaktualizowaliśmy też strony Wymiary i dane.

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

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

      • Raport o źródłach wizyt podaje liczbę wyświetleń filmów, które pochodzą z różnych typów stron odsyłających.

      • Raport ze szczegółami źródła wizyt wskazuje strony odsyłające, które wygenerowały najwięcej wyświetleń dla określonego filmu i określonego typu źródła wizyt. W tym raporcie możesz na przykład znaleźć podobne filmy, które przyciągnęły największy ruch do danego filmu. Ten raport jest obsługiwany w przypadku kilku źródeł wizyt.

      • Raporty o czasie oglądania pokazują, ile czasu widzowie spędzili na oglądaniu Twoich treści. Raporty mogą obejmować zbiorcze dane z określonego przedziału czasu – dnia, ostatnich siedmiu dni, poprzednich 30 dni itd. – lub kraju. Jeśli raport zawiera dane zbiorcze według dnia lub kraju, może też podawać średnią długość każdego wyświetlenia filmu, a także średni procent obejrzenia poszczególnych filmów.

    2 października 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Aplikacja YouTube Analytics API jest teraz dostępna dla wszystkich deweloperów. W panelu Usługi w narzędziu APIs console możesz aktywować interfejs API w projekcie bez konieczności uprzedniego proszenia o dostęp.

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

    12 września 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowa sekcja dotycząca wykorzystywania limitów zawiera wskazówki dotyczące optymalizacji wykorzystania limitów interfejsu API. Serwer interfejsu API oblicza koszt zapytań dla każdego żądania, który jest odejmowany od Twojego limitu wykorzystania interfejsu API. Różne typy raportów mogą mieć znacznie różne koszty zapytań, dlatego należy zaplanować efektywne wykorzystanie limitu oraz że aplikacja powinna żądać tylko danych i danych, których rzeczywiście potrzebuje.

    • Zaktualizowaliśmy sekcję dotyczącą wymiarów tymczasowych, aby wyjaśnić, że wskazują one, że raport Analytics powinien gromadzić dane z określonego przedziału czasu. Interfejs API obsługuje teraz te dodatkowe wymiary czasowe:

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

      Zaktualizowaliśmy też sekcję Dostępne raporty, aby odzwierciedlała obsługę raportów korzystających z tych wymiarów przez interfejs API.

    • Zaktualizowaliśmy sekcję dotyczącą wymiarów raportowanych, aby zwrócić uwagę na to, że żądania do interfejsu API umożliwiające pobieranie raportów właściciela treści muszą filtrować dane przy użyciu jednego z tych wymiarów (video, channel lub show) albo obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

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

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