Przykładowe żądania do interfejsu API

Raporty na temat filmów

Dane o dziennym czasie oglądania filmów na kanale

To zapytanie zwraca dzienną liczbę wyświetleń, dane o czasie oglądania i liczbę nowych subskrybentów filmów na kanale. Raport zwraca po 1 wierszu danych na każdy dzień w wybranym zakresie dat. Wiersze są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Dane dotyczące codziennych statystyk powiadomień na temat kanału

To żądanie umożliwia pobieranie dziennych liczb wyświetleń, współczynników klikalności adnotacji, współczynników zamknięć adnotacji i wyświetleń adnotacji dla treści na kanale. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Raporty dotyczące playlist

Dzienna liczba wyświetleń playlisty na kanale

Ta prośba pobiera liczbę wyświetleń dziennie (zbiorcze dane wideo), wyświetlenia playlisty (dane na poziomie playlisty), rozpoczęcia playlisty, szacowany czas oglądania oraz wyświetlenia na rozpoczęcie playlisty na autoryzowanym kanale użytkownika. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

Raporty na temat filmów

Dane o czasie oglądania filmów na kanale w poszczególnych krajach

To zapytanie pobiera liczbę wyświetleń w poszczególnych krajach, dane o czasie oglądania oraz dane dotyczące subskrypcji filmów z kanału. Raport zawiera jeden wiersz danych dla każdego kraju, w którym oglądane były filmy z danego kanału. Wiersze są sortowane malejąco według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Dane dotyczące adnotacji w poszczególnych krajach w przypadku filmów na kanale

To żądanie umożliwia pobranie liczby wyświetleń w poszczególnych krajach, współczynników klikalności adnotacji, współczynników zamykania adnotacji i wyświetleń adnotacji w filmach na kanale. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej, co oznacza, że kraj o najwyższym współczynniku klikalności adnotacji będzie wyświetlany jako pierwszy.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

Dane dotyczące poszczególnych stanów USA i Waszyngtonu, D.C.

Ta prośba umożliwia pobranie podziału według prowincji liczby wyświetleń, szacowanej liczby minut oglądania i średniego czasu oglądania filmów na kanale. Dane dotyczą stanów w USA i Waszyngtonu. Wyniki są sortowane alfabetycznie według kodów ISO 3166-2 prowincji.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Top 10 – najczęściej oglądane filmy w określonym kraju

To zapytanie zwraca 10 najpopularniejszych filmów na kanale, mierzonych liczbą wyświetleń w wybranym zakresie dat w określonym kraju. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: aby korzystać z tego raportu, musisz podać wartość parametru sort i ustawić parametr maxResults na wartość całkowitą równą 10 lub mniejszą.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 najpopularniejszych miast w Stanach Zjednoczonych według łącznej liczby wyświetleń

To zapytanie zwraca listę 10 miast w Stanach Zjednoczonych, w których treści na kanale uzyskały największą liczbę wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować, aby poprosić o dane dotyczące innego kraju, wybierając inną prawidłową wartość dla tego filtra. W podobny sposób zapytanie można zmodyfikować, aby pobrać dane dotyczące subkontynentu, np. Europy Zachodniej lub Azji Południowo-Wschodniej, za pomocą filtra subContinent i jednej z dozwolonych wartości. Obsługiwane są też inne filtry. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 największych miast w Stanach Zjednoczonych według łącznej liczby wyświetleń dla każdego typu treści

To zapytanie zwraca listę 10 miast w Stanach Zjednoczonych, w których treści na kanale uzyskały największą liczbę wyświetleń w wybranym zakresie dat dla każdego obsługiwanego typu treści twórcy. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 miast w USA o największym łącznym czasie oglądania

To zapytanie umożliwia pobranie listy 10 najpopularniejszych dni w wybranym zakresie dat, w których dowolne miasto w USA odnotowało najdłuższy łączny dzienny czas oglądania treści z tego kanału. Wyniki zapytania wskazują łączny czas oglądania, datę, w której nastąpiło obejrzenie treści, oraz miasto, w którym szacuje się, że treści te zostały obejrzane. Wyniki są posortowane w kolejności malejącej według łącznego czasu oglądania.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

Top 10 – najczęściej oglądane filmy w Europie

To zapytanie zwraca 10 najpopularniejszych filmów na kanale w Europie, mierzonych liczbą wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować, aby uzyskać dane dotyczące innego kontynentu, wybierając inną prawidłową wartość dla tego filtra. W podobny sposób zapytanie można zmodyfikować, aby pobrać dane dotyczące subkontynentu, np. Europy Zachodniej lub Azji Południowo-Wschodniej, za pomocą filtra subContinent i jednej z dozwolonych wartości. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: aby korzystać z tego raportu, musisz podać wartość parametru sort i ustawić parametr maxResults na wartość całkowitą równą 10 lub mniejszą.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Raporty dotyczące playlist

Dane dotyczące czasu oglądania playlist na kanale w poszczególnych krajach

To zapytanie pobiera liczbę wyświetleń z podziałem na kraj (zbiorcze dane o filmach), wyświetlenia playlist (dane na playliście) oraz dane dotyczące czasu oglądania playlist kanału. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym oglądane były playlisty kanału. Wiersze są sortowane malejąco według liczby obejrzanych minut.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

Top 10 – najczęściej uruchamiane playlisty w Stanach Zjednoczonych.

To zapytanie zwraca 10 playlist, które widzowie w Stanach Zjednoczonych najczęściej zaczęli oglądać w wybranym zakresie dat. Wyniki są sortowane według liczby odtworzeń playlisty w kolejności malejącej.

Uwaga: w tym raporcie używany jest wymiar playlist, dlatego musisz określić wartość parametru żądania sort i ustawić dla parametru maxResults liczbę całkowitą równą 10 lub mniejszą.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera liczbę wyświetleń i szacowany czas oglądania filmów z konkretnego kanału. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której odtwarzano film, i sortowane malejąco według liczby wyświetleń.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Dzienna liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera dzienną liczbę wyświetleń oraz szacowany czas oglądania filmów z danego kanału w Stanach Zjednoczonych. Wyniki są grupowane według dnia dla każdego typu strony lub aplikacji, w której odtwarzano film. Wyniki są sortowane w kolejności chronologicznej.

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

Top 10 – strony zewnętrzne, które wygenerowały najwięcej wyświetleń umieszczonego filmu

To zapytanie zwraca liczbę wyświetleń i szacowany czas oglądania konkretnego filmu lub grupy filmów. Wyniki są pogrupowane według witryny zewnętrznej, w której umieszczono film. Wyniki są sortowane malejąco według liczby wyświetleń. Aby wykonać to zapytanie w APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters listą rozdzieloną przecinkami zawierającą co najmniej 1 identyfikator przesłanego filmu.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Raporty dotyczące playlist

liczbę wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;

To zapytanie zwraca liczbę wyświetleń (zagregowane dane o filmach), wyświetleń playlist (dane dotyczące playlisty), szacowany czas oglądania oraz liczbę rozpoczętych playlist na danym kanale. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której odtwarzano film, a następnie sortowane w kolejności malejącej według liczby uruchomień playlisty.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

dzienna liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania;

To zapytanie zwraca dzienną liczbę rozpoczęcia oglądania playlisty, liczbę wyświetleń (zagregowane dane dotyczące filmu), wyświetlenia playlisty (dane dotyczące playlisty) oraz szacowany czas oglądania w Stanach Zjednoczonych w przypadku playlist konkretnego kanału. Wyniki są grupowane według dnia dla każdego typu strony lub aplikacji, na której wystąpiły wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

Raporty na temat filmów

Oceny pozytywne i negatywne według typu treści

To zapytanie pobiera liczbę polubień i głosów na nie dla każdego typu treści na kanale.

dimensions=creatorContentType
metrics=likes,dislikes

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych źródeł wizyt w danym kraju

To żądanie pobiera liczbę wyświetleń i szacowany czas oglądania filmów z kanału w wybranym kraju. Dane są agregowane według źródła wizyt, które opisuje sposób, w jaki użytkownicy dotarli do filmu.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Dzienna liczba wyświetleń i czas oglądania z różnych źródeł wizyt

To żądanie zwraca dzienną liczbę wyświetleń i szacowany dzienny czas oglądania filmów na kanale. Dane są agregowane codziennie według źródła wizyt i sortowane w kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 najpopularniejszych – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla filmu

To zapytanie zwraca 10 słów kluczowych, które wygenerowały najwięcej wyświetleń w wynikach wyszukiwania w YouTube dla jednego lub większej liczby konkretnych filmów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Aby wykonać to zapytanie w interfejsie APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters listą rozdzielanych przecinkami maksymalnie 500 identyfikatorów filmów.

Możesz na przykład uruchomić zapytanie dotyczące pojedynczego filmu lub zastąpić VIDEO_ID, aby znaleźć hasła wyszukiwania, które generują najwięcej ruchu dla tego filmu. Możesz też wymienić wszystkie filmy z danej playlisty, aby sprawdzić, które wyszukiwane hasła generują najwięcej ruchu.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – strony zewnętrzne, które generują najwięcej wizyt na filmie

To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń dla określonego filmu lub grupy filmów. Wyniki są sortowane według szacunkowego czasu oglądania w kolejności malejącej. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów filmów przesłanych przez Ciebie.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt w danym kraju

To żądanie pobiera liczbę wyświetleń (zbiorcze dane o filmach), wyświetlenia playlisty (dane na playliście), uruchomienia playlisty oraz szacowany czas oglądania w przypadku wyświetleń playlist w określonym kraju. Dane są agregowane według źródła wizyt, które opisuje sposób, w jaki użytkownicy dotarli do playlisty.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Liczba wyświetleń playlisty i czas oglądania z różnych źródeł wizyt

To żądanie pobiera dzienną liczbę wyświetleń playlist na kanale (dane na poziomie playlisty), liczbę rozpoczęcia playlisty i szacowany czas oglądania. Zwraca też łączną liczbę wyświetleń (zbiorcze dane o filmie). Dane są agregowane codziennie według źródła wizyt i posortowane w kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

Raporty na temat filmów

Dzienne dane o typie urządzeń z systemem operacyjnym Android

To zapytanie zwraca dzienną liczbę wyświetleń i szacowany czas oglądania na urządzeniach z Androidem filmów z konkretnego kanału. Wyniki są pogrupowane według dnia dla każdego typu urządzenia, na którym doszło do odtworzenia filmu. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Dane dzienne o systemie operacyjnym na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń oraz szacowany czas oglądania filmów z danego kanału na urządzeniach mobilnych. Wyniki są grupowane według dnia i każdego systemu operacyjnego, na którym odtwarzano film. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Dane dzienne dotyczące systemu operacyjnego i typu urządzenia

To zapytanie zwraca dzienną liczbę wyświetleń i szacowany czas oglądania na kanale. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Raporty dotyczące playlist

Dzienne dane o typie urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android

To zapytanie pobiera dzienne wyświetlenia (zbiorcze dane o filmach), wyświetlenia playlist (dane na playliście) oraz szacowany czas oglądania playlist z konkretnego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzenia, na którym miały miejsce wyświetlenia playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Dane dzienne dotyczące systemu operacyjnego w przypadku wyświetleń playlist na urządzeniach mobilnych

To zapytanie zwraca dzienną liczbę wyświetleń (zagregowane dane o filmach), liczbę wyświetleń z playlist (dane z playlisty) oraz szacowany czas oglądania na urządzeniach mobilnych w przypadku playlist na danym kanale. Wyniki są grupowane według dnia dla każdego systemu operacyjnego, w którym nastąpiło wyświetlenie playlisty. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

Raporty na temat filmów

Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)

Ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali filmy na kanale. Wyniki są sortowane według płci, a następnie grupy wiekowej. To zapytanie może zostać zmienione, by uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z kraju, kontynentu, subkontynentu lub innego stanu USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Raporty dotyczące playlist

Dane demograficzne widzów playlisty w Kalifornii (grupa wiekowa i płeć)

Ten raport zawiera statystyki dotyczące wieku i płci widzów w Kalifornii, którzy obejrzeli playlisty na kanale. Wyniki są sortowane według płci, a następnie grupy wiekowej. To zapytanie można zmodyfikować, aby uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z kraju, kontynentu, subkontynentu lub innego stanu USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Dane o udostępnianiu, zagregowane według usługi, w której udostępniono filmy

To żądanie zwraca liczbę razy, gdy użytkownicy użyli przycisku Share, aby udostępnić filmy z kanału. Wyniki są agregowane według usługi udostępniania (Google+, Twitter itp.) i sortowane w malejącym porządku według liczby udostępnień.

dimensions=sharingService
metrics=shares
sort=-shares

dane dotyczące utrzymania uwagi odbiorców dla filmu;

Ten raport mierzy zdolność filmu do utrzymywania uwagi odbiorców. Raport można pobrać tylko w przypadku jednego filmu naraz. Aby wykonać to zapytanie w interfejsie APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters identyfikatorem jednego z przesłanych filmów. Pamiętaj, że w raportach o utrzymaniu uwagi odbiorców nie można określić wielu wartości filtra video.

W tym przykładzie raport korzysta z filtra audienceType, aby ograniczyć odpowiedź, tak aby zawierała tylko dane o bezpłatnych wyświetleniach, które są wynikiem bezpośredniego działania użytkownika, takiego jak wyszukiwanie filmu lub kliknięcie proponowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam In-Stream TrueView ani reklam In-Display TrueView. Możesz usunąć filtr, aby pobrać dane dotyczące utrzymania uwagi odbiorców dla filmu dla wszystkich typów odbiorców.

Pamiętaj, że dane dla filtra audienceType są dostępne od 25 września 2013 r. Interfejs API nie zwraca danych w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie używają filtra, działają w przypadku każdej daty po 1 lipca 2008 r.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Dane o przychodach z kanału i skuteczności reklam

Ta prośba umożliwia pobieranie danych o przychodach i skuteczności reklam na kanale. Raport zwraca 1 wiersz danych z łącznymi wartościami poszczególnych żądanych danych w wybranym zakresie dat.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Dane o dochodach i skuteczności reklamy

Ta prośba pobiera dane o codziennych przychodach i skuteczności reklam na kanale.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Dane o przychodach i skuteczności reklamy w poszczególnych krajach

To zapytanie zwraca dane o przychodach i skuteczności reklam na kanale w poszczególnych krajach. Wyniki są posortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy wymieniony kraj jest tym, w którym partner osiągnął największe przychody netto.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

Top 10 – filmy z najwyższymi przychodami

To żądanie pobiera dane o przychodach i skuteczności reklam w przypadku 10 filmów na kanale, które przyniosły największe przychody. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszym filmem będzie ten, który miał najwyższy szacowany przychód.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Dane o skuteczności różnych typów reklam

To żądanie umożliwia pobranie danych o skuteczności reklam w przypadku treści, do których właściciel treści zgłosił roszczenie. Wyniki są grupowane według typu reklamy, co umożliwia porównywanie wartości przychodów i CPM w różnych typach reklam.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

Raporty na temat filmów

Dane dotyczące dziennego czasu oglądania dla treści przesłanych przez siebie

To zapytanie zwraca dzienne dane o czasie oglądania, a także liczbę wyświetleń, zarabiających odtworzeń i wyświetleń filmów przesłanych przez właściciela treści. Raport zwraca po jednym wierszu danych na każdy dzień z wybranego zakresu dat, a wiersze są posortowane w kolejności chronologicznej.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Dane dotyczące adnotacji w przypadku treści objętych roszczeniem

To żądanie umożliwia pobieranie dziennych liczb wyświetleń, współczynników klikalności adnotacji, współczynników zamknięcia adnotacji i wyświetleń adnotacji w przypadku treści, których właściciel zażądał ochrony. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Raporty dotyczące playlist

Wyświetlenia playlisty dziennie dla właściciela treści

To żądanie zwraca dane dotyczące codziennych interakcji użytkowników z filmami na playlistach właściciela treści. Dane pobierane w raporcie to playlistViews, playlistStarts, playlistEstimatedMinutesWatched i viewsPerPlaylistStart. Wszystkie te dane są danymi na poziomie playlisty. Wszystkie żądane dane dotyczą playlisty, więc w prośbie nie musisz też uwzględniać filtra playlisty ani grupy.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

Raporty na temat filmów

Dane dotyczące czasu oglądania w poszczególnych krajach w przypadku treści przesłanych przez Ciebie

To zapytanie pobiera liczbę wyświetleń, dane o czasie oglądania i szacunkowe przychody z reklam w poszczególnych krajach. Dane dotyczą filmów przesłanych przez właściciela treści. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym filmy były oglądane. Wiersze są sortowane w kolejności malejącej według liczby minut oglądania.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Dane o adnotacji w poszczególnych krajach dotyczące treści przesłanych przez użytkowników

To żądanie zwraca liczbę wyświetleń w poszczególnych krajach, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji i wyświetlenia adnotacji w przypadku przesłanych filmów właściciela treści. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej, co oznacza, że kraj o najwyższym współczynniku klikalności adnotacji będzie wyświetlany jako pierwszy.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

Dane dotyczące poszczególnych prowincji w Stanach Zjednoczonych i Waszyngtonie

Ta prośba umożliwia uzyskanie podziału według prowincji liczby wyświetleń, szacowanego czasu oglądania i średniego czasu oglądania filmów objętych roszczeniem właściciela treści. Dane obejmują stany USA i Waszyngton. Wyniki są sortowane alfabetycznie według kodów ISO 3166-2 poszczególnych prowincji.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 najpopularniejszych miast w Stanach Zjednoczonych według łącznej liczby wyświetleń

To zapytanie zwraca listę 10 miast w Stanach Zjednoczonych, w których w wybranym zakresie dat odbyło się najwięcej wyświetleń filmów z roszczeniem właściciela treści. Zapytanie można zmodyfikować, aby pobrać dane dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. W podobny sposób zapytanie można zmodyfikować, aby pobrać dane dotyczące subkontynentu, np. Europy Zachodniej lub Azji Południowo-Wschodniej, za pomocą filtra subContinent i jednej z dozwolonych wartości. Obsługiwane są też inne filtry. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 największych miast w Stanach Zjednoczonych według łącznej liczby wyświetleń dla każdego typu treści

To zapytanie zwraca listę 10 miast w Stanach Zjednoczonych, w których zarejestrowano najwięcej wyświetleń treści objętych roszczeniem właściciela w określonym zakresie dat dla każdego obsługiwanego typu treści twórcy. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 najpopularniejszych miast w Stanach Zjednoczonych według łącznego czasu oglądania

To zapytanie zwraca listę 10 najlepszych dni w wybranym zakresie dat, w których dowolne miasto w Stanach Zjednoczonych miało największy łączny dzienny czas oglądania treści zgłoszonych przez właściciela treści. Wyniki zapytania zawierają łączny czas oglądania, datę i godzinę obejrzenia oraz miasto, w którym według szacunków treści zostały wyświetlone. Wyniki są sortowane w kolejności malejącej według łącznego czasu oglądania.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 najpopularniejszych filmów w Europie

To zapytanie umożliwia pobranie 10 najczęściej oglądanych filmów w Europie spośród filmów objętych roszczeniem właściciela treści, które zostały określone na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, aby żądało danych z innego kontynentu. Aby to zrobić, wybierz inną prawidłową wartość dla tego filtra. W podobny sposób zapytanie można zmodyfikować, aby pobrać dane dotyczące subkontynentu, np. Europy Zachodniej lub Azji Południowo-Wschodniej, za pomocą filtra subContinent i jednej z dozwolonych wartości. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Dane o czasie oglądania w poszczególnych krajach dotyczące playlist właściciela treści

To zapytanie zwraca liczbę wyświetleń i czas oglądania playlisty w danym kraju dla wszystkich playlist na kanałach właściciela treści. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym odtwarzano playlisty. Wiersze są sortowane w kolejności malejącej według liczby obejrzanych minut.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

Top 10 – najczęściej uruchamiane playlisty w Stanach Zjednoczonych.

To zapytanie zwraca 10 playlist z kanałów właściciela treści, które widzowie w Stanach Zjednoczonych najczęściej zaczęli oglądać w wybranym zakresie dat. Wyniki są sortowane według liczby rozpoczęć playlisty w kolejności malejącej.

Uwaga: ten raport używa wymiaru playlist, więc musisz podać wartość parametru sort w żądaniu oraz ustawić parametr maxResults na wartość całkowitą równą co najmniej 10.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

Raporty na temat filmów

Oznaczenia „Podoba mi się” i „Nie podoba mi się” według typu treści

To zapytanie zwraca liczbę polubień i głosów na nie dla każdego typu treści na danym kanale lub grupie kanałów. Aby wykonać to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów kanałów.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych miejsc odtwarzania

To zapytanie zwraca liczbę wyświetleń i szacowany czas oglądania filmów przesłanych na konkretny kanał lub grupę kanałów. Wyniki są agregowane na podstawie typu strony lub aplikacji, na której odtwarzano film, i sortowane malejąco według liczby wyświetleń. Aby wykonać to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów kanałów.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

dzienna liczba wyświetleń i czas oglądania z różnych lokalizacji odtwarzania;

To zapytanie pobiera dzienną liczbę wyświetleń oraz szacowany czas oglądania w Stanach Zjednoczonych w przypadku filmów przesłanych na konkretny kanał lub określoną grupę kanałów. Wyniki są grupowane według dnia dla każdego typu strony lub aplikacji, w której odtwarzano film. Wyniki są sortowane w odwrotnej kolejności chronologicznej. Aby wykonać to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą rozdzielonych przecinkami maksymalnie 500 identyfikatorów kanałów.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

Top 10 – strony zewnętrzne, które wygenerowały najwięcej wyświetleń umieszczonego filmu

To zapytanie zwraca liczbę wyświetleń i szacowany czas oglądania konkretnego filmu lub grupy filmów. Wyniki są grupowane według strony zewnętrznej, na której film został umieszczony. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Aby wykonać to zapytanie w APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów przesłanych filmów.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Raporty dotyczące playlist

Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania

To zapytanie zwraca liczbę wyświetleń playlisty, szacowany czas oglądania playlisty oraz liczbę rozpoczęć playlisty na wszystkich kanałach właściciela treści. Wyniki są zagregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w kolejności malejącej według rozpoczęcia playlisty.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Liczba wyświetleń playlisty i czas oglądania z różnych miejsc odtwarzania

To zapytanie pobiera dzienne rozpoczęcia playlisty, liczbę wyświetleń playlisty oraz szacowany czas oglądania w Stanach Zjednoczonych w przypadku wszystkich playlist na kanałach właściciela treści. Wyniki są zwracane dla każdego typu strony lub aplikacji, na której wystąpiło wyświetlenie playlisty.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

Raporty na temat filmów

Liczba wyświetleń i czas oglądania z różnych źródeł wizyt

Ta prośba pobiera liczbę wyświetleń i szacowany czas oglądania filmów właściciela treści. Dane są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali do filmu.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Liczba wyświetleń i czas oglądania z różnych źródeł wizyt

Ta prośba umożliwia pobranie dziennej liczby wyświetleń i szacowanego dziennego czasu oglądania filmów właściciela treści. Dane są agregowane codziennie według źródła wizyt i sortowane w odwrotnej kolejności chronologicznej.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Uwaga: 2 kolejne przykładowe raporty są obsługiwane tylko w przypadku określonych źródeł wizyt. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES i NO_LINK_EMBEDDED to niektóre z nieobsługiwanych źródeł wizyt.

Top 10 – wyszukiwane słowa w YouTube, które generują najwięcej ruchu dla filmu.

To zapytanie zwraca 10 wyszukiwanych słów, które wygenerowały najwięcej wyświetleń w wynikach wyszukiwania w YouTube w przypadku konkretnego filmu lub grupy filmów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Aby wykonać to zapytanie w APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów przesłanych filmów.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

Top 10 – strony zewnętrzne, które generują najwięcej wizyt na filmie

To zapytanie zwraca 10 zewnętrznych witryn, które uzyskały najwięcej wyświetleń w wynikach wyszukiwania Google dla konkretnego filmu lub grupy filmów. Wyniki są sortowane według szacunkowego czasu oglądania w kolejności malejącej. Aby wykonać to zapytanie w APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów przesłanych filmów.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Raporty dotyczące playlist

Liczba wyświetleń playlist i czas oglądania z różnych źródeł wizyt w danym kraju

To żądanie pobiera liczbę wyświetleń playlisty, rozpoczęcia odtwarzania playlisty oraz szacowany czas oglądania playlisty dla wyświetleń playlisty w określonym kraju. Dane są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali do playlisty.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

liczbę wyświetleń playlisty i czas oglądania z różnych źródeł wizyt;

To żądanie umożliwia uzyskanie danych dotyczących wyświetleń playlist, rozpoczęcia playlist i szacowanego czasu oglądania playlist na co najmniej jednym kanale właściciela treści. Wskaźniki są agregowane według źródła wizyt. Aby wykonać to zapytanie w eksploratorze interfejsów API, musisz zastąpić ciąg znaków CHANNEL_ID w wartości parametru filters rozdzieloną przecinkami listą maksymalnie 500 identyfikatorów kanałów.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

Raporty na temat filmów

Dane dzienne o typach urządzeń w przypadku filmów objętych roszczeniem

To zapytanie zwraca liczbę wyświetleń dziennie i szacowany czas oglądania według typu urządzenia w przypadku filmów, do których zgłoszono roszczenie przez konkretnego właściciela treści. Wyniki są grupowane według dnia i typu urządzenia, na którym odtwarzano film. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Dane dzienne dotyczące systemu operacyjnego w przypadku roszczeń dotyczących filmów wyświetlanych na urządzeniach mobilnych

To zapytanie zwraca liczbę wyświetleń dziennie i szacowany czas oglądania według systemu operacyjnego w przypadku filmów, które zostały objęte roszczeniem przez określonego właściciela treści i które zostały obejrzane na urządzeniach mobilnych. Wyniki są grupowane według dnia dla każdego systemu operacyjnego, w którym odtwarzano film. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Dzienne dane dotyczące systemu operacyjnego i typu urządzenia

To zapytanie zwraca liczbę wyświetleń dziennie i szacowany czas oglądania filmów objętych roszczeniem przez konkretnego właściciela treści. Statystyki są grupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane w kolejności chronologicznej.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Raporty dotyczące playlist

Dane o typach urządzeń w przypadku wyświetleń playlist w systemie operacyjnym Android

To zapytanie pobiera liczbę wyświetleń playlist i szacowany czas oglądania playlisty na urządzeniach z Androidem w przypadku playlist na co najmniej jednym kanale właściciela treści. Wyniki są zwracane dla każdego typu urządzenia, na którym nastąpiło wyświetlenie playlisty. Aby wykonać to zapytanie w sekcji Eksplorator interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą rozdzielonych przecinkami identyfikatorów maksymalnie 500 kanałów.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Dane o systemie operacyjnym dotyczące wyświetleń playlist na urządzeniach mobilnych

To zapytanie zwraca liczbę wyświetleń playlisty i szacowany czas oglądania na urządzeniach mobilnych dla playlist na dowolnym kanale właściciela treści. Zwracane są wyniki dla każdego systemu operacyjnego, w którym wystąpiły wyświetlenia playlist.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

Raporty na temat filmów

Dane demograficzne widzów w Kalifornii (grupa wiekowa i płeć)

Ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów w Kalifornii, którzy oglądali treści objęte roszczeniem właściciela treści. Wyniki są sortowane według płci, a następnie grupy wiekowej. To zapytanie może zostać zmienione, by uzyskać te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z kraju, kontynentu, subkontynentu lub innego stanu USA, dostosowując wartość parametru filters.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Dane o udostępnianiu, zagregowane według usługi, w której udostępniono filmy

To żądanie zwraca liczbę razy, gdy użytkownicy użyli przycisku Share, aby udostępnić filmy przesłane przez właściciela treści. Wyniki są agregowane według usługi udostępniania (Google+, Twitter itp.) i sortowane w malejącym porządku według liczby udostępnień.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

Dane dotyczące utrzymania uwagi odbiorców przez film

Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko w przypadku jednego filmu naraz. Aby wykonać to zapytanie w interfejsie APIs Explorer, musisz zastąpić ciąg znaków VIDEO_ID w wartości parametru filters identyfikatorem jednego z przesłanych filmów. Pamiętaj, że w raportach o utrzymaniu uwagi odbiorców nie można określić wielu wartości filtra video.

W tym przykładzie raport używa filtra audienceType, aby ograniczyć odpowiedź tak, aby zawierała tylko dane o bezpłatnych wyświetleniach, które są wynikiem bezpośredniego działania użytkownika, np. wyszukiwania filmu lub kliknięcia sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream i TrueView In-Display. Możesz usunąć filtr, aby pobrać dane dotyczące utrzymania uwagi odbiorców dla wszystkich typów odbiorców.

Pamiętaj, że dane dla filtra audienceType są dostępne od 25 września 2013 r. Interfejs API nie zwraca danych w przypadku zapytań, które używają filtra do próby pobrania danych z wcześniejszych dat. Zapytania, które nie korzystają z filtra, działają w przypadku każdej daty po 1 lipca 2008 r.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

Dane o przychodach i skuteczności reklam w przypadku treści zgłoszonych do Google

To żądanie umożliwia pobranie danych o przychodach i skuteczności reklam w przypadku treści objętych roszczeniem przez właściciela treści. Raport zwraca 1 wiersz danych z łącznymi wartościami poszczególnych żądanych danych w wybranym zakresie dat.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Dane o dochodach i skuteczności reklamy

To żądanie pobiera dzienne dane o przychodach i skuteczności reklam, które dotyczą treści objętych roszczeniem właściciela treści.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Dane o przychodach i skuteczności reklamy w poszczególnych krajach

To żądanie umożliwia pobranie danych o przychodach i skuteczności reklam w przypadku treści zgłoszonych przez właściciela treści. Wyniki są sortowane w malejącym porządku według kwoty przychodu, co oznacza, że pierwszym krajem na liście będzie ten, w którym partner miał najwyższy szacowany przychód.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

Top 10 – filmy z najwyższymi przychodami

Ta prośba pobiera dane o przychodach i skuteczności reklam w przypadku 10 filmów, które zostały zgłoszone przez właściciela treści i które przyniosły najwyższe przychody. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że pierwszy film będzie tym, który ma najwyższe szacunkowe przychody.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Dane o skuteczności różnych typów reklam

To żądanie umożliwia pobranie danych o skuteczności reklam w przypadku treści, do których właściciel treści zgłosił roszczenie. Wyniki są grupowane według typu reklamy, co umożliwia porównywanie wartości przychodów i CPM w różnych typach reklam.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType