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 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

Dzienne dane o adnotacjach do filmów na kanale

To żądanie pobiera dzienną liczbę wyświetleń, współczynnik klikalności adnotacji, współczynnik zamykania adnotacji oraz liczbę wyświetleń adnotacji dotyczących treści z kanału. 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

To żądanie pobiera dzienną liczbę wyświetleń ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), rozpoczęcia playlisty, szacowanego czasu oglądania oraz liczby wyświetleń na włączenie playlisty w przypadku uwierzytelnionych kanał 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ą posortowane w kolejności malejącej 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 dotyczące filmów na kanale. Wyniki są sortowane według współczynnika klikalności adnotacji w kolejności malejącej. Oznacza to, że jako pierwszy wyświetla się kraj o najwyższym współczynniku klikalności adnotacji.

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

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

To żądanie pobiera dane z podziałem na prowincje, czyli liczbę wyświetleń, szacowany czas oglądania i średni czas oglądania filmów z kanału. Dane dotyczą stanów w USA i Waszyngtonu. Wyniki są sortowane alfabetycznie według prowincji Kody ISO 3166-2.

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

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

To zapytanie pobiera 10 najczęściej oglądanych filmów z kanału na podstawie liczby wyświetleń w wybranym zakresie dat w wybranym kraju. 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ą równą 10 lub mniejszą.

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

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

To zapytanie umożliwia pobranie listy 10 miast w Stanach Zjednoczonych, które uzyskały największą liczbę wyświetleń treści z kanału w określonym zakresie dat. Zapytanie można zmodyfikować, aby żądać danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra subContinent i jednej z jego prawidłowych 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 miast w USA o największej liczbie wyświetleń dla każdego typu treści

To zapytanie pobiera listę 10 miast w Stanach Zjednoczonych, które uzyskały największą liczbę wyświetleń treści z kanału w określonym zakresie dat dla każdego obsługiwanego typu 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 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 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ą posortowane w kolejności malejącej według łącznego czasu oglądania.

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

10 najpopularniejszych filmów w Europie

To zapytanie pobiera 10 najczęściej oglądanych filmów na kanale w Europie, określonych 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. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu 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ą równą 10 lub mniejszą.

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

Raporty dotyczące playlist

Dane o czasie oglądania playlist z kanału w zależności od kraju

To zapytanie pobiera liczby wyświetleń dla danego kraju ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz dane o czasie oglądania dla playlist kanału. Raport zwraca po jednym wierszu danych dla każdego kraj, w którym były oglądane playlisty kanału. Wiersze są posortowane w kolejności malejącej według liczby obejrzanych minut.

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

10 – najczęściej słuchane playlisty w Stanach Zjednoczonych

To zapytanie umożliwia pobranie 10 playlist, które widzowie w Stanach Zjednoczonych najczęściej oglądali w wybranym zakresie dat. Wyniki są sortowane według liczby rozpoczęcia 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ć parametr maxResults na 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ą 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 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ą pogrupowane według dnia dla każdego typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w kolejności chronologicznej.

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

10 – witryny zewnętrzne, które generują najwięcej wyświetleń 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 zewnętrznej, w której umieszczono dany film. 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 VIDEO_ID w wartości parametru filters listą rozdzielonych przecinkami identyfikatorów filmów przesłanych przez Ciebie.

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 pobiera liczbę wyświetleń (w polu zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), szacowany czas oglądania i rozpoczęcia playlisty dla playlist na konkretnym kanale. Wyniki to dane zbiorcze z uwzględnieniem typu strony lub aplikacji, w której miały miejsce odtworzenia filmu; Wyniki są sortowane w kolejności malejącej według rozpoczęcia playlisty.

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

dziennej liczby wyświetleń playlisty i czasu oglądania w różnych miejscach odtwarzania;

To zapytanie pobiera dzienne uruchomienia playlisty, liczbę wyświetleń ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), i 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 miały miejsce wyświetlenia playlisty. Wyniki są posortowane chronologicznie.

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

Raporty na temat filmów

Oznaczenia „Podoba mi się” i „Nie podoba mi się” 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

liczbę 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, w jaki sposób użytkownicy docierali 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 pobiera dzienną liczbę wyświetleń oraz 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ększy ruch dla filmu

To zapytanie pobiera 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń z wyników 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. 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 wysłać zapytanie dotyczące pojedynczego filmu lub zastąpić ciąg VIDEO_ID, aby zidentyfikować wyszukiwane hasła, 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

10 najpopularniejszych – zewnętrznych witryn, które generują największy ruch dla filmu

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ą posortowane według szacowanego 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

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

To żądanie pobiera liczbę wyświetleń (parametr zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), rozpoczęcia odtwarzania playlisty i szacowany czas oglądania w przypadku wyświetleń playlist w danym kraju. są agregowane według źródła wizyt, które opisuje, w jaki sposób użytkownicy docierali 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ń playlisty kanału ( in-playlist), rozpoczęcia playlisty i szacowany czas oglądania. Gromadzi też łączną liczbę wyświetleń ( zagregowane dane o wideo). Dane są agregowane codziennie według źródła wizyt i sortowane 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 pobiera dzienną liczbę wyświetleń i szacowany czas oglądania filmów z konkretnego kanału na urządzeniach z Androidem. 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

Dzienne dane o systemie operacyjnym urządzeń mobilnych

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

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ń oraz szacowany czas oglądania kanału. 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 ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz szacowany czas oglądania dla playlist konkretnego kanału na urządzeniach z Androidem. Wyniki to pogrupowane według dnia na każdym typie 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

Dzienne dane systemu operacyjnego dotyczące wyświetleń playlist na urządzeniach mobilnych

To zapytanie pobiera dzienne wyświetlenia ( zagregowane dane o wideo) wyświetlenia playlist (dane dotyczące playlist), oraz szacowany czas oglądania playlist konkretnego kanału na urządzeniach mobilnych. Wyniki to pogrupowane według dnia dla każdego systemu operacyjnego, w którym miały miejsce wyświetlenia 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. Można zmodyfikować to zapytanie, 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

Raporty dotyczące playlist

Dane demograficzne widzó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 obejrzeli playlisty kanału. Wyniki są sortowane według płci, a następnie grupy wiekowej. Ten można zmodyfikować zapytanie, 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 w USA przez dostosowanie wartości parametru filters.

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

Dane dotyczące udostępniania, zagregowane według usługi, w której udostępniono filmy

To żądanie pobiera informację o tym, ile razy użytkownicy kliknęli przycisk Share, aby udostępnić filmy z kanału. Wyniki są zagregowane według usługi udostępniania (Google+, Twitter itp.) i posortowane w kolejności malejącej według liczby udostępnień.

dimensions=sharingService
metrics=shares
sort=-shares

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

Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla pojedynczego filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem wideo 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 TrueView In-Stream i TrueView In-Display. 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 dla zapytań, które korzystają z filtra w celu pobrania danych z wcześniejszych dat. Zapytania bez filtra działają po 1 lipca 2008 roku.

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

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

To żądanie pobiera dane dotyczące przychodów kanału i skuteczności reklam. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych 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 dane dotyczące dziennych przychodów i skuteczności reklam kanału.

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

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

To żądanie pobiera dane dotyczące przychodów kanału i skuteczności reklam 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

10 najlepszych – filmy z najwyższymi przychodami

To żądanie pobiera dane o przychodach i skuteczności reklam z 10 filmów na kanale, które uzyskał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
maxResults=10
sort=-estimatedRevenue

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

To żądanie pobiera dane o skuteczności reklam w przypadku treści, do których prawa zgłosił właściciel treści. Wyniki są pogrupowane według typu reklamy, co pozwala porównać wartości przychodów i CPM różnych typów reklam.

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

Raporty na temat filmów

Dane o dziennym czasie oglądania treści przesłanych przez siebie

To zapytanie pobiera dane dotyczące dziennego czasu oglądania, a także liczby wyświetleń, odtworzeń generujących przychody i wyświetleń filmów przesłanych przez właściciela treści. Raport zwraca po 1 wierszu danych na każdy dzień w wybranym zakresie dat. Wiersze są posortowane w kolejności chronologicznej.

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

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

To żądanie pobiera dzienną liczbę wyświetleń, współczynniki klikalności adnotacji, współczynniki zamykania adnotacji oraz wyświetlenia adnotacji dotyczące treści, do których zgłoszono roszczenie właściciela treści. Wyniki są sortowane w kolejności chronologicznej.

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

Raporty dotyczące playlist

Dzienna liczba wyświetleń playlisty dla właściciela treści

To żądanie pobiera dane dotyczące dziennych interakcji użytkowników z filmami na playlistach. Dane pobrane w raporcie to playlistViews, playlistStarts, playlistEstimatedMinutesWatched i viewsPerPlaylistStart. Wszystkie te dane to dane dotyczące playlist. Ponieważ wszystkie żądane dane są danymi w playliście, nie musi to być zastosuj też filtr playlisty lub grupy.

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

Raporty na temat filmów

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

To zapytanie pobiera liczbę wyświetleń, dane o czasie oglądania i szacunkowe przychody z reklam w poszczególnych krajach. Te dane dotyczą filmów przesłanych przez właściciela treści. Raport zwróci po jednym wierszu danych dla każdego kraju, w którym widzowie oglądali filmy. Wiersze są posortowane 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 dotyczące adnotacji związanych z krajem w przypadku treści przesył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 dotyczące 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. Oznacza to, że jako pierwszy wyświetla się kraj o najwyższym współczynniku klikalności adnotacji.

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

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

Pobiera ono dane z podziałem na prowincje, czyli liczbę wyświetleń, szacowany czas oglądania (w minutach) i średni czas oglądania filmów objętych roszczeniami właściciela treści. Dane dotyczą stanów w USA i Waszyngtonu. Wyniki są sortowane alfabetycznie według prowincji Kody ISO 3166-2.

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

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

To zapytanie umożliwia pobranie listy 10 amerykańskich miast, w których w wybranym zakresie dat odnotowano najwięcej wyświetleń filmów objętych roszczeniem zgłoszonym przez właściciela treści. Zapytanie można zmodyfikować, aby żądać danych dla innego kraju, wybierając inną prawidłową wartość dla tego filtra. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu filtra subContinent i jednej z jego prawidłowych 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 miast w USA o największej 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 określonym zakresie dat w przypadku każdego obsługiwanego typu 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 umożliwia pobranie listy 10 najlepszych dni w wybranym zakresie dat, w których dowolne miasto w Stanach Zjednoczonych odnotowało najdłuższy łączny dzienny czas oglądania treści, do których zgłoszono roszczenie 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ą posortowane 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 pobiera 10 najczęściej oglądanych filmów w Europie wś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. Podobnie zapytanie można zmodyfikować w celu pobrania danych z jednego subkontynentu, takiego jak Europa Zachodnia czy Azja Południowo-Wschodnia, przy użyciu 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 w poszczególnych krajach dotyczące playlist właściciela treści

To zapytanie pobiera liczbę wyświetleń playlisty i dane o czasie oglądania playlisty w poszczególnych krajach we wszystkich playlistach na kanałach właściciela treści. Raport zwraca po jednym wierszu danych dla każdego kraju, w którym były oglądane playlisty. Wiersze są sortowane w kolejności malejącej według liczby minut oglądania.

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

10 – najczęściej słuchane playlisty w Stanach Zjednoczonych

To zapytanie pobiera 10 playlist z kanałów właściciela treści, które widzowie oglądają w Największy wzrost liczby wyświetleń w Stanach Zjednoczonych rozpoczął się w wybranym zakresie dat. Wyniki to posortowane według liczby odtworzeń playlisty w kolejności malejącej.

Uwaga: w tym raporcie wykorzystywana jest funkcja playlist, musisz określ wartość parametru żądania sort i ustaw też maxResults na wartość całkowitą nie większą niż 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 pobiera liczbę polubień i głosów na nie dla każdego typu treści na konkretnym kanale lub w grupie kanałów. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich 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 pobiera liczbę wyświetleń i szacowany czas oglądania filmów przesłanych na konkretny kanał lub określoną grupę kanałów. 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 liczby wyświetleń. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich kanałów.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
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 w Stanach Zjednoczonych w przypadku filmów przesłanych na konkretny kanał lub określoną grupę kanałów. Wyniki są pogrupowane według dnia dla każdego typu strony lub aplikacji, w której miały miejsce odtworzenia filmów. Wyniki są sortowane w odwrotnej kolejności chronologicznej. Pamiętaj, że aby uruchomić to zapytanie w narzędziu Google APIs Explorer, musisz zastąpić ciąg CHANNEL_ID w wartości parametru filters listą oddzielonych przecinkami maksymalnie 500 identyfikatorów kanałów Twoich kanałów.

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

10 – witryny zewnętrzne, które generują najwięcej wyświetleń 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 zewnętrznej, w której umieszczono film. Wyniki są sortowane w kolejności malejącej według liczby wyświetleń. 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=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 pobiera liczbę wyświetleń playlisty, szacowany czas oglądania playlisty oraz jest początek wszystkich playlist na kanałach właściciela treści. Wyniki są oparte na danych zbiorczych według typu strony lub aplikacji, w której miały miejsce odtworzenia filmów, a wyniki są sortowane według w kolejności malejącej według rozpoczęcia playlisty.

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

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

To zapytanie pobiera dzienne uruchomienia playlisty, liczbę wyświetleń playlisty 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órych wystąpiły wyświetlenia playlist.

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

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, które opisuje, w jaki sposób użytkownicy docierali do filmu.

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

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

To żądanie pobiera dzienną liczbę wyświetleń oraz szacowany dzienny czas 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: dwa następne przykładowe raporty są obsługiwane tylko w przypadku konkretnych źródeł wizyt. Na przykład źródło wizyt NO_LINK_EMBEDDED nie ma dodatkowych informacji, więc te raporty są dla niego niedostępne. Szczegółowe informacje o źródłach wizyt, dla których dostępne są raporty tego typu, znajdziesz w definicji insightTrafficSourceType.

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

To zapytanie pobiera 10 wyszukiwanych haseł, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania w YouTube dla konkretnego filmu lub grupy filmów. Wyniki są sortowane według liczby wyświetleń 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=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 najpopularniejszych – zewnętrznych witryn, które generują największy ruch dla filmu

To zapytanie pobiera 10 zewnętrznych witryn, które wygenerowały najwięcej wyświetleń z wyników wyszukiwania Google dotyczących konkretnego filmu lub grupy filmów. Wyniki są posortowane według szacowanego 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

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

To żądanie pobiera liczbę wyświetleń playlisty, początków playlisty oraz szacowany czas oglądania playlisty w danym kraju. Dane są agregowane według źródła wizyt, który opisuje, w jaki sposób użytkownicy dotarli 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;

Ta prośba pobiera informacje o wyświetleniach playlisty, uruchomieniach playlisty i szacowanym czasie oglądania do playlist na co najmniej jednym kanale właściciela treści. Wskaźniki są agregowane według źródła wizyt. Pamiętaj, że aby uruchomić to zapytanie w narzędziu APIs Explorer, musisz zastąpić ciąg znaków CHANNEL_ID w wartości parametru filters rozdzielonych przecinkami lista maksymalnie 500 identyfikatorów swoich kanałów.

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

Raporty na temat filmów

Dzienne dane o typie urządzenia w przypadku filmów objętych roszczeniem

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według typu urządzenia w przypadku filmów objętych roszczeniem przez konkretnego właściciela treści. 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=claimedStatus==claimed
sort=day

Dzienne dane systemu operacyjnego dotyczące filmów objętych roszczeniem wyświetlonych na urządzeniach mobilnych

To zapytanie pobiera dzienną liczbę wyświetleń i szacowany czas oglądania według systemu operacyjnego dla wyświetleń filmów objętych roszczeniem przez określonego właściciela treści, które miały miejsce na urządzeniach mobilnych. Wyniki są pogrupowane według dnia dla każdego systemu operacyjnego, w którym zostały odtworzone filmy. 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 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 w kolejności chronologicznej.

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

Raporty dotyczące playlist

Dane dotyczące typu urządzenia w przypadku wyświetleń playlist w systemie operacyjnym Android

To zapytanie pobiera liczbę wyświetleń playlisty i szacowany czas oglądania playlisty na urządzeniach z Androidem do playlist na co najmniej jednym kanale właściciela treści. Wyniki są zwracane dla na poszczególnych rodzajach urządzeń, na których zostały wyświetlone playlisty. Pamiętaj, że aby uruchomić to zapytanie w interfejsach API Eksplorator, musisz zastąpić ciąg CHANNEL_ID w filters do 500 identyfikatorów swoich kanałów, rozdzielając je przecinkami.

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

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

To zapytanie pobiera liczbę wyświetleń playlisty i szacowany czas oglądania playlisty na urządzeniach mobilnych do playlist na kanałach właściciela treści. Wyniki są zwracane dla każdego system operacyjny, w którym playlisty zostały wyświetlone.

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. Można zmodyfikować to zapytanie, 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=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

Dane dotyczące udostępniania, zagregowane według usługi, w której udostępniono filmy

To żądanie pobiera, ile razy użytkownicy kliknęli przycisk Share, aby udostępnić filmy przesłane przez właściciela treści. Wyniki są zagregowane według usługi udostępniania (Google+, Twitter itp.) i posortowane 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 dla filmu;

Ten raport sprawdza zdolność filmu do utrzymania uwagi odbiorców. Raport można pobrać tylko dla pojedynczego filmu naraz. Pamiętaj, że aby uruchomić to zapytanie w Eksploratorze interfejsów API, musisz zastąpić ciąg VIDEO_ID w wartości parametru filters identyfikatorem wideo 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 TrueView In-Stream i TrueView In-Display. 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 dla zapytań, które korzystają z filtra w celu pobrania danych z wcześniejszych dat. Zapytania bez filtra działają 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

To żądanie pobiera dane o przychodach i skuteczności reklam dotyczące treści, do których zgłoszono roszczenie przez właściciela treści. Raport zwraca jeden wiersz danych, który zawiera sumy poszczególnych żądanych 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

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 reklam w poszczególnych krajach

To żądanie pobiera dane o przychodach i skuteczności reklam w poszczególnych krajach, które dotyczą treści objętych roszczeniem właściciela treści. Wyniki są posortowane w kolejności malejącej według kwoty przychodów. Oznacza to, że pierwszy wymieniony kraj jest tym, w którym partner ma 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 dotyczące 10 filmów, które zostały objęte roszczeniem przez właściciela treści i które uzyskał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 pobiera dane o skuteczności reklam w przypadku treści, do których prawa zgłosił właściciel treści. Wyniki są pogrupowane według typu reklamy, co pozwala porównać wartości przychodów i CPM różnych typów reklam.

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