Historia zmian

Ta strona zawiera informacje o zmianach w interfejsach API i aktualizacjach dokumentacji interfejsów API YouTube do raportowania i YouTube Analytics API. Oba interfejsy API umożliwiają programistom dostęp do danych Statystyk YouTube, ale w różny sposób. Zasubskrybuj ten dziennik zmian. Subskrybuj

15 listopada 2024 r.

Uwaga: ta zmiana wejdzie w życie 18 listopada 2024 r.

Dokumentacja interfejsu API Analytics (wyszukiwania ukierunkowane) w YouTube została zaktualizowana. W przypadku raportów źródeł ruchu metoda reports.query interfejsu API zwraca teraz błąd, jeśli iloczyn liczba zapytanych filmów × liczba dni w zakresie dat przekracza 50 tys. Na przykład zapytanie, które pobiera dane dla 500 identyfikatorów filmów, może zawierać prośbę o dane z maksymalnie 100 dni.

Ta zmiana dotyczy raportów dotyczących zarówno kanałów, jak i właścicieli treści.

Aby zmniejszyć liczbę wierszy zwracanych przez żądanie, podziel zapytanie na kilka zapytań, które określają mniej filmów lub zawierają krótsze zakresy dat. Zasadniczo w przypadku dużych zbiorów danych zalecamy raporty zbiorcze.

6 maja 2024 r.

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

Poza tym raport Utrzymanie uwagi odbiorców został rozbudowany o 3 nowe rodzaje danych:

7 kwietnia 2024 r.

W interfejsie API Statystyk YouTube (kierowane zapytania) wprowadzono kilka zmian związanych z raportami playlist właścicieli treści. Te zmiany są takie same jak te dotyczące raportów dotyczących playlist na kanale, które zostały ogłoszone 19 stycznia 2024 r.

Poniższy wpis w historii zmian zawiera prawie te same informacje co wpis z 19 stycznia 2024 r. Pamiętaj jednak, że w raportach playlist właścicieli treści wymiar isCurated będzie obsługiwany do 31 grudnia 2024 r., a w raportach playlist kanału – do 30 czerwca 2024 r.

  • Uwaga: to jest ogłoszenie o wycofaniu.

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

    Aby zachować zgodność wsteczną po usunięciu wymiaru isCurated, musisz zaktualizować kod, aby pobierać dane playlistViews zamiast danych views tylko w przypadku raportów dotyczących playlist. Dane views są nadal obsługiwane w raportach dotyczących playlist, ale mają inną interpretację. Jeśli nie zaktualizujesz nazwy danych, interfejs API nadal będzie zwracać dane. Oczywiście możesz zmodyfikować swoją 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 przypadku nowych raportów dotyczących playlist na kanale.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist na kanale. Te dane nie były dostępne w YouTube Studio, więc ta zmiana dopasowuje funkcjonalność interfejsu API do funkcjonalności dostępnej w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach dotyczących playlist kanału. Te filtry nie były dostępne w YouTube Studio, więc ta zmiana dopasowuje funkcjonalność interfejsu API do funkcjonalności dostępnej w aplikacji Studio.

  • Sekcja raportów playlist w dokumentacji dotyczącej raportów właścicieli treści została zaktualizowana, aby dokładniej wyjaśnić typy danych obsługiwanych w raportach playlist:

    • Zbiorcze dane wideo obejmują dane o aktywności użytkowników i wyświetleniach, które są zliczane dla wszystkich filmów na playlistach należących do właściciela treści. Aggregowane dane o wideo są obsługiwane tylko w przypadku żądań interfejsu API, które nie używają wymiaru isCurated.
    • Dane na poziomie playlisty odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane obejmują wyświetlenia filmów, do których nie masz praw, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • W sekcji obsługiwane dane dotyczące playlist przedstawiono zbiorcze dane wideo i dane na poziomie playlisty, które są obsługiwane w raportach dotyczących playlist.

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

  • Zachowanie danych views zależy teraz od tego, czy żądanie interfejsu API, które pobiera raport playlisty, używa wymiaru isCurated:

    • Gdy żądanie zawiera wymiar isCurated, dane views to dane dotyczące playlisty, 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 wideo, które określają łączną liczbę wyświetleń filmów na playlistach właściciela treści, niezależnie od tego, czy wyświetlenia te miały miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko te filmy, które należą do właściciela treści powiązanego z kanałem, na którym znajduje się playlista.

      W tych raportach, które nie używają wymiaru isCurated, dane playlistViews wskazują liczbę wyświetleń filmów w kontekście playlisty. Ten wskaźnik uwzględnia wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W przypadku każdego raportu dotyczącego playlist dokumentacja raportów właścicieli treści zawiera teraz tabele z obsługiwanymi danymi w raporcie, w zależności od tego, czy żądanie interfejsu API zawiera wymiar isCurated. Przykładowo zapoznaj się z sekcją definiującą raporty dotyczące playlist na podstawie czasu.

19 stycznia 2024 r.

Wprowadziliśmy kilka zmian w interfejsie API Statystyk YouTube (kierowane zapytania) dotyczących raportów dotyczących playlist kanału. Aktualizacje obejmują wycofany wymiar i kilka nowych i zaktualizowanych danych:

  • Uwaga: to jest ogłoszenie o wycofaniu.

    Wymiar isCurated został wycofany z raportów kanałów. Po 30 czerwca 2024 r. przestanie być ona obsługiwana. Definicja tego wymiaru została odpowiednio zaktualizowana.

    Aby zachować zgodność wsteczną po usunięciu wymiaru isCurated, musisz zaktualizować kod, aby pobierać dane playlistViews zamiast danych views tylko w przypadku raportów dotyczących playlist. Dane views są nadal obsługiwane w raportach dotyczących playlist, ale mają inną interpretację. Jeśli nie zaktualizujesz nazwy danych, interfejs API nadal będzie zwracać dane. Oczywiście możesz zmodyfikować swoją 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 przypadku nowych raportów dotyczących playlist na kanale.
    • Dane redViews i estimatedRedMinutesWatched nie są już obsługiwane w nowych raportach dotyczących playlist na kanale. Te dane nie były dostępne w YouTube Studio, więc ta zmiana dopasowuje funkcjonalność interfejsu API do funkcjonalności dostępnej w aplikacji Studio.
    • Wymiary subscribedStatus i youtubeProduct nie są już obsługiwane jako filtry w raportach dotyczących playlist kanału. Te filtry nie były dostępne w YouTube Studio, więc ta zmiana dopasowuje funkcjonalność interfejsu API do funkcjonalności dostępnej w aplikacji Studio.

  • Sekcja raportów playlist w dokumentacji dotyczącej raportów o kanałach została zaktualizowana, aby dokładniej wyjaśnić typy danych obsługiwanych w raportach o playlistach:

    • Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach, które są zliczane dla wszystkich filmów na playlistach należących do danego kanału. Aggregowane dane o wideo są obsługiwane tylko w przypadku żądań interfejsu API, które nie używają wymiaru isCurated.
    • Dane na poziomie playlisty odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Te dane obejmują wyświetlenia filmów, do których nie masz praw, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
    • W sekcji obsługiwane dane dotyczące playlist przedstawiono zbiorcze dane wideo i dane na poziomie playlisty, które są obsługiwane w raportach dotyczących playlist.

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

  • Zachowanie danych views zależy teraz od tego, czy żądanie interfejsu API, które pobiera raport playlisty, używa wymiaru isCurated:

    • Gdy żądanie zawiera wymiar isCurated, dane views to dane dotyczące playlisty, 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 filmie, które określają łączną liczbę wyświetleń tego filmu na playlistach kanału, niezależnie od tego, czy wyświetlenia te miały miejsce w kontekście playlisty. Łączny wynik obejmuje tylko wyświetlenia filmów należących do kanału, który jest właścicielem playlisty.

      W tych raportach, które nie używają wymiaru isCurated, dane playlistViews wskazują liczbę wyświetleń filmów w kontekście playlisty. Ten wskaźnik uwzględnia wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.

  • W przypadku każdego raportu dotyczącego playlisty dokumentacja raportów o kanałach zawiera teraz tabele z obsługiwanymi danymi w zależności od tego, czy żądanie API zawiera wymiar isCurated. Przykładowo zapoznaj się z sekcją definiującą raporty dotyczące playlist na podstawie czasu.

4 grudnia 2023 r.

Interfejs API Statystyk YouTube (kierowane zapytania) został zaktualizowany, aby umożliwić scalanie 2 wartości wymiaru insightTrafficSourceType. Wcześniej ten wymiar rozróżniał filmy odtwarzane w ramach playlisty (PLAYLIST) i wyświetlenia pochodzące ze strony zawierającej wszystkie filmy z playlisty (YT_PLAYLIST_PAGE). Od teraz oba typy wyświetleń będą powiązane z wartością wymiaru PLAYLIST.

15 grudnia 2022 r.

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

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

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

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

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

  • Odniesienia do wymiarów 7DayTotals i 30DayTotals zostały usunięte z dokumentacji. Oświadczenie o wycofaniu tych wymiarów zostało opublikowane w październiku 2019 r.

26 sierpnia 2022 r.

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

  • Jeśli w interfejsie API Analytics (zapytań ukierunkowanych) w YouTube wartość wymiaru insightTrafficSourceType wynosi SUBSCRIBER, wartość wymiaru insightTrafficSourceDetail może być ustawiona na podcasts, co oznacza, że ruch został skierowany z poziomu strony docelowej z podcastami.
  • Jeśli w interfejsie API raportowania YouTube (raporty zbiorcze) wymiar traffic_source_type ma wartość 3, wartość traffic_source_detail może być ustawiona na podcasts, co oznacza, że ruch został skierowany z poziomu strony docelowej Podcastów.

11 lutego 2022 r.

Zestaw prawidłowych wartości wymiaru gender zmieni się 11 sierpnia 2022 r. lub później. Może to być zmiana w implementacji interfejsu API, która powoduje brak zgodności wstecznej. Zgodnie z sekcją Zgodność wsteczna w Warunkach korzystania z usługi YouTube API ta zmiana jest ogłaszana na 6 miesięcy przed jej wprowadzeniem. Zaktualizuj implementację interfejsu API przed 11 sierpnia 2022 r., aby zapewnić płynne przejście na nowy zestaw wartości.

Wprowadzone zmiany:

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

9 lutego 2022 r.

13 grudnia 2021 r. zaktualizowaliśmy 2 rodzaje danych, aby wykluczyć z nich ruch z klipy odtwarzanego w kółko. Ta zmiana dotyczy zarówno interfejsu API Statystyk YouTube (kierowane zapytania), jak i interfejsu API do raportowania (raporty zbiorcze) w Statystykach YouTube.

2 lutego 2022 r.

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

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

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

23 września 2020 r.

Interfejs API Statystyk YouTube (zapytania kierowane) i interfejs API do raportowania w YouTube (raporty zbiorcze) obsługują nową wartość wymiaru źródła ruchu, która wskazuje, że widz został skierowany do filmu przez przesunięcie palcem w pionie podczas oglądania filmów Short:

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

Wymiar szczegółów źródła wizyt (insightTrafficSourceDetail) w interfejsie API Statystyk YouTube lub wymiar traffic_source_detail w interfejsie API do raportowania YouTube nie jest wypełniany w przypadku tego nowego typu źródła wizyt.

20 lipca 2020 r.

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

  • Maksymalny rozmiar grupy raportów Statystyk YouTube wzrósł z 200 do 500 elementów.
  • Parametr filters metody reports.query identyfikuje listę filtrów, które należy zastosować podczas pobierania danych ze Statystyk YouTube. Parametr umożliwia określenie wielu wartości dla filtrów video, playlist i channel, a maksymalna liczba identyfikatorów, które można podać dla tych filtrów, wzrosła z 200 do 500.

13 lutego 2020 r.

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

W obu interfejsach API zestaw możliwych wartości szczegółów źródła ruchu w powiadomieniach ulega zmianie. W zapytaniach kierowanych powiadomienia są raportowane jako insightTrafficSourceType=NOTIFICATION. W raportach zbiorczych powiadomienia są raportowane jako traffic_source_type=17.

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

  • uploaded_push – wyświetlenia pochodzące z powiadomień push wysłanych do subskrybentów po przesłaniu filmu.
  • uploaded_other – wyświetlenia pochodzące z powiadomień niebędących powiadomieniami push, takich jak e-maile lub powiadomienia z Odebranych wysłane do subskrybentów po przesłaniu filmu.

Te wartości są zwracane dla zakresu czasowego rozpoczynającego się 13 stycznia 2020 r.

Przypominamy, że te wartości nie odnoszą się do samych powiadomień, ale do źródeł ruchu, które spowodowały określone wyświetlenia w YouTube. Jeśli na przykład wiersz raportu wskazuje wartości views=3, traffic_source_type=17 (NOTIFICATION) i traffic_source_detail=uploaded_push, oznacza to, że 3 wyświetlenia powstały w wyniku kliknięcia przez widzów powiadomień push wysłanych po przesłaniu filmu.

15 października 2019 r.

Ta aktualizacja zawiera te zmiany związane z interfejsem API Statystyk YouTube (kierowane zapytania):

  • Uwaga: to jest ogłoszenie o wycofaniu.

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

    Użytkownicy mogą odtworzyć niektóre dane z tych wymiarów, wysyłając zapytanie z użyciem wymiaru day i zbierając lub wyodrębniając dane z okresów 7- lub 30-dniowych. Na przykład:

    • Liczba wyświetleń w okresie 7 dni może zostać obliczona przez zsumowanie liczby wyświetleń z każdego dnia tego okresu.
    • Wartość viewerPercentage w okresie 7 dni można obliczyć, mnożąc liczbę wyświetleń w każdym dniu przez viewerPercentage w tym dniu, aby uzyskać liczbę widzów, którzy zalogowali się, aby obejrzeć film w tym dniu. Następnie można zsumować liczbę zalogowanych widzów w całym okresie i podzielić ją przez łączną liczbę wyświetleń w tym okresie, aby uzyskać wartość viewerPercentage (odsetek widzów) w całym okresie.
    • Liczba unikalnych widzów w okresie 7 dni nie może zostać obliczona, ponieważ ten sam widz może zostać policzony jako unikalny widz w różnych dniach. Możesz jednak użyć wymiaru month zamiast wymiaru 30DayTotals, aby ekstrapolować dane o liczbie unikalnych widzów w ciągu 30 dni. Pamiętaj, że wymiar month odnosi się do miesięcy kalendarzowych, a wymiar 30DayTotals oblicza okresy 30-dniowe na podstawie określonej daty rozpoczęcia i zakończenia.

27 czerwca 2019 r.

Ta aktualizacja zawiera te zmiany związane z interfejsem API Statystyk YouTube (kierowane zapytania):

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

1 listopada 2018 r.

Ta aktualizacja zawiera te zmiany związane z interfejsem API Statystyk YouTube (kierowane zapytania):

  • Wersja 1 interfejsu API została wycofana. Jeśli jeszcze tego nie zrobiono, jak najszybciej zaktualizuj klientów interfejsu API, aby używali wersji 2 interfejsu API, aby zminimalizować przerwy w działaniu usługi. Więcej informacji znajdziesz w przewodniku po migracji.

    Pamiętaj, że harmonogram wycofania został ogłoszony 26 kwietnia 2018 roku.

17 września 2018 r.

Ta aktualizacja zawiera te zmiany związane z interfejsem API Statystyk YouTube (kierowane zapytania):

  • Nowa sekcja anonimizacji danych w dokumencie Model danych wyjaśnia, że niektóre dane w Statystykach YouTube są ograniczone, gdy wskaźniki nie przekraczają określonego progu. Może się tak zdarzyć w różnych przypadkach. W praktyce oznacza to, że raport może nie zawierać części danych lub być całkiem pusty, jeśli:

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

      lub

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

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

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

18 czerwca 2018 r.

Ta aktualizacja zawiera te zmiany w interfejsie API Statystyk YouTube (kierowane zapytania):

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

        zakres https://www.googleapis.com/auth/yt-analytics.readonly

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

23 maja 2018 r.

Ta aktualizacja zawiera te zmiany w interfejsie API Statystyk YouTube (kierowane zapytania):

  • Informacje ogólne o interfejsie API zawierają nową sekcję Łączne dane i usunięte elementy, która wyjaśnia, jak odpowiedzi interfejsu API obsługują dane powiązane z usuniętymi zasobami, takimi jak filmy, playlisty czy kanały.
  • Sekcja najlepszych praktyk w omówieniu interfejsu API została zaktualizowana, aby przypomnieć, że za pomocą interfejsu YouTube Data API możesz pobierać dodatkowe metadane dotyczące zasobów zidentyfikowanych w odpowiedziach interfejsu YouTube Analytics API. Zgodnie z zasadami dla deweloperów dotyczącymi usług YouTube API (sekcje III.E.4.b–III.E.4.d) po 30 dniach klienci interfejsu API muszą usunąć lub odświeżyć zapisane w tym interfejsie metadane zasobów.

22 maja 2018 r.

Ta aktualizacja zawiera te zmiany dotyczące interfejsu API do raportowania w YouTube (raporty zbiorcze):

  • Obecnie planujemy wprowadzić te zmiany w lipcu 2018 r. Nowe zasady będą obowiązywać na całym świecie w przypadku wszystkich raportów i zadań związanych z raportowaniem.

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

      Przed tym ogłoszeniem wszystkie raporty API były dostępne przez 180 dni od momentu ich wygenerowania. Gdy te zmiany wejdą w życie, raporty z danymi historycznymi starszymi niż 30 dni nie będą już dostępne za pomocą interfejsu API. Nie będzie też można uzyskać dostępu do innych raportów, które mają więcej niż 60 dni. W dokumentacji jest teraz podane, że raporty utworzone przed zmianą zasad będą dostępne przez maksymalnie 180 dni.

    • Po wprowadzeniu tej zmiany, gdy zaplanowasz zadanie generowania raportów, YouTube będzie generować raporty od tego dnia i obejmujące okres 30 dni poprzedzający zaplanowanie zadania. Przed wprowadzeniem tej zmiany, gdy zaplanowasz zadanie generowania raportów, YouTube będzie generować raporty obejmujące okres 180 dni poprzedzających zaplanowanie zadania.

  • Sekcja sprawdzonych metod została zaktualizowana, aby przypomnieć, że możesz użyć interfejsu YouTube Data API, aby pobrać dodatkowe metadane dotyczące zasobów zidentyfikowanych w raportach. Zgodnie z zasadami dla deweloperów dotyczącymi usług YouTube API (sekcje III.E.4.b–III.E.4.d) po 30 dniach klienci interfejsu API muszą usunąć lub odświeżyć zapisane w tym interfejsie metadane zasobów.

  • Sekcja Charakterystyka raportu została zaktualizowana. Chociaż dane w raportach nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. lub później nie będą zawierać żadnych odwołań do zasobów w YouTube, które zostały usunięte co najmniej 30 dni przed wygenerowaniem raportu.

  • W sekcji dane historyczne w omówieniu interfejsu API uwzględniliśmy informację, że po zaplanowaniu nowego zadania związanego z raportowaniem raporty historyczne są zwykle publikowane w ciągu kilku dni. Wcześniej w dokumentacji podano, że może to potrwać do 30 dni.

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

26 kwietnia 2018 r.

Interfejs API Statystyk YouTube (kierowane zapytania) w wersji 2 jest teraz publicznie dostępny. Poniżej znajdziesz listę zmian w usługach i dokumentacji związanych z nową wersją interfejsu API:

  • Interfejs API w wersji 2 jest prawie identyczny z interfejsem API w wersji 1. Prawdopodobnie jednak trzeba będzie zaktualizować kod, aby odzwierciedlić zmiany wymienione poniżej. Wszystkie te zmiany są szczegółowo opisane w nowym przewodniku po migracji.

    • Wersja interfejsu API zmieniła się z v1 na v2.
    • Adres URL podstawowy dla żądań interfejsu API zmienił się z https://www.googleapis.com/youtube/analytics/v1 na https://youtubeanalytics.googleapis.com/v2.
    • Zmieniliśmy nazwy kilku parametrów metody reports.query. W szczególności nazwy parametrów, które zawierają łączniki, np. end-date w interfejsie API w wersji 1, w interfejsie API w wersji 2 są zapisane w sposób odwrócony (endDate), a nie z łącznikami. Ta zmiana sprawia, że nazwy parametrów są spójne w całym interfejsie API, ponieważ metody interfejsu API służące do tworzenia i zarządzania grupami używały już nazewnictwa w stylu „camel case” w nazwach parametrów.
    • Interfejs API w wersji 2 nie obsługuje żądań zbiorczych wysyłanych do globalnego punktu końcowego zbiorczego HTTP Google (www.googleapis.com/batch). Jeśli wysyłasz żądania zbiorcze w interfejsie API w wersji 2, musisz użyć punktu końcowego https://youtubeanalytics.googleapis.com/v2.

    Ponadto w interfejsie API w wersji 2 nie są obsługiwane niektóre funkcje w wersji 1:

    • Metoda reports.query nie obsługuje już parametrów żądań alt, quotaUser i userIp.
    • Interfejs API w wersji 2 nie udostępnia punktu końcowego zbiorczego, który obsługuje zbiorcze żądania do różnych interfejsów API. (żądania zbiorcze mogą jednak zawierać żądania różnych metod tego samego interfejsu API). Ta wycofana funkcja nie dotyczy tylko interfejsu YouTube Analytics API, ponieważ wycofujemy globalny punkt końcowy operacji grupowych we wszystkich interfejsach API.
    • Interfejs API w wersji 2 nie obsługuje protokołu JSON-RPC, który był obsługiwany w wersji 1. Ponownie przypominamy, że wycofanie nie dotyczy tylko interfejsu YouTube Analytics API.

  • Uwaga: to jest ogłoszenie o wycofaniu.

    Wersja 1 interfejsu API (v1) została wycofana i będzie obsługiwana do 31 października 2018 r. Po tej dacie wszystkie żądania wysyłane do interfejsu API w wersji 1 przestaną działać. Dlatego do 31 października 2018 r. musisz przejść na interfejs API w wersji 2, aby uniknąć przerw w dostępie do danych z YouTube Analytics przez interfejs API.

21 lutego 2018 r.

Ta aktualizacja zawiera te zmiany w interfejsie API Statystyk YouTube (kierowane zapytania):

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

18 stycznia 2018 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

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

  • YouTube Analytics API (kierowane zapytania)

20 grudnia 2017 r.

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

  • Serwer interfejsu API obsługuje teraz kompresję gzip w przypadku żądań, które pobierają raporty. Pamiętaj, że kompresja gzip nie jest obsługiwana w przypadku innych typów żądań interfejsu API. Włączenie kompresji gzip zmniejsza przepustowość potrzebną do obsługi każdej odpowiedzi interfejsu API. Chociaż aplikacja będzie potrzebować dodatkowego czasu procesora na dekompresję odpowiedzi interfejsu API, korzyści płynące z obniżenia zużycia zasobów sieciowych zwykle przewyższają te koszty.

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

    Accept-Encoding: gzip

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

  • Dokumentacja wymiarów age group i gender została poprawiona, aby zawierać rzeczywiste wartości zwracane przez interfejs API. Pamiętaj, że jest to poprawka w dokumentacji i nie odzwierciedla zmiany w funkcjach ani zachowaniu interfejsu API. W szczególności zmieniły się te wartości:

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

10 sierpnia 2017 r.

10 sierpnia 2016 r. w tej dokumentacji ogłosiliśmy wycofanie wskaźnika earnings w interfejsie YouTube Analytics API. (W tym samym czasie dodano do interfejsu API obsługę nowych 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. Po upływie roku dane earnings nie są już obsługiwane. W rezultacie żądania interfejsu API, które określają dane earnings, zwracają teraz kod odpowiedzi HTTP 400. Jeśli nie zaktualizowałeś(-aś) jeszcze aplikacji, aby używała metadanych estimatedRevenue zamiast earnings, zrób to jak najszybciej.

Dokumentacja interfejsu API została zaktualizowana w celu usunięcia pozostałych odwołań do metryki earnings.

6 lipca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • YouTube Analytics API (kierowane zapytania)

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

      Jeśli na przykład żądanie określa datę zakończenia 5 lipca 2017 r., a wartości wszystkich wskaźników są dostępne tylko do 3 lipca 2017 r., to właśnie ta data będzie ostatnią, dla której dane zostaną uwzględnione w odpowiedzi. (dotyczy to nawet sytuacji, gdy dane dotyczące niektórych wskaźników są dostępne 4 lipca 2017 r.).

    • Wymiar adType obsługuje teraz wartość reservedBumperInstream, która odnosi się do reklamy wideo niemożliwej do pominięcia o długości do 6 sekund, która wyświetla się przed odtworzeniem filmu. Format reklamy jest identyczny jak w przypadku reklamy auctionBumperInstream, ale ten typ odnosi się do reklam sprzedawanych na podstawie rezerwacji, a nie aukcji.

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

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

    • Usunięto zadania generowania raportów dotyczących tych raportów interfejsu API do raportowania YouTube:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Te typy raportów zostały wycofane 15 września 2016 r., a po 15 grudnia 2016 r. nie są już generowane. Wygenerowane wcześniej raporty były dostępne przez 180 dni od momentu ich wygenerowania. Niektóre raporty były dostępne dopiero 15 czerwca 2017 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z nimi są niepotrzebne.

24 maja 2017 r.

Usunięto wszystkie zadania raportowania dotyczące tych raportów interfejsu API do raportowania YouTube:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Te typy raportów zostały wycofane 22 czerwca 2016 r., a po 22 września 2016 r. nie były już generowane. Wygenerowane wcześniej raporty były dostępne przez 180 dni od momentu ich wygenerowania. Niektóre raporty były dostępne dopiero 22 marca 2017 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z nimi są niepotrzebne.

22 maja 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

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

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

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

  • YouTube Analytics API (kierowane zapytania)

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

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 marca 2017 r.

Właściciele kanałów, którzy mają dostęp do danych o przychodach w Statystykach YouTube w Studio Twórcy, mogą teraz korzystać z tych danych za pomocą interfejsu YouTube Analytics API:

17 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

3 marca 2017 r.

Ta aktualizacja zawiera następujące zmiany:

  • Interfejs API YouTube do raportowania (raporty zbiorcze)

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

      Chociaż daty zwykle oznaczają 24-godzinny okres, daty, w których zegary są przestawiane do przodu, oznaczają 23-godzinny okres, a te, w których zegary są przestawiane do tyłu, oznaczają 25-godzinny okres. (wcześniej w dokumentacji było napisane, że każda data oznacza unikalny okres 24-godzinny, a czas pacyficzny to zawsze UTC-8).

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

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

    • Wszystkie zadania raportowania dotyczące typu raportu content_owner_basic_a1 zostały usunięte. Ten typ raportu został całkowicie wycofany 19 sierpnia 2016 r., ale wcześniej wygenerowane raporty content_owner_basic_a1 były nadal dostępne przez 180 dni od momentu ich wygenerowania. Niektóre raporty były dostępne dopiero 19 lutego 2017 r. Ponieważ jednak raporty nie są już dostępne, zadania powiązane z nimi są niepotrzebne.

  • YouTube Analytics API (kierowane zapytania)

    • W opisie wymiarów powiązanych z wartością time periods uwzględniono poprawkę, która informuje, że wartość wymiaru odnosi się do okresu rozpoczynającego się o 00:00 czasu pacyficznego i kończącego się o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny to UTC-7 lub UTC-8.

      Chociaż daty zwykle oznaczają 24-godzinny okres, daty, w których zegary są przestawiane do przodu, oznaczają 23-godzinny okres, a te, w których zegary są przestawiane do tyłu, oznaczają 25-godzinny okres. (Wcześniej w dokumentacji podano, że czas pacyficzny to UTC-8 i nie wspomniano o możliwości, że dzień może nie obejmować 24 godzin).

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

    • Dokumentacja dotycząca raportów o kanałach została zaktualizowana. Obecnie raporty o kanałach nie zawierają danych o zarobkach ani o skuteczności reklam. W efekcie zakres https://www.googleapis.com/auth/yt-analytics-monetary.readonly nie zapewnia obecnie dostępu do danych finansowych w raportach dotyczących kanału.

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

8 lutego 2017 r.

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

Parametr pozwala właścicielowi treści wskazać, że odpowiedź interfejsu API powinna zawierać dane dotyczące czasu oglądania i oglądalności kanałów z okresu, w którym nie były one jeszcze powiązane z właścicielem treści. Domyślna wartość parametru to false, co oznacza, że domyślnie odpowiedź interfejsu API zawiera tylko dane dotyczące czasu oglądania i liczba wyświetleń od momentu powiązania kanałów z właścicielem treści.

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

  • Jeśli wartość parametru to false, dane dotyczące czasu oglądania i liczba wyświetleń zwracane dla dowolnego kanału są oparte na dacie powiązania tego kanału z właścicielem treści.

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

15 grudnia 2016 r.

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

Zaktualizowano też listę obecnych 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 3 nowe raporty ekranu końcowego oraz nowe wymiary i dane do tych raportów. Raporty zawierają statystyki wyświetleń i klikalności ekranów końcowych, które pojawiają się po zakończeniu odtwarzania filmu.

    8 listopada 2016 r.

    Ta aktualizacja zawiera te zmiany w interfejsie YouTube Analytics API:

    • Dane na tej liście są całkowicie wycofane i nie są już obsługiwane. Zgodnie z ogłoszeniem z 10 sierpnia 2016 r. nowe dane odnoszące się do tych samych informacji są już obsługiwane. Tabela poniżej zawiera wycofaną nazwę danych i nową nazwę danych:

      Wycofany rodzaj danych Nowy wskaźnik
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 października 2016 r.

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

    Omówienie raportów zarządzanych przez system zawiera krótkie omówienie nowych raportów i wyjaśnia proces ich pobierania za pomocą interfejsu API. Ten proces różni się nieco od procesu pobierania raportów zbiorczych w Statystykach YouTube, ponieważ partnerzy nie muszą planować zadań służących do generowania raportów.

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

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

    27 września 2016 r.

    Uwaga: to jest ogłoszenie o wycofaniu.

    Wskaźnik uniques w interfejsie API YouTube Analytics został wycofany. Te dane nie są podstawowymi danymi i będą obsługiwane do 31 października 2016 r.

    15 września 2016 r.

    Ta aktualizacja zawiera te zmiany w interfejsie YouTube Reporting API:

    19 sierpnia 2016 r.

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

    • 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ą nadal dostępne przez 180 dni od momentu ich wygenerowania.

      Zastępczym raportem dla raportu content_owner_basic_a1 jest raport content_owner_basic_a2, jak wyjaśniono w historii zmian z 19 maja 2016 roku.

    11 sierpnia 2016 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowo opublikowane Warunki korzystania z usług interfejsu API YouTube („Zaktualizowane warunki”) omówione szczegółowo na blogu zespołu inżynierów i programistów YouTube zawierają wiele zmian w stosunku do dotychczasowych Warunków korzystania z usługi. Oprócz zaktualizowanych Warunków, które wejdą w życie 10 lutego 2017 r., aktualizacja zawiera kilka dokumentów pomocniczych wyjaśniających zasady, których muszą przestrzegać deweloperzy.

      Pełny zestaw nowych dokumentów jest opisany w historii zmian zaktualizowanych Warunków. Ponadto w tej historii zmian będą też opisane przyszłe zmiany Zaktualizowanych Warunków lub dokumentów pomocniczych. Możesz zasubskrybować kanał RSS, który zawiera listę zmian w tej historii zmian, z poziomu linku w tym dokumencie.

    10 sierpnia 2016 r.

    Ta aktualizacja zawiera te zmiany:

    • YouTube Analytics API (kierowane zapytania)

      • Uwaga: to jest ogłoszenie o wycofaniu.

        Dane w tabeli poniżej są wycofywane. Wprowadziliśmy też nowe dane odnoszące się do tych samych informacji. Oznacza to, że stare dane są przemianowane, ale interfejs YouTube Analytics API będzie obsługiwać obie nazwy danych 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 danymi podstawowymi, więc będą obsługiwane przez rok od daty tego ogłoszenia. Pozostałe dane, które nie były podstawowymi danymi, będą obsługiwane przez 3 miesiące, czyli do 4 listopada 2016 r.

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

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

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

      • Wymiar adType obsługuje teraz wartość auctionBumperInstream, która odnosi się do reklamy wideo niemożliwej do pominięcia o długości do 6 sekund, która wyświetla się przed odtworzeniem filmu.

    • Interfejs API YouTube do raportowania (raporty zbiorcze)

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

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

      • Lista podstawowych danych w interfejsie API została poprawiona tak, aby zawierała estimated_partner_revenue jako podstawowe dane, a z niej usunięto earnings. (dane earnings nigdy nie były obsługiwane w interfejsie YouTube Reporting API).

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

    18 lipca 2016 r.

    Ta aktualizacja zawiera te zmiany:

    • YouTube Analytics API (kierowane zapytania)

      • Listy obsługiwanych danych w tych raportach o kanałach zostały zaktualizowane, aby uwzględniały dane na karcie. Obsługa danych kart w tych raportach została dodana 28 czerwca 2016 r., a w historii zmian na ten dzień znajdziesz więcej informacji o tej zmianie. Raporty:
        • Podstawowa aktywność użytkowników w stanach USA
        • Aktywność użytkowników w stanach USA w określonych przedziałach czasu
        • Aktywność użytkowników według województwa
        • Aktywność użytkowników według stanu subskrypcji
        • Aktywność użytkowników według stanu subskrypcji w poszczególnych prowincjach
        • Najpopularniejsze filmy według stanu
        • Najpopularniejsze filmy wśród subskrybentów i osób, które anulowały subskrypcję

      • Listy filtrów zostały poprawione w przypadku raportów dotyczących retencji odbiorców na kanale i raportów dotyczących retencji odbiorców właściciela treści, aby odzwierciedlały one wymagany filtr video i nieobsługiwany filtr group.

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

    • Interfejs API YouTube do raportowania (raporty zbiorcze)

      • W sekcji Przegląd interfejsu API, która wyjaśnia, jak pobrać adres URL do pobrania raportu, poprawiliśmy informacje. Wprowadziliśmy poprawkę, aby wskazać, że YouTube generuje raporty do pobrania także za te dni, w które nie było dostępnych żadnych danych. Te raporty zawierają wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji Charakterystyka raportu w tym samym dokumencie 12 kwietnia 2016 r..
      • Lista wymiarów w raporcie content_owner_asset_cards_a1 została poprawiona, aby odzwierciedlała fakt, że raport używa wymiaru card_id. Wcześniej w dokumentacji nazwa wymiaru była nieprawidłowo podana jako card_title.

    28 czerwca 2016 r.

    Dokumentacja interfejsu YouTube Analytics API została zaktualizowana, aby odzwierciedlić obsługę danych na karcie w wielu raportach dotyczących kanału i właściciela treści. Nowo obsługiwane dane to:

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

    22 czerwca 2016 r.

    Ta aktualizacja zawiera następujące zmiany w interfejsie YouTube Reporting API: Pierwsza zmiana dotyczy interfejsu API w ogóle, a pozostałe dotyczą tylko raportów właścicieli treści:

    • Sekcja Charakterystyka raportów w omówieniu interfejsu API została zaktualizowana, aby wyjaśnić, że raporty są dostępne przez 180 dni od momentu ich wygenerowania.

      Wcześniej w dokumentacji było podawane, że raporty są dostępne przez okres do 180 dni przed datą wysłania żądania interfejsu API. Chociaż technicznie rzecz biorąc jest to prawda, pierwotny tekst był w najlepszym razie raczej mylący.

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

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

      • Zmieniono nazwy 2 raportów, które mają nowe wersje:

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

        Oba nowo przemianowane raporty różnią się od swoich poprzedników w następujący sposób:

      Jeśli masz już zadania służące do tworzenia starszych wersji tych raportów, musisz utworzyć nowe zadania dla przemianowanych raportów. Wraz z wydaniem nowych wersji raportów raporty content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 i content_owner_asset_estimated_earnings_a1 zostały wycofane.

      Jeśli masz zadania związane z którymkolwiek z tych raportów, nie spodziewaj się, że YouTube będzie generować nowe raporty dotyczące tych zadań po 22 września 2016 r. 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 obecny zestaw dostępnych raportów.

    • W dokumentacji poprawiono nazwy 2 rodzajów danych, aby odpowiadały nazwom widocznym w raportach. Jest to wyłącznie poprawka dokumentacji i nie odzwierciedla zmiany w rzeczywistej treści raportu:

      • Nazwa rodzaju danych estimated_partner_adsense_revenue została zmieniona na estimated_partner_ad_sense_revenue. Pamiętaj jednak, że te dane są dostępne tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych raportów nazwa tego rodzaju danych została zmieniona na estimated_partner_ad_auction_revenue.
      • Nazwa rodzaju danych estimated_partner_doubleclick_revenue została zmieniona na estimated_partner_double_click_revenue. Pamiętaj, że te dane są dostępne tylko w 2 raportach, które są wycofywane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych raportów nazwa tego rodzaju danych została zmieniona na estimated_partner_ad_reserved_revenue.

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

    19 maja 2016 r.

    Ta aktualizacja zawiera te zmiany w interfejsie YouTube Reporting API:

    • Interfejs API obsługuje nową wersję raportu o aktywności użytkownika dla właścicieli treści. Identyfikator typu nowego raportu 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 polegające na tworzeniu raportu content_owner_basic_a1, musisz utworzyć nowe zadanie dla raportu content_owner_basic_a2. YouTube nie przenosi automatycznie właścicieli treści do nowej wersji raportu ani nie tworzy automatycznie zadania służącego do wygenerowania nowej wersji raportu. W niektórych implementacjach pojawienie się nowego, nieoczekiwanego zadania może być zmianą powodującą przerwanie działania.

      Wraz z wprowadzeniem nowego raportu raport content_owner_basic_a1 został wycofany. Jeśli masz zadanie związane z tym raportem, nie oczekuj, że YouTube będzie generować nowe raporty po 19 sierpnia 2016 r. 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 reprezentuje wycofany typ raportu:

      • Właściwość deprecateTime zasobu reportType określa datę i godzinę, od której dany typ raportu zostanie wycofany. Ta właściwość ma wartość tylko w przypadku raportów, które zostały ogłoszone jako wycofane. Wartość ta wskazuje datę, od której YouTube przestanie generować raporty tego typu.

        Po ogłoszeniu wycofania danego typu zgłoszenia YouTube będzie generować raporty tego typu przez kolejne 3 miesiące. Na przykład ta aktualizacja z 19 maja 2016 r. informuje o wycofaniu raportu content_owner_basic_a1. W związku z tym deprecateTime dla tego typu raportu wskazuje czas 19 sierpnia 2016 r., po którym YouTube przestanie generować raporty tego typu.

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

      • Właściwość jobExpireTime zasobu report określa datę i godzinę, w której zadanie powiązane z raportami wygasa lub wygaśnie. Ta właściwość zawiera tę samą wartość co właściwość expireTime w zasobie job, jak opisano w poprzednim punkcie tej listy.

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

    12 kwietnia 2016 r.

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

    • YouTube generuje teraz dane obejmujące okres 180 dni poprzedzający zaplanowanie zadania raportowania. Wcześniej interfejs Reporting API nie dostarczał żadnych danych historycznych. Ta zmiana dotyczy wszystkich zadań, w tym tych utworzonych przed publikacją tego ogłoszenia.

      Raporty historyczne są publikowane od razu, gdy tylko są dostępne, ale opublikowanie wszystkich danych historycznych dotyczących zadania zajmuje około miesiąca. Po miesiącu od zaplanowania zadania związanego z generowaniem raportów będziesz mieć dostęp do danych z około 7 miesięcy. (wszystkie historyczne dane dotyczące zadań utworzonych przed tym ogłoszeniem powinny zostać opublikowane w ciągu miesiąca od ogłoszenia).

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

      Więcej informacji o tych zmianach znajdziesz w nowej sekcji Dane historyczne w omówieniu interfejsu Reporting API.

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

      • Dokumentacja zawiera teraz informację, że raporty są dostępne przez 180 dni od momentu ich wygenerowania, a dlatego klienci interfejsu API mogą je pobierać. Wcześniej w dokumentacji było podane, że raporty są dostępne przez okres do 6 miesięcy przed datą wysłania żądania interfejsu API.

      • Dokumentacja została zaktualizowana, aby odzwierciedlić fakt, że interfejs API generuje teraz raporty do pobrania za dni, w które nie było dostępnych żadnych danych. Te raporty będą zawierać nagłówki, ale nie będą zawierać dodatkowych danych.

    • Interfejs YouTube Reporting API wkrótce będzie obsługiwać zestaw automatycznie generowanych raportów zarządzanych przez system, które zawierają dane o przychodach z reklam lub przychodach z subskrypcji YouTube Red. Raporty będą dostępne dla właścicieli treści, którzy mogą już ręcznie pobierać raporty o przychodach w Studio Twórców w YouTube. Nowa funkcja interfejsu API zapewni dostęp do tych danych w sposób zautomatyzowany.

      W ramach przygotowań do wprowadzenia raportów zarządzanych przez system ogłaszamy te zmiany w interfejsie API:

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

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

      • Nowy parametr startTimeAtOrAfter metody jobs.reports.list wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty, jeśli najstarsze dane w raporcie są z określonej daty lub później. Podobnie parametr startTimeBefore wskazuje, że odpowiedź interfejsu API powinna zawierać tylko raporty, jeśli najstarsze dane w raporcie są wcześniejsze niż podana data.

        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. Wartość domyślna tego parametru to false.

    28 marca 2016 r.

    Interfejsy API YouTube do raportowania i YouTube Analytics zwracają teraz statystyki wyświetleń dotyczące 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: Android Messenger
    • W interfejsie YouTube Analytics API wymiar sharingService obsługuje te nowe wartości:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Skrzynka odbiorcza Google
      • IOS_SYSTEM_ACTIVITY_DIALOG: okno aktywności systemu iOS

    16 marca 2016 r.

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

    Interfejs API YouTube do raportowania

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

    YouTube Analytics API

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

    8 lutego 2016 r.

    Lista danych obsługiwanych przez interfejs YouTube Analytics API została zaktualizowana, tak aby dane kart nie były już wyświetlane jako obsługiwane dane w tym interfejsie. Żaden z raportów tego interfejsu API nie obsługuje żadnych danych na karcie.

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

    6 stycznia 2016 r.

    Interfejsy API YouTube do raportowania i YouTube Analytics API teraz dokładniej identyfikują wyświetlenia, które nastąpiły za pomocą urządzenia Chromecast.

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

    21 grudnia 2015 r.

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

    18 grudnia 2015 r.

    Przepisy Unii Europejskiej (UE) wymagają, aby użytkownicy w UE byli informowani o określonych kwestiach i aby uzyskać od nich zgodę. W przypadku użytkowników z Unii Europejskiej musisz przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy powiadomienie o tym wymaganiu w Warunkach korzystania z interfejsu API YouTube.

    15 grudnia 2015 r.

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

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

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

      Dokumentacja została zaktualizowana, aby uwzględnić nowe raporty dotyczące szczegółów odtwarzania, które są dostępne dla kanałów i właścicieli treści. Ponadto w wielu innych raportach uwzględniliśmy informację, że w tych raportach co najmniej 1 z tych wymiarów może być opcjonalnie używany jako wymiar lub filtr.

    • Zmieniliśmy format tabel, które opisują raporty, aby ułatwić Ci identyfikowanie prawidłowych kombinacji wymiarów, danych i filtrów, których można używać do pobierania poszczególnych raportów. Tabela poniżej, która wyjaśnia raport „Typ urządzenia” dotyczący kanałów, przedstawia nowy format:

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

      Terminologia dotycząca pól wymaganych i opcjonalnych jest wyjaśniona w dokumentacji dotyczącej raportów kanału i właściciela treści.

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

      Załóżmy na przykład, że użytkownik przesyła żądanie interfejsu API, w którym filtr video zawiera 20 identyfikatorów filmów. Użytkownik jest właścicielem 18 filmów. Jeden identyfikator wskazuje film należący do innego kanału, a inny – film, który został usunięty i nie istnieje. W takim przypadku zamiast zwracać błąd serwer interfejsu API odrzuca 2 filmy, do których użytkownik nie ma dostępu, a odpowiedź interfejsu API zawiera dane o 18 filmach, które należą do użytkownika interfejsu API.

    • Jeśli zażądasz danych z pustego interfejsu API Statystyk YouTube group, zamiast błędu otrzymasz pusty zbiór danych.

    • Metoda groupItems.insert interfejsu API YouTube Analytics 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 pozwalał na dodanie elementu do grupy, ale później zwracał błąd nieautoryzowany podczas próby pobrania danych raportu dotyczących tej grupy.

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

    10 listopada 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    29 października 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokumentacja wymiaru date interfejsu YouTube Reporting API została poprawiona, aby odzwierciedlała fakt, że daty odnoszą się do 24-godzinnego okresu rozpoczynającego się o 12:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji podano, że data rozpoczęła się o 00:00 (GMT).

      Ponadto w dokumentacji interfejsu API Statystyk YouTube dodano informację, że wszystkie wymiary związane z datami (day, 7DayTotals, 30DayTotals i month) odnoszą się do dat począwszy od godziny 12: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 odpowiedź interfejsu API powinna zawierać tylko raporty utworzone po podanej dacie i godzinie, w tym nowe raporty z uzupełnionymi danymi. Pamiętaj, że wartość parametru dotyczy czasu utworzenia raportu, a nie dat powiązanych z zwróconymi danymi.

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

      Zaktualizowaliśmy też sprawdzone metody dotyczące interfejsu YouTube Reporting API, aby wyjaśnić, jak za pomocą parametru createdAfter 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 wskazać, że wartości właściwości są dokładne do mikrosekund, a nie nanosekund. Ponadto wszystkie definicje odzwierciedlają teraz, że wartość właściwości to sygnatura czasowa.

    8 października 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

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

      Zaktualizowano też definicję wymiaru sharing_service w usłudze YouTube Reporting API, aby uwzględnić nowe obsługiwane wartości. Wartości typu enum, które są większe niż 59, są nowymi wartościami na liście.

    24 września 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

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

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

      Za pomocą interfejsu API możesz zaplanować zadania generowania raportów, z których każde określa raport, który YouTube powinien wygenerować. Gdy skonfigurujesz zadanie, YouTube będzie generować codzienny raport, który można pobrać asynchronicznie. Każdy raport zawiera dane z okresu 24 godzin.

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

      • Karta Przewodniki w dokumentacji zawiera informacje wspólne dla obu interfejsów API, w tym instrukcje autoryzacji żądań interfejsu API.
      • Karta Raporty zbiorcze zawiera dokumentację referencyjną i inne treści dotyczące interfejsu YouTube Reporting API.
      • Karta Kierowane zapytania zawiera dokumentację referencyjną i inne treści dotyczące interfejsu YouTube Analytics API.
      • Na karcie Przykłady znajdziesz przykłady kodu dostępne dla obu interfejsów API.
      • Na karcie Narzędzia znajdują się dodatkowe zasoby, które ułatwiają deweloperom implementację obu interfejsów API.

    20 sierpnia 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokumentacja interfejsu API została przebudowana, aby ułatwić jej zrozumienie. Zmiany te nie dotyczą nowych funkcji:

      • Dokumentacja zawiera teraz jedną stronę z listą wszystkich dostępnych raportów o kanałach i drugą z listą wszystkich dostępnych raportów właściciela treści. Wcześniej dokumentacja zawierała osobne strony dla raportów dotyczących filmów na kanale, raportów dotyczących playlist na kanale itp.

      • Nowy omówienie modelu danych ma na celu ułatwienie zrozumienia działania interfejsu API. W tym dokumencie staramy się dokładniej wyjaśnić, jak YouTube używa danych, wymiarów i filtrów do obliczania wartości raportów.

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

    22 lipca 2015 r.

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

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

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

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

    • Oprócz nieobsługiwanych już danych primaryAdGrossRevenue raporty o skuteczności reklam nie obsługują już danych monetizedPlaybacks i playbackBasedCpm. Nadal jednak niektóre raporty dotyczące filmów obsługują te dane.

    1 czerwca 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

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

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

      Oba te dane obejmują playlisty domyślne, takie jak „Do obejrzenia”. Nie uwzględniają jednak playlist, do których filmy są automatycznie dodawane, takich jak playlista przesłanych filmów na kanale lub historia odtwarzania użytkownika. Pamiętaj też, że te dane odzwierciedlają bezwzględną liczbę dodanych i usuniętych elementów. Jeśli więc użytkownik doda film do playlisty, a następnie usunie go i doda ponownie, dane pokazują, że film został dodany do 2 playlist i usunięty z jednej z nich.

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

    31 marca 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    16 marca 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowy parametr currency umożliwia pobieranie danych o zarobkach w walucie innej niż dolar amerykański (USD). Jeśli parametr jest ustawiony, interfejs API konwertuje wartości danych earnings, grossRevenue, playbackBasedCpm i impressionBasedCpm do wybranej waluty. Zwracane wartości to szacunki obliczone na podstawie kursów wymiany, które zmieniają się codziennie.

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

    25 lutego 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API umożliwia teraz tworzenie grup w Statystykach YouTube i zarządzanie nimi, a także pobieranie danych raportów dotyczących tych grup.

      • Tworzenie grup i zarządzanie nimi

        W ramach tego uaktualnienia udostępniamy zasoby group i groupItem do tworzenia grup i zarządzania nimi.

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

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

      • Pobieranie danych raportu dotyczących grupy

        Dokumentacja wymiarów została zaktualizowana i zawiera wymiar group, który można używać jako filtra w wielu raportach kanałów i raportach właścicieli treści. Gdy użyjesz filtra group, interfejs API zwróci dane o wszystkich elementach w tej grupie. Pamiętaj, że interfejs API nie obsługuje obecnie tworzenia raportów dotyczących grup komponentów.

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

    13 lutego 2015 r.

    Ta aktualizacja zawiera następujące zmiany:

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

    28 sierpnia 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

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

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

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

    16 lipca 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Podczas pobierania raportu kanału możesz teraz pobierać dane z kanału uwierzytelnionego użytkownika, ustawiając wartość parametru ids na channel==MINE. (nadal możesz ustawić parametr ids na channel==CHANNEL_ID, aby pobrać dane z wybranego kanału).

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

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

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

      • playlistStarts: liczba rozpoczętych przez widzów odtworzeń playlisty.
      • viewsPerPlaylistStart: średnia liczba wyświetleń filmu, która wystąpiła po każdym uruchomieniu playlisty.
      • averageTimeInPlaylist: Szacowany średni czas w minutach, jaki widz poświęcił na oglądanie filmów z playlisty po jej uruchomieniu.

      W żądaniu pobrania raportu dotyczącego playlisty musi być użyty filtr isCurated, który musi być ustawiony na 1 (isCurated==1).

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

      • Wskaźnik audienceWatchRatio określa bezwzględny odsetek widzów oglądających film w danym momencie. Współczynnik ten jest obliczany na podstawie porównania liczby obejrzeń danego fragmentu filmu z łączną liczbą obejrzeń filmu.

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

      • Dane relativeRetentionPerformance pokazują, jak dobrze film utrzymuje uwagę widzów podczas odtwarzania w porównaniu z innymi filmami w YouTube o podobnej długości. Wartość 0 oznacza, że film przyciąga uwagę widzów gorzej niż inne filmy o podobnej długości, a wartość 1 – że przyciąga uwagę widzów lepiej niż inne filmy o podobnej długości. Wartość mediany równa 0,5 oznacza, że połowa filmów o podobnej długości lepiej utrzymuje uwagę widzów, a połowa gorzej.

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

    • Interfejs API obsługuje kilka nowych rodzajów danych związanych z adnotacjami. Dane wymienione poniżej można pobrać w dowolnych raportach, 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 dane dotyczące nowych rodzajów danych są dostępne od 16 lipca 2013 r. (dane dotyczące wskaźników annotationClickThroughRate i annotationCloseRate są dostępne od 10 czerwca 2012 r.).

    • Wartość GOOGLE_SEARCH nie jest już raportowana jako osobna wartość wymiaru insightTrafficSourceType. Odsyłacze z wyników wyszukiwania Google są teraz przypisywane do typu źródła wizyt EXT_URL. W efekcie nie można też pobrać raportu insightTrafficSourceDetail, który ma ustawiony filtr insightTrafficSourceType o wartości GOOGLE_SEARCH.

    31 stycznia 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

    16 stycznia 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokument przykładowych próśb został przeprojektowany, aby przykłady były grupowane według kategorii. Użyliśmy formatu kart, który jest podobny do tego, który niedawno udostępniliśmy w raportach dotyczących właścicieli kanałów i treści. W nowej wersji przykłady są podzielone na te kategorie:

      • Statystyki podstawowe
      • Zależne od czasu
      • Geografia
      • Miejsce odtwarzania
      • Źródło wizyt
      • Urządzenie/system operacyjny
      • Grupa demograficzna
      • Sieci społecznościowe
      • Zarobki/Reklamy (tylko w raportach dla właścicieli treści)

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

      • Dane dotyczące poszczególnych stanów w Stanach Zjednoczonych i Dystrykcie Kolumbii: Ten raport zawiera podział według prowincji liczby wyświetleń i innych statystyk filmów na kanale. Dane obejmują stany w USA i Waszyngton. Przykład używa wymiaru province oraz parametru filters, aby ograniczyć odpowiedź tylko do wyników z tego stanu.

      • Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć): ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy obejrzeli filmy z kanału lub, w przypadku raportów właścicieli treści, treści zgłoszone przez właściciela. W tym przykładzie użyto parametru filters, aby zapewnić, że odpowiedź będzie zawierać tylko dane dotyczące konkretnej prowincji.

    • Definicja wymiaru province została zaktualizowana, aby uwzględnić fakt, że gdy wartość parametru dimensions zawiera wartość province, to w prośbie należy też ograniczyć dane do Stanów Zjednoczonych, podając wartość country==US w parametrze filters.

    6 stycznia 2014 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Dokumenty zawierające listę obsługiwanych kanałów i raportów właścicieli treści zostały przeprojektowane. Zamiast tabeli z listą wszystkich możliwych raportów każdy dokument zamiast tego grupuje raporty według kategorii:

      • Statystyki podstawowe
      • Zależne od 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ę tych kategorii w postaci kart. Możesz kliknąć dowolną kartę, aby wyświetlić obsługiwane raporty w danej kategorii.

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

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

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

          • Raport z podstawowymi statystykami zawiera kilka statystyk, w tym liczbę wyświetleń i szacowaną liczbę obejrzanych minut.
          • Raport oparty na czasie zawiera te same statystyki, ale dane są w nim agregowane na podstawie okresów 1-, 7-, 30- lub 365-dniowych.

        • Parametrem zapytania filters możesz ograniczyć raport, aby zawierał tylko statystyki dotyczące konkretnego stanu. Tego typu filtrowanie obsługuje kilka raportów, w tym raporty geograficzne, raporty o lokalizacji odtwarzania, raporty o źródłach wizyt, raporty o urządzeniach, raporty o systemach operacyjnych, raporty demograficzne i raporty o najpopularniejszych filmach.

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

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

        Ponieważ każdy region podrzędny jest powiązany tylko z jednym kontynentem, nie musisz używać filtra continent, jeśli korzystasz z filtra subContinent. (w przeciwnym razie interfejs API zwróci błąd).

    • Dokumentacja została poprawiona, aby wymiar insightTrafficSourceDetail nie zawierał wartości insightTrafficSourceType PROMOTED jako prawidłowej wartości filtra.

    30 września 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API YouTube Analytics podlega teraz polityce wycofywania opisanej w Warunkach korzystania z usługi. Wymiary i dane niepodstawowe w interfejsie API nie podlegają jednak zasadom wycofywania. Strony Wymiary i Dane zostały zaktualizowane i zawierają listę podstawowych wymiarów i danych. Zaktualizowaliśmy też definicje na tych stronach, aby wyraźnie wskazywały one podstawowe wymiary i dane.

    • Interfejs API obsługuje teraz wartość EXTERNAL_APP jako wartość wymiaru insightPlaybackLocationType. W związku z tą zmianą od 10 września 2013 r. odtwarzanie nie jest już klasyfikowane jako odtwarzanie MOBILE, ale odtwarzanie na urządzeniach mobilnych, które miało miejsce przed tą datą, nadal będzie przypisane do tej wartości.

      W ramach tej aktualizacji odtwarzanie na urządzeniach mobilnych jest teraz klasyfikowane jako odtwarzanie WATCH, EMBEDDED lub EXTERNAL_APP w zależności od typu aplikacji, w której występuje.

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

    16 lipca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API umożliwia teraz sortowanie raportów według wielu wymiarów i danych. Dokument z przykładowymi żądaniami zawiera nowy przykład, sortowanie żądań według wielu wymiarów lub danych, który demonstruje tę funkcję. Żądanie pobiera dane o źródłach wizyt i ma parametr sort o wartości day,-views. Wyniki są sortowane chronologicznie, ale w przypadku każdego dnia pierwsza pozycja zawiera dane o źródle wizyty, które wygenerowało najwięcej wyświetleń, druga pozycja – dane o źródle, które wygenerowało drugą najwyższą liczbę wyświetleń, i tak dalej.

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

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

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

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

    • Dokument przykładowe prośby został zaktualizowany, aby zawierał 3 raporty dotyczące urządzeń dla kanałów i 3 raporty dotyczące urządzeń dla właścicieli treści.

    • Wymiar insightPlaybackLocationType może zwracać wartość YT_OTHER, która identyfikuje widoki, które nie zostały sklasyfikowane za pomocą żadnej z innych wartości tego wymiaru.

    23 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    10 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    6 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API umożliwia teraz pobieranie danych o czasie oglądania (estimatedMinutesWatched, averageViewDuration i averageViewPercentage) w połączeniu z innymi danymi, w tym danymi o oglądalności, zaangażowaniu, zarobkach i skuteczności reklam.

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

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

    • Raporty korzystające z wymiarów insightPlaybackLocationDetail i insightTrafficSourceDetail zostały ulepszone w następujący sposób:

      • Teraz obsługują one opcjonalny filtr country.

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

        • Szczegóły lokalizacji odtwarzania

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

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

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

    3 maja 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

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

    • Wymiar insightTrafficSourceType obsługuje teraz wartość SUBSCRIBER. Ta wartość identyfikuje wyświetlenia filmów, które zostały odtworzone z kanałów na stronie głównej YouTube lub z funkcji subskrypcji w YouTube. Jeśli zastosujesz filtrowanie na podstawie tego źródła wizyt, pole insightTrafficSourceDetail będzie wskazywać kanał strony głównej lub innej strony, z której pochodzą wyświetlenia.

    28 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    21 marca 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Interfejs API obsługuje teraz dane o dochodach i skuteczności reklam oraz nowe raporty o skuteczności reklam. Wszystkie dane i raporty są dostępne tylko dla partnerów treści YouTube, którzy uczestniczą w programie partnerskim YouTube.

      • Nowo obsługiwane raporty obsługują dane o skuteczności reklamy na podstawie odtworzeń i wyświetleń. Więcej informacji o raportach o skuteczności reklam znajdziesz w dokumentacji dotyczącej raportów dla właścicieli treści.

      • Poniżej znajdziesz listę nowo obsługiwanych danych. Lista raportów dla właścicieli treści została zaktualizowana, aby uwzględnić raporty, w tym 2 nowe, które obsługują te dane.

        • earnings – łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google.
        • grossRevenue – szacunkowe przychody brutto od partnerów Google lub DoubleClick.
        • primaryAdGrossRevenue – szacunkowy przychód brutto, zsumowany i sklasyfikowany według głównego typu reklamy w przypadku odtwarzań filmów objętych raportem, pochodzący od Google lub partnerów DoubleClick.
        • monetizedPlaybacks – liczba odtworzeń, w których przypadku wystąpiło co najmniej 1 wyświetlenie reklamy.
        • playbackBasedCpm – szacunkowe przychody brutto na tysiąc odtworzeń.
        • impressions – liczba zweryfikowanych zrealizowanych wyświetleń reklamy.
        • impressionBasedCpm – szacunkowy przychód brutto z tysiąca wyświetleń reklamy.

        Uwaga: aby uzyskać więcej informacji, zapoznaj się z definicjami danych.

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

    • Dokumentacja interfejsu API została uporządkowana, tak aby różne typy raportów były opisane na osobnych stronach. Dlatego teraz istnieją osobne strony wyjaśniające różne typy raportów dotyczących kanału i raportów właścicieli treści.

    4 lutego 2013 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Przewodnik referencyjny interfejsu API zawiera teraz sekcję przykładów, w której znajdziesz przykłady kodu pokazujące, jak wywoływać interfejs API za pomocą bibliotek klienta Java, JavaScript, Python i Ruby. Przykładowy kod JavaScript jest taki sam jak omówiony szczegółowo w dokumentacji aplikacji przykładowej.

    14 listopada 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

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

    • Interfejs API obsługuje wiele nowych raportów dotyczących zarówno kanałów, jak i właścicieli treści. Opisują je poniższe informacje. Każdy raport jest dostępny jako raport o kanale lub raport właściciela treści. Zmieniliśmy też strony Wymiary i Dane.

      • Raport o miejscach odtwarzania podaje liczbę wyświetleń filmu na różnych stronach lub w różnych aplikacjach.

      • Raport Szczegóły miejsca odtwarzania wskazuje wbudowane odtwarzacze, które wygenerowały najwięcej wyświetleń określonego filmu. Zapewnia on bardziej szczegółowy wgląd niż raport z lokalizacją odtwarzania, ponieważ identyfikuje adresy URL powiązane z najpopularniejszymi wbudowanymi odtwarzaczami.

      • Raport Źródło wizyty podaje liczbę wyświetleń filmów pochodzących z różnych źródeł odesłaniających.

      • Raport Szczegóły źródła wizyty zawiera informacje o odwołaniach, które wygenerowały najwięcej wyświetleń określonego filmu i określonego typu źródła wizyt. Ten raport może na przykład zawierać informacje o powiązanych filmach, które przyciągnęły najwięcej widzów do konkretnego filmu. Ten raport jest dostępny w przypadku kilku źródeł wizyt.

      • Raporty o czasie oglądania podają, ile czasu widzowie spędzili na oglądaniu Twoich treści. Raporty mogą agregować dane z określonego przedziału czasu (np. dnia, ostatnich 7 dni, ostatnich 30 dni) lub kraju. Jeśli raport agreguje dane według dnia lub kraju, może też podawać średnią długość każdego obejrzenia filmu oraz średni procentowy udział każdego filmu w łącznym czasie oglądania.

    2 października 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Funkcja YouTube Analytics API jest teraz dostępna dla wszystkich deweloperów. Możesz aktywować interfejs API w projekcie bez konieczności zgłaszania prośby o dostęp w panelu Usługi w APIs console.

    • Nowa sekcja Pierwsze kroki zawiera wymagania wstępne i podstawowe czynności związane z tworzeniem aplikacji korzystającej z YouTube Analytics API.

    12 września 2012 r.

    Ta aktualizacja zawiera następujące zmiany:

    • Nowa sekcja Poznanie wykorzystania limitu zawiera wskazówki dotyczące optymalizacji wykorzystania limitu interfejsu API. Serwer interfejsu API oblicza koszt zapytania dla każdego żądania, a ten koszt jest odliczany od limitu użycia interfejsu API. Ponieważ różne typy raportów mogą mieć bardzo różne koszty zapytań, musisz racjonalnie korzystać z limitu, a Twoja aplikacja powinna żądać tylko tych danych, których rzeczywiście potrzebuje.

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

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

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

    • Sekcja Wymiary podmiotu raportującego została zaktualizowana, aby uwzględnić informację, że żądania interfejsu API służące do pobierania raportów właścicieli treści muszą filtrować dane za pomocą jednego z tych wymiarów (video, channel lub show) albo za pomocą obsługiwanej kombinacji wymiarów claimedStatus i uploaderType.

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

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