Przykładowe żądania do interfejsu API

Raporty na temat filmów

Dane dotyczące dziennego czasu oglądania filmów na kanale

To zapytanie pobiera dzienną liczbę wyświetleń, dane dotyczące czasu oglądania i nowych subskrybentów filmów z kanału. Raport zwraca jeden wiersz danych dla każdego dnia w żądanym zakresie dat. Wiersze są sortowane chronologicznie.

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

Dzienne wskaźniki adnotacji do filmów na kanale

To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści kanału. Wyniki są sortowane chronologicznie.

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

Raporty dotyczące playlist

Dzienne wyświetlenia playlisty na kanale

To żądanie pobiera dzienną liczbę wyświetleń (zbiorcze dane o filmach), wyświetlenia playlisty (dane na playliście), rozpoczęcia odtwarzania playlisty, szacowany czas oglądania oraz liczbę wyświetleń na rozpoczęcie playlisty z kanału uwierzytelnionego użytkownika. Wyniki są sortowane chronologicznie.

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

Pobiera ono liczbę wyświetleń w poszczególnych krajach, dane o czasie oglądania i liczbę subskrypcji filmów z danego kanału. Raport zawiera po jednym wierszu danych dla każdego kraju, w którym widzowie oglądali filmy na kanale. Wiersze są posortowane malejąco według liczby obejrzanych minut.

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

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

To żądanie pobiera liczbę wyświetleń w poszczególnych krajach, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz wyświetlenia adnotacji do filmów 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 jest wymieniony jako pierwszy.

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

Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu

Pobiera ono dane o liczbie wyświetleń, szacowanym czasie oglądania i średnim czasie oglądania filmów z kanału w poszczególnych prowincjach. Dane dotyczą stanó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

10 najpopularniejszych filmów – najczęściej oglądane filmy w danym kraju

To zapytanie pobiera 10 najczęściej oglądanych filmów na kanale według liczby wyświetleń w wybranym kraju w wybranym zakresie dat. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą nie większą niż 10.

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

10 miast w USA o największej łącznej liczbie wyświetleń

To zapytanie pobiera listę 10 miast w USA, które wygenerowały najwięcej wyświetleń treści na kanale w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych wartości. Inne filtry również są obsługiwane. 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 miast w USA o największej łącznej liczbie wyświetleń dla każdego typu treści

To zapytanie pobiera listę 10 miast w USA, które wygenerowały najwięcej wyświetleń treści na kanale w wybranym zakresie dat dla każdego obsługiwanego elementu creatorContentType. 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 pobiera listę 10 dni najpopularniejszych w wybranym zakresie dat, kiedy to dowolne miasto w USA miało największy dzienny czas oglądania treści na kanale. Wyniki zapytania zawierają całkowity czas oglądania, datę czasu oglądania oraz miasto, w którym według szacunków treści były oglądane. Wyniki są posortowane malejąco 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 pobiera 10 filmów najczęściej oglądanych przez kanał w Europie. Dane zmierzono na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kontynentu, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych wartości. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej.

Uwaga: ten raport wymaga określenia wartości parametru żądania sort i ustawienia parametru maxResults na liczbę całkowitą nie większą niż 10.

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

Raporty dotyczące playlist

Dane o czasie oglądania playlist kanału w poszczególnych krajach

To zapytanie pobiera liczbę wyświetleń w poszczególnych krajach (zbiorcze dane o filmach), liczbę wyświetleń playlist (dane playlisty) i dane o czasie oglądania dotyczące playlist kanału. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym oglądano playlisty na kanale. Wiersze są posortowane malejąco według liczby obejrzanych minut.

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

Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych

To zapytanie pobiera 10 playlist, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby początków playlisty w kolejności malejącej.

Uwaga: w tym raporcie używany jest wymiar playlist, więc musisz określić wartość parametru żądania sort, a także ustawić parametr maxResults na liczbę całkowitą nie większą niż 10.

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 określonego kanału. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń.

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

Dzienne liczby wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału w Stanach Zjednoczonych. Wyniki są pogrupowane według dnia dla poszczególnych typów stron lub aplikacji, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.

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

Top 10 – witryny innych firm, które generują najwięcej wyświetleń dla umieszczonego filmu

To zapytanie pobiera liczbę wyświetleń i szacowany czas oglądania określonego filmu lub grupy filmów. Wyniki są pogrupowane według witryny, w której został umieszczony film. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą co najmniej jednego identyfikatora filmu oddzielonych przecinkami.

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

Raporty dotyczące playlist

liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.

To zapytanie pobiera informacje o liczbie wyświetleń (zbiorczych danych o filmach), wyświetleniach playlist (dane na playliście), szacowanym czasie oglądania oraz początkach odtwarzania playlisty na konkretnym kanale. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu, a wyniki są sortowane w kolejności malejącej według rozpoczęcia odtwarzania playlisty.

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

Dzienna liczba wyświetleń playlist i czas oglądania w różnych lokalizacjach odtwarzania

To zapytanie pobiera dzienną liczbę rozpoczęcia odtwarzania playlisty, liczbę wyświetleń (zbiorcze dane o filmach), liczbę wyświetleń playlist (dane na playliście) oraz szacowany czas oglądania w Stanach Zjednoczonych dla playlist konkretnego kanału. Wyniki są pogrupowane według dnia dla każdego typu strony lub aplikacji, w której wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.

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ę ocen pozytywnych i negatywnych dla każdego typu treści na kanale.

dimensions=creatorContentType
metrics=likes,dislikes

Raporty na temat filmów

liczby 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 danym kraju. Dane są agregowane według źródła wizyt, czyli w jaki sposób użytkownicy dotarli do filmu.

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

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

To żądanie pobiera dzienną liczbę wyświetleń i szacowany dzienny czas oglądania filmów z kanału. Dane są codziennie agregowane według źródła wizyt i sortowane chronologicznie.

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

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

Pobiera ono 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń w wynikach wyszukiwania w YouTube dla co najmniej jednego konkretnego filmu. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów filmów rozdzielonych przecinkami.

Możesz na przykład uruchomić zapytanie dotyczące pojedynczego filmu lub zastąpić VIDEO_ID, aby zidentyfikować wyszukiwane hasła, które generują najwięcej ruchu dla tego filmu. Możesz też wymienić wszystkie filmy na playliście, aby określić, które wyszukiwane hasła generują największy ruch w przypadku dowolnego z filmów z tej playlisty.

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

10 największych witryn – witryny zewnętrzne, które generują największy ruch związany z filmem

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 szacowanego czasu oglądania w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów przesłanych filmów, rozdzielonych przecinkami.

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

Raporty dotyczące playlist

liczby wyświetleń playlisty i czasu oglądania z różnych źródeł wizyt w danym kraju;

To żądanie pobiera informacje o liczbie wyświetleń (zbiorczych danych o filmach), wyświetleniach playlisty (w przypadku playlisty), rozpoczęcia odtwarzania playlisty oraz szacowanym czasie oglądania wyświetleń playlisty w danym kraju. Wskaźniki są agregowane według źródła wizyt, które określają, w jaki sposób użytkownicy dotarli do playlisty.

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

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

To żądanie pobiera dzienną liczbę wyświetleń playlisty z kanału (dane na playliście), rozpoczęcia odtwarzania playlisty i szacowany czas oglądania. Zbiera też łączną liczbę wyświetleń (zbiorcze dane o filmach). Dane są codziennie agregowane według źródła wizyt i sortowane chronologicznie.

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 pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których odtworzone zostały filmy. Wyniki są sortowane chronologicznie.

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

Dzienne dane o systemie operacyjnym na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z określonego kanału na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla poszczególnych systemów operacyjnych, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.

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

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

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania kanału. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane chronologicznie.

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

Raporty dotyczące playlist

Dzienne dane o typie urządzeń dotyczące wyświetleń playlist w systemie operacyjnym Android

To zapytanie pobiera liczbę wyświetleń dziennie (zbiorcze dane o filmach), wyświetleń playlist (dane na playliście) oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach z Androidem. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.

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

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

To zapytanie podaje liczbę dziennych wyświetleń (zbiorcze dane o filmach), wyświetleń playlist (dane na playliście) oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla każdego systemu operacyjnego, w którym wystąpiły wyświetlenia playlisty. Wyniki są sortowane chronologicznie.

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 z Kalifornii, którzy oglądali filmy na tym kanale. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters.

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

Raporty dotyczące playlist

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

Ten raport zawiera statystyki dotyczące grupy wiekowej i płci widzów z Kalifornii, którzy oglądali playlisty na kanale. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dotyczące wszystkich widzów z całego świata lub wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters.

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

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

To żądanie podaje, ile razy 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 kolejności malejącej według liczby udostępnień.

dimensions=sharingService
metrics=shares
sort=-shares

dane dotyczące utrzymania uwagi odbiorców dotyczące filmu,

Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla 1 filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem filmu jednego z przesłanych przez siebie filmów. Pamiętaj, że w raportach utrzymania 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, takiego jak wyszukiwanie filmu lub kliknięcie sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć ten filtr, aby pobrać dane o utrzymaniu uwagi odbiorców dotyczące 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 tego filtra, nie działają w przypadku dat po 1 lipca 2008 roku.

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

Dane dotyczące przychodów z kanału i skuteczności reklam

Pobiera ono dane o przychodach kanału i skuteczności reklam. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.

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

Dane o dziennych przychodach i skuteczności reklam

To żądanie pobiera dzienne dane o przychodach kanału i skuteczności reklam.

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

Dane dotyczące przychodów i skuteczności reklam w poszczególnych krajach

To żądanie pobiera dane o przychodach z kanału i skuteczności reklam w danym kraju. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy kraj na liście będzie krajem, w którym partner uzyskał największe przychody netto.

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

10 najlepszych – filmy z najwyższymi przychodami

Pobiera ono dane o przychodach i skuteczności reklam dla 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 pierwszy film będzie miał najwyższe szacunkowe przychody.

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

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

Pobiera ono dane o skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Wyniki są grupowane według typu reklamy, co pozwala porównać przychody i wartości CPM w przypadku różnych typów reklam.

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

Raporty na temat filmów

Statystyki dziennego czasu oglądania treści przesłanych przez siebie

To zapytanie pobiera dane o dziennym czasie oglądania, a także liczby wyświetleń i odtworzeń generujących przychody oraz liczby wyświetleń filmów przesłanych przez właściciela treści. Raport zwraca po jednym wierszu danych dla każdego dnia w żądanym zakresie dat, a wiersze są posortowane w kolejności chronologicznej.

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

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

To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści objętych roszczeniem właściciela treści. Wyniki są sortowane chronologicznie.

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

Raporty dotyczące playlist

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

To żądanie pobiera dane o codziennych interakcjach użytkowników z filmami na playlistach właściciela treści. Dane pobrane w raporcie to playlistViews, playlistStarts, playlistEstimatedMinutesWatched i viewsPerPlaylistStart. Wszystkie te dane są podawane na playliście. Wszystkie żądane dane są danymi na temat playlisty, więc żądanie nie musi zawierać filtra playlisty ani grupy.

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

Raporty na temat filmów

Dane o czasie oglądania treści przesłanych przez siebie w poszczególnych krajach

To zapytanie pobiera liczby 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 zawiera po jednym wierszu danych dla każdego kraju, w którym można było obejrzeć filmy. Wiersze są sortowane w kolejności malejącej według liczby minut czasu oglądania.

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

Dane dotyczące adnotacji w poszczególnych krajach dotyczące treści przesłanych przez siebie

To żądanie pobiera liczbę wyświetleń w poszczególnych krajach, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz wyświetlenia adnotacji do filmów przesłanych przez 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 jest wymieniony jako pierwszy.

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

Dane dotyczące prowincji dotyczące stanów USA i Waszyngtonu

Pobiera ono podział na prowincje według liczby wyświetleń, szacowanego czasu oglądania i średniego czasu oglądania filmów objętych roszczeniami właściciela treści. Dane dotyczą stanó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

10 miast w USA o największej łącznej liczbie wyświetleń

To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, z których pochodziło najwięcej wyświetleń filmów objętych roszczeniem właściciela treści w określonym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych wartości. Inne filtry również są obsługiwane. 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 miast w USA o największej łącznej liczbie wyświetleń dla każdego typu treści

To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, z których pochodziło najwięcej wyświetleń treści objętych roszczeniem właściciela treści w wybranym zakresie dat dla każdego obsługiwanego elementu creatorContentType. 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 miast w USA o największym łącznym czasie oglądania

To zapytanie pobiera listę 10 dni najpopularniejszych w wybranym zakresie dat, kiedy to dowolne miasto w Stanach Zjednoczonych miało największy łączny czas oglądania dziennie treści objętych roszczeniem właściciela treści. Wyniki zapytania zawierają całkowity czas oglądania, datę czasu oglądania oraz miasto, w którym według szacunków treści były oglądane. Wyniki są posortowane malejąco według łącznego czasu oglądania.

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

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

To zapytanie pobiera 10 najczęściej oglądanych filmów w Europie spośród filmów objętych roszczeniem przez właściciela treści. Liczba wyświetleń na podstawie liczby wyświetleń w wybranym zakresie dat. Zapytanie można zmodyfikować w taki sposób, by żądało danych dla innego kontynentu, wybierając inną prawidłową wartość dla tego filtra. Podobnie można zmodyfikować zapytanie, aby pobierało dane dotyczące subkontynentu, np. Europy Zachodniej czy Azji Południowo-Wschodniej, używając filtra subContinent i jednej z jego prawidłowych 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 na playlistach właściciela treści w poszczególnych krajach

To zapytanie pobiera liczbę wyświetleń playlist w poszczególnych krajach i dane o czasie oglądania playlisty dla wszystkich playlist na kanałach właściciela treści. Raport zwróci po jednym wierszu danych dla każdego kraju, w którym oglądano playlisty. Wiersze są posortowane malejąco według liczby obejrzanych minut.

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

Top 10 – najczęściej odtwarzane playlisty w Stanach Zjednoczonych

To zapytanie pobiera 10 playlist z kanałów właściciela treści, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby uruchomień playlisty w kolejności malejącej.

Uwaga: w tym raporcie używany jest wymiar playlist, więc musisz określić wartość parametru żądania sort, a także ustawić dla parametru maxResults liczbę całkowitą nie mniejszą niż 10.

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

Raporty na temat filmów

Oceny pozytywne i negatywne według typu treści

To zapytanie pobiera liczbę ocen pozytywnych i negatywnych dla każdego typu treści na określonym kanale lub grupie kanałów. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.

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 pobiera liczbę wyświetleń i szacowany czas oglądania filmów przesłanych na określony kanał lub grupę kanałów. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.

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

Dzienne liczby wyświetleń i czas oglądania w różnych lokalizacjach odtwarzania

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania w Stanach Zjednoczonych dla filmów przesłanych na określony kanał lub grupę kanałów. Wyniki są pogrupowane według dnia dla poszczególnych typów stron lub aplikacji, w których miały miejsce odtworzenia filmu. Wyniki są sortowane w odwrotnej kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.

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

Top 10 – witryny innych firm, które generują najwięcej wyświetleń dla umieszczonego filmu

To zapytanie pobiera liczbę wyświetleń i szacowany czas oglądania określonego filmu lub grupy filmów. Wyniki są pogrupowane według witryny, w której został umieszczony film. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów przesłanych filmów, rozdzielonych przecinkami.

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

Raporty dotyczące playlist

liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.

To zapytanie pobiera liczbę wyświetleń playlist, szacowany czas oglądania playlisty i rozpoczęcia odtwarzania na wszystkich playlistach na kanałach właściciela treści. Wyniki są agregowane na podstawie typu strony lub aplikacji, w której miały miejsce odtworzenia filmu, a wyniki są sortowane w kolejności malejącej według rozpoczęcia odtwarzania playlisty.

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

liczby wyświetleń playlisty i czas oglądania w różnych miejscach odtwarzania.

To zapytanie pobiera dzienną liczbę odtworzeń playlisty, liczbę wyświetleń playlist i szacowany czas oglądania playlisty 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, w której wystąpiły wyświetlenia playlisty.

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

Raporty na temat filmów

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

To żądanie 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, czyli w jaki sposób użytkownicy dotarli do filmu.

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

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

To żądanie pobiera dzienną liczbę wyświetleń i szacowany dzienny czas oglądania filmów właściciela treści. Dane są codziennie agregowane 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: kolejne 2 przykładowe raporty są obsługiwane tylko w przypadku określonych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie zawiera dodatkowych informacji, dlatego te raporty są dla niego niedostępne. Szczegółowe informacje o źródłach wizyt, w przypadku których dostępne są raporty tego typu, znajdziesz w definicji insightTrafficSourceType.

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

To zapytanie pobiera 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania w YouTube dotyczących określonego filmu lub grupy filmów. Wyniki są sortowane według liczby wyświetleń w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów przesłanych filmów, rozdzielonych przecinkami.

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

10 największych witryn – witryny zewnętrzne, które generują największy ruch związany z filmem

To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania Google dotyczących określonego filmu lub grupy filmów. Wyniki są sortowane według szacowanego czasu oglądania w kolejności malejącej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów przesłanych filmów, rozdzielonych przecinkami.

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

Raporty dotyczące playlist

liczby wyświetleń playlisty i czasu 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 w przypadku wyświetleń playlisty w danym kraju. Dane są agregowane według źródła wizyt, które określają, w jaki sposób użytkownicy dotarli do playlisty.

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

liczby wyświetleń playlisty i czasu oglądania z różnych źródeł wizyt.

To żądanie pobiera wyświetlenia playlist, rozpoczęcia odtwarzania playlisty i szacowany czas oglądania playlist z co najmniej jednego kanału właściciela treści. Wskaźniki są agregowane według źródła wizyt. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.

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

Raporty na temat filmów

Dzienne dane o typie urządzeń dotyczące filmów objętych roszczeniem

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według typu urządzenia dla filmów objętych roszczeniem przez konkretnego właściciela treści. Wyniki są pogrupowane według dnia dla każdego typu urządzeń, na których odtworzone zostały filmy. Wyniki są sortowane chronologicznie.

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

Dzienne dane o systemie operacyjnym dotyczące filmów objętych roszczeniem wyświetlanych na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według systemu operacyjnego. Dotyczy to wyświetleń filmów objętych roszczeniem konkretnego właściciela treści, które miały miejsce na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla poszczególnych systemów operacyjnych, w których miały miejsce odtworzenia filmu. Wyniki są sortowane chronologicznie.

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 pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów objętych roszczeniem przez konkretnego właściciela treści. Statystyki są pogrupowane według systemu operacyjnego i typu urządzenia. Wyniki są sortowane chronologicznie.

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

Raporty dotyczące playlist

Dane o typie urządzenia dotyczące wyświetleń playlist w systemie operacyjnym Android

To zapytanie pobiera liczby wyświetleń playlist i szacowany czas oglądania playlist na urządzeniach z Androidem w przypadku playlist z co najmniej jednego kanału właściciela treści. Wyniki są zwracane dla każdego typu urządzeń, na których wystąpiły wyświetlenia playlisty. Aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą maksymalnie 500 identyfikatorów kanałów swoich kanałów rozdzielonych przecinkami.

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 pobiera liczby wyświetleń playlist i szacowany czas oglądania playlist na urządzeniach mobilnych w przypadku playlist na dowolnym kanale właściciela treści. Wyniki są zwracane dla każdego systemu operacyjnego, w którym wystąpiły wyświetlenia playlisty.

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 z Kalifornii, którzy oglądali treści objęte roszczeniem właściciela treści. Wyniki są posortowane według płci, a następnie według grupy wiekowej. Zapytanie można zmodyfikować tak, by pobierało te same statystyki dla wszystkich widzów na całym świecie lub dla wszystkich widzów z danego kraju, kontynentu, subkontynentu lub innego stanu w USA. W tym celu należy dostosować wartość parametru filters.

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

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

To żądanie sprawdza, ile razy 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 kolejności malejącej według liczby udostępnień.

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

dane dotyczące utrzymania uwagi odbiorców dotyczące filmu,

Ten raport mierzy zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla 1 filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem filmu jednego z przesłanych przez siebie filmów. Pamiętaj, że w raportach utrzymania 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, takiego jak wyszukiwanie filmu lub kliknięcie sugerowanego filmu. Dlatego raport nie zawiera danych o wyświetleniach reklam TrueView In-Stream ani TrueView In-Display. Możesz usunąć ten filtr, aby pobrać dane o utrzymaniu uwagi odbiorców dotyczące 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 tego filtra, nie działają w przypadku dat po 1 lipca 2008 roku.

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

Dane o przychodach i skuteczności reklam dotyczące treści objętych roszczeniem

Pobiera ono dane o przychodach i skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy wszystkich żądanych rodzajów danych w wybranym zakresie dat.

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

Dane o dziennych przychodach i skuteczności reklam

Pobiera ono dane o dziennych przychodach i skuteczności reklam dotyczące 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 dotyczące przychodów i skuteczności reklam w poszczególnych krajach

Pobiera ono dane o przychodach i skuteczności reklam w poszczególnych krajach dotyczące treści objętych roszczeniem właściciela treści. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że kraj na liście jest krajem, w którym partner osiągnął najwyższe szacunkowe przychody.

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

10 najlepszych – filmy z najwyższymi przychodami

To żądanie pobiera dane o przychodach i skuteczności reklam w 10 filmach, do których właściciel treści zgłosił roszczenie i które przyniosły największe przychody. Wyniki są sortowane w kolejności malejącej według kwoty przychodów, co oznacza, że pierwszy film będzie miał 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 reklam dla różnych typów reklam

Pobiera ono dane o skuteczności reklam dotyczące treści objętych roszczeniem właściciela treści. Wyniki są grupowane według typu reklamy, co pozwala porównać przychody i wartości CPM w przypadku różnych typów reklam.

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