Historia zmian

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

6 maja 2024 r.

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

Oprócz tego raport Utrzymanie uwagi odbiorców został rozszerzony o 3 nowe rodzaje danych:

7 kwietnia 2024 r.

W interfejsie YouTube Analytics (Targeted Queries) API wprowadziliśmy kilka aktualizacji związanych z raportami dotyczącymi playlist przesłanych przez właścicieli treści. Są to te same aktualizacje dotyczące raportów o playlistach kanału, które ogłosiliśmy 19 stycznia 2024 r.

Poniższy wpis historii zmian zawiera prawie te same informacje co wpis z 19 stycznia 2024 r. Pamiętaj jednak, że w raportach dotyczących playlist przesłanych przez właścicieli treści będzie można używać wymiaru isCurated do 31 grudnia 2024 r., a w przypadku raportów o playlistach kanału do 30 czerwca 2024 r.

  • Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

    W raportach o playlistach właścicieli treści wycofaliśmy wymiar isCurated. Przestanie być obsługiwana 31 grudnia 2024 r. lub później. Definicja tego wymiaru została odpowiednio zaktualizowana.

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

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

    • Filtry lokalizacji, takie jak continent i subcontinent, nie są obsługiwane w nowych raportach dotyczących playlist kanału.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist kanału. Te dane nie były dostępne w YouTube Studio, dlatego zmiana pozwala dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach o playlistach kanału. Te filtry nie były dostępne w YouTube Studio, dlatego zmiana pozwala dostosować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Sekcja Raporty o playlistach w dokumentacji raportów właścicieli treści została zaktualizowana, aby dokładniej wyjaśnić, jakie typy danych są obsługiwane w raportach o playlistach:

    • Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach wyświetlane dla wszystkich filmów znajdujących się na playlistach właściciela treści, które również należą do tego właściciela treści. Zbiorcze dane o reklamach wideo są 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. Obejmują one też wyświetlenia filmów z playlisty nienależące do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • Sekcja Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.

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

  • Sposób działania danych views zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport o playlistie, użyło wymiaru isCurated:

    • Jeśli żądanie zawiera wymiar isCurated, dane views to dane na playliście, które wskazują liczbę wyświetleń filmów w kontekście playlist właściciela treści.
    • Jeśli żądanie nie zawiera wymiaru isCurated, dane views to zagregowane dane o filmach, które określają łączną liczbę wyświetleń filmów z playlist właściciela treści, niezależnie od tego, czy miało to miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko wyświetlenia filmów, które należą do właściciela treści powiązanego z kanałem, do którego należy playlista.

      W tych raportach, które nie korzystają z wymiaru isCurated, dane playlistViews wskazują liczbę wyświetleń filmów w kontekście playlisty. Dane te zliczają wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • Dokumentacja raportów właścicieli treści w przypadku każdego raportu playlisty zawiera teraz tabele z danymi obsługiwanymi w przypadku każdego raportu zależnie od tego, czy żądanie do interfejsu API zawiera wymiar isCurated. Przykład znajdziesz w sekcji definiującej raporty o playlistach na osi czasu.

19 stycznia 2024 r.

W interfejsie YouTube Analytics (Targeted Queries) API wprowadziliśmy kilka aktualizacji związanych z raportami o playlistach kanału. Aktualizacje obejmują wycofany wymiar oraz kilka nowych i zaktualizowanych danych:

  • Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

    W raportach dotyczących kanałów wymiar isCurated został wycofany. Przestanie być obsługiwana 30 czerwca 2024 r. lub później. Definicja tego wymiaru została odpowiednio zaktualizowana.

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

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

    • Filtry lokalizacji, takie jak continent i subcontinent, nie są obsługiwane w nowych raportach dotyczących playlist kanału.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist kanału. Te dane nie były dostępne w YouTube Studio, dlatego zmiana pozwala dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach o playlistach kanału. Te filtry nie były dostępne w YouTube Studio, dlatego zmiana pozwala dostosować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.

  • Zaktualizowaliśmy sekcję Raporty dotyczące playlist w dokumentacji raportów kanału, aby dokładniej wyjaśnić, jakie typy danych są obsługiwane w raportach o playlistach:

    • Zbiorcze dane o filmach to dane zbiorcze o aktywności użytkowników i wyświetleniach, które są przedstawiane dla wszystkich filmów na playlistach na kanale, które są również własnością tego kanału. Zbiorcze dane o reklamach wideo są 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. Obejmują one też wyświetlenia filmów z playlisty nienależące do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • Sekcja Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.

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

  • Sposób działania danych views zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport o playlistie, użyło wymiaru isCurated:

    • Jeśli żądanie zawiera wymiar isCurated, dane views to dane na playliście, które wskazują liczbę wyświetleń filmów w kontekście playlist na kanale.
    • Jeśli żądanie nie zawiera wymiaru isCurated, dane views to zagregowane dane o filmach, które określają łączną liczbę wyświetleń danego filmu z playlist na kanale, niezależnie od tego, czy miało to miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko wyświetlenia filmów, które są własnością kanału, który jest właścicielem playlisty.

      W tych raportach, które nie korzystają z wymiaru isCurated, dane playlistViews wskazują liczbę wyświetleń filmów w kontekście playlisty. Dane te zliczają wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • Dokumentacja raportów dotyczących kanałów w przypadku każdego raportu playlisty zawiera teraz tabele z danymi obsługiwanymi w przypadku tego raportu zależnie od tego, czy żądanie do interfejsu API zawiera wymiar isCurated. Przykład znajdziesz w sekcji definiującej raporty o playlistach na osi czasu.

4 grudnia 2023 r.

Zaktualizowaliśmy interfejs YouTube Analytics (Targeted Queries) API, by scalić 2 wartości wymiarów insightTrafficSourceType. Wcześniej ten wymiar odróżniał filmy odtwarzane w ramach playlisty (PLAYLIST) od wyświetleń pochodzących ze strony zawierającej wszystkie filmy z playlisty (YT_PLAYLIST_PAGE). Od tej pory oba rodzaje wyświetleń będą powiązane z wartością wymiaru PLAYLIST.

15 grudnia 2022 r.

Interfejs YouTube Analytics (docelowych zapytań) API 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 kanałów i właścicieli treści. Ten raport zawiera nowy wymiar city, który określa szacunkowe przez YouTube miasto, w którym miała miejsce aktywność użytkownika.

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

    Wymiar creatorContentType jest obsługiwany jako wymiar opcjonalny we wszystkich raportach dotyczących filmów na kanałach i właścicielach treści.

  • Przewodnik po przykładowych żądaniach w interfejsie YouTube Analytics API zawiera teraz przykłady obu nowych wymiarów.

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

26 sierpnia 2022 r.

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

  • Jeśli w interfejsie YouTube Analytics API (Targeted Zapytania) wartość wymiaru insightTrafficSourceType to SUBSCRIBER, wartość insightTrafficSourceDetail może być ustawiona na podcasts, co oznacza, że ruch został przekierowany ze strony docelowej Podcastów.
  • Jeśli w interfejsie API YouTube do raportowania (raporty zbiorcze) wartość wymiaru traffic_source_type to 3, wartość traffic_source_detail może być ustawiona na podcasts, co oznacza, że ruch został przekierowany ze strony docelowej Podcastów.

11 lutego 2022 r.

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

Konkretne wprowadzane zmiany:

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

9 lutego 2022 r.

13 grudnia 2021 r. zaktualizowaliśmy 2 wskaźniki, aby wykluczały ruch generowany przez klipy zapętlone. Ta zmiana dotyczy zarówno YouTube Analytics (Targeted Queries) API, jak i YouTube Reporting (Bulk Reports) API.

2 lutego 2022 r.

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

  • W interfejsie YouTube Reporting (Bulk Reports) API wymiar traffic_source_type obsługuje wartość 28.

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

23 września 2020 r.

Interfejs YouTube Analytics (Targeted Zapytania) i YouTube Reporting (Bulk Reports) API obsługują nową wartość wymiaru źródła wizyt, która wskazuje, że widz został odesłany, przesuwając palcem w pionie podczas oglądania YouTube Shorts:

  • W interfejsie YouTube Analytics API (Targeted Zapytania) wymiar insightTrafficSourceType obsługuje wartość SHORTS.
  • W interfejsie YouTube Reporting (Bulk Reports) API wymiar traffic_source_type obsługuje wartość 24.

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

20 lipca 2020 r.

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

  • Maksymalny rozmiar grupy raportowania w Statystykach YouTube wzrósł z 200 do 500 elementów.
  • Parametr filters metody reports.query określa listę filtrów, które należy zastosować przy pobieraniu danych ze Statystyk YouTube. Parametr umożliwia podanie wielu wartości filtrów video, playlist i channel. Maksymalna liczba identyfikatorów, które można określić dla tych filtrów, wzrosła z 200 do 500.

13 lutego 2020 r.

Ta aktualizacja wprowadza podane niżej zmiany związane z interfejsami YouTube Analytics (Targeted Zapytania) i YouTube Reporting (Bulk Reports) API. Więcej informacji o tych zmianach znajdziesz w Centrum pomocy YouTube.

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

Nowe wartości dzielą powiadomienia dotyczące przesłanych filmów i transmisji na żywo (wcześniej zgłoszonych jako uploaded) 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ą z powiadomień innych niż push, takich jak powiadomienia e-mail lub powiadomienia skrzynki odbiorczej, wysyłane do subskrybentów podczas przesyłania filmu.

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

Przypominamy też, że wartości te nie reprezentują samych powiadomień, a jedynie źródła wizyt, które doprowadziły do określonych wyświetleń w YouTube. Jeśli na przykład wiersz raportu zawiera wartości views=3, traffic_source_type=17 (NOTIFICATION) i traffic_source_detail=uploaded_push, oznacza to, że 3 wyświetlenia zostały wyświetlone przez widzów, którzy kliknęli powiadomienia push wysłane podczas przesyłania filmu.

15 października 2019 r.

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

  • Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

    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 zwróci błąd.

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

    • Liczbę wyświetleń w okresie 7 dni można obliczyć przez zsumowanie liczby wyświetleń z każdego dnia tego okresu.
    • Procent widzów dla okresu 7 dni można obliczyć, mnożąc liczbę wyświetleń każdego dnia pomnożoną przez wartość procentu widzów w danym dniu, aby otrzymać liczbę widzów, którzy byli zalogowani podczas oglądania filmu w danym dniu. Następnie można dodać liczbę zalogowanych widzów dla całego okresu i podzielić ją przez łączną liczbę wyświetleń w tym okresie, aby otrzymać wartość procentową liczby widzów dla całego okresu.
    • Nie można obliczyć liczby unikalnych widzów w okresie 7 dni, ponieważ tego samego widza można by policzyć jako unikalny widz w różnych dniach. Możesz jednak użyć wymiaru month zamiast wymiaru 30DayTotals, aby oszacować dane o liczbie unikalnych widzów w okresie 30 dni. Pamiętaj, że wymiar month odnosi się do miesięcy kalendarzowych, a wymiar 30DayTotals oblicza okresy 30-dniowe na podstawie określonej daty rozpoczęcia i zakończenia.

27 czerwca 2019 r.

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

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

1 listopada 2018 r.

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

  • Wersja 1 interfejsu API została wycofana. Aby uniknąć przerw w działaniu usługi, jak najszybciej zaktualizuj klienty interfejsu API do wersji 2 interfejsu API. Więcej informacji znajdziesz w przewodniku po migracji.

    Harmonogram wycofywania tych funkcji ogłosiliśmy po raz pierwszy 26 kwietnia 2018 roku.

17 września 2018 r.

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

  • Nowa sekcja anonimizacji danych w dokumencie z omówieniem modelu danych wyjaśnia, że niektóre dane w Statystykach YouTube są ograniczone, gdy wartości nie osiągną określonego progu. Może się to zdarzyć w różnych przypadkach. W praktyce oznacza to, że raport może nie zawierać wszystkich (lub żadnych) danych, jeśli:

    1. na film lub na kanale odnotowano ograniczony ruch w określonym przedziale czasu;

      lub

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

    W nowej sekcji omówiono typy danych, które mogą być ograniczone w raportach Statystyk YouTube.

  • Zaktualizowaliśmy raporty dotyczące kanałów i raporty właścicieli treści, aby uwzględniały fakt, że dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w raportach o miejscach odtwarzania, źródłach wizyt, typie urządzenia/systemie operacyjnym.

18 czerwca 2018 r.

Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

  • Zmieniły się wymagania dotyczące zakresu 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 za pomocą metody groupItems.list muszą mieć dostęp do:
      • zakres https://www.googleapis.com/auth/youtube
        lub
      • zakres https://www.googleapis.com/auth/youtube.readonly
        oraz
        zakres https://www.googleapis.com/auth/yt-analytics.readonly

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

23 maja 2018 r.

Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

  • Przegląd interfejsu API zawiera nową sekcję dotyczącą zbiorczych danych i usuniętych elementów, która wyjaśnia, jak odpowiedzi interfejsu API postępują z danymi powiązanymi z usuniętymi zasobami, takimi jak filmy, playlisty czy kanały.
  • Zaktualizowaliśmy sekcję dotyczącą sprawdzonych metod, w której omawiamy interfejs API, aby przypomnieć, że możesz używać interfejsu YouTube Data API do pobierania dodatkowych metadanych dotyczących zasobów zidentyfikowanych w odpowiedziach YouTube Analytics API. Zgodnie z zasadami dla deweloperów usług YouTube API (sekcje od III.E.4.b do III.E.4.d) klienty interfejsu API muszą usunąć lub odświeżyć metadane przechowywanych zasobów z tego interfejsu API po 30 dniach.

22 maja 2018 r.

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

  • Podane niżej zmiany planujemy wprowadzić w lipcu 2018 roku. Nowe zasady będą obowiązywać na całym świecie do wszystkich raportów i zadań związanych z raportowaniem.

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

      Przed ogłoszeniem wszystkie raporty dotyczące interfejsu API były dostępne przez 180 dni od momentu ich wygenerowania. Dla jasności – po wejściu tych zasad w życie raporty z danymi historycznymi sprzed ponad 30 dni również przestaną być dostępne przez interfejs API. Wszystkie inne raporty starsze niż 60 dni również nie będą dostępne. W związku z tym w dokumentacji wynika teraz, że raporty utworzone przed zmianą zasad będą dostępne przez maksymalnie 180 dni.

    • Gdy po tej zmianie zaplanujesz zadanie raportowania, YouTube będzie generować raporty od tego dnia, które obejmują okres 30 dni poprzedzających zaplanowanie zadania. Przed tą zmianą, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty obejmujące okres 180 dni poprzedzających zaplanowanie tego zadania.

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

  • Zaktualizowaliśmy sekcję Cechy raportu, by uwzględnić, że chociaż dane w raporcie nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. lub po tej dacie nie będą zawierać odwołań do zasobów YouTube, które zostały usunięte co najmniej 30 dni przed datą wygenerowania raportu.

  • Zaktualizowaliśmy sekcję Dane historyczne w omówieniu interfejsu API, aby uwzględnić, że gdy zaplanujesz nowe zadanie raportowania, raporty historyczne są zwykle publikowane w ciągu kilku dni. Wcześniej w dokumentacji znajdowały się informacje, ż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 wyraźniej określać dane zapasowe jako zbiór danych, który zastępuje wcześniej przesłany zbiór.

26 kwietnia 2018 r.

Interfejs API YouTube Analytics (Targeted Queries) (v2) w wersji 2 jest już publicznie dostępny. Na poniższej liście znajdziesz informacje o zmianach w usługach i dokumentacji związanych z nową wersją interfejsu API:

  • Interfejs API w wersji 2 jest prawie taki sam jak wersja 1. Prawdopodobnie jednak konieczne będzie zaktualizowanie kodu, tak aby uwzględniał zmiany wymienione poniżej. Wszystkie te zmiany zostały szczegółowo opisane w nowym przewodniku po migracji.

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

    Dodatkowo wersja 2 nie obsługuje kilku funkcji wersji 1:

    • Metoda reports.query nie obsługuje już parametrów żądania alt, quotaUser ani userIp.
    • Interfejs API w wersji 2 nie zapewnia punktu końcowego wsadowego, który obsługuje wsady złożone z żądań kierowanych do różnych interfejsów API. Grupa może jednak składać się z żądań wysyłanych do różnych metod tego samego interfejsu API. Nie dotyczy to interfejsu YouTube Analytics API, ponieważ Google wycofuje globalny punkt końcowy dla wszystkich swoich interfejsów API.
    • Interfejs API w wersji 2 nie obsługuje protokołu JSON-RPC, który był obsługiwany w wersji 1. Przypominamy, że wycofanie tej kolumny nie dotyczy wyłącznie interfejsu YouTube Analytics API.

  • Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

    Interfejs API w wersji 1 (1) został wycofany i będzie obsługiwany 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 API, przejdź na wersję 2 API do 31 października 2018 r.

21 lutego 2018 r.

Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:

  • Raporty demograficzne widzów, które zawierają zbiorcze statystyki wyświetleń na podstawie ich grupy wiekowej i płci, nie obsługują już wymiaru youtubeProduct, który pozwala zidentyfikować usługę YouTube, w której wystąpiła aktywność użytkownika.

18 stycznia 2018 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Reporting API (raporty zbiorcze)

    • Wymiar operating_system, który identyfikuje system oprogramowania urządzenia, na którym doszło do wyświetleń, obsługuje teraz tę wartość:
      • 25: KaiOS

  • YouTube Analytics API (kierowanie na zapytania)

20 grudnia 2017 r.

Ta aktualizacja wprowadza 2 zmiany związane z interfejsem YouTube Reporting API:

  • Serwer API obsługuje teraz kompresję gzip dla żądań pobierających raporty. Pamiętaj, że kompresja gzip nie jest obsługiwana w przypadku innych typów żądań do interfejsu API. Włączenie kompresji gzip zmniejsza przepustowość potrzebną do przetwarzania każdej odpowiedzi interfejsu API. Choć dekompresja odpowiedzi interfejsu API wymaga dodatkowego czasu procesora, korzyści wynikające ze zużywania mniejszej liczby zasobów sieciowych zwykle przeważają nad tym kosztem.

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

    Accept-Encoding: gzip

    Tę funkcję znajdziesz 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 pokazywała rzeczywiste wartości, które interfejs API zwraca dla tych wymiarów. Jest to poprawka w dokumentacji, która nie odzwierciedla zmian w działaniu interfejsu API ani w jego działaniu. Zmieniły się następujące wartości:

    • Wartości wymiaru age_group mogą zawierać wielkie litery, podkreślenia między słowem AGE a cyframi z grupy wiekowej oraz używać podkreśleń zamiast łączników. W związku z tym wartości takie jak age13-17 i age18-24 zostały poprawione odpowiednio na AGE_13_17 i AGE_18_24.
    • Wartości wymiaru gender 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. ta dokumentacja informowała o wycofaniu danych earnings interfejsu YouTube Analytics API. Jednocześnie interfejs API dodał obsługę nowego rodzaju danych o nazwie estimatedRevenue, które zawierają te same informacje.

Dane earnings były danymi podstawowymi, dlatego były obsługiwane przez rok od daty ogłoszenia. Jednak po zakończeniu rocznego okresu dane earnings nie są już obsługiwane. W efekcie żądania do interfejsu API, które określają wskaźnik earnings, zwracają teraz kod odpowiedzi HTTP 400. Jeśli Twoja aplikacja nie korzysta jeszcze z danych estimatedRevenue zamiast earnings, zrób to 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 (kierowanie na zapytania)

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

      Jeśli na przykład żądanie określa datę końcową 5 lipca 2017 roku, a wartości wszystkich żądanych danych są dostępne tylko do 3 lipca 2017 roku, będzie to ostatni dzień, którego dotyczy odpowiedź. (nawet jeśli dane niektórych żądanych rodzajów 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 do 6 sekund, zanim rozpocznie się odtwarzanie filmu. Format reklamy jest taki sam jak auctionBumperInstream, ale ten typ odnosi się do reklam sprzedawanych na zasadzie rezerwacji, a nie na aukcji.

  • YouTube Reporting API (raporty zbiorcze)

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

    • Usunięto zadania raportowania dotyczące 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 wycofanie tych typów raportów. Po 15 grudnia 2016 r. nie były już dla nich 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 dopiero od 15 czerwca 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.

24 maja 2017 r.

Usunięto wszystkie zadania raportowania dla tych raportów interfejsu YouTube Reporting API:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

22 czerwca 2016 r. ogłosiliśmy, że raporty te zostały wycofane, a po 22 września 2016 r. nie były już dla nich 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 dopiero od 22 marca 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.

22 maja 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Reporting API (raporty zbiorcze)

    • Wymiar sharing_service, który identyfikuje usługę używaną do udostępniania filmów, obsługuje teraz te wartości:

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

      Zaktualizowaliśmy też nazwę służącą do identyfikowania wartości 52 w dokumentacji na Kakao (Kakao Talk), aby ułatwić odróżnienie jej od wartości 73 (Kakao Story). Ta zmiana nie odzwierciedla żadnych zmian w działaniu interfejsu API ani klasyfikacji filmów udostępnianych tym usługom.

  • YouTube Analytics API (kierowanie na zapytania)

    • Wymiar sharingService obsługuje teraz te wartości:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 marca 2017 r.

Właściciele kanałów, którzy mają dostęp do danych o przychodach w Statystykach YouTube w Studio twórców, mają teraz dostęp także za pomocą interfejsu YouTube Analytics API:

17 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

3 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Reporting API (raporty zbiorcze)

    • Definicja wymiaru date została zmieniona, aby zwrócić uwagę, że wartość wymiaru odnosi się do okresu zaczynającego się o 00:00 czasu pacyficznego, a kończącego o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny nosi nazwę UTC-7 lub UTC-8.

      Chociaż daty są zwykle 24-godzinne, daty, w których zegary są przesunięte do przodu, przedstawiają okres 23-godzinny, a daty przesunięte do tyłu – 25-godzinny. Wcześniej dokumentacja informowała, że każda data dotyczyła unikalnego okresu 24-godzinnego, a czas pacyficzny to zawsze UTC-8.

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

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

    • Wszystkie zadania raportowania dla typu raportu content_owner_basic_a1 zostały usunięte. 19 sierpnia 2016 r. wycofaliśmy ten typ raportu, ale wygenerowane wcześniej raporty typu content_owner_basic_a1 były dostępne przez 180 dni od momentu ich wygenerowania. W związku z tym niektóre raporty były dostępne dopiero od 19 lutego 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.

  • YouTube Analytics API (kierowanie na zapytania)

    • Poprawiliśmy opis wymiarów związanych z wymiarem time periods, aby zaznaczyć, że wartość wymiaru odnosi się do okresu zaczynającego się o 00:00 czasu pacyficznego, a kończącego o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny nosi nazwę UTC-7 lub UTC-8.

      Chociaż daty są zwykle 24-godzinne, daty, w których zegary są przesunięte do przodu, przedstawiają okres 23-godzinny, a daty przesunięte do tyłu – 25-godzinny. Wcześniej dokumentacja informowała, że czas pacyficzny wynosi UTC-8, ale nie wspomniano o możliwości, że dzień nie będzie odbiegał od 24-godzinnego.

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

    • Zaktualizowaliśmy dokumentację raportów kanałów, by uwzględnić, że raporty dotyczące kanałów nie zawierają obecnie danych o zarobkach ani skuteczności reklam. W efekcie zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie umożliwia obecnie dostępu do danych finansowych w raportach dotyczących kanałów.

    • Wymiar operatingSystem obsługuje 3 nowe wartości wymiarów:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 lutego 2017 r.

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

Umożliwia on właścicielowi treści wskazanie, że odpowiedź interfejsu API powinna zawierać dane o czasie oglądania i wyświetleniach kanału z okresu poprzedzającego połączenie kanałów z tym właścicielem. Domyślna wartość tego parametru to false. Oznacza to, że odpowiedź interfejsu API domyślnie zawiera tylko dane o czasie oglądania i wyświetleniach z okresu od połączenia kanałów z właścicielem treści.

Te reguły mają też zastosowanie, jeśli żądanie do interfejsu API pobiera dane z wielu kanałów:

  • Jeśli wartością tego parametru jest false, dane o czasie oglądania i wyświetleniach dla każdego kanału zależą od daty połączenia tego 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 dla wielu kanałów, a wartość parametru to false, odpowiedź interfejsu API zawiera dane o czasie oglądania i wyświetleniach oparte na dacie połączenia z poszczególnymi kanałami.
  • Jeśli wartością tego parametru jest true, odpowiedź zwraca czas oglądania i dane dotyczące wszystkich kanałów na podstawie dat rozpoczęcia i zakończenia określonych 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 opublikowaliśmy 15 września 2016 r.

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

11 listopada 2016 r.

Ta aktualizacja zawiera następujące zmiany:

    Interfejs YouTube Reporting API obsługuje trzy nowe raporty ekranów końcowych oraz nowe wymiary i dane. Raporty te zawierają statystyki wyświetleń i kliknięć ekranów końcowych, które pojawiają się po zatrzymaniu odtwarzania filmu.

    8 listopada 2016 r.

    Ta aktualizacja wiąże się z następującymi zmianami w YouTube Analytics API:

    • Dane na poniższej liście zostały w pełni wycofane i nie są już obsługiwane. Zgodnie z tym, co ogłosiliśmy z 10 sierpnia 2016 r., obsługiwane są już nowe rodzaje danych, które odnoszą się do tych samych danych. W tabeli poniżej znajdziesz nazwy wycofanych danych oraz ich nowe:

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

    27 października 2016 r.

    Teraz YouTube automatycznie generuje zestaw zarządzanych przez system raportów o przychodach z reklam dla właścicieli treści, którzy mają dostęp do odpowiednich raportów w sekcji Raporty w Studiu twórców YouTube. Nowe raporty interfejsu API zarządzane przez system mają zapewnić zautomatyzowany dostęp do danych, które są również dostępne w ręcznie możliwych do pobrania raportach ze Studia twórców.

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

    Zaktualizowaliśmy właściwość id zasobu reportType, 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 na całym świecie
    • Dzienne przychody z reklam według kraju na film
    • Miesięczne przychody z reklam na zasób na całym świecie
    • Dzienne przychody z reklam według kraju na zasób
    • Roszczenia (ten raport nie zawiera danych o przychodach)

    27 września 2016 r.

    Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

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

    15 września 2016 r.

    Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Reporting API:

    19 sierpnia 2016 r.

    Ta aktualizacja wprowadza tę zmianę w interfejsie YouTube Reporting API:

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

      Zastąpiono raport content_owner_basic_a1 raport content_owner_basic_a2, jak opisano we wpisie historii zmian z 19 maja 2016 r.

    11 sierpnia 2016 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Niedawno opublikowane Warunki korzystania z usług interfejsu YouTube API („Zaktualizowane Warunki”), które są szczegółowo omówione na blogu YouTube dla programistów i programistów, zawierają wiele aktualizacji bieżących Warunków korzystania z usługi. Oprócz zaktualizowanych Warunków, które zaczną obowiązywać 10 lutego 2017 roku, ta aktualizacja zawiera kilka dokumentów pomocniczych, które wyjaśniają zasady, których muszą przestrzegać deweloperzy.

      Pełny zestaw nowych dokumentów opisano w historii zmian zaktualizowanych Warunków. Historia zmian będzie również wyjaśniana w przypadku przyszłych zmian zaktualizowanych Warunków lub dokumentów pomocniczych. Możesz zasubskrybować kanał RSS z listą zmian w historii zmian, korzystając z linku w dokumencie.

    10 sierpnia 2016 r.

    Ta aktualizacja obejmuje te zmiany:

    • YouTube Analytics API (kierowanie na zapytania)

      • Uwaga: to jest powiadomienie o wycofaniu tych funkcji.

        Dane w poniższej tabeli zostały wycofane. Jednocześnie wprowadzamy nowe dane, które odnoszą się do tych samych informacji. Oznacza to, że zmieniamy nazwy starych danych, chociaż interfejs YouTube Analytics API będzie obsługiwać obie nazwy do daty wycofania wymienionych 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 roku żądanie do interfejsu API może określać dane impressionBasedCpm, dane cpm lub oba te rodzaje danych. Jednak po tej dacie obsługiwane będą tylko dane cpm.

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

        W przypadku obu nowych źródeł wizyt możesz też pobrać raport traffic source detail. W obu przypadkach wymiar insightTrafficSourceDetail wskazuje 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 do 6 sekund, zanim rozpocznie się odtwarzanie filmu.

    • YouTube Reporting API (raporty zbiorcze)

      • Wymiar traffic_source_type obsługuje teraz te wartości:
        • 19: to źródło wizyt jest obsługiwane tylko w raportach właścicieli treści. Wskazuje on, że wyświetlenia pochodziły z filmów przesłanych przez użytkowników, które były objęte roszczeniem, a które właściciel treści wykorzystał do promowania wyświetlanych treści.
        • 20: dane dotyczą wyświetleń pochodzących z ekranu końcowego innego filmu.

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

      • Poprawiliśmy listę podstawowych danych interfejsu API, aby uwzględniała estimated_partner_revenue jako podstawowe dane i usunęła z niej 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, które trwają do 6 sekund i wyświetlają się przed wyświetleniem filmu.

    18 lipca 2016 r.

    Ta aktualizacja obejmuje te zmiany:

    • YouTube Analytics API (kierowanie na zapytania)

      • Listy obsługiwanych danych w następujących raportach kanału zostały zaktualizowane, aby uwzględniały dane karty. Obsługa danych kart została wprowadzona w tych raportach 28 czerwca 2016 r. Szczegółowe informacje o zmianie znajdziesz w wpisie historii zmian dla tego dnia. Raporty to:
        • Podstawowa aktywność użytkowników w stanach w USA
        • Aktywność użytkowników w stanach w USA w określonych przedziałach czasu
        • Aktywność użytkowników według prowincji
        • Aktywność użytkowników według stanu subskrypcji
        • Aktywność użytkowników według stanu subskrypcji dla prowincji
        • Najpopularniejsze filmy wg stanu
        • Najpopularniejsze filmy dla widzów z subskrypcją i bez subskrypcji

      • Poprawiliśmy listy filtrów w raportach utrzymania uwagi odbiorców na kanale i raportach utrzymania uwagi odbiorców, by uwzględnić, że filtr video jest wymagany, a filtr group nie jest obsługiwany.

        Wcześniej w dokumentacji obu raportów podano błędne informacje, że można je pobrać za pomocą jednego z tych filtrów lub żadnego z nich.

    • YouTube Reporting API (raporty zbiorcze)

      • W omówieniu interfejsu API sekcja, która wyjaśnia, jak pobrać adres URL raportu, została zmieniona tak, aby zaznaczyć, że YouTube generuje raporty do pobrania za dni, w których dane nie były dostępne. Zawierają one wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji Charakterystyka raportu w tym samym dokumencie 12 kwietnia 2016 r.
      • Lista wymiarów w raporcie content_owner_asset_cards_a1 została zmieniona, by odzwierciedlała, że raport używa wymiaru card_id. Wcześniej dokumentacja błędnie wyświetlała nazwę wymiaru jako „card_title”.

    28 czerwca 2016 r.

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

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

    22 czerwca 2016 r.

    Ta aktualizacja wprowadza następujące 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ę Charakterystyka raportu w omówieniu interfejsu API, aby wyjaśnić, że raporty są dostępne przez ten interfejs API przez 180 dni od momentu ich wygenerowania.

      Wcześniej w dokumentacji znajdowały się raporty dostępne dla okresu do 180 dni poprzedzających datę wysłania żądania do interfejsu API. Technicznie rzecz biorąc, oryginalny tekst był w najlepszym przypadku raczej niejasny.

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

      • Raport content_owner_ad_rates_a1 to nowa wersja raportu content_owner_ad_performance_a1. Raport o nowej nazwie jest taki sam jak poprzednia wersja.

      • Zmieniliśmy nazwy dwóch raportów z nowymi wersjami:

        • 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 pod nową nazwą różnią się od swoich poprzedników pod tym względem:

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

      Jeśli w przypadku któregoś z tych raportów masz zadania, nie należy oczekiwać, że po 22 września 2016 r. wygenerujemy dla nich nowe raporty. Wygenerowane raporty będą dostępne przez 180 dni od momentu ich wygenerowania.

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

    • Nazwy 2 rodzajów danych w dokumentacji zostały poprawione, aby były zgodne z nazwami widocznymi w raportach. Jest to tylko poprawka w dokumentacji, która nie odzwierciedla 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 zostaną wycofane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych danych nazwa tych danych została zmieniona na estimated_partner_ad_auction_revenue.
      • Nazwa danych estimated_partner_doubleclick_revenue została zmieniona na estimated_partner_double_click_revenue. Te dane pojawiają się tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych danych nazwa tych danych została zmieniona na estimated_partner_ad_reserved_revenue.

    • Dokumentacja wymiarów dotycząca interfejsu API do raportowania została zaktualizowana i nie zawiera już właściwości elapsed_video_time_percentage ani audience_retention_type. Te wymiary nie są obecnie obsługiwane w żadnych raportach dostępnych za pośrednictwem interfejsu API.

    19 maja 2016 r.

    Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Reporting API:

    • Ten interfejs API obsługuje nową wersję raportu aktywności użytkownika dla właścicieli treści. Identyfikator typu raportu w nowym raporcie to content_owner_basic_a2. W przeciwieństwie do poprzedniej wersji raportu (content_owner_basic_a1) nowa wersja obsługuje dane likes i dislikes.

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

      W związku z opublikowaniem nowego raportu raport content_owner_basic_a1 został wycofany. Jeśli masz zadanie związane z tym raportem, po 19 sierpnia 2016 roku YouTube nie powinien generować dla niego nowych raportów. Wygenerowane raporty będą 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 to 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, i wskazuje dzień, w którym YouTube przestanie generować raporty tego typu.

        Po ogłoszeniu, że dany typ raportu zostanie wycofany, YouTube będzie generować raporty tego typu przez kolejne 3 miesiące. Na przykład ta aktualizacja z 19 maja 2016 roku informuje o wycofaniu raportu content_owner_basic_a1. deprecateTime w przypadku tego typu raportu określa więc datę 19 sierpnia 2016 r., po której YouTube przestanie generować raporty tego typu.

      • Właściwość expireTime zasobu job określa datę i godzinę wygaśnięcia zadania. Ta właściwość zawiera wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub jeśli raporty generowane dla tego zadania nie były pobierane od dłuższego czasu. Jest to data, po której YouTube przestanie generować nowe raporty dotyczące tego zadania.

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

    • Metoda jobs.create zwraca teraz kod odpowiedzi HTTP 400 (Bad Request), jeśli próbujesz utworzyć zadanie dla wycofanego raportu. Dodatkowo w dokumentacji tej 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 dotyczy wszystkich stanowisk, w tym tych utworzonych przed tym ogłoszeniem.

      Raporty historyczne są publikowane natychmiast po ich udostępnieniu, ale opublikowanie wszystkich danych historycznych dotyczących zatrudnienia zajmuje około miesiąca. Oznacza to, że miesiąc po zaplanowaniu zadania raportowania będziesz mieć dostęp do danych z około siedmiu miesięcy. (Wszystkie historyczne dane dotyczące ofert pracy utworzonych przed tym ogłoszeniem powinny zostać opublikowane w ciągu miesiąca od ogłoszenia).

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

      Wyjaśniamy te zmiany w nowej sekcji poświęconej danych historycznych w omówieniu interfejsu API do raportowania.

    • Zaktualizowaliśmy sekcję dotyczącą charakteru raportu w omówieniu interfejsu YouTube Reporting API. Wprowadziliśmy w niej te zmiany:

      • Dokumentacja wskazuje obecnie, że raporty są dostępne przez okres 180 dni po wygenerowaniu, więc klienty interfejsu API mogą je pobrać. Wcześniej w dokumentacji znajdowały się informacje, że raporty były dostępne przez okres do 6 miesięcy przed datą wysłania żądania do interfejsu API.

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

    • Wkrótce interfejs YouTube Reporting API będzie obsługiwać zestaw automatycznie generowanych, zarządzanych przez system raportów zawierających dane o przychodach z reklam lub przychodów z subskrypcji YouTube Red. Będą one 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 programowy dostęp do tych danych.

      W ramach przygotowań do udostępnienia raportów zarządzanych przez system ogłosiliśmy następujące zmiany 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, a właściciele treści nie mogą modyfikować ani usuwać zadań, które je tworzą.

      • Nowy parametr includeSystemManaged metody jobs.list wskazuje, czy odpowiedź interfejsu API powinna zawierać zadania w przypadku 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 najwcześniejsze dane w raporcie pochodzą z określonej daty lub później. Podobnie parametr startTimeBefore wskazuje, że odpowiedź interfejsu API powinna zawierać raporty tylko wtedy, gdy najwcześniejsze 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 i YouTube Analytics API zwracają teraz statystyki wyświetleń dla kilku dodatkowych usług udostępniania.

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

    16 marca 2016 r.

    Ta aktualizacja wprowadza następujące zmiany, które będą miały wpływ na interfejs YouTube Reporting API oraz YouTube Analytics API:

    Interfejs API YouTube do raportowania

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

    YouTube Analytics API

    • Wymiar insightPlaybackLocationType obsługuje 2 nowe wartości wymiaru:
      • BROWSE: dane dotyczą wyświetleń dokonanych na stronie głównej lub ekranie głównym YouTube, na karcie subskrypcji użytkownika lub za pomocą innej funkcji przeglądania w YouTube.
      • SEARCH: dane dotyczą wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.
    • Wymiar insightTrafficSourceType może teraz służyć jako wartość wymiaru YT_PLAYLIST_PAGE. Ta wartość oznacza, że wyświetlenia filmu pochodzą ze strony zawierającej listę wszystkich filmów z playlisty. To źródło różni się od typu źródła PLAYLIST, co 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, dzięki czemu dane karty nie są już wymienione jako obsługiwane przez ten interfejs API. (Żaden z raportów tego interfejsu API nie został udokumentowany jako pomoc w zakresie danych karty).

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

    Styczeń 6, 2016

    Zarówno YouTube Reporting API, jak i YouTube Analytics API identyfikują teraz wyświetlenia, które mają miejsce na urządzeniu Chromecast.

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

    21 grudnia 2015 r.

    W dokumentacji nazwy danych annotation_clickable_impressions i annotation_closable_impressions zostały zaktualizowane, tak aby odpowiadały nazwom wyświetlanym w raportach. Wcześniej nazwy te były podane 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 oraz uzyskania od nich zgody. Użytkownicy z Unii Europejskiej muszą więc przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy informację o tym wymaganiu w Warunkach korzystania z interfejsu API YouTube.

    15 grudnia 2015 r.

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

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

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

      Zaktualizowaliśmy dokumentację, aby znaleźć nowe raporty o szczegółach odtwarzania dostępne dla kanałów i właścicieli treści. Zaktualizowaliśmy też wiele innych raportów, by uwzględnić, że co najmniej jeden z tych wymiarów może być opcjonalnie używany jako wymiary lub filtry w tych raportach.

    • Zmienił się format tabel wyjaśniających te raporty, by ułatwić identyfikowanie prawidłowych kombinacji wymiarów, danych i filtrów, których można używać do pobierania poszczególnych raportów. W tabeli poniżej, w której objaśniamy raport „Typ urządzenia” w przypadku kanałów, podajemy nowy format:

      Spis treści
      Wymiary:
      Wymagane deviceType
      Użyj 0 lub więcej day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Dane:
      Użyj 1 lub więcej wyświetlenia, estimatedMinutesWatched
      Filtry:
      Użyj 0 lub 1 country: województwo, kontynent, subContinent
      Użyj 0 lub 1 video, group
      Użyj 0 lub więcej operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Terminologia opisująca pola wymagane i opcjonalne została objaśniona w dokumentacji raportów kanału i właściciela treści.

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

    • Jeśli zażądasz danych dla pustego elementu group w YouTube Analytics, interfejs API zwróci teraz pusty zbiór danych, a nie błąd.

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

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

    10 listopada 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    29 października 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Poprawiliśmy dokumentację wymiaru date interfejsu YouTube Reporting API, aby uwzględniała ten okres: 24-godzinny okres rozpoczynający się o godzinie 00:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji znajdowała się informacja, że data rozpoczęcia tej daty to 00:00 (GMT).

      Zaktualizowaliśmy też dokumentację interfejsu API YouTube Analytics, aby uwzględnić, że wszystkie wymiary związane z datami (day, 7DayTotals, 30DayTotals i month) dotyczą dat rozpoczynających się o 00:00 czasu pacyficznego (UTC-8).

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

      Wartość parametru jest sygnaturą czasową w formacie UTC „Zulu” RFC 3339 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, aby zwrócić uwagę, że wartości właściwości są podane w mikrosekundach, a nie nanosekundach. Dodatkowo wszystkie definicje dokładnie odzwierciedlają teraz, że wartość właściwości jest sygnaturą czasową.

    8 października 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Zaktualizowaliśmy dokumentację wymiaru sharingService interfejsu YouTube Analytics API, aby uwzględnić listę możliwych wartości wymiarów. Lista zawiera ostatnio obsługiwane usługi.

      Zaktualizowaliśmy też definicję wymiaru sharing_service w interfejsie YouTube Reporting API o 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 interfejs YouTube Reporting API umożliwia pobieranie raportów danych zbiorczych, które zawierają dane Statystyk YouTube dotyczące kanału lub właściciela treści. Została ona zaprojektowana z myślą o aplikacjach umożliwiających importowanie dużych zbiorów danych oraz zapewniających narzędzia do filtrowania, sortowania i wydobywania tych danych.

      Każdy raport interfejsu YouTube Reporting API zawiera wstępnie zdefiniowany zestaw wymiarów i danych. (w raportach z interfejsu YouTube Analytics API używane są również dane i wymiary). Każdy wiersz danych w raporcie zawiera niepowtarzalną kombinację wartości wymiarów. Możesz łączyć dane z różnych wierszy na podstawie wartości wymiarów, aby obliczać dane dotyczące poszczególnych filmów, krajów, filmów na żywo, subskrybentów itd.

      Za pomocą interfejsu API możesz zaplanować zadania raportowania. Każde z nich identyfikuje raport do wygenerowania przez YouTube. Gdy skonfigurujesz zadanie, YouTube generuje raport dzienny, który możesz pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego 24-godzinnego okresu.

    • Mimo że są to różne interfejsy API, interfejsy 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 została opublikowana w formie jednego 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ę i inne materiały dotyczące interfejsu YouTube Reporting API.
      • Karta Zapytania docelowe zawiera dokumentację referencyjną i inne treści dotyczące interfejsu YouTube Analytics API.
      • Na karcie Przykłady znajdziesz przykłady kodu dostępne w przypadku każdego z tych 2 interfejsów API.
      • Karta Narzędzia zawiera dodatkowe materiały, które mogą pomóc programistom we wdrożeniu jednego z tych interfejsów.

    20 sierpnia 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Zmieniliśmy strukturę dokumentacji API, aby ułatwić jej zrozumienie. Opisane tu zmiany nie dotyczą nowych funkcji:

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

      • Nowy omówienie modelu danych ma na celu wyjaśnienie, jak działa interfejs API. W tym dokumencie szczegółowo opisujemy, jak 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 dokumentowana oddzielnie. Informacje na tej stronie znajdowały się wcześniej na kilku innych stronach. Nowa strona ma na celu ułatwienie identyfikacji informacji, które należy przesłać w celu uzyskania raportu.

    22 lipca 2015 r.

    W ramach tej aktualizacji wprowadziliśmy 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ą to podstawowe dane. Interfejs API obsługuje dane adEarnings w każdym raporcie, który obsługiwał już dane earnings.

      Dodatkowo zmieniliśmy definicję danych earnings, aby odzwierciedlała fakt, że ich wartość obejmuje łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google i ze źródeł innych niż reklamy. Wcześniej definicja błędnie sugerowała, że dane uwzględniały tylko zarobki ze źródeł reklamowych.

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

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

    1 czerwca 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

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

      • videosAddedToPlaylists – ile razy 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 playlist na innych kanałach.
      • videosRemovedFromPlaylists – liczba razy, gdy filmy objęte zapytaniem zostały usunięte ze wszystkich playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist na innych kanałach.

      Oba dane obejmują domyślne playlisty, takie jak playlista „Do obejrzenia”. Nie uwzględniają jednak playlist, do których film jest automatycznie dodawany, takich jak playlisty przesłane na kanał czy historia oglądania użytkownika. Pamiętaj też, że te wskaźniki odzwierciedlają bezwzględną liczbę dodanych i usunięć. Jeśli więc użytkownik doda film do playlisty, usunie go i doda jeszcze raz, dane wskazują, że film został dodany do 2 playlist i 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 jest ustawiony, interfejs API przelicza wartości danych earnings, grossRevenue, playbackBasedCpm i impressionBasedCpm na określoną walutę. Zwracane wartości są wartościami szacunkowymi obliczonymi z wykorzystaniem kursów wymiany, które zmieniają się codziennie.

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

    25 lutego 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Umożliwia on teraz tworzenie grup w YouTube Analytics i zarządzanie nimi, a także pobieranie danych raportów z tych grup.

      • Tworzenie grup i zarządzanie nimi

        W tej aktualizacji poznasz zasoby group i groupItem służące do tworzenia grup i zarządzania nimi.

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

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

      • Pobieranie danych do raportu dotyczących grupy

        Zaktualizowaliśmy dokumentację dotyczącą wymiarów, aby 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. Gdy użyjesz filtra group, interfejs API zwróci dane wszystkich elementów w danej grupie. Pamiętaj, że obecnie interfejs API nie umożliwia 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ć wiele wartości, ustaw wartość parametru filters na rozdzieloną przecinkami listę identyfikatorów filmów, playlist, kanałów lub programów, w przypadku których chcesz odfiltrować odpowiedź interfejsu API. Wartość parametru może zawierać do 200 identyfikatorów.

      Jeśli określisz wiele wartości dla tego samego filtra, możesz też dodać ten filtr do listy wymiarów określonych w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony na liście wymiarów obsługiwanych w danym raporcie. Jeśli dodasz filtr do listy wymiarów, interfejs API będzie używać ich też 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 kanału możesz teraz pobrać dane kanału uwierzytelnionego użytkownika. W tym celu ustaw wartość parametru ids na channel==MINE. (możesz też ustawić parametr ids na channel==CHANNEL_ID, aby pobierać dane z określonego kanału).

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

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

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

      • playlistStarts: liczba przypadków zainicjowania odtwarzania playlisty przez widzów.
      • viewsPerPlaylistStart: średnia liczba wyświetleń filmów przy każdym uruchomieniu playlisty.
      • averageTimeInPlaylist: szacowany średni czas (w minutach), przez jaki widz oglądał filmy z playlisty po zainicjowaniu playlisty.

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

    • Interfejs API obsługuje teraz raport Utrzymanie uwagi odbiorców. Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Nowy wymiar elapsedVideoTimeRatio w raporcie mierzy długość filmu, który upłynął w przypadku odpowiednich wartości danych:

      • audienceWatchRatio określa bezwzględny odsetek widzów, którzy oglądają film w danym momencie filmu. Współczynnik ten jest obliczany przez porównanie liczby odtworzeń części filmu z łączną liczbą wyświetleń filmu.

        Pamiętaj, że w ramach danego wyświetlenia filmu można obejrzeć jego fragment więcej niż raz (lub nie zobaczyć go wcale). Jeśli na przykład użytkownicy przewijają film do tyłu i wielokrotnie oglądają ten sam fragment, wartość bezwzględna tej części filmu może być większa niż 1.

      • Dane relativeRetentionPerformance wskazują, jak skutecznie film utrzymuje uwagę widzów podczas jego 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, a wartość 1 oznacza, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Mediana równa 0,5 oznacza, że połowa filmów o podobnej długości utrzymuje uwagę widzów, a połowa gorzej.

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

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

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

    • GOOGLE_SEARCH nie jest już raportowany jako osobna wartość wymiaru insightTrafficSourceType. Odesłania z wyników wyszukiwania Google są teraz przypisywane do typu źródła wizyt EXT_URL. W rezultacie nie można też 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:

    • Zmieniliśmy wygląd dokumentu z przykładowymi prośbami, aby zawierał przykłady w kategoriach. Format kart jest podobny do tych, które zostały niedawno wprowadzone w raportach dotyczących kanałów i właścicieli treści. W nowym wyglądzie przykłady są podzielone na następujące 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 w przypadku raportów właściciela treści)

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

      • Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu: Ten raport zawiera dane o liczbie wyświetleń i inne statystyki dotyczące filmów na kanale w podziale na poszczególne prowincje. Dane dotyczą stanów USA i Waszyngtonu. W przykładzie użyto wymiaru province oraz parametru filters, aby ograniczyć odpowiedź tylko do tych ze 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 na kanale, 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 mieć pewność, że odpowiedź zawiera tylko dane z konkretnej prowincji.

    • Definicja wymiaru province została zaktualizowana, aby zaznaczyć, że jeśli wartość parametru dimensions zawiera province, żądanie musi też ograniczać dane do Stanów Zjednoczonych, dołączając country==US w wartości parametru filters.

    6 stycznia 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Zmieniliśmy wygląd dokumentów przedstawiających obsługiwane raporty dotyczące kanału i właściciela treści. Zamiast tworzyć tabelę 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 listę kart. Możesz kliknąć dowolną z nich, aby zobaczyć raporty 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 przedstawiają statystyki z poszczególnych stanów. Oba raporty są dostępne dla kanałów i właścicieli treści.

          • Raport podstawowych statystyk zawiera kilka statystyk, w tym liczbę wyświetleń i szacowany czas oglądania.
          • Raport czasowy zawiera te same statystyki, ale podsumowuje dane dzienne, 7-dniowe, 30-dniowe lub miesięczne.

        • Korzystając z parametru zapytania filters, możesz ograniczyć raport, aby zawierał statystyki tylko z konkretnego stanu. Ten typ filtrowania obsługuje kilka raportów, w tym raporty geograficzne, o miejscach odtwarzania, o źródłach wizyt, o urządzeniach, systemie operacyjnym, dane demograficzne i na temat najpopularniejszych filmów.

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

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

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

    • Poprawiono dokumentację, tak aby wymiar insightTrafficSourceDetail nie zawierał wartości PROMOTED insightTrafficSourceType jako prawidłowej wartości filtra.

    30 września 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs YouTube Analytics API podlega teraz zasadom wycofywania opisanym w Warunkach korzystania z usługi. Jednak wymiary i dane spoza podstawowego interfejsu API nie podlegają zasadom wycofywania. Na stronach Wymiary i metrics zaktualizowaliśmy listę podstawowych wymiarów i podstawowych danych. Zaktualizowaliśmy też definicje na tych stronach, aby wyraźnie określać podstawowe wymiary i dane.

    • Interfejs API obsługuje teraz wartość EXTERNAL_APP w wymiarze insightPlaybackLocationType. W związku z tą aktualizacją od 10 września 2013 r. odtworzenia nie będą już zaliczane do kategorii odtworzeń MOBILE, ale odtworzenia na urządzeniach mobilnych, które miały miejsce przed tą datą, zostaną przypisane do tej wartości.

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

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

    16 lipca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API obsługuje teraz sortowanie raportów według wielu wymiarów i danych. W dokumencie z przykładowymi żądaniami znajdziesz nowy przykład sortowania żądań według wielu wymiarów/danych, który przedstawia tę funkcję. Żądanie pobiera dane źródła wizyt i ma wartość parametru sort równą day,-views. Wyniki są sortowane chronologicznie, ale w ramach zestawu wyników dla każdego dnia pierwszy wiersz zawiera dane o źródle wizyt, które wygenerowało najwięcej wyświetleń, drugi o źródle z kolejną największą liczbą wyświetleń itd.

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

      • Dzięki raportowi deviceType możesz sprawdzić liczbę wyświetleń i szacowany czas oglądania dla różnych typów urządzeń, takich jak komputery, komórki i tablety. Możesz też użyć filtra operatingSystem, aby ograniczyć raport o typie urządzeń, aby obejmował tylko statystyki dotyczące urządzeń z określonym systemem operacyjnym, np. Android lub iOS.

      • Dzięki raportowi operatingSystem możesz sprawdzić liczbę wyświetleń i szacowany czas oglądania w różnych systemach operacyjnych, takich jak Android, iOS czy Linux. Możesz też użyć filtra deviceType, aby ograniczyć raport o systemie operacyjnym do statystyk dotyczących urządzeń określonego typu (np. komórek lub tabletów).

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

    • Zaktualizowaliśmy dokument z przykładowymi prośbami, by uwzględniał 3 raporty o urządzeniach dla kanałów i 3 raporty dotyczące urządzeń dla właścicieli treści.

    • Wymiar insightPlaybackLocationType może zwrócić wartość YT_OTHER, która identyfikuje widoki danych, które nie są 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 dotyczących czasu oglądania – estimatedMinutesWatched, averageViewDuration i averageViewPercentage – w połączeniu z innymi danymi, w tym danymi dotyczącymi wyświetleń, zaangażowania, zarobków i skuteczności reklam.

      Listy dostępnych raportów dotyczących kanałów i raportów właścicieli treści zostały zaktualizowane, by odzwierciedlały tę zmianę. (Te listy są obecnie krótsze, ponieważ dane o czasie oglądania można pobrać jako część 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 o te sposoby:

      • Obsługują teraz opcjonalny filtr country.

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

        • Szczegóły miejsca odtwarzania

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

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

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

    3 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowy dokument Przykładowe żądania do interfejsu API zawiera przykłady, które pokazują, jak pobierać różne typy raportów za pomocą metody YouTube Analytics API. Każdy przykład zawiera krótki opis pobieranego przez żądanie raportu, a następnie wymiary, dane, filtry i parametry sortowania dotyczące żądania.

    • Wymiar insightTrafficSourceType obsługuje teraz prawidłową wartość SUBSCRIBER. Ta wartość identyfikuje wyświetlenia filmów, które pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji YouTube. Jeśli filtrujesz według tego źródła wizyt, pole insightTrafficSourceDetail zawiera kanał strony głównej lub inną stronę, z której zostały odesłane wyświetlenia.

    28 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    21 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

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

      • Nowe raporty obejmują dane o skuteczności reklam wg odtworzeń oraz dane o skuteczności reklam w oparciu o liczbę wyświetleń. Aby dowiedzieć się więcej o raportach skuteczności reklam, zapoznaj się z dokumentacją raportów właścicieli treści.

      • Poniżej znajdziesz listę nowo obsługiwanych wskaźników. Zaktualizowaliśmy listę raportów właściciela treści, aby identyfikować raporty (obejmujące 2 nowe raporty, które obsługują te dane).

        • earnings – całkowite szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google.
        • grossRevenue – szacunkowe przychody brutto od partnerów Google lub DoubleClick.
        • primaryAdGrossRevenue – szacunkowe przychody brutto z Google lub partnerów DoubleClick, zsumowane i sklasyfikowane w ramach głównego typu reklamy dla odtworzeń filmów, których dotyczy raport.
        • monetizedPlaybacks – liczba odtworzeń, podczas których wykonano co najmniej jedno wyświetlenie reklamy.
        • playbackBasedCpm – szacowany przychód brutto na tysiąc odtworzeń.
        • impressions – liczba zweryfikowanych wyświetleń reklam.
        • impressionBasedCpm – szacowane przychody brutto na tysiąc wyświetleń reklam.

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

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

    • Zmieniliśmy układ dokumentacji interfejsu API, aby różne typy raportów zostały objaśnione na osobnych stronach. Dlatego teraz dostępne są osobne strony z objaśnieniami różnych typów raportów dotyczących kanałów i raportów właścicieli treści.

    4 lutego 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • W przewodniku po interfejsie API znajdziesz teraz sekcję examples z przykładami kodu, które pokazują, jak wywoływać interfejs API przy użyciu bibliotek klienckich 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:

    • W Przewodniku po interfejsach API znajdziesz teraz polecenie APIs Explorer, które umożliwia wywoływanie interfejsu API, sprawdzanie żądań do interfejsu API i pobieranie rzeczywistych danych w odpowiedzi.

    • Ten interfejs API obsługuje szereg nowych raportów, które zostały opisane poniżej, zarówno dla 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. Odpowiednio zaktualizowaliśmy też strony Wymiary i metrics.

      • Raport o miejscach odtwarzania podaje liczbę wyświetleń filmów na różnych rodzajach stron lub aplikacji.

      • Raport szczegółów o miejscu odtwarzania wskazuje odtwarzacze umieszczone na stronach, które wygenerowały najwięcej wyświetleń dla określonego filmu. Identyfikacja adresów URL powiązanych z najczęściej umieszczonymi odtwarzaczami zapewnia bardziej szczegółowy widok niż raport o miejscach odtwarzania.

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

      • Raport Szczegółów źródła wizyt wskazuje strony odsyłające, które wygenerowały najwięcej wyświetleń dla określonego filmu, oraz określonego typu źródła wizyt. Mogą one obejmować na przykład podobne filmy, które przyciągnęły największy ruch do konkretnego filmu. Ten raport jest obsługiwany dla kilku źródeł wizyt.

      • Raporty Czas oglądania zawierają informacje o czasie, jaki widzowie spędzili na oglądaniu Twoich treści. Raporty mogą zawierać dane zbiorcze z określonego przedziału czasu – dnia, ostatnich 7 dni, poprzednich 30 dni itd. – lub kraju. Jeśli dane w raporcie są zbierane według dnia lub kraju, możesz w nim też określić średnią długość każdego wyświetlenia filmu oraz średni procent każdego filmu obejrzanego przez użytkownika.

    2 października 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Aplikacja YouTube Analytics API jest już dostępna dla wszystkich deweloperów. Interfejs API swojego projektu możesz aktywować w panelu Usługi w APIs console bez konieczności uprzedniego wysyłania prośby o dostęp.

    • Nowa sekcja Pierwsze kroki zawiera informacje o wymaganiach wstępnych i podstawowych krokach do tworzenia aplikacji korzystających z YouTube Analytics API.

    12 września 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowa sekcja dotycząca wykorzystania limitu zawiera wskazówki dotyczące optymalizacji wykorzystania limitu interfejsu API. Serwer API oblicza koszt zapytania dla każdego żądania i odejmuje go od limitu wykorzystania interfejsu API. Różne typy raportów mogą wiązać się z znacznie różniącymi się kosztami zapytań, dlatego musisz dobrze zaplanować wykorzystanie limitu, a aplikacja powinna żądać tylko tych danych i danych, których rzeczywiście potrzebuje.

    • Zaktualizowaliśmy sekcję dotyczącą wymiarów tymczasowych, aby zawierała wyjaśnienie, że wskazują one, że raport Analytics powinien agregować dane według przedziału czasu. Interfejs API obsługuje teraz te dodatkowe wymiary czasowe:

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

      Podobnie zaktualizowaliśmy sekcję Dostępne raporty, by uwzględnić w nich obsługę raportów korzystających z tych wymiarów przez interfejs API.

    • Zaktualizowaliśmy sekcję Wymiary jednostki raportowania, by uwzględnić, że żądania API pobierania 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 dwie nowe opcje sortowania raportów dotyczących najpopularniejszych filmów. Raporty, dostępne jako raporty kanału lub właściciela treści, zawierają dane (wyświetlenia, komentarze, polubienia itp.) z podziałem na kraje i podzielone według filmów. Możesz teraz sortować te raporty według liczby użytkowników, którzy zasubskrybowali kanał lub zrezygnowali z subskrypcji na stronie odtwarzania filmu.

    • Definicje metrics subscribersGained i subscribersLost zostały zaktualizowane, aby wyjaśnić, że kanał może zyskać lub stracić subskrybentów w kilku miejscach, takich jak strona odtwarzania filmu, strona kanału i przewodnik wyświetlany na stronie głównej YouTube. Gdy te dane są widoczne w raporcie dotyczącym konkretnego filmu, obejmują tylko statystyki ze strony odtwarzania konkretnego filmu.