Na tej stronie znajdują się informacje o zmianach w interfejsie API oraz aktualizacjach dokumentacji dotyczącej interfejsu YouTube Reporting API oraz YouTube Analytics API. Oba interfejsy API umożliwiają deweloperom dostęp do danych Statystyk YouTube, ale na różne sposoby. Zasubskrybuj ten dziennik zmian.
6 maja 2024 r.
Interfejs YouTube Analytics (Targeted Queries) API obsługuje 3 nowe raporty dotyczące kanałów:
-
Raport Aktywność użytkowników według DMA to raport geograficzny, który zawiera statystyki aktywności użytkowników z podziałem na rynki docelowe (DMA). Na potrzeby tego raportu ustaw wartość parametru
filters
nacountry==US
. -
Raport Transmisje równoległe pokazuje liczbę równoczesnych widzów różnych części pojedynczej transmisji na żywo.
-
Raport Anulowanie wspierania kanału zawiera statystyki pokazujące, dlaczego użytkownicy anulowali wspieranie kanału.
W tym raporcie używany jest nowy wymiar
membershipsCancellationSurveyReason
, który określa, dlaczego użytkownik anulował wspieranie kanału. Wykorzystuje też nowe danemembershipsCancellationSurveyResponses
, które wskazują, ile wspierania kanału zostało anulowane z tego powodu.
Oprócz tego raport Utrzymanie uwagi odbiorców został rozszerzony o 3 nowe rodzaje danych:
7 kwietnia 2024 r.
W interfejsie YouTube Analytics (Targeted Queries) API wprowadziliśmy kilka aktualizacji związanych z raportami dotyczącymi playlist przesłanych przez właścicieli treści. Są to te same aktualizacje dotyczące raportów o playlistach kanału, które ogłosiliśmy 19 stycznia 2024 r.
Poniższy wpis historii zmian zawiera prawie te same informacje co wpis z 19 stycznia 2024 r. Pamiętaj jednak, że w raportach dotyczących playlist przesłanych przez właścicieli treści będzie można używać wymiaru isCurated
do 31 grudnia 2024 r., a w przypadku raportów o playlistach kanału do 30 czerwca 2024 r.
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
W raportach o playlistach właścicieli treści wycofaliśmy wymiar
isCurated
. Przestanie być obsługiwana 31 grudnia 2024 r. lub później. Definicja tego wymiaru została odpowiednio zaktualizowana.Aby zachować zgodność wsteczną po usunięciu wymiaru
isCurated
, musisz też zaktualizować swój kod tak, aby pobierał daneplaylistViews
, a nie daneviews
tylko w przypadku raportów o playlistach. Daneviews
są nadal obsługiwane w raportach o playlistach, ale mają inne znaczenie, więc jeśli nie zaktualizujesz nazwy danych, interfejs API wciąż będzie zwracać dane. Oczywiście możesz zmodyfikować aplikację, aby pobierać i wyświetlać zarównoviews
, jak iplaylistViews
.Oprócz wymiaru
isCurated
w nowych raportach nie są już obsługiwane te funkcje interfejsu API:- Filtry lokalizacji, takie jak
continent
isubcontinent
, nie są obsługiwane w nowych raportach dotyczących playlist kanału. - Dane
redViews
iestimatedRedMinutesWatched
nie są już obsługiwane w nowych raportach dotyczących playlist kanału. Te dane nie były dostępne w YouTube Studio, dlatego zmiana pozwala dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio. - Wymiary
subscribedStatus
iyoutubeProduct
nie są już obsługiwane jako filtry w raportach o playlistach kanału. Te filtry nie były dostępne w YouTube Studio, dlatego zmiana pozwala dostosować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
- Filtry lokalizacji, takie jak
-
Sekcja Raporty o playlistach w dokumentacji raportów właścicieli treści została zaktualizowana, aby dokładniej wyjaśnić, jakie typy danych są obsługiwane w raportach o playlistach:
- Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach wyświetlane dla wszystkich filmów znajdujących się na playlistach właściciela treści, które również należą do tego właściciela treści. Zbiorcze dane o reklamach wideo są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru
isCurated
. - Dane dotyczące playlist odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Obejmują one też wyświetlenia filmów z playlisty nienależące do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
- Sekcja Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.
- Zbiorcze dane o filmach zawierają dane o aktywności użytkowników i wyświetleniach wyświetlane dla wszystkich filmów znajdujących się na playlistach właściciela treści, które również należą do tego właściciela treści. Zbiorcze dane o reklamach wideo są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru
-
W raportach dotyczących playlist dla właścicieli treści obsługiwane są poniższe nowe dane dotyczące treści na playliście. Pamiętaj, że te dane są obsługiwane tylko wtedy, gdy żądanie pobierania raportów do interfejsu API nie używa wymiaru
isCurated
. Definicje poszczególnych danych znajdziesz w dokumentacji metrics: -
Sposób działania danych
views
zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport o playlistie, użyło wymiaruisCurated
:- Jeśli żądanie zawiera wymiar
isCurated
, daneviews
to dane na playliście, które wskazują liczbę wyświetleń filmów w kontekście playlist właściciela treści. - Jeśli żądanie nie zawiera wymiaru
isCurated
, daneviews
to zagregowane dane o filmach, które określają łączną liczbę wyświetleń filmów z playlist właściciela treści, niezależnie od tego, czy miało to miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko wyświetlenia filmów, które należą do właściciela treści powiązanego z kanałem, do którego należy playlista.
W tych raportach, które nie korzystają z wymiaruisCurated
, daneplaylistViews
wskazują liczbę wyświetleń filmów w kontekście playlisty. Dane te zliczają wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.
- Jeśli żądanie zawiera wymiar
-
Dokumentacja raportów właścicieli treści w przypadku każdego raportu playlisty zawiera teraz tabele z danymi obsługiwanymi w przypadku każdego raportu zależnie od tego, czy żądanie do interfejsu API zawiera wymiar
isCurated
. Przykład znajdziesz w sekcji definiującej raporty o playlistach na osi czasu.
19 stycznia 2024 r.
W interfejsie YouTube Analytics (Targeted Queries) API wprowadziliśmy kilka aktualizacji związanych z raportami o playlistach kanału. Aktualizacje obejmują wycofany wymiar oraz kilka nowych i zaktualizowanych danych:
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
W raportach dotyczących kanałów wymiar
isCurated
został wycofany. Przestanie być obsługiwana 30 czerwca 2024 r. lub później. Definicja tego wymiaru została odpowiednio zaktualizowana.Aby zachować zgodność wsteczną po usunięciu wymiaru
isCurated
, musisz też zaktualizować swój kod tak, aby pobierał daneplaylistViews
, a nie daneviews
tylko w przypadku raportów o playlistach. Daneviews
są nadal obsługiwane w raportach o playlistach, ale mają inne znaczenie, więc jeśli nie zaktualizujesz nazwy danych, interfejs API wciąż będzie zwracać dane. Oczywiście możesz zmodyfikować aplikację, aby pobierać i wyświetlać zarównoviews
, jak iplaylistViews
.Oprócz wymiaru
isCurated
w nowych raportach nie są już obsługiwane te funkcje interfejsu API:- Filtry lokalizacji, takie jak
continent
isubcontinent
, nie są obsługiwane w nowych raportach dotyczących playlist kanału. - Dane
redViews
iestimatedRedMinutesWatched
nie są już obsługiwane w nowych raportach dotyczących playlist kanału. Te dane nie były dostępne w YouTube Studio, dlatego zmiana pozwala dopasować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio. - Wymiary
subscribedStatus
iyoutubeProduct
nie są już obsługiwane jako filtry w raportach o playlistach kanału. Te filtry nie były dostępne w YouTube Studio, dlatego zmiana pozwala dostosować funkcje interfejsu API do funkcji dostępnych w aplikacji Studio.
- Filtry lokalizacji, takie jak
-
Zaktualizowaliśmy sekcję Raporty dotyczące playlist w dokumentacji raportów kanału, aby dokładniej wyjaśnić, jakie typy danych są obsługiwane w raportach o playlistach:
- Zbiorcze dane o filmach to dane zbiorcze o aktywności użytkowników i wyświetleniach, które są przedstawiane dla wszystkich filmów na playlistach na kanale, które są również własnością tego kanału. Zbiorcze dane o reklamach wideo są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru
isCurated
. - Dane dotyczące playlist odzwierciedlają aktywność i zaangażowanie użytkowników w kontekście strony playlisty. Obejmują one też wyświetlenia filmów z playlisty nienależące do Ciebie, ale tylko wtedy, gdy te wyświetlenia miały miejsce w kontekście playlisty.
- Sekcja Obsługiwane dane dotyczące playlist zawiera zbiorcze dane o filmach i dane dotyczące playlist, które są obsługiwane w raportach dotyczących playlist.
- Zbiorcze dane o filmach to dane zbiorcze o aktywności użytkowników i wyświetleniach, które są przedstawiane dla wszystkich filmów na playlistach na kanale, które są również własnością tego kanału. Zbiorcze dane o reklamach wideo są obsługiwane tylko w przypadku żądań do interfejsu API, które nie używają wymiaru
-
W raportach dotyczących playlist kanałów są obsługiwane nowe dane dotyczące treści na playliście. Te dane nie są jeszcze obsługiwane w raportach właściciela treści. Pamiętaj, że te dane są obsługiwane tylko wtedy, gdy żądanie pobierania raportów do interfejsu API nie używa wymiaru
isCurated
. Definicje poszczególnych danych znajdziesz w dokumentacji metrics: -
Sposób działania danych
views
zależy teraz od tego, czy żądanie do interfejsu API, które pobrało raport o playlistie, użyło wymiaruisCurated
:- Jeśli żądanie zawiera wymiar
isCurated
, daneviews
to dane na playliście, które wskazują liczbę wyświetleń filmów w kontekście playlist na kanale. - Jeśli żądanie nie zawiera wymiaru
isCurated
, daneviews
to zagregowane dane o filmach, które określają łączną liczbę wyświetleń danego filmu z playlist na kanale, niezależnie od tego, czy miało to miejsce w kontekście playlisty. Łączna liczba wyświetleń obejmuje tylko wyświetlenia filmów, które są własnością kanału, który jest właścicielem playlisty.
W tych raportach, które nie korzystają z wymiaruisCurated
, daneplaylistViews
wskazują liczbę wyświetleń filmów w kontekście playlisty. Dane te zliczają wyświetlenia wszystkich filmów z playlisty, niezależnie od tego, do którego kanału należą.
- Jeśli żądanie zawiera wymiar
-
Dokumentacja raportów dotyczących kanałów w przypadku każdego raportu playlisty zawiera teraz tabele z danymi obsługiwanymi w przypadku tego raportu zależnie od tego, czy żądanie do interfejsu API zawiera wymiar
isCurated
. Przykład znajdziesz w sekcji definiującej raporty o playlistach na osi czasu.
4 grudnia 2023 r.
Zaktualizowaliśmy interfejs YouTube Analytics (Targeted Queries) API, by scalić 2 wartości wymiarów insightTrafficSourceType
. Wcześniej ten wymiar odróżniał filmy odtwarzane w ramach playlisty (PLAYLIST
) od wyświetleń pochodzących ze strony zawierającej wszystkie filmy z playlisty (YT_PLAYLIST_PAGE
). Od tej pory oba rodzaje wyświetleń będą powiązane z wartością wymiaru PLAYLIST
.
15 grudnia 2022 r.
Interfejs YouTube Analytics (docelowych zapytań) API obsługuje 2 nowe wymiary i 1 nowy raport:
-
Nowy raport przedstawia aktywność użytkowników według miasta. Ten raport jest dostępny dla kanałów i właścicieli treści. Ten raport zawiera nowy wymiar
city
, który określa szacunkowe przez YouTube miasto, w którym miała miejsce aktywność użytkownika. -
Nowy wymiar
creatorContentType
wskazuje typ treści w YouTube, który jest powiązany z danymi o aktywności użytkownika w wierszu danych. Obsługiwane wartości toLIVE_STREAM
,SHORTS
,STORY
iVIDEO_ON_DEMAND
.Wymiar
creatorContentType
jest obsługiwany jako wymiar opcjonalny we wszystkich raportach dotyczących filmów na kanałach i właścicielach treści. -
Przewodnik po przykładowych żądaniach w interfejsie YouTube Analytics API zawiera teraz przykłady obu nowych wymiarów.
-
Odniesienia do wymiarów
7DayTotals
i30DayTotals
zostały usunięte z dokumentacji. Wycofanie tych wymiarów ogłosiliśmy w październiku 2019 r.
26 sierpnia 2022 r.
Interfejs YouTube Analytics (Targeted Queries) API i YouTube Reporting (Bulk Reports) API obsługują nową wartość szczegółów źródła wizyt:
- Jeśli w interfejsie YouTube Analytics API (Targeted Zapytania) wartość wymiaru
insightTrafficSourceType
toSUBSCRIBER
, wartośćinsightTrafficSourceDetail
może być ustawiona napodcasts
, co oznacza, że ruch został przekierowany ze strony docelowej Podcastów. - Jeśli w interfejsie API YouTube do raportowania (raporty zbiorcze) wartość wymiaru
traffic_source_type
to3
, wartośćtraffic_source_detail
może być ustawiona napodcasts
, co oznacza, że ruch został przekierowany ze strony docelowej Podcastów.
11 lutego 2022 r.
11 sierpnia 2022 r. lub później zestaw prawidłowych wartości wymiaru gender
zmieni się. Może to być niekompatybilna wstecznie zmiana w Twojej implementacji interfejsu API. Zgodnie z sekcją Niezgodne zmiany w Warunkach korzystania z usług interfejsu API YouTube informujemy, że ta zmiana wejdzie w życie na 6 miesięcy przed jej wejściem w życie. Zaktualizuj implementację interfejsu API przed 11 sierpnia 2022 r., aby umożliwić płynne przejście na nowy zestaw wartości.
Konkretne wprowadzane zmiany:
- W interfejsie YouTube Analytics (Targeted Queries) API wymiar
gender
obsługuje obecnie 2 wartości:female
imale
. Od 11 sierpnia 2022 r. ten wymiar będzie obsługiwać 3 wartości:female
,male
iuser_specified
. - W interfejsie YouTube Reporting (Bulk Reports) API wymiar
gender
obsługuje obecnie 3 wartości:FEMALE
,MALE
iGENDER_OTHER
. 11 sierpnia 2022 r. lub później zestaw obsługiwanych wartości zmieni się naFEMALE
,MALE
iUSER_SPECIFIED
.
9 lutego 2022 r.
13 grudnia 2021 r. zaktualizowaliśmy 2 wskaźniki, aby wykluczały ruch generowany przez klipy zapętlone. Ta zmiana dotyczy zarówno YouTube Analytics (Targeted Queries) API, jak i YouTube Reporting (Bulk Reports) API.
- W interfejsie API YouTube Analytics (Targeted Zapytania) dane
averageViewDuration
iaverageViewPercentage
od 13 grudnia 2021 r. wykluczają ruch z klipów zapętlonych. - W interfejsie YouTube Reporting (Bulk Reports) API dane
average_view_duration_seconds
iaverage_view_duration_percentage
wykluczają ruch z klipów zapętlonych na dzień 13 grudnia 2021 r.
2 lutego 2022 r.
Ten interfejs YouTube Reporting (Bulk Reports) API obsługuje nową wartość wymiaru źródła wizyt, która wskazuje, że wyświetlenia pochodzą z Live Redirect:
- W interfejsie YouTube Reporting (Bulk Reports) API wymiar
traffic_source_type
obsługuje wartość28
.
W przypadku tego typu źródła wizyt wymiar traffic_source_detail
określa identyfikator kanału, z którego widz został odesłany.
23 września 2020 r.
Interfejs YouTube Analytics (Targeted Zapytania) i YouTube Reporting (Bulk Reports) API obsługują nową wartość wymiaru źródła wizyt, która wskazuje, że widz został odesłany, przesuwając palcem w pionie podczas oglądania YouTube Shorts:
- W interfejsie YouTube Analytics API (Targeted Zapytania) wymiar
insightTrafficSourceType
obsługuje wartośćSHORTS
. - W interfejsie YouTube Reporting (Bulk Reports) API wymiar
traffic_source_type
obsługuje wartość24
.
Wymiar szczegółów źródła wizyt – insightTrafficSourceDetail
w YouTube Analytics API lub traffic_source_detail
w YouTube Reporting API – nie jest wypełniany w przypadku tego nowego typu źródła wizyt.
20 lipca 2020 r.
Aktualizacja obejmuje 2 zmiany, które wpływają na interfejs YouTube Analytics (Targeted Queries) API:
- Maksymalny rozmiar grupy raportowania w Statystykach YouTube wzrósł z 200 do 500 elementów.
- Parametr
filters
metodyreports.query
określa listę filtrów, które należy zastosować przy pobieraniu danych ze Statystyk YouTube. Parametr umożliwia podanie wielu wartości filtrówvideo
,playlist
ichannel
. Maksymalna liczba identyfikatorów, które można określić dla tych filtrów, wzrosła z 200 do 500.
13 lutego 2020 r.
Ta aktualizacja wprowadza podane niżej zmiany związane z interfejsami YouTube Analytics (Targeted Zapytania) i YouTube Reporting (Bulk Reports) API. Więcej informacji o tych zmianach znajdziesz w Centrum pomocy YouTube.
W obu interfejsach API zmienia się zestaw możliwych wartości szczegółów źródeł wizyt dla powiadomień.
W przypadku docelowych zapytań powiadomienia są raportowane jako insightTrafficSourceType=NOTIFICATION
. W raportach zbiorczych powiadomienia są raportowane jako traffic_source_type=17
.
Nowe wartości dzielą powiadomienia dotyczące przesłanych filmów i transmisji na żywo (wcześniej zgłoszonych jako uploaded
) na 2 kategorie:
uploaded_push
– wyświetlenia pochodzące z powiadomień push wysyłanych do subskrybentów po przesłaniu filmuuploaded_other
– wyświetlenia pochodzą z powiadomień innych niż push, takich jak powiadomienia e-mail lub powiadomienia skrzynki odbiorczej, wysyłane do subskrybentów podczas przesyłania filmu.
Te wartości są zwracane dla zakresu czasu od 13 stycznia 2020 r.
Przypominamy też, że wartości te nie reprezentują samych powiadomień, a jedynie źródła wizyt, które doprowadziły do określonych wyświetleń w YouTube. Jeśli na przykład wiersz raportu zawiera wartości views=3
, traffic_source_type=17
(NOTIFICATION
) i traffic_source_detail=uploaded_push
, oznacza to, że 3 wyświetlenia zostały wyświetlone przez widzów, którzy kliknęli powiadomienia push wysłane podczas przesyłania filmu.
15 października 2019 r.
Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Queries) API:
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
YouTube wycofuje obsługę wymiarów
7DayTotals
i30DayTotals
. Dane za pomocą tych wymiarów możesz pobierać do 15 kwietnia 2020 r. Tego dnia lub później próba pobrania raportów przy użyciu wymiaru7DayTotals
lub30DayTotals
zwróci błąd.Pamiętaj, że użytkownicy mogą odtworzyć niektóre dane w tych wymiarach, wysyłając zapytania za pomocą wymiaru
day
oraz agregując lub pozyskując dane z okresów 7 lub 30 dni. Na przykład:- Liczbę wyświetleń w okresie 7 dni można obliczyć przez zsumowanie liczby wyświetleń z każdego dnia tego okresu.
- Procent widzów dla okresu 7 dni można obliczyć, mnożąc liczbę wyświetleń każdego dnia pomnożoną przez wartość procentu widzów w danym dniu, aby otrzymać liczbę widzów, którzy byli zalogowani podczas oglądania filmu w danym dniu. Następnie można dodać liczbę zalogowanych widzów dla całego okresu i podzielić ją przez łączną liczbę wyświetleń w tym okresie, aby otrzymać wartość procentową liczby widzów dla całego okresu.
- Nie można obliczyć liczby unikalnych widzów w okresie 7 dni, ponieważ tego samego widza można by policzyć jako unikalny widz w różnych dniach. Możesz jednak użyć wymiaru
month
zamiast wymiaru30DayTotals
, aby oszacować dane o liczbie unikalnych widzów w okresie 30 dni. Pamiętaj, że wymiarmonth
odnosi się do miesięcy kalendarzowych, a wymiar30DayTotals
oblicza okresy 30-dniowe na podstawie określonej daty rozpoczęcia i zakończenia.
27 czerwca 2019 r.
Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Queries) API:
-
Ponieważ wersja 1 interfejsu API została całkowicie wycofana, zaktualizowaliśmy dokumentację, aby usunąć odniesienia do tej wersji, w tym powiadomienie o wycofaniu i przewodnik po migracji wyjaśniający, jak zaktualizować go do wersji 2.
1 listopada 2018 r.
Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Queries) API:
-
Wersja 1 interfejsu API została wycofana. Aby uniknąć przerw w działaniu usługi, jak najszybciej zaktualizuj klienty interfejsu API do wersji 2 interfejsu API. Więcej informacji znajdziesz w przewodniku po migracji.
Harmonogram wycofywania tych funkcji ogłosiliśmy po raz pierwszy 26 kwietnia 2018 roku.
17 września 2018 r.
Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Analytics (Targeted Queries) API:
-
Nowa sekcja anonimizacji danych w dokumencie z omówieniem modelu danych wyjaśnia, że niektóre dane w Statystykach YouTube są ograniczone, gdy wartości nie osiągną określonego progu. Może się to zdarzyć w różnych przypadkach. W praktyce oznacza to, że raport może nie zawierać wszystkich (lub żadnych) danych, jeśli:
-
na film lub na kanale odnotowano ograniczony ruch w określonym przedziale czasu;
lub
-
wybrać filtr lub wymiar, np. źródło wizyt lub kraj, dla których wartości nie osiągnęły określonego progu.
W nowej sekcji omówiono typy danych, które mogą być ograniczone w raportach Statystyk YouTube.
-
-
Zaktualizowaliśmy raporty dotyczące kanałów i raporty właścicieli treści, aby uwzględniały fakt, że dane
redViews
iestimatedRedMinutesWatched
nie są już obsługiwane w raportach o miejscach odtwarzania, źródłach wizyt, typie urządzenia/systemie operacyjnym.
18 czerwca 2018 r.
Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:
- Zmieniły się wymagania dotyczące zakresu tych metod:
- Żądania wysyłane do metody
reports.query
muszą mieć dostęp do zakresuhttps://www.googleapis.com/auth/youtube.readonly
. - Żądania wysyłane za pomocą metody
groupItems.list
muszą mieć dostęp do:- zakres
https://www.googleapis.com/auth/youtube
lub - zakres
https://www.googleapis.com/auth/youtube.readonly
oraz
zakreshttps://www.googleapis.com/auth/yt-analytics.readonly
Pierwsza opcja używa 1 zakresu, który jest zakresem do odczytu i zapisu, a druga – 2 zakresów tylko do odczytu.
- zakres
- Żądania wysyłane do metody
23 maja 2018 r.
Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:
- Przegląd interfejsu API zawiera nową sekcję dotyczącą zbiorczych danych i usuniętych elementów, która wyjaśnia, jak odpowiedzi interfejsu API postępują z danymi powiązanymi z usuniętymi zasobami, takimi jak filmy, playlisty czy kanały.
- Zaktualizowaliśmy sekcję dotyczącą sprawdzonych metod, w której omawiamy interfejs API, aby przypomnieć, że możesz używać interfejsu YouTube Data API do pobierania dodatkowych metadanych dotyczących zasobów zidentyfikowanych w odpowiedziach YouTube Analytics API. Zgodnie z zasadami dla deweloperów usług YouTube API (sekcje od III.E.4.b do III.E.4.d) klienty interfejsu API muszą usunąć lub odświeżyć metadane przechowywanych zasobów z tego interfejsu API po 30 dniach.
22 maja 2018 r.
Ta aktualizacja wprowadza te zmiany związane z interfejsem YouTube Reporting (Zbiorcze raporty) API:
- Podane niżej zmiany planujemy wprowadzić w lipcu 2018 roku. Nowe zasady będą obowiązywać na całym świecie do wszystkich raportów i zadań związanych z raportowaniem.
-
Po zmianie większość raportów interfejsu API, w tym raporty dotyczące uzupełniania, będzie dostępna przez 60 dni od momentu ich wygenerowania. Raporty zawierające dane historyczne będą jednak dostępne przez 30 dni od momentu ich wygenerowania.
Przed ogłoszeniem wszystkie raporty dotyczące interfejsu API były dostępne przez 180 dni od momentu ich wygenerowania. Dla jasności – po wejściu tych zasad w życie raporty z danymi historycznymi sprzed ponad 30 dni również przestaną być dostępne przez interfejs API. Wszystkie inne raporty starsze niż 60 dni również nie będą dostępne. W związku z tym w dokumentacji wynika teraz, że raporty utworzone przed zmianą zasad będą dostępne przez maksymalnie 180 dni.
-
Gdy po tej zmianie zaplanujesz zadanie raportowania, YouTube będzie generować raporty od tego dnia, które obejmują okres 30 dni poprzedzających zaplanowanie zadania. Przed tą zmianą, gdy zaplanujesz zadanie raportowania, YouTube będzie generować raporty obejmujące okres 180 dni poprzedzających zaplanowanie tego zadania.
-
-
Zaktualizowaliśmy sekcję ze sprawdzonymi metodami, aby przypomnieć, że za pomocą interfejsu YouTube Data API możesz pobierać dodatkowe metadane zasobów zidentyfikowanych w raportach. Zgodnie z zasadami dla deweloperów usług YouTube API (sekcje od III.E.4.b do III.E.4.d) klienty interfejsu API muszą usunąć lub odświeżyć metadane przechowywanych zasobów z tego interfejsu API po 30 dniach.
-
Zaktualizowaliśmy sekcję Cechy raportu, by uwzględnić, że chociaż dane w raporcie nie są filtrowane, raporty zawierające dane z okresu od 1 czerwca 2018 r. lub po tej dacie nie będą zawierać odwołań do zasobów YouTube, które zostały usunięte co najmniej 30 dni przed datą wygenerowania raportu.
-
Zaktualizowaliśmy sekcję Dane historyczne w omówieniu interfejsu API, aby uwzględnić, że gdy zaplanujesz nowe zadanie raportowania, raporty historyczne są zwykle publikowane w ciągu kilku dni. Wcześniej w dokumentacji znajdowały się informacje, że udostępnienie takich raportów może potrwać do 30 dni.
-
Zaktualizowaliśmy sekcję dotyczącą danych zapasowych w omówieniu interfejsu API, aby wyraźniej określać dane zapasowe jako zbiór danych, który zastępuje wcześniej przesłany zbiór.
26 kwietnia 2018 r.
Interfejs API YouTube Analytics (Targeted Queries) (v2) w wersji 2 jest już publicznie dostępny. Na poniższej liście znajdziesz informacje o zmianach w usługach i dokumentacji związanych z nową wersją interfejsu API:
-
Interfejs API w wersji 2 jest prawie taki sam jak wersja 1. Prawdopodobnie jednak konieczne będzie zaktualizowanie kodu, tak aby uwzględniał zmiany wymienione poniżej. Wszystkie te zmiany zostały szczegółowo opisane w nowym przewodniku po migracji.
- Wersja interfejsu API została zmieniona z
v1
nav2
. - Podstawowy URL żądań do interfejsu API zmienił się z
https://www.googleapis.com/youtube/analytics/v1
nahttps://youtubeanalytics.googleapis.com/v2
. - Nazwy kilku parametrów metody
reports.query
zostały zmienione. W szczególności nazwy parametrów zawierające łączniki, np.end-date
w interfejsie API v1, używają wielbłądów (endDate
), a nie łączników w interfejsie API v2. Ta zmiana sprawi, że nazwy parametrów będą spójne w całym interfejsie API, ponieważ stosowane przez interfejs API metody tworzenia grup i zarządzania nimi używają już wielkich liter w nazwach parametrów. - Interfejs API wersji 2 nie obsługuje żądań zbiorczych wysyłanych do globalnego punktu końcowego HTTP Google (
www.googleapis.com/batch
). Jeśli wysyłasz żądania zbiorcze w interfejsie API wersji 2, musisz użyć punktu końcowegohttps://youtubeanalytics.googleapis.com/v2
.
Dodatkowo wersja 2 nie obsługuje kilku funkcji wersji 1:
- Metoda
reports.query
nie obsługuje już parametrów żądaniaalt
,quotaUser
aniuserIp
. - Interfejs API w wersji 2 nie zapewnia punktu końcowego wsadowego, który obsługuje wsady złożone z żądań kierowanych do różnych interfejsów API. Grupa może jednak składać się z żądań wysyłanych do różnych metod tego samego interfejsu API. Nie dotyczy to interfejsu YouTube Analytics API, ponieważ Google wycofuje globalny punkt końcowy dla wszystkich swoich interfejsów API.
- Interfejs API w wersji 2 nie obsługuje protokołu JSON-RPC, który był obsługiwany w wersji 1. Przypominamy, że wycofanie tej kolumny nie dotyczy wyłącznie interfejsu YouTube Analytics API.
- Wersja interfejsu API została zmieniona z
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
Interfejs API w wersji 1 (1) został wycofany i będzie obsługiwany do 31 października 2018 r. Po tej dacie wszystkie żądania wysyłane do interfejsu API w wersji 1 przestaną działać. Aby uniknąć przerw w dostępie do danych Statystyk YouTube przez ten interfejs API, przejdź na wersję 2 API do 31 października 2018 r.
21 lutego 2018 r.
Po tej aktualizacji wprowadziliśmy te zmiany w interfejsie YouTube Analytics (Targeted Queries) API:
- Raporty demograficzne widzów, które zawierają zbiorcze statystyki wyświetleń na podstawie ich grupy wiekowej i płci, nie obsługują już wymiaru
youtubeProduct
, który pozwala zidentyfikować usługę YouTube, w której wystąpiła aktywność użytkownika.
18 stycznia 2018 r.
Ta aktualizacja zawiera następujące zmiany:
-
YouTube Reporting API (raporty zbiorcze)
- Wymiar
operating_system
, który identyfikuje system oprogramowania urządzenia, na którym doszło do wyświetleń, obsługuje teraz tę wartość:25
: KaiOS
- Wymiar
-
YouTube Analytics API (kierowanie na zapytania)
- Wymiar
operatingSystem
obsługuje wartość wymiaruKAIOS
.
- Wymiar
20 grudnia 2017 r.
Ta aktualizacja wprowadza 2 zmiany związane z interfejsem YouTube Reporting API:
-
Serwer API obsługuje teraz kompresję gzip dla żądań pobierających raporty. Pamiętaj, że kompresja gzip nie jest obsługiwana w przypadku innych typów żądań do interfejsu API. Włączenie kompresji gzip zmniejsza przepustowość potrzebną do przetwarzania każdej odpowiedzi interfejsu API. Choć dekompresja odpowiedzi interfejsu API wymaga dodatkowego czasu procesora, korzyści wynikające ze zużywania mniejszej liczby zasobów sieciowych zwykle przeważają nad tym kosztem.
Aby odebrać odpowiedź zakodowaną w formacie gzip, ustaw nagłówek żądania HTTP
Accept-Encoding
nagzip
, jak pokazano w poniższym przykładzie:Accept-Encoding: gzip
Tę funkcję znajdziesz w omówieniu interfejsu API oraz w definicji właściwości
downloadUrl
zasobureport
. -
Dokumentacja wymiarów
age group
igender
została poprawiona, aby pokazywała rzeczywiste wartości, które interfejs API zwraca dla tych wymiarów. Jest to poprawka w dokumentacji, która nie odzwierciedla zmian w działaniu interfejsu API ani w jego działaniu. Zmieniły się następujące wartości:- Wartości wymiaru
age_group
mogą zawierać wielkie litery, podkreślenia między słowemAGE
a cyframi z grupy wiekowej oraz używać podkreśleń zamiast łączników. W związku z tym wartości takie jakage13-17
iage18-24
zostały poprawione odpowiednio naAGE_13_17
iAGE_18_24
. - Wartości wymiaru
gender
zawierają wielkie litery. W związku z tym wartościfemale
,male
igender_other
zostały poprawione naFEMALE
,MALE
iGENDER_OTHER
.
- Wartości wymiaru
10 sierpnia 2017 r.
10 sierpnia 2016 r. ta dokumentacja informowała o wycofaniu danych earnings
interfejsu YouTube Analytics API. Jednocześnie interfejs API dodał obsługę nowego rodzaju danych o nazwie estimatedRevenue
, które zawierają te same informacje.
Dane earnings
były danymi podstawowymi, dlatego były obsługiwane przez rok od daty ogłoszenia. Jednak po zakończeniu rocznego okresu dane earnings
nie są już obsługiwane. W efekcie żądania do interfejsu API, które określają wskaźnik earnings
, zwracają teraz kod odpowiedzi HTTP 400
. Jeśli Twoja aplikacja nie korzysta jeszcze z danych estimatedRevenue
zamiast earnings
, zrób to jak najszybciej.
Zaktualizowaliśmy dokumentację interfejsu API, aby usunąć pozostałe odwołania do wskaźnika earnings
.
6 lipca 2017 r.
Ta aktualizacja zawiera następujące zmiany:
-
YouTube Analytics API (kierowanie na zapytania)
-
Dokumentacja API została zaktualizowana, aby uwzględnić fakt, że odpowiedzi interfejsu API zawierają dane do ostatniego dnia w żądanym zakresie dat, dla którego dostępne są wszystkie dane objęte zapytaniem.
Jeśli na przykład żądanie określa datę końcową 5 lipca 2017 roku, a wartości wszystkich żądanych danych są dostępne tylko do 3 lipca 2017 roku, będzie to ostatni dzień, którego dotyczy odpowiedź. (nawet jeśli dane niektórych żądanych rodzajów danych są dostępne od 4 lipca 2017 r.).
-
Wymiar
adType
obsługuje teraz wartośćreservedBumperInstream
, która odnosi się do niemożliwej do pominięcia reklamy wideo, która trwa do 6 sekund, zanim rozpocznie się odtwarzanie filmu. Format reklamy jest taki sam jakauctionBumperInstream
, ale ten typ odnosi się do reklam sprzedawanych na zasadzie rezerwacji, a nie na aukcji.
-
-
YouTube Reporting API (raporty zbiorcze)
-
Wymiar
ad_type
obsługuje teraz wartość20
, która odnosi się do bumperów reklamowych sprzedawanych na zasadzie rezerwacji. Bumpery reklamowe to reklamy wideo niemożliwe do pominięcia, które trwają do 6 sekund i odtwarzają się, zanim rozpocznie się odtwarzanie filmu. Pamiętaj, że wartość19
w przypadku tego wymiaru odnosi się również do bumperów reklamowych sprzedawanych w ramach aukcji, a nie na zasadzie rezerwacji. -
Usunięto zadania raportowania dotyczące tych raportów interfejsu YouTube Reporting API:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
15 września 2016 r. ogłosiliśmy wycofanie tych typów raportów. Po 15 grudnia 2016 r. nie były już dla nich generowane. Wygenerowane wcześniej raporty były nadal dostępne przez 180 dni od momentu ich wygenerowania. W związku z tym niektóre raporty były dostępne dopiero od 15 czerwca 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.
-
24 maja 2017 r.
Usunięto wszystkie zadania raportowania dla tych raportów interfejsu YouTube Reporting API:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
22 czerwca 2016 r. ogłosiliśmy, że raporty te zostały wycofane, a po 22 września 2016 r. nie były już dla nich generowane. Wygenerowane wcześniej raporty były nadal dostępne przez 180 dni od momentu ich wygenerowania. W związku z tym niektóre raporty były dostępne dopiero od 22 marca 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.
22 maja 2017 r.
Ta aktualizacja zawiera następujące zmiany:
-
YouTube Reporting API (raporty zbiorcze)
- Wymiar
sharing_service
, który identyfikuje usługę używaną do udostępniania filmów, obsługuje teraz te wartości:85
: YouTube Music86
: Gry YouTube87
: YouTube Kids88
: YouTube TV
Zaktualizowaliśmy też nazwę służącą do identyfikowania wartości
52
w dokumentacji na Kakao (Kakao Talk), aby ułatwić odróżnienie jej od wartości73
(Kakao Story). Ta zmiana nie odzwierciedla żadnych zmian w działaniu interfejsu API ani klasyfikacji filmów udostępnianych tym usługom.
- Wymiar
-
YouTube Analytics API (kierowanie na zapytania)
- Wymiar
sharingService
obsługuje teraz te wartości:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
- Wymiar
28 marca 2017 r.
Właściciele kanałów, którzy mają dostęp do danych o przychodach w Statystykach YouTube w Studio twórców, mają teraz dostęp także za pomocą interfejsu YouTube Analytics API:
-
Interfejs API obsługuje te dane związane z przychodami:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Te dane są obsługiwane w tych raportach:
-
Właściciele kanałów mogą teraz również pobierać raport skuteczności reklam, który obsługuje wymiar
adType
oraz opcjonalny wymiarday
. -
Przewodnik po przykładowych żądaniach w interfejsie YouTube Analytics API zawiera teraz sekcję poświęconą raportom o przychodach kanału.
17 marca 2017 r.
Ta aktualizacja zawiera następujące zmiany:
-
Interfejs YouTube Analytics API obsługuje dane
redViews
iestimatedRedMinutesWatched
. Oba odnoszą się do oglądalności w YouTube Red. Interfejs API obsługuje już te dane już od jakiegoś czasu, a interfejs YouTube Reporting API obsługuje już oba te rodzaje danych, co ogłosiliśmy 15 września 2016 r.- Dane
redViews
wskazują, ile razy film został wyświetlony przez subskrybentów YouTube Red. - Wartość
estimatedRedMinutesWatched
określa liczbę minut, przez które subskrybenci YouTube Red obejrzeli film.
Zaktualizowaliśmy dokumentację raportów dotyczących kanałów i raportów właściciela treści, by pokazać, które raporty obsługują te 2 nowe rodzaje danych. Są one obsługiwane we wszystkich raportach, które obsługiwały już dane
views
iestimatedMinutesWatched
. - Dane
3 marca 2017 r.
Ta aktualizacja zawiera następujące zmiany:
-
YouTube Reporting API (raporty zbiorcze)
-
Definicja wymiaru
date
została zmieniona, aby zwrócić uwagę, że wartość wymiaru odnosi się do okresu zaczynającego się o 00:00 czasu pacyficznego, a kończącego o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny nosi nazwę UTC-7 lub UTC-8.Chociaż daty są zwykle 24-godzinne, daty, w których zegary są przesunięte do przodu, przedstawiają okres 23-godzinny, a daty przesunięte do tyłu – 25-godzinny. Wcześniej dokumentacja informowała, że każda data dotyczyła unikalnego okresu 24-godzinnego, a czas pacyficzny to zawsze UTC-8.
Pamiętaj, że ta poprawka nie odzwierciedla rzeczywistego działania interfejsu API.
- Wymiar
operating_system
, który identyfikuje system oprogramowania urządzenia, na którym doszło do wyświetleń, obsługuje teraz te wartości:22
: Tizen23
: Firefox24
: RealMedia
-
Wszystkie zadania raportowania dla typu raportu
content_owner_basic_a1
zostały usunięte. 19 sierpnia 2016 r. wycofaliśmy ten typ raportu, ale wygenerowane wcześniej raporty typucontent_owner_basic_a1
były dostępne przez 180 dni od momentu ich wygenerowania. W związku z tym niektóre raporty były dostępne dopiero od 19 lutego 2017 r. Ponieważ jednak raporty nie są już dostępne, powiązane z nimi zadania także nie są potrzebne.
-
-
YouTube Analytics API (kierowanie na zapytania)
-
Poprawiliśmy opis wymiarów związanych z wymiarem
time periods
, aby zaznaczyć, że wartość wymiaru odnosi się do okresu zaczynającego się o 00:00 czasu pacyficznego, a kończącego o 23:59 czasu pacyficznego w określonym dniu, miesiącu i roku. W zależności od pory roku czas pacyficzny nosi nazwę UTC-7 lub UTC-8.Chociaż daty są zwykle 24-godzinne, daty, w których zegary są przesunięte do przodu, przedstawiają okres 23-godzinny, a daty przesunięte do tyłu – 25-godzinny. Wcześniej dokumentacja informowała, że czas pacyficzny wynosi UTC-8, ale nie wspomniano o możliwości, że dzień nie będzie odbiegał od 24-godzinnego.
Pamiętaj, że ta poprawka nie odzwierciedla rzeczywistego działania interfejsu API.
-
Zaktualizowaliśmy dokumentację raportów kanałów, by uwzględnić, że raporty dotyczące kanałów nie zawierają obecnie danych o zarobkach ani skuteczności reklam. W efekcie zakres
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
nie umożliwia obecnie dostępu do danych finansowych w raportach dotyczących kanałów. - Wymiar
operatingSystem
obsługuje 3 nowe wartości wymiarów:FIREFOX
REALMEDIA
TIZEN
-
8 lutego 2017 r.
Interfejs YouTube Analytics API obsługuje teraz opcjonalny parametr include-historical-channel-data
. Pamiętaj, że ten parametr ma znaczenie tylko podczas pobierania raportów właściciela treści.
Umożliwia on właścicielowi treści wskazanie, że odpowiedź interfejsu API powinna zawierać dane o czasie oglądania i wyświetleniach kanału z okresu poprzedzającego połączenie kanałów z tym właścicielem. Domyślna wartość tego parametru to false
. Oznacza to, że odpowiedź interfejsu API domyślnie zawiera tylko dane o czasie oglądania i wyświetleniach z okresu od połączenia kanałów z właścicielem treści.
Te reguły mają też zastosowanie, jeśli żądanie do interfejsu API pobiera dane z wielu kanałów:
- Jeśli wartością tego parametru jest
false
, dane o czasie oglądania i wyświetleniach dla każdego kanału zależą od daty połączenia tego kanału z właścicielem treści.
Pamiętaj, że różne kanały mogły zostać połączone z właścicielem treści w różnych dniach. Jeśli żądanie do interfejsu API pobiera dane dla wielu kanałów, a wartość parametru tofalse
, odpowiedź interfejsu API zawiera dane o czasie oglądania i wyświetleniach oparte na dacie połączenia z poszczególnymi kanałami. - Jeśli wartością tego parametru jest
true
, odpowiedź zwraca czas oglądania i dane dotyczące wszystkich kanałów na podstawie dat rozpoczęcia i zakończenia określonych w żądaniu do interfejsu API.
15 grudnia 2016 r.
Poniższe raporty interfejsu YouTube Reporting API nie są już obsługiwane i zostały usunięte z dokumentacji. Dostępna jest nowsza wersja każdego raportu. Ogłoszenie o wycofaniu tych raportów opublikowaliśmy 15 września 2016 r.
-
Raporty dotyczące kanałów
channel_basic_a1
– zastąpiono raportemchannel_basic_a2
.channel_province_a1
– zastąpiono raportemchannel_province_a2
.channel_playback_location_a1
– zastąpiono raportemchannel_playback_location_a2
.channel_traffic_source_a1
– zastąpiono raportemchannel_traffic_source_a2
.channel_device_os_a1
– zastąpiono raportemchannel_device_os_a2
.channel_subtitles_a1
– zastąpiono raportemchannel_subtitles_a2
.channel_combined_a1
– zastąpiono raportemchannel_combined_a2
.
-
Zgłoszenia właścicieli treści
content_owner_basic_a2
– zastąpiono raportemcontent_owner_basic_a3
.content_owner_province_a1
– zastąpiono raportemcontent_owner_province_a2
.content_owner_playback_location_a1
– zastąpiono raportemcontent_owner_playback_location_a2
.content_owner_traffic_source_a1
– zastąpiono raportemcontent_owner_traffic_source_a2
.content_owner_device_os_a1
– zastąpiono raportemcontent_owner_device_os_a2
.content_owner_subtitles_a1
– zastąpiono raportemcontent_owner_subtitles_a2
.content_owner_combined_a1
– zastąpiono raportemcontent_owner_combined_a2
.content_owner_asset_basic_a1
– zastąpiono raportemcontent_owner_asset_basic_a2
.content_owner_asset_province_a1
– zastąpiono raportemcontent_owner_asset_province_a2
.content_owner_asset_playback_location_a1
– zastąpiono raportemcontent_owner_asset_playback_location_a2
.content_owner_asset_traffic_source_a1
– zastąpiono raportemcontent_owner_asset_traffic_source_a2
.content_owner_asset_device_os_a1
– zastąpiono raportemcontent_owner_asset_device_os_a2
.content_owner_asset_combined_a1
– zastąpiono raportemcontent_owner_asset_combined_a2
.
Zaktualizowaliśmy też listę aktualnych typów raportów w dokumentacji referencyjnej interfejsu API.
11 listopada 2016 r.
Ta aktualizacja zawiera następujące zmiany:
-
Raporty dotyczące ekranów końcowych
- Raport ekranu końcowego dotyczący filmów na kanale zawiera statystyki dotyczące wszystkich filmów na kanale.
- Raport o ekranach końcowych dotyczący filmów należących do właścicieli treści zawiera statystyki dotyczące filmów ze wszystkich kanałów należących do właściciela treści.
- Raport ekranu końcowego dotyczący zasobów właściciela treści zawiera statystyki dotyczące zasobów powiązanych z filmami, po których wyświetlają się ekrany końcowe.
-
Wymiary ekranu końcowego
end_screen_element_type
: typ elementu na ekranie końcowym powiązany ze statystykami.end_screen_element_id
: unikalny identyfikator używany w YouTube do identyfikowania elementu na ekranie końcowym.
Dane dotyczące ekranu końcowego
Uwaga: dane dotyczące ekranów końcowych są dostępne od 1 maja 2016 r.
end_screen_element_impressions
: łączna liczba wyświetleń elementu na ekranie końcowym. Dla każdego elementu na ekranie końcowym rejestrowane jest jedno wyświetlenie.end_screen_element_clicks
: liczba kliknięć elementów na ekranie końcowym.end_screen_element_click_rate
: współczynnik klikalności elementów na ekranie końcowym.
-
Poniższe raporty nie są już obsługiwane, więc zostały usunięte z dokumentacji. Dostępna jest nowsza wersja każdego raportu. Ogłoszenie o wycofaniu tych raportów opublikowaliśmy 22 czerwca 2016 r.
content_owner_ad_performance_a1
– zastąpiono raportemcontent_owner_ad_rates_a1
.content_owner_estimated_earnings_a1
– zastąpiono raportemcontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
– zastąpiono raportemcontent_owner_asset_estimated_revenue_a1
.
-
Dane na poniższej liście zostały w pełni wycofane i nie są już obsługiwane. Zgodnie z tym, co ogłosiliśmy z 10 sierpnia 2016 r., obsługiwane są już nowe rodzaje danych, które odnoszą się do tych samych danych. W tabeli poniżej znajdziesz nazwy wycofanych danych oraz ich nowe:
Wycofane dane Nowy wskaźnik adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Miesięczne przychody z reklam na film na całym świecie
- Dzienne przychody z reklam według kraju na film
- Miesięczne przychody z reklam na zasób na całym świecie
- Dzienne przychody z reklam według kraju na zasób
- Roszczenia (ten raport nie zawiera danych o przychodach)
-
Interfejs API obsługuje 2 nowe dane związane z oglądalnością w YouTube Red:
red_views
: liczba wyświetleń filmu przez subskrybentów YouTube Red.red_watch_time_minutes
: liczba minut, przez które subskrybenci YouTube Red oglądali film.
-
Interfejs API obsługuje nowe wersje 20 raportów. Wszystkie nowe wersje obsługują nowe dane
red_views
ired_watch_time_minutes
.W każdym raporcie liczba w nowym typie raportu jest o jedną liczbą wyższa niż w poprzednim raporcie. (Starsze wersje tych raportów zostały wycofane zgodnie z opisem w dalszej części historii zmian). Na przykład raport
channel_basic_a1
został wycofany i zastąpiony przez raportchannel_basic_a2
.Na tych listach znajdują się identyfikatory nowych typów raportów:
Raporty na temat filmów na kanale
Raporty na temat filmów właścicieli treści
Raporty o zasobach należących do właścicieli treści
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
Pamiętaj, że jeśli masz już zadania do utworzenia starszych wersji raportów wymienionych powyżej, musisz utworzyć nowe zadania dla raportów ze zmienioną nazwą. Wraz z udostępnieniem nowych wersji raportu wycofaliśmy następujące wersje:
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
Jeśli masz zadania związane z którymkolwiek z tych raportów, nie należy oczekiwać, że po 15 grudnia 2016 r. wygenerujemy dla nich nowe raporty. Wygenerowane raporty będą dostępne przez 180 dni od momentu ich wygenerowania.
-
Raport
content_owner_basic_a1
został całkowicie wycofany i usunięty z dokumentacji. YouTube nie będzie już generować nowych raportów tego typu, ale już wygenerowane raporty będą dostępne przez 180 dni od momentu ich wygenerowania.Zastąpiono raport
content_owner_basic_a1
raportcontent_owner_basic_a2
, jak opisano we wpisie historii zmian z 19 maja 2016 r. -
Niedawno opublikowane Warunki korzystania z usług interfejsu YouTube API („Zaktualizowane Warunki”), które są szczegółowo omówione na blogu YouTube dla programistów i programistów, zawierają wiele aktualizacji bieżących Warunków korzystania z usługi. Oprócz zaktualizowanych Warunków, które zaczną obowiązywać 10 lutego 2017 roku, ta aktualizacja zawiera kilka dokumentów pomocniczych, które wyjaśniają zasady, których muszą przestrzegać deweloperzy.
Pełny zestaw nowych dokumentów opisano w historii zmian zaktualizowanych Warunków. Historia zmian będzie również wyjaśniana w przypadku przyszłych zmian zaktualizowanych Warunków lub dokumentów pomocniczych. Możesz zasubskrybować kanał RSS z listą zmian w historii zmian, korzystając z linku w dokumencie.
-
YouTube Analytics API (kierowanie na zapytania)
-
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
Dane w poniższej tabeli zostały wycofane. Jednocześnie wprowadzamy nowe dane, które odnoszą się do tych samych informacji. Oznacza to, że zmieniamy nazwy starych danych, chociaż interfejs YouTube Analytics API będzie obsługiwać obie nazwy do daty wycofania wymienionych w tabeli.
Stara nazwa danych Nowa nazwa danych Data wsparcia earnings
estimatedRevenue
10 sierpnia 2017 r. adEarnings
estimatedAdRevenue
4 listopada 2016 r. redPartnerRevenue
estimatedRedPartnerRevenue
4 listopada 2016 r. impressionBasedCpm
cpm
4 listopada 2016 r. impressions
adImpressions
4 listopada 2016 r. Pamiętaj, że dane
earnings
były podstawowymi danymi, więc będą obsługiwane przez rok od daty tego ogłoszenia. Pozostałe dane, które nie były danymi podstawowymi, będą obsługiwane przez 3 miesiące, do 4 listopada 2016 r.Na przykład do 4 listopada 2016 roku żądanie do interfejsu API może określać dane
impressionBasedCpm
, danecpm
lub oba te rodzaje danych. Jednak po tej dacie obsługiwane będą tylko danecpm
. - Wymiar
insightTrafficSourceType
obsługuje 2 nowe wartości wymiaru:CAMPAIGN_CARD
: to źródło wizyt jest obsługiwane tylko w raportach właścicieli treści. Wskazuje on, że wyświetlenia pochodziły z filmów przesłanych przez użytkowników, które były objęte roszczeniem, a które właściciel treści wykorzystał do promowania wyświetlanych treści.END_SCREEN
: dane dotyczą wyświetleń pochodzących z ekranu końcowego innego filmu.
W przypadku obu nowych źródeł wizyt możesz też pobrać raport
traffic source detail
. W obu przypadkach wymiarinsightTrafficSourceDetail
wskazuje film, z którego trafił użytkownik. -
Wymiar
adType
obsługuje teraz wartośćauctionBumperInstream
, która odnosi się do niemożliwej do pominięcia reklamy wideo, która trwa do 6 sekund, zanim rozpocznie się odtwarzanie filmu.
-
-
YouTube Reporting API (raporty zbiorcze)
- Wymiar
traffic_source_type
obsługuje teraz te wartości:19
: to źródło wizyt jest obsługiwane tylko w raportach właścicieli treści. Wskazuje on, że wyświetlenia pochodziły z filmów przesłanych przez użytkowników, które były objęte roszczeniem, a które właściciel treści wykorzystał do promowania wyświetlanych treści.20
: dane dotyczą wyświetleń pochodzących z ekranu końcowego innego filmu.
W przypadku obu nowych źródeł wizyt wymiar
traffic_source_detail
wskazuje film, z którego widz został odesłany. -
Poprawiliśmy listę podstawowych danych interfejsu API, aby uwzględniała
estimated_partner_revenue
jako podstawowe dane i usunęła z niejearnings
. (daneearnings
nigdy nie były obsługiwane w interfejsie YouTube Reporting API). -
Wymiar
ad_type
obsługuje teraz wartość19
odnoszącą się do bumperów reklamowych, czyli reklam wideo niemożliwych do pominięcia, które trwają do 6 sekund i wyświetlają się przed wyświetleniem filmu.
- Wymiar
-
YouTube Analytics API (kierowanie na zapytania)
- Listy obsługiwanych danych w następujących raportach kanału zostały zaktualizowane, aby uwzględniały dane karty. Obsługa danych kart została wprowadzona w tych raportach 28 czerwca 2016 r. Szczegółowe informacje o zmianie znajdziesz w wpisie historii zmian dla tego dnia. Raporty to:
- Podstawowa aktywność użytkowników w stanach w USA
- Aktywność użytkowników w stanach w USA w określonych przedziałach czasu
- Aktywność użytkowników według prowincji
- Aktywność użytkowników według stanu subskrypcji
- Aktywność użytkowników według stanu subskrypcji dla prowincji
- Najpopularniejsze filmy wg stanu
- Najpopularniejsze filmy dla widzów z subskrypcją i bez subskrypcji
-
Poprawiliśmy listy filtrów w raportach utrzymania uwagi odbiorców na kanale i raportach utrzymania uwagi odbiorców, by uwzględnić, że filtr
video
jest wymagany, a filtrgroup
nie jest obsługiwany.Wcześniej w dokumentacji obu raportów podano błędne informacje, że można je pobrać za pomocą jednego z tych filtrów lub żadnego z nich.
- Listy obsługiwanych danych w następujących raportach kanału zostały zaktualizowane, aby uwzględniały dane karty. Obsługa danych kart została wprowadzona w tych raportach 28 czerwca 2016 r. Szczegółowe informacje o zmianie znajdziesz w wpisie historii zmian dla tego dnia. Raporty to:
-
YouTube Reporting API (raporty zbiorcze)
- W omówieniu interfejsu API sekcja, która wyjaśnia, jak pobrać adres URL raportu, została zmieniona tak, aby zaznaczyć, że YouTube generuje raporty do pobrania za dni, w których dane nie były dostępne. Zawierają one wiersz nagłówka, ale nie zawierają dodatkowych danych. Te informacje zostały już zaktualizowane w sekcji Charakterystyka raportu w tym samym dokumencie 12 kwietnia 2016 r.
- Lista wymiarów w raporcie
content_owner_asset_cards_a1
została zmieniona, by odzwierciedlała, że raport używa wymiarucard_id
. Wcześniej dokumentacja błędnie wyświetlała nazwę wymiaru jako „card_title
”.
- podstawowe statystyki(kanały, właściciele treści);
- Na podstawie czasu(kanały, właściciele treści)
- Obszar geograficzny użytkownika (kanały, właściciele treści)
- Aktywność użytkowników według stanu subskrypcji (kanały, właściciele treści)
- Najpopularniejsze filmy (kanały, właściciele treści)
-
Zaktualizowaliśmy sekcję Charakterystyka raportu w omówieniu interfejsu API, aby wyjaśnić, że raporty są dostępne przez ten interfejs API przez 180 dni od momentu ich wygenerowania.
Wcześniej w dokumentacji znajdowały się raporty dostępne dla okresu do 180 dni poprzedzających datę wysłania żądania do interfejsu API. Technicznie rzecz biorąc, oryginalny tekst był w najlepszym przypadku raczej niejasny.
-
Interfejs API obsługuje nowe wersje trzech raportów. Dwa raporty zawierają też nowe dane i inne ich nazwy:
-
Raport
content_owner_ad_rates_a1
to nowa wersja raportucontent_owner_ad_performance_a1
. Raport o nowej nazwie jest taki sam jak poprzednia wersja. -
Zmieniliśmy nazwy dwóch raportów z nowymi wersjami:
- Nowa wersja raportu
content_owner_estimated_earnings_a1
nazywa sięcontent_owner_estimated_revenue_a1
. - Nowa wersja raportu
content_owner_asset_estimated_earnings_a1
nazywa sięcontent_owner_asset_estimated_revenue_a1
.
Oba raporty pod nową nazwą różnią się od swoich poprzedników pod tym względem:
- Dodaje do niego nowy rodzaj danych (
estimated_partner_red_revenue
), który pozwala oszacować łączne zarobki z subskrypcji YouTube Red. - Dodają nowe dane
estimated_partner_transaction_revenue
, które szacują przychody z transakcji, takich jak płatne treści i finansowanie przez fanów, pomniejszone o zwroty środków obciążających partnera. - Zmienia nazwę danych
estimated_partner_ad_sense_revenue
naestimated_partner_ad_auction_revenue
. - Zmienia nazwę danych
estimated_partner_double_click_revenue
naestimated_partner_ad_reserved_revenue
.
- Nowa wersja raportu
Pamiętaj, że jeśli masz już zadania do utworzenia starszych wersji tych raportów, musisz utworzyć nowe zadania dla raportów o zmienionych nazwach. Wraz z udostępnieniem nowych wersji raportów wycofaliśmy raporty
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
icontent_owner_asset_estimated_earnings_a1
.Jeśli w przypadku któregoś z tych raportów masz zadania, nie należy oczekiwać, że po 22 września 2016 r. wygenerujemy dla nich nowe raporty. Wygenerowane raporty będą dostępne przez 180 dni od momentu ich wygenerowania.
-
-
Definicja właściwości
id
zasobureportType
została zaktualizowana, aby odzwierciedlała bieżący zestaw dostępnych raportów. -
Nazwy 2 rodzajów danych w dokumentacji zostały poprawione, aby były zgodne z nazwami widocznymi w raportach. Jest to tylko poprawka w dokumentacji, która nie odzwierciedla rzeczywistej treści raportu:
- Nazwa danych
estimated_partner_adsense_revenue
została zmieniona naestimated_partner_ad_sense_revenue
. Te dane pojawiają się tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych danych nazwa tych danych została zmieniona naestimated_partner_ad_auction_revenue
. - Nazwa danych
estimated_partner_doubleclick_revenue
została zmieniona naestimated_partner_double_click_revenue
. Te dane pojawiają się tylko w 2 raportach, które zostaną wycofane w ramach tej aktualizacji. Jak opisano powyżej, w nowszych wersjach tych danych nazwa tych danych została zmieniona naestimated_partner_ad_reserved_revenue
.
- Nazwa danych
-
Dokumentacja wymiarów dotycząca interfejsu API do raportowania została zaktualizowana i nie zawiera już właściwości
elapsed_video_time_percentage
aniaudience_retention_type
. Te wymiary nie są obecnie obsługiwane w żadnych raportach dostępnych za pośrednictwem interfejsu API. -
Ten interfejs API obsługuje nową wersję raportu aktywności użytkownika dla właścicieli treści. Identyfikator typu raportu w nowym raporcie to
content_owner_basic_a2
. W przeciwieństwie do poprzedniej wersji raportu (content_owner_basic_a1
) nowa wersja obsługuje danelikes
idislikes
.Jeśli masz już zadanie tworzenia raportu
content_owner_basic_a1
, musisz utworzyć nowe zadanie dla raportucontent_owner_basic_a2
. YouTube nie przenosi właścicieli treści automatycznie do nowej wersji raportu ani nie tworzy zadania do wygenerowania nowej wersji raportu. W niektórych implementacjach wygląd nowego, nieoczekiwanego zadania może okazać się przełomową zmianą.W związku z opublikowaniem nowego raportu raport
content_owner_basic_a1
został wycofany. Jeśli masz zadanie związane z tym raportem, po 19 sierpnia 2016 roku YouTube nie powinien generować dla niego nowych raportów. Wygenerowane raporty będą dostępne przez 180 dni od momentu ich wygenerowania. -
Zasoby
reportType
,job
ireport
obsługują nową właściwość, która wskazuje, czy powiązany zasób to wycofany typ raportu:-
Właściwość
deprecateTime
zasobureportType
określa datę i godzinę wycofania tego typu raportu. Ta właściwość ma wartość tylko w przypadku raportów, które zostały ogłoszone jako wycofane, i wskazuje dzień, w którym YouTube przestanie generować raporty tego typu.Po ogłoszeniu, że dany typ raportu zostanie wycofany, YouTube będzie generować raporty tego typu przez kolejne 3 miesiące. Na przykład ta aktualizacja z 19 maja 2016 roku informuje o wycofaniu raportu
content_owner_basic_a1
.deprecateTime
w przypadku tego typu raportu określa więc datę 19 sierpnia 2016 r., po której YouTube przestanie generować raporty tego typu. -
Właściwość
expireTime
zasobujob
określa datę i godzinę wygaśnięcia zadania. Ta właściwość zawiera wartość, jeśli typ raportu powiązany z zadaniem został wycofany lub jeśli raporty generowane dla tego zadania nie były pobierane od dłuższego czasu. Jest to data, po której YouTube przestanie generować nowe raporty dotyczące tego zadania. -
Właściwość
jobExpireTime
zasobureport
określa datę i godzinę wygaśnięcia zadania powiązanego z raportem lub jego wygaśnięcia. Ta właściwość zawiera tę samą wartość co właściwośćexpireTime
w zasobiejob
, zgodnie z opisem w poprzednim elemencie tej listy.
-
-
Metoda
jobs.create
zwraca teraz kod odpowiedzi HTTP400
(Bad Request
), jeśli próbujesz utworzyć zadanie dla wycofanego raportu. Dodatkowo w dokumentacji tej metody znajdziesz teraz kilka innych przyczyn niepowodzenia żądania do interfejsu API. -
YouTube generuje teraz dane obejmujące 180 dni poprzedzających zaplanowanie pierwszego zadania raportowania. Wcześniej interfejs API do raportowania nie dostarczał żadnych danych historycznych. Ta zmiana dotyczy wszystkich stanowisk, w tym tych utworzonych przed tym ogłoszeniem.
Raporty historyczne są publikowane natychmiast po ich udostępnieniu, ale opublikowanie wszystkich danych historycznych dotyczących zatrudnienia zajmuje około miesiąca. Oznacza to, że miesiąc po zaplanowaniu zadania raportowania będziesz mieć dostęp do danych z około siedmiu miesięcy. (Wszystkie historyczne dane dotyczące ofert pracy utworzonych przed tym ogłoszeniem powinny zostać opublikowane w ciągu miesiąca od ogłoszenia).
Pamiętaj, że dane historyczne są dostępne od 1 lipca 2015 r. Oznacza to, że zadania utworzone przed 28 grudnia 2015 r. będą miały mniej niż 180 dni danych historycznych.
Wyjaśniamy te zmiany w nowej sekcji poświęconej danych historycznych w omówieniu interfejsu API do raportowania.
-
Zaktualizowaliśmy sekcję dotyczącą charakteru raportu w omówieniu interfejsu YouTube Reporting API. Wprowadziliśmy w niej te zmiany:
-
Dokumentacja wskazuje obecnie, że raporty są dostępne przez okres 180 dni po wygenerowaniu, więc klienty interfejsu API mogą je pobrać. Wcześniej w dokumentacji znajdowały się informacje, że raporty były dostępne przez okres do 6 miesięcy przed datą wysłania żądania do interfejsu API.
-
Dokumentacja została zaktualizowana, aby uwzględnić fakt, że interfejs API generuje teraz raporty do pobrania dla dni, dla których nie były dostępne żadne dane. Takie raporty będą zawierać wiersze nagłówka, ale nie będą zawierać dodatkowych danych.
-
-
Wkrótce interfejs YouTube Reporting API będzie obsługiwać zestaw automatycznie generowanych, zarządzanych przez system raportów zawierających dane o przychodach z reklam lub przychodów z subskrypcji YouTube Red. Będą one dostępne dla właścicieli treści, którzy mają już dostęp do ręcznie możliwych do pobrania raportów o przychodach w Studiu twórców w YouTube. Dzięki temu nowa funkcja interfejsu API zapewni programowy dostęp do tych danych.
W ramach przygotowań do udostępnienia raportów zarządzanych przez system ogłosiliśmy następujące zmiany w interfejsie API:
-
Nowa właściwość
systemManaged
zasobujob
wskazuje, czy zasób opisuje zadanie generujące raporty zarządzane przez system. YouTube automatycznie generuje raporty zarządzane przez system dla właścicieli treści YouTube, a właściciele treści nie mogą modyfikować ani usuwać zadań, które je tworzą. -
Nowy parametr
includeSystemManaged
metodyjobs.list
wskazuje, czy odpowiedź interfejsu API powinna zawierać zadania w przypadku raportów zarządzanych przez system. Domyślną wartością parametru jestfalse
. -
Nowy parametr
startTimeAtOrAfter
metodyjobs.reports.list
wskazuje, że odpowiedź interfejsu API powinna zawierać raporty tylko wtedy, gdy najwcześniejsze dane w raporcie pochodzą z określonej daty lub później. Podobnie parametrstartTimeBefore
wskazuje, że odpowiedź interfejsu API powinna zawierać raporty tylko wtedy, gdy najwcześniejsze dane w raporcie przypadają przed określoną datą.W odróżnieniu od parametru
createdAfter
metody, który odnosi się do czasu utworzenia raportu, nowe parametry odnoszą się do danych w raporcie. -
Nowa właściwość
systemManaged
zasobureportType
wskazuje, czy zasób opisuje raport zarządzany przez system. -
Nowy parametr
includeSystemManaged
metodyreportTypes.list
wskazuje, czy odpowiedź interfejsu API powinna zawierać raporty zarządzane przez system. Domyślną wartością parametru jestfalse
.
-
- W interfejsie YouTube Reporting API wymiar
sharing_service
obsługuje te nowe wartości:82
: okno aktywności systemu iOS83
: skrzynka odbiorcza Google84
: Messenger na Androidzie
- W interfejsie YouTube Analytics API wymiar
sharingService
obsługuje te nowe wartości:ANDROID_MESSENGER
: Messenger na AndroidzieINBOX
: skrzynka odbiorcza GoogleIOS_SYSTEM_ACTIVITY_DIALOG
: okno aktywności systemu iOS
- Wymiar
playback_location_type
obsługuje 2 nowe wartości wymiaru:7
: dane dotyczą wyświetleń dokonanych na stronie głównej lub ekranie głównym YouTube, na karcie subskrypcji użytkownika lub za pomocą innej funkcji przeglądania w YouTube.8
: dane dotyczą wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.
- Wymiar
traffic_source_type
może teraz służyć jako wartość wymiaru18
. Ta wartość oznacza, że wyświetlenia filmu pochodzą ze strony zawierającej listę wszystkich filmów z playlisty. To źródło różni się od typu źródła14
, który wskazuje, że wyświetlenia miały miejsce podczas odtwarzania filmu w ramach playlisty. - Wymiar
insightPlaybackLocationType
obsługuje 2 nowe wartości wymiaru:BROWSE
: dane dotyczą wyświetleń dokonanych na stronie głównej lub ekranie głównym YouTube, na karcie subskrypcji użytkownika lub za pomocą innej funkcji przeglądania w YouTube.SEARCH
: dane dotyczą wyświetleń, które miały miejsce bezpośrednio na stronie wyników wyszukiwania w YouTube.
- Wymiar
insightTrafficSourceType
może teraz służyć jako wartość wymiaruYT_PLAYLIST_PAGE
. Ta wartość oznacza, że wyświetlenia filmu pochodzą ze strony zawierającej listę wszystkich filmów z playlisty. To źródło różni się od typu źródłaPLAYLIST
, co oznacza, że wyświetlenia miały miejsce podczas odtwarzania filmu w ramach playlisty. - W interfejsie YouTube Reporting API wymiar
operating_system
używa wartości21
do identyfikowania wyświetleń realizowanych przez Chromecasta. - W interfejsie YouTube Analytics API wymiar
operatingSystem
używa wartościCHROMECAST
do identyfikowania wyświetleń realizowanych przez Chromecasta. -
Interfejs YouTube Analytics API obsługuje teraz 3 nowe wymiary szczegółów odtwarzania, których możesz używać w różnych raportach dotyczących kanałów i właścicieli treści:
liveOrOnDemand
: ten wymiar wskazuje, czy dane w raporcie opisują aktywność użytkownika podczas transmisji na żywo.subscribedStatus
: ten wymiar wskazuje, czy zawarte w nich dane o aktywności użytkownika są powiązane z widzami, którzy zasubskrybowali kanał z filmem lub playlistą.youtubeProduct
: ten wymiar określa usługę YouTube, w której wystąpiła aktywność użytkownika. Możliwe wartości to główna witryna YouTube (lub aplikacja YouTube), YouTube Gaming i YouTube Kids.
Zaktualizowaliśmy dokumentację, aby znaleźć nowe raporty o szczegółach odtwarzania dostępne dla kanałów i właścicieli treści. Zaktualizowaliśmy też wiele innych raportów, by uwzględnić, że co najmniej jeden z tych wymiarów może być opcjonalnie używany jako wymiary lub filtry w tych raportach.
-
Zmienił się format tabel wyjaśniających te raporty, by ułatwić identyfikowanie prawidłowych kombinacji wymiarów, danych i filtrów, których można używać do pobierania poszczególnych raportów. W tabeli poniżej, w której objaśniamy raport „Typ urządzenia” w przypadku kanałów, podajemy nowy format:
Spis treści Wymiary: Wymagane deviceType Użyj 0 lub więcej day, liveOrOnDemand, subscribedStatus, youtubeProduct Dane: Użyj 1 lub więcej wyświetlenia, estimatedMinutesWatched Filtry: Użyj 0 lub 1 country: województwo, kontynent, subContinent Użyj 0 lub 1 video, group Użyj 0 lub więcej operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct Terminologia opisująca pola wymagane i opcjonalne została objaśniona w dokumentacji raportów kanału i właściciela treści.
-
YouTube Analytics API automatycznie pomija elementy, dla których użytkownik interfejsu API nie może pobrać danych z filtrów obsługujących wiele wartości (
video
,playlist
ichannel
). Wcześniej serwer API zwracał właśnie błąd, jeśli użytkownik API nie mógł uzyskać dostępu do danych co najmniej jednego ze wskazanych elementów.Załóżmy na przykład, że użytkownik przesyła żądanie do interfejsu API, w którym filtr
video
zawiera 20 identyfikatorów filmów. Do użytkownika należy 18 filmów. Jeden identyfikator filmu identyfikuje film należący do innego kanału, a drugi – film, który został usunięty, dlatego już nie istnieje. W takim przypadku zamiast zwracać błąd, serwer interfejsu API pomija 2 filmy, do których użytkownik nie ma dostępu, a odpowiedź interfejsu API zawiera dane dotyczące 18 filmów należących do tego użytkownika. -
Jeśli zażądasz danych dla pustego elementu
group
w YouTube Analytics, interfejs API zwróci teraz pusty zbiór danych, a nie błąd. -
Metoda
groupItems.insert
interfejsu YouTube Analytics API zwraca teraz błąd nieautoryzowany (kod odpowiedzi HTTP403
), jeśli próbujesz dodać element do grupy, ale nie masz do niego dostępu. Wcześniej interfejs API umożliwiał dodanie elementu do grupy, ale później przy próbie pobrania danych raportu dotyczącego tej grupy wystąpił nieautoryzowany błąd. -
Metoda
groups.list
interfejsu YouTube Analytics API obsługuje teraz podział na strony. Jeśli odpowiedź interfejsu API nie zawiera wszystkich dostępnych grup, parametrnextPageToken
odpowiedzi określa token, który może zostać użyty do pobrania następnej strony wyników. Aby pobrać dodatkowe wyniki, ustaw parametrpageToken
metody na tę wartość. -
Interfejs YouTube Analytics API obsługuje teraz dane
redPartnerRevenue
, które zawierają łączne szacunkowe przychody z subskrypcji YouTube Red w przypadku wybranych wymiarów raportu. Wartość wskaźnika odzwierciedla zarobki z muzyki oraz treści niemuzycznych i podlega korekcie na koniec miesiąca.Zaktualizowaliśmy listę raportów właściciela treści w interfejsie YouTube Analytics API, aby identyfikować raporty o filmach, które obsługują dane
redPartnerRevenue
:- Podstawowe statystyki
- Ograniczony czasowo
- Obszar geograficzny użytkownika
- Najpopularniejsze filmy – w tym raporcie dane
redPartnerRevenue
są również obsługiwane jako dane sortowania, co oznacza, że możesz pobrać listę filmów posortowaną według zarobków z YouTube Red.
-
Definicja raportu Najpopularniejsze filmy w interfejsie API YouTube Analytics odzwierciedla teraz, że raport ten obsługuje również następujące dane o zarobkach:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
iimpressionBasedCpm
. -
Poprawiliśmy dokumentację wymiaru
date
interfejsu YouTube Reporting API, aby uwzględniała ten okres: 24-godzinny okres rozpoczynający się o godzinie 00:00 czasu pacyficznego (UTC-8). Wcześniej w dokumentacji znajdowała się informacja, że data rozpoczęcia tej daty to 00:00 (GMT).Zaktualizowaliśmy też dokumentację interfejsu API YouTube Analytics, aby uwzględnić, że wszystkie wymiary związane z datami (
day
,7DayTotals
,30DayTotals
imonth
) dotyczą dat rozpoczynających się o 00:00 czasu pacyficznego (UTC-8). -
Metoda
jobs.reports.list()
interfejsu YouTube Reporting API obsługuje teraz parametr zapytaniacreatedAfter
. Jeśli jest określony, wskazuje, że w odpowiedzi interfejsu API powinny znajdować się tylko raporty utworzone po określonej dacie i godzinie, w tym nowe raporty z uzupełnionymi danymi. Pamiętaj, że wartość parametru odnosi się do czasu utworzenia raportu, a nie do dat powiązanych ze zwróconymi danymi.Wartość parametru jest sygnaturą czasową w formacie UTC „Zulu” RFC 3339 z dokładnością do mikrosekund. Przykład:
"2015-10-02T15:01:23.045678Z"
.Zaktualizowaliśmy też sprawdzone metody korzystania z interfejsu YouTube Reporting API, aby wyjaśnić, jak używać parametru
createdAfter
, aby uniknąć wielokrotnego przetwarzania tego samego raportu. -
Definicje właściwości
createTime
zasobujob
oraz właściwościstartTime
,endTime
icreateTime
zasobureport
zostały poprawione, aby zwrócić uwagę, że wartości właściwości są podane w mikrosekundach, a nie nanosekundach. Dodatkowo wszystkie definicje dokładnie odzwierciedlają teraz, że wartość właściwości jest sygnaturą czasową. -
Zaktualizowaliśmy dokumentację wymiaru
sharingService
interfejsu YouTube Analytics API, aby uwzględnić listę możliwych wartości wymiarów. Lista zawiera ostatnio obsługiwane usługi.Zaktualizowaliśmy też definicję wymiaru
sharing_service
w interfejsie YouTube Reporting API o nowe obsługiwane wartości. Wartości wyliczeniowe większe niż59
to nowe wartości na liście. -
Nowy interfejs YouTube Reporting API umożliwia pobieranie raportów danych zbiorczych, które zawierają dane Statystyk YouTube dotyczące kanału lub właściciela treści. Została ona zaprojektowana z myślą o aplikacjach umożliwiających importowanie dużych zbiorów danych oraz zapewniających narzędzia do filtrowania, sortowania i wydobywania tych danych.
Każdy raport interfejsu YouTube Reporting API zawiera wstępnie zdefiniowany zestaw wymiarów i danych. (w raportach z interfejsu YouTube Analytics API używane są również dane i wymiary). Każdy wiersz danych w raporcie zawiera niepowtarzalną kombinację wartości wymiarów. Możesz łączyć dane z różnych wierszy na podstawie wartości wymiarów, aby obliczać dane dotyczące poszczególnych filmów, krajów, filmów na żywo, subskrybentów itd.
Za pomocą interfejsu API możesz zaplanować zadania raportowania. Każde z nich identyfikuje raport do wygenerowania przez YouTube. Gdy skonfigurujesz zadanie, YouTube generuje raport dzienny, który możesz pobrać asynchronicznie. Każdy raport zawiera dane z unikalnego 24-godzinnego okresu.
-
Mimo że są to różne interfejsy API, interfejsy YouTube Analytics API i YouTube Reporting API umożliwiają programistom pobieranie danych Statystyk YouTube. Oba interfejsy API zapewniają dostęp do podobnych zbiorów danych, dlatego ich dokumentacja została opublikowana w formie jednego zestawu.
- Karta Przewodniki w zestawie dokumentacji zawiera informacje wspólne dla obu interfejsów API, w tym instrukcje autoryzacji żądań do interfejsu API.
- Karta Raporty zbiorcze zawiera dokumentację i inne materiały dotyczące interfejsu YouTube Reporting API.
- Karta Zapytania docelowe zawiera dokumentację referencyjną i inne treści dotyczące interfejsu YouTube Analytics API.
- Na karcie Przykłady znajdziesz przykłady kodu dostępne w przypadku każdego z tych 2 interfejsów API.
- Karta Narzędzia zawiera dodatkowe materiały, które mogą pomóc programistom we wdrożeniu jednego z tych interfejsów.
-
Zmieniliśmy strukturę dokumentacji API, aby ułatwić jej zrozumienie. Opisane tu zmiany nie dotyczą nowych funkcji:
-
Dokumentacja zawiera teraz listę wszystkich dostępnych raportów dotyczących kanałów i drugą stronę z listą wszystkich dostępnych raportów właścicieli treści. Wcześniej dokumentacja zawierała osobne strony z raportami o filmach na kanale, o playlistach kanału itd.
-
Nowy omówienie modelu danych ma na celu wyjaśnienie, jak działa interfejs API. W tym dokumencie szczegółowo opisujemy, jak YouTube wykorzystuje dane, wymiary i filtry do obliczania wartości w raportach.
-
Metoda
reports.query
interfejsu API, której używasz do pobierania raportów, jest teraz dokumentowana oddzielnie. Informacje na tej stronie znajdowały się wcześniej na kilku innych stronach. Nowa strona ma na celu ułatwienie identyfikacji informacji, które należy przesłać w celu uzyskania raportu.
-
-
Nowe dane
adEarnings
obejmują łączne szacunkowe zarobki (przychody netto) ze wszystkich źródeł reklam sprzedawanych przez Google. Nie są to podstawowe dane. Interfejs API obsługuje daneadEarnings
w każdym raporcie, który obsługiwał już daneearnings
.Dodatkowo zmieniliśmy definicję danych
earnings
, aby odzwierciedlała fakt, że ich wartość obejmuje łączne szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google i ze źródeł innych niż reklamy. Wcześniej definicja błędnie sugerowała, że dane uwzględniały tylko zarobki ze źródeł reklamowych. -
Dane
primaryAdGrossRevenue
zostały wycofane. Zamiast tego do pobierania danych o przychodach użyj danychgrossRevenue
. -
Oprócz wycofanych danych
primaryAdGrossRevenue
raporty skuteczności reklam nie obsługują już danychmonetizedPlaybacks
iplaybackBasedCpm
. Jednak kilka raportów na temat filmów nadal obsługuje te dane. -
Interfejs API obsługuje teraz 2 nowe rodzaje danych w raportach o reklamach wideo:
videosAddedToPlaylists
ivideosRemovedFromPlaylists
. Zaktualizowaliśmy listy raportów na temat filmów dotyczących kanałów i właścicieli treści, aby uwzględniały raporty, które obsługują nowe dane.videosAddedToPlaylists
– ile razy filmy objęte zapytaniem zostały dodane do dowolnej playlisty w YouTube. Filmy mogły zostać dodane do playlisty właściciela filmu lub do playlist na innych kanałach.videosRemovedFromPlaylists
– liczba razy, gdy filmy objęte zapytaniem zostały usunięte ze wszystkich playlist w YouTube. Filmy mogły zostać usunięte z playlisty właściciela filmu lub z playlist na innych kanałach.
Oba dane obejmują domyślne playlisty, takie jak playlista „Do obejrzenia”. Nie uwzględniają jednak playlist, do których film jest automatycznie dodawany, takich jak playlisty przesłane na kanał czy historia oglądania użytkownika. Pamiętaj też, że te wskaźniki odzwierciedlają bezwzględną liczbę dodanych i usunięć. Jeśli więc użytkownik doda film do playlisty, usunie go i doda jeszcze raz, dane wskazują, że film został dodany do 2 playlist i usunięty z jednej.
Dane dla tych kategorii są dostępne od 1 października 2014 r.
-
Z dniem tego ogłoszenia dane
favoritesAdded
ifavoritesRemoved
zostały wycofane. Są to zarówno podstawowe dane, jak i podlegają zasadom wycofywania określonym w Warunkach korzystania z usługi. -
Nowy parametr
currency
umożliwia pobieranie danych o zarobkach w walucie innej niż dolar amerykański (USD
). Jeśli jest ustawiony, interfejs API przelicza wartości danychearnings
,grossRevenue
,playbackBasedCpm
iimpressionBasedCpm
na określoną walutę. Zwracane wartości są wartościami szacunkowymi obliczonymi z wykorzystaniem kursów wymiany, które zmieniają się codziennie.Wartością tego parametru jest trzyliterowy kod waluty w formacie ISO 4217. Wartością domyślną jest
USD
. Definicja parametru zawiera listę obsługiwanych kodów walut. -
Umożliwia on teraz tworzenie grup w YouTube Analytics i zarządzanie nimi, a także pobieranie danych raportów z tych grup.
-
Tworzenie grup i zarządzanie nimi
W tej aktualizacji poznasz zasoby
group
igroupItem
służące do tworzenia grup i zarządzania nimi.- Zasób
group
reprezentuje grupę Analytics, czyli niestandardową kolekcję maksymalnie 200 kanałów, filmów, playlist lub zasobów. Interfejs API obsługuje metodylist
,insert
,update
idelete
dla tego zasobu. - Zasób
groupItem
reprezentuje element w grupie Analytics. Interfejs API obsługuje w przypadku tego zasobu metodylist
,insert
idelete
.
Możesz na przykład utworzyć grupę, używając metody
groups.insert
, a następnie dodać do niej elementy, używając metodygroupItems.insert
. - Zasób
-
Pobieranie danych do raportu dotyczących grupy
Zaktualizowaliśmy dokumentację dotyczącą wymiarów, aby uwzględnić wymiar
group
, którego można używać jako filtra w wielu raportach dotyczących kanałów i raportach właścicieli treści. Gdy użyjesz filtragroup
, interfejs API zwróci dane wszystkich elementów w danej grupie. Pamiętaj, że obecnie interfejs API nie umożliwia tworzenia raportów dotyczących grup plików.
Więcej informacji o grupach w Statystykach YouTube znajdziesz w Centrum pomocy YouTube.
-
-
Interfejs API nie obsługuje już wymiaru
show
. -
Interfejs API umożliwia teraz określenie wielu wartości wymiarów
video
,playlist
,channel
ishow
, gdy te wymiary są używane jako filtry. Aby określić wiele wartości, ustaw wartość parametrufilters
na rozdzieloną przecinkami listę identyfikatorów filmów, playlist, kanałów lub programów, w przypadku których chcesz odfiltrować odpowiedź interfejsu API. Wartość parametru może zawierać do 200 identyfikatorów.Jeśli określisz wiele wartości dla tego samego filtra, możesz też dodać ten filtr do listy wymiarów określonych w żądaniu. Dzieje się tak nawet wtedy, gdy filtr nie jest wymieniony na liście wymiarów obsługiwanych w danym raporcie. Jeśli dodasz filtr do listy wymiarów, interfejs API będzie używać ich też do grupowania wyników.
Szczegółowe informacje o tej funkcji znajdziesz w definicji parametru
filters
. -
Podczas pobierania raportu kanału możesz teraz pobrać dane kanału uwierzytelnionego użytkownika. W tym celu ustaw wartość parametru
ids
nachannel==MINE
. (możesz też ustawić parametrids
nachannel==CHANNEL_ID
, aby pobierać dane z określonego kanału). -
Interfejs API obsługuje teraz raporty dotyczące playlist, które zawierają statystyki wyświetleń filmów w kontekście playlist. Raporty dotyczące playlist są dostępne dla kanałów i właścicieli treści.
Wszystkie raporty o playlistach obsługują dane
views
iestimatedMinutesWatched
, a niektóre także daneaverageViewDuration
.Dodatkowo wszystkie raporty dotyczące playlist obsługują te nowe dane. Pamiętaj, że wszystkie te dane odzwierciedlają tylko wyświetlenia playlisty w internecie.
playlistStarts
: liczba przypadków zainicjowania odtwarzania playlisty przez widzów.viewsPerPlaylistStart
: średnia liczba wyświetleń filmów przy każdym uruchomieniu playlisty.averageTimeInPlaylist
: szacowany średni czas (w minutach), przez jaki widz oglądał filmy z playlisty po zainicjowaniu playlisty.
Każde żądanie pobrania raportu o playliście musi korzystać z filtra
isCurated
, który musi być ustawiony na wartość1
(isCurated==1
). -
Interfejs API obsługuje teraz raport Utrzymanie uwagi odbiorców. Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Nowy wymiar
elapsedVideoTimeRatio
w raporcie mierzy długość filmu, który upłynął w przypadku odpowiednich wartości danych:-
audienceWatchRatio
określa bezwzględny odsetek widzów, którzy oglądają film w danym momencie filmu. Współczynnik ten jest obliczany przez porównanie liczby odtworzeń części filmu z łączną liczbą wyświetleń filmu.Pamiętaj, że w ramach danego wyświetlenia filmu można obejrzeć jego fragment więcej niż raz (lub nie zobaczyć go wcale). Jeśli na przykład użytkownicy przewijają film do tyłu i wielokrotnie oglądają ten sam fragment, wartość bezwzględna tej części filmu może być większa niż
1
. -
Dane
relativeRetentionPerformance
wskazują, jak skutecznie film utrzymuje uwagę widzów podczas jego odtwarzania w porównaniu do wszystkich filmów w YouTube o podobnej długości. Wartość 0 oznacza, że film utrzymuje uwagę widzów gorzej niż jakikolwiek inny film o podobnej długości, a wartość 1 oznacza, że film utrzymuje uwagę widzów lepiej niż jakikolwiek inny film o podobnej długości. Mediana równa 0,5 oznacza, że połowa filmów o podobnej długości utrzymuje uwagę widzów, a połowa gorzej.
Możesz też użyć filtra
audienceType
, aby raport zawierał tylko dane związane z bezpłatnymi wyświetleniami, wyświetleniami z reklam TrueView In-Stream lub z reklam TrueView In-Display. (Bezpłatne wyświetlenia to bezpośredni wynik działań użytkownika, takich jak wyszukiwanie filmu czy kliknięcie sugerowanego filmu). -
-
Interfejs API obsługuje kilka nowych danych związanych z adnotacjami. Wymienione poniżej dane można pobrać razem ze wszystkimi raportami, które wcześniej obsługiwały dane
annotationClickThroughRate
iannotationCloseRate
.annotationImpressions
: łączna liczba wyświetleń adnotacji.annotationClickableImpressions
: liczba adnotacji, które się wyświetliły i można je kliknąć.annotationClosableImpressions
: liczba adnotacji, które się wyświetliły i które można zamknąć.annotationClicks
: łączna liczba klikniętych adnotacji.annotationCloses
: łączna liczba zamkniętych adnotacji.
Wszystkie nowe dane są podstawowymi danymi i podlegają zasadom wycofywania. Pamiętaj jednak, że w przypadku nowych danych dostępne są dane od 16 lipca 2013 r. (dane
annotationClickThroughRate
iannotationCloseRate
są dostępne od 10 czerwca 2012 r.). -
GOOGLE_SEARCH
nie jest już raportowany jako osobna wartość wymiaruinsightTrafficSourceType
. Odesłania z wyników wyszukiwania Google są teraz przypisywane do typu źródła wizytEXT_URL
. W rezultacie nie można też już pobrać raportuinsightTrafficSourceDetail
z ustawieniem filtrainsightTrafficSourceType
naGOOGLE_SEARCH
. -
Zaktualizowaliśmy dokument Zgłoszenia właścicieli treści, aby uwzględniał on, że dane
subscribersGained
isubscribersLost
mogą teraz być pobierane w przypadku treści, do których właściciel treści zgłosił roszczenia lub które je przesłał.Zmiana jest widoczna w pierwszym raporcie podstawowych statystyk dla właścicieli treści, który obsługuje teraz filtry
claimedStatus
iuploaderType
. -
Zmieniliśmy wygląd dokumentu z przykładowymi prośbami, aby zawierał przykłady w kategoriach. Format kart jest podobny do tych, które zostały niedawno wprowadzone w raportach dotyczących kanałów i właścicieli treści. W nowym wyglądzie przykłady są podzielone na następujące kategorie:
- Podstawowe statystyki
- Według kryterium czasu
- Geografia
- Miejsce odtwarzania
- Źródło wizyt
- Urządzenie/system operacyjny
- Grupa demograficzna
- Sieci społecznościowe
- Zarobki/reklamy (tylko w przypadku raportów właściciela treści)
-
Dokument przykładowe żądania zawiera teraz nowe przykłady pobierania danych z poszczególnych prowincji w raportach dotyczących kanałów lub właściciela treści.
-
Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu: Ten raport zawiera dane o liczbie wyświetleń i inne statystyki dotyczące filmów na kanale w podziale na poszczególne prowincje. Dane dotyczą stanów USA i Waszyngtonu. W przykładzie użyto wymiaru
province
oraz parametrufilters
, aby ograniczyć odpowiedź tylko do tych ze Stanów Zjednoczonych. -
Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć): ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów z Kalifornii, którzy obejrzeli filmy na kanale, lub (w przypadku raportów właściciela treści) treści objęte roszczeniem przez właściciela treści. W tym przykładzie użyto parametru
filters
, aby mieć pewność, że odpowiedź zawiera tylko dane z konkretnej prowincji.
-
-
Definicja wymiaru
province
została zaktualizowana, aby zaznaczyć, że jeśli wartość parametrudimensions
zawieraprovince
, żądanie musi też ograniczać dane do Stanów Zjednoczonych, dołączająccountry==US
w wartości parametrufilters
. -
Zmieniliśmy wygląd dokumentów przedstawiających obsługiwane raporty dotyczące kanału i właściciela treści. Zamiast tworzyć tabelę z listą wszystkich możliwych raportów, każdy dokument grupuje raporty w kategorie:
- Podstawowe statystyki
- Według kryterium czasu
- Geografia
- Miejsce odtwarzania
- Źródło wizyt
- Urządzenie/system operacyjny
- Grupa demograficzna
- Sieci społecznościowe
- Najpopularniejsze filmy
Każdy dokument zawiera listę kart. Możesz kliknąć dowolną z nich, aby zobaczyć raporty z danej kategorii.
-
Interfejs API obsługuje teraz 3 nowe wymiary geograficzne:
province
,continent
isubContinent
.-
Wymiar
province
umożliwia pobieranie statystyk dotyczących stanów w USA i Dystryktu Kolumbii. Interfejs API obsługuje 2 zastosowania tego wymiaru:-
Interfejs API obsługuje 2 raporty, które przedstawiają statystyki z poszczególnych stanów. Oba raporty są dostępne dla kanałów i właścicieli treści.
- Raport podstawowych statystyk zawiera kilka statystyk, w tym liczbę wyświetleń i szacowany czas oglądania.
- Raport czasowy zawiera te same statystyki, ale podsumowuje dane dzienne, 7-dniowe, 30-dniowe lub miesięczne.
-
Korzystając z parametru zapytania
filters
, możesz ograniczyć raport, aby zawierał statystyki tylko z konkretnego stanu. Ten typ filtrowania obsługuje kilka raportów, w tym raporty geograficzne, o miejscach odtwarzania, o źródłach wizyt, o urządzeniach, systemie operacyjnym, dane demograficzne i na temat najpopularniejszych filmów.
-
-
Wymiar
continent
określa kod regionu statystycznego ONZ, który identyfikuje kontynent. Tego wymiaru można używać tylko jako filtra. -
Wymiar
subContinent
określa kod regionu statystycznego ONZ, który określa podregion kontynentu. Tego wymiaru można też używać tylko jako filtra.Ponieważ każdy podregion jest powiązany tylko z jednym kontynentem, nie musisz używać filtra
continent
, gdy używasz filtrasubContinent
. (W rzeczywistości interfejs API zwróci błąd, jeśli żądanie użyje obu wymiarów).
-
-
Poprawiono dokumentację, tak aby wymiar
insightTrafficSourceDetail
nie zawierał wartościPROMOTED
insightTrafficSourceType
jako prawidłowej wartości filtra. -
Interfejs YouTube Analytics API podlega teraz zasadom wycofywania opisanym w Warunkach korzystania z usługi. Jednak wymiary i dane spoza podstawowego interfejsu API nie podlegają zasadom wycofywania. Na stronach Wymiary i metrics zaktualizowaliśmy listę podstawowych wymiarów i podstawowych danych. Zaktualizowaliśmy też definicje na tych stronach, aby wyraźnie określać podstawowe wymiary i dane.
-
Interfejs API obsługuje teraz wartość
EXTERNAL_APP
w wymiarzeinsightPlaybackLocationType
. W związku z tą aktualizacją od 10 września 2013 r. odtworzenia nie będą już zaliczane do kategorii odtworzeńMOBILE
, ale odtworzenia na urządzeniach mobilnych, które miały miejsce przed tą datą, zostaną przypisane do tej wartości.W ramach tej aktualizacji odtworzenia na urządzeniach mobilnych są teraz klasyfikowane jako odtworzenia
WATCH
,EMBEDDED
lubEXTERNAL_APP
, w zależności od typu aplikacji, w której są odtwarzane. -
Interfejs API obsługuje teraz wartość
PLAYLIST
w wymiarzeinsightTrafficSourceType
. Wartość wskazuje, że wyświetlenia filmów pochodzą z playlisty. Wcześniej te widoki były klasyfikowane na podstawie kategoriiYT_OTHER_PAGE
wymiaru. -
Interfejs API obsługuje teraz sortowanie raportów według wielu wymiarów i danych. W dokumencie z przykładowymi żądaniami znajdziesz nowy przykład sortowania żądań według wielu wymiarów/danych, który przedstawia tę funkcję. Żądanie pobiera dane źródła wizyt i ma wartość parametru
sort
równąday,-views
. Wyniki są sortowane chronologicznie, ale w ramach zestawu wyników dla każdego dnia pierwszy wiersz zawiera dane o źródle wizyt, które wygenerowało najwięcej wyświetleń, drugi o źródle z kolejną największą liczbą wyświetleń itd. -
Interfejs API obsługuje teraz 2 nowe wymiary:
deviceType
ioperatingSystem
, dzięki którym można pobierać dane o urządzeniach, na których widzowie oglądają Twoje filmy. Interfejs API obsługuje raporty korzystające z jednego z tych wymiarów lub z obu tych wymiarów.-
Dzięki raportowi
deviceType
możesz sprawdzić liczbę wyświetleń i szacowany czas oglądania dla różnych typów urządzeń, takich jak komputery, komórki i tablety. Możesz też użyć filtraoperatingSystem
, aby ograniczyć raport o typie urządzeń, aby obejmował tylko statystyki dotyczące urządzeń z określonym systemem operacyjnym, np. Android lub iOS. -
Dzięki raportowi
operatingSystem
możesz sprawdzić liczbę wyświetleń i szacowany czas oglądania w różnych systemach operacyjnych, takich jak Android, iOS czy Linux. Możesz też użyć filtradeviceType
, aby ograniczyć raport o systemie operacyjnym do statystyk dotyczących urządzeń określonego typu (np. komórek lub tabletów).
Nowe raporty dotyczące typu urządzenia i systemu operacyjnego są dostępne dla kanałów i właścicieli treści.
-
-
Zaktualizowaliśmy dokument z przykładowymi prośbami, by uwzględniał 3 raporty o urządzeniach dla kanałów i 3 raporty dotyczące urządzeń dla właścicieli treści.
-
Wymiar
insightPlaybackLocationType
może zwrócić wartośćYT_OTHER
, która identyfikuje widoki danych, które nie są sklasyfikowane na podstawie jednej z pozostałych wartości wymiaru. -
Zaktualizowaliśmy dokument Raporty dotyczące właścicieli treści, aby uwzględnić w nim, że aby znaleźć filmy o najwyższych zarobkach, możesz sortować raport dotyczący najlepszych filmów w kolejności malejącej. Jest to pierwszy raport wymieniony w drugiej tabeli w sekcji Raporty o aktywności użytkowników i zarobkach.
-
YouTube nie identyfikuje już eksperymentalnych funkcji ani usług interfejsu API. Zamiast tego przedstawiamy listę interfejsów API YouTube, które podlegają zasadom wycofywania.
-
Interfejs API umożliwia teraz pobieranie danych dotyczących czasu oglądania –
estimatedMinutesWatched
,averageViewDuration
iaverageViewPercentage
– w połączeniu z innymi danymi, w tym danymi dotyczącymi wyświetleń, zaangażowania, zarobków i skuteczności reklam.Listy dostępnych raportów dotyczących kanałów i raportów właścicieli treści zostały zaktualizowane, by odzwierciedlały tę zmianę. (Te listy są obecnie krótsze, ponieważ dane o czasie oglądania można pobrać jako część innych wymienionych raportów).
Zaktualizowaliśmy też dokument Przykładowe żądania do interfejsu API.
-
Raporty korzystające z wymiarów
insightPlaybackLocationDetail
iinsightTrafficSourceDetail
zostały ulepszone o te sposoby:-
Obsługują teraz opcjonalny filtr
country
. -
Właściciele treści mogą teraz pobierać te raporty za pomocą dowolnych nowych kombinacji funkcji
filter
. Pamiętaj, że wszystkie te kombinacje obsługują też opcjonalny filtrcountry
.-
Szczegóły miejsca odtwarzania
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Szczegóły źródła wizyt
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Nowy dokument Przykładowe żądania do interfejsu API zawiera przykłady, które pokazują, jak pobierać różne typy raportów za pomocą metody YouTube Analytics API. Każdy przykład zawiera krótki opis pobieranego przez żądanie raportu, a następnie wymiary, dane, filtry i parametry sortowania dotyczące żądania.
-
Wymiar
insightTrafficSourceType
obsługuje teraz prawidłową wartośćSUBSCRIBER
. Ta wartość identyfikuje wyświetlenia filmów, które pochodzą z kanałów na stronie głównej YouTube lub z funkcji subskrypcji YouTube. Jeśli filtrujesz według tego źródła wizyt, poleinsightTrafficSourceDetail
zawiera kanał strony głównej lub inną stronę, z której zostały odesłane wyświetlenia. -
Interfejs API obsługuje teraz 2 nowe rodzaje danych:
annotationClickThroughRate
iannotationCloseRate
, które odnoszą się do interakcji widzów z adnotacjami wyświetlanymi w filmach. Zaktualizowaliśmy listy raportów dotyczących kanałów i raportów właścicieli treści, by identyfikować raporty, które obsługują te nowe dane.annotationClickThroughRate
– stosunek liczby kliknięć adnotacji przez widzów do łącznej liczby wyświetleń adnotacji, które można kliknąć.annotationCloseRate
– stosunek adnotacji zamkniętych przez widzów do łącznej liczby wyświetleń adnotacji.
-
Interfejs API obsługuje teraz dane o zarobkach i skuteczności reklam, a także nowe raporty skuteczności reklam. Wszystkie dane i raporty są dostępne wyłącznie dla dostawców treści w YouTube, którzy biorą udział w programie partnerskim YouTube.
-
Nowe raporty obejmują dane o skuteczności reklam wg odtworzeń oraz dane o skuteczności reklam w oparciu o liczbę wyświetleń. Aby dowiedzieć się więcej o raportach skuteczności reklam, zapoznaj się z dokumentacją raportów właścicieli treści.
-
Poniżej znajdziesz listę nowo obsługiwanych wskaźników. Zaktualizowaliśmy listę raportów właściciela treści, aby identyfikować raporty (obejmujące 2 nowe raporty, które obsługują te dane).
earnings
– całkowite szacunkowe zarobki ze wszystkich źródeł reklam sprzedawanych przez Google.grossRevenue
– szacunkowe przychody brutto od partnerów Google lub DoubleClick.primaryAdGrossRevenue
– szacunkowe przychody brutto z Google lub partnerów DoubleClick, zsumowane i sklasyfikowane w ramach głównego typu reklamy dla odtworzeń filmów, których dotyczy raport.monetizedPlaybacks
– liczba odtworzeń, podczas których wykonano co najmniej jedno wyświetlenie reklamy.playbackBasedCpm
– szacowany przychód brutto na tysiąc odtworzeń.impressions
– liczba zweryfikowanych wyświetleń reklam.impressionBasedCpm
– szacowane przychody brutto na tysiąc wyświetleń reklam.
Uwaga: szczegółowe informacje znajdziesz w definicjach danych.
-
Każde żądanie pobierające dane o zarobkach lub skuteczności reklam musi przesłać token autoryzacji, który przyznaje dostęp za pomocą nowego zakresu
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
.
-
-
Zmieniliśmy układ dokumentacji interfejsu API, aby różne typy raportów zostały objaśnione na osobnych stronach. Dlatego teraz dostępne są osobne strony z objaśnieniami różnych typów raportów dotyczących kanałów i raportów właścicieli treści.
-
W przewodniku po interfejsie API znajdziesz teraz sekcję examples z przykładami kodu, które pokazują, jak wywoływać interfejs API przy użyciu bibliotek klienckich Java, JavaScript, Python i Ruby. Przykładowy kod JavaScript jest taki sam jak ten omówiony szczegółowo w dokumentacji przykładowej aplikacji.
-
W Przewodniku po interfejsach API znajdziesz teraz polecenie APIs Explorer, które umożliwia wywoływanie interfejsu API, sprawdzanie żądań do interfejsu API i pobieranie rzeczywistych danych w odpowiedzi.
-
Ten interfejs API obsługuje szereg nowych raportów, które zostały opisane poniżej, zarówno dla kanałów, jak i właścicieli treści. Każdy raport jest dostępny jako raport kanału lub raport właściciela treści. Odpowiednio zaktualizowaliśmy też strony Wymiary i metrics.
-
Raport o miejscach odtwarzania podaje liczbę wyświetleń filmów na różnych rodzajach stron lub aplikacji.
-
Raport szczegółów o miejscu odtwarzania wskazuje odtwarzacze umieszczone na stronach, które wygenerowały najwięcej wyświetleń dla określonego filmu. Identyfikacja adresów URL powiązanych z najczęściej umieszczonymi odtwarzaczami zapewnia bardziej szczegółowy widok niż raport o miejscach odtwarzania.
-
Raport o źródłach wizyt podaje liczbę wyświetleń filmów pochodzących z różnych typów stron odsyłających.
-
Raport Szczegółów źródła wizyt wskazuje strony odsyłające, które wygenerowały najwięcej wyświetleń dla określonego filmu, oraz określonego typu źródła wizyt. Mogą one obejmować na przykład podobne filmy, które przyciągnęły największy ruch do konkretnego filmu. Ten raport jest obsługiwany dla kilku źródeł wizyt.
-
Raporty Czas oglądania zawierają informacje o czasie, jaki widzowie spędzili na oglądaniu Twoich treści. Raporty mogą zawierać dane zbiorcze z określonego przedziału czasu – dnia, ostatnich 7 dni, poprzednich 30 dni itd. – lub kraju. Jeśli dane w raporcie są zbierane według dnia lub kraju, możesz w nim też określić średnią długość każdego wyświetlenia filmu oraz średni procent każdego filmu obejrzanego przez użytkownika.
-
-
Aplikacja YouTube Analytics API jest już dostępna dla wszystkich deweloperów. Interfejs API swojego projektu możesz aktywować w panelu Usługi w APIs console bez konieczności uprzedniego wysyłania prośby o dostęp.
-
Nowa sekcja Pierwsze kroki zawiera informacje o wymaganiach wstępnych i podstawowych krokach do tworzenia aplikacji korzystających z YouTube Analytics API.
-
Nowa sekcja dotycząca wykorzystania limitu zawiera wskazówki dotyczące optymalizacji wykorzystania limitu interfejsu API. Serwer API oblicza koszt zapytania dla każdego żądania i odejmuje go od limitu wykorzystania interfejsu API. Różne typy raportów mogą wiązać się z znacznie różniącymi się kosztami zapytań, dlatego musisz dobrze zaplanować wykorzystanie limitu, a aplikacja powinna żądać tylko tych danych i danych, których rzeczywiście potrzebuje.
-
Zaktualizowaliśmy sekcję dotyczącą wymiarów tymczasowych, aby zawierała wyjaśnienie, że wskazują one, że raport Analytics powinien agregować dane według przedziału czasu. Interfejs API obsługuje teraz te dodatkowe wymiary czasowe:
7DayTotals
– dane w raporcie będą agregowane, tak aby każdy wiersz zawierał dane z 7 dni.30DayTotals
– dane w raporcie będą agregowane, tak aby każdy wiersz zawierał dane z 30 dni.month
– dane w raporcie zostaną agregowane według miesiąca kalendarzowego.
Podobnie zaktualizowaliśmy sekcję Dostępne raporty, by uwzględnić w nich obsługę raportów korzystających z tych wymiarów przez interfejs API.
-
Zaktualizowaliśmy sekcję Wymiary jednostki raportowania, by uwzględnić, że żądania API pobierania raportów właściciela treści muszą filtrować dane przy użyciu jednego z tych wymiarów (
video
,channel
lubshow
) albo obsługiwanej kombinacji wymiarówclaimedStatus
iuploaderType
. -
Interfejs API obsługuje teraz dwie nowe opcje sortowania raportów dotyczących najpopularniejszych filmów. Raporty, dostępne jako raporty kanału lub właściciela treści, zawierają dane (wyświetlenia, komentarze, polubienia itp.) z podziałem na kraje i podzielone według filmów. Możesz teraz sortować te raporty według liczby użytkowników, którzy zasubskrybowali kanał lub zrezygnowali z subskrypcji na stronie odtwarzania filmu.
-
Definicje metrics
subscribersGained
isubscribersLost
zostały zaktualizowane, aby wyjaśnić, że kanał może zyskać lub stracić subskrybentów w kilku miejscach, takich jak strona odtwarzania filmu, strona kanału i przewodnik wyświetlany na stronie głównej YouTube. Gdy te dane są widoczne w raporcie dotyczącym konkretnego filmu, obejmują tylko statystyki ze strony odtwarzania konkretnego filmu.
Interfejs YouTube Reporting API obsługuje trzy nowe raporty ekranów końcowych oraz nowe wymiary i dane. Raporty te zawierają statystyki wyświetleń i kliknięć ekranów końcowych, które pojawiają się po zatrzymaniu odtwarzania filmu.
Więcej informacji o dodawaniu ekranów końcowych do filmów znajdziesz w Centrum pomocy YouTube.
8 listopada 2016 r.
Ta aktualizacja wiąże się z następującymi zmianami w YouTube Analytics API:
27 października 2016 r.
Teraz YouTube automatycznie generuje zestaw zarządzanych przez system raportów o przychodach z reklam dla właścicieli treści, którzy mają dostęp do odpowiednich raportów w sekcji Raporty w Studiu twórców YouTube. Nowe raporty interfejsu API zarządzane przez system mają zapewnić zautomatyzowany dostęp do danych, które są również dostępne w ręcznie możliwych do pobrania raportach ze Studia twórców.
W sekcji Omówienie raportów zarządzanych przez system znajdziesz krótkie omówienie nowych raportów i wyjaśnienie procesu ich pobierania przez interfejs API. Ten proces różni się nieco od pobierania raportów zbiorczych w Statystykach YouTube, ponieważ partnerzy nie muszą planować zadań, aby wygenerować raporty.
Zaktualizowaliśmy właściwość id
zasobu reportType
, aby uwzględnić listę raportów zarządzanych przez system, do których możesz uzyskać dostęp za pomocą interfejsu API:
27 września 2016 r.
Uwaga: to jest powiadomienie o wycofaniu tych funkcji.
Dane uniques
interfejsu YouTube Analytics API zostały wycofane. Nie są to podstawowe dane i będą obsługiwane do 31 października 2016 r.
15 września 2016 r.
Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Reporting API:
19 sierpnia 2016 r.
Ta aktualizacja wprowadza tę zmianę w interfejsie YouTube Reporting API:
11 sierpnia 2016 r.
Ta aktualizacja zawiera następujące zmiany:
10 sierpnia 2016 r.
Ta aktualizacja obejmuje te zmiany:
18 lipca 2016 r.
Ta aktualizacja obejmuje te zmiany:
28 czerwca 2016 r.
Dokumentacja interfejsu YouTube Analytics API została zaktualizowana, aby uwzględniała dane karty w wielu raportach dotyczących kanałów i właścicieli treści. Nowe obsługiwane dane to:
Dane te są obsługiwane w tych typach raportów:
22 czerwca 2016 r.
Ta aktualizacja wprowadza następujące zmiany w interfejsie YouTube Reporting API. Pierwsza zmiana dotyczy ogólnie interfejsu API, a pozostałe dotyczą tylko raportów właścicieli treści:
19 maja 2016 r.
Ta aktualizacja wprowadza te zmiany w interfejsie YouTube Reporting API:
12 kwietnia 2016 r.
Ta aktualizacja wprowadza następujące zmiany, z których wszystkie będą miały wpływ tylko na interfejs YouTube Reporting API:
28 marca 2016 r.
Interfejs YouTube Reporting API i YouTube Analytics API zwracają teraz statystyki wyświetleń dla kilku dodatkowych usług udostępniania.
16 marca 2016 r.
Ta aktualizacja wprowadza następujące zmiany, które będą miały wpływ na interfejs YouTube Reporting API oraz YouTube Analytics API:
Interfejs API YouTube do raportowania
YouTube Analytics API
8 lutego 2016 r.
Zaktualizowaliśmy listę danych obsługiwanych przez YouTube Analytics API, dzięki czemu dane karty nie są już wymienione jako obsługiwane przez ten interfejs API. (Żaden z raportów tego interfejsu API nie został udokumentowany jako pomoc w zakresie danych karty).
Pamiętaj, że nadal możesz pobierać dane karty za pomocą interfejsu YouTube Reporting API, który obsługuje te dane w wielu raportach dotyczących kanałów i właścicieli treści.
Styczeń 6, 2016
Zarówno YouTube Reporting API, jak i YouTube Analytics API identyfikują teraz wyświetlenia, które mają miejsce na urządzeniu Chromecast.
21 grudnia 2015 r.
W dokumentacji nazwy danych annotation_clickable_impressions
i annotation_closable_impressions
zostały zaktualizowane, tak aby odpowiadały nazwom wyświetlanym w raportach. Wcześniej nazwy te były podane jako clickable_annotation_impressions
i closable_annotation_impressions
.
18 grudnia 2015 r.
Przepisy Unii Europejskiej (UE) wymagają udostępnienia określonych informacji użytkownikom z Unii Europejskiej oraz uzyskania od nich zgody. Użytkownicy z Unii Europejskiej muszą więc przestrzegać polityki w zakresie zgody użytkownika z UE. Dodaliśmy informację o tym wymaganiu w Warunkach korzystania z interfejsu API YouTube.
15 grudnia 2015 r.
Ta aktualizacja wprowadza następujące zmiany, z których wszystkie będą miały wpływ na interfejs YouTube Analytics API:
10 listopada 2015 r.
Ta aktualizacja zawiera następujące zmiany:
29 października 2015 r.
Ta aktualizacja zawiera następujące zmiany:
8 października 2015 r.
Ta aktualizacja zawiera następujące zmiany:
24 września 2015 r.
Ta aktualizacja zawiera następujące zmiany:
20 sierpnia 2015 r.
Ta aktualizacja zawiera następujące zmiany:
22 lipca 2015 r.
W ramach tej aktualizacji wprowadziliśmy kilka zmian, z których wszystkie dotyczą tylko właścicieli treści:
1 czerwca 2015 r.
Ta aktualizacja zawiera następujące zmiany:
31 marca 2015 r.
Ta aktualizacja zawiera następujące zmiany:
16 marca 2015 r.
Ta aktualizacja zawiera następujące zmiany:
25 lutego 2015 r.
Ta aktualizacja zawiera następujące zmiany:
13 lutego 2015 r.
Ta aktualizacja zawiera następujące zmiany:
28 sierpnia 2014 r.
Ta aktualizacja zawiera następujące zmiany:
16 lipca 2014 r.
Ta aktualizacja zawiera następujące zmiany:
31 stycznia 2014 r.
Ta aktualizacja zawiera następujące zmiany:
16 stycznia 2014 r.
Ta aktualizacja zawiera następujące zmiany:
6 stycznia 2014 r.
Ta aktualizacja zawiera następujące zmiany:
30 września 2013 r.
Ta aktualizacja zawiera następujące zmiany:
16 lipca 2013 r.
Ta aktualizacja zawiera następujące zmiany:
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:
3 maja 2013 r.
Ta aktualizacja zawiera następujące zmiany:
28 marca 2013 r.
Ta aktualizacja zawiera następujące zmiany:
21 marca 2013 r.
Ta aktualizacja zawiera następujące zmiany:
4 lutego 2013 r.
Ta aktualizacja zawiera następujące zmiany:
14 listopada 2012 r.
Ta aktualizacja zawiera następujące zmiany:
2 października 2012 r.
Ta aktualizacja zawiera następujące zmiany:
12 września 2012 r.
Ta aktualizacja zawiera następujące zmiany: