Bu sayfada, hem YouTube Reporting API hem de YouTube Analytics API için API değişiklikleri ve belge güncellemeleri listelenmektedir. Her iki API de geliştiricilerin YouTube Analytics verilerine farklı şekillerde erişmesine olanak tanır. Bu değişiklik günlüğüne abone olun.
6 Mayıs 2024
YouTube Analytics (Targeted Sorgular) API'si, kanallar için üç yeni raporu desteklemektedir:
-
TPA'ya göre kullanıcı etkinliği raporu, Kullanıcı etkinliği istatistiklerini Tanımlanmış Pazar Alanı'na (DMA) göre sağlayan bir coğrafi rapordur. Bu rapor için
filters
parametre değerinicountry==US
olarak ayarlamanız gerekir. -
Aynı anda izleyen kullanıcı sayısı raporu, canlı yayınlanan tek bir videonun farklı bölümlerini eşzamanlı olarak izleyen kullanıcı sayısını gösterir.
-
Üye İptalleri raporu, kullanıcıların kanal üyeliklerini iptal etme nedenlerini gösteren istatistikler sağlar.
Bu raporda, kullanıcının kanal üyeliğini neden iptal ettiğini belirten yeni
membershipsCancellationSurveyReason
boyutu kullanılmaktadır. Ayrıca bu nedenle kaç kanal üyeliğinin iptal edildiğini gösteren yenimembershipsCancellationSurveyResponses
metriğini de kullanır.
Buna ek olarak, Kitleyi Elde Tutma raporu üç yeni metriği destekleyecek şekilde iyileştirildi:
7 Nisan 2024
YouTube Analytics (Targeted Sorgular) API'de, içerik sahibi oynatma listesi raporlarıyla ilgili çeşitli güncellemeler bulunmaktadır. Güncellemeler, 19 Ocak 2024'te duyurulan kanal oynatma listesi raporlarıyla ilgili güncellemelerle aynıdır.
Aşağıdaki düzeltme geçmişi girişi, 19 Ocak 2024 tarihli girişle neredeyse aynı bilgileri sağlar. Bununla birlikte, içerik sahibi oynatma listesi raporlarının 31 Aralık 2024'e kadar isCurated
boyutunu, bu boyutun ise 30 Haziran 2024'e kadar kanal oynatma listesi raporlarında destekleneceğini unutmayın.
-
Not: Bu, kullanımdan kaldırma duyurusudur.
isCurated
boyutu, içerik sahibi oynatma listesi raporları için kullanımdan kaldırıldı. 31 Aralık 2024'te veya sonrasında artık desteklenmeyecek. Bu boyutun tanımı uygun şekilde güncellenmiştir.isCurated
boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu yalnızca oynatma listesi raporlarındaviews
metriği yerineplaylistViews
metriğini alacak şekilde güncellemeniz de gerekir. Oynatma listesi raporları içinviews
metriği hâlâ desteklendiğinden, farklı bir anlama gelse de, metrik adını güncellemezseniz API veri döndürmeye devam eder. Elbette, uygulamanızı hemviews
hem deplaylistViews
öğelerini alıp görüntüleyecek şekilde değiştirebilirsiniz.Yeni raporlarda,
isCurated
boyutuna ek olarak aşağıdaki API işlevleri artık desteklenmemektedir:continent
vesubcontinent
gibi konum filtreleri, yeni kanal oynatma listesi raporları için desteklenmez.redViews
veestimatedRedMinutesWatched
metrikleri artık yeni kanal oynatma listesi raporları için desteklenmemektedir. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.subscribedStatus
veyoutubeProduct
boyutları artık kanal oynatma listesi raporlarına filtre olarak desteklenmemektedir. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.
-
İçerik sahibi raporları dokümanlarının oynatma listesi raporları bölümü, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı şekilde açıklanacak şekilde güncellendi:
- Toplu video metrikleri, içerik sahibinin oynatma listelerinde bu içerik sahibine ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca
isCurated
boyutunu kullanmayan API istekleri için desteklenir. - Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahipsiz videoların görüntülemelerini de içerir (yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiyse) ve görüntüleme sayısını içerir.
- Desteklenen oynatma listesi metrikleri bölümü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.
- Toplu video metrikleri, içerik sahibinin oynatma listelerinde bu içerik sahibine ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca
-
İçerik sahiplerine yönelik oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metriklerin yalnızca raporları almaya yönelik API isteğinin
isCurated
boyutunu kullanmaması durumunda desteklendiğini unutmayın. Her metriğin tanımı için metrics belgelerine bakın: -
views
metriğinin davranışı artık oynatma listesi raporunu alan API isteğininisCurated
boyutunu kullanıp kullanmadığına bağlıdır:- İstek
isCurated
boyutunu içerdiğindeviews
metriği, oynatma listesi içi metriktir. Bu metrik, videoların içerik sahibinin oynatma listeleri bağlamında görüntülenme sayısını belirtir. - İstek
isCurated
boyutunu içermediğindeviews
metriği, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğinden bağımsız olarak içerik sahibinin oynatma listelerindeki videoların toplam görüntülenme sayısını belirten toplu bir video metriğidir. Toplu toplam yalnızca oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videoların görüntülemelerini içerir.
isCurated
boyutunu kullanmayan bu raporlarda,playlistViews
metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrikte, oynatma listesindeki tüm videoların görüntüleme sayısı, videonun sahibi olan kanaldan bağımsız olarak sayılır.
- İstek
-
Her oynatma listesi raporu için içerik sahibi raporları dokümanlarında, artık API isteğinin
isCurated
boyutunu içerip içermediğine bağlı olarak bu rapor için desteklenen metrikleri gösteren tablolar yer alıyor. Örnek için zamana dayalı oynatma listesi raporlarını tanımlayan bölüme bakın.
19 Ocak 2024
YouTube Analytics (Targeted Sorgular) API'sinde kanal oynatma listesi raporlarıyla ilgili çeşitli güncellemeler bulunmaktadır. Güncellemeler, kullanımdan kaldırılmış bir boyutun yanı sıra birkaç yeni ve güncellenmiş metrik içerir:
-
Not: Bu, kullanımdan kaldırma duyurusudur.
isCurated
boyutu, kanal raporları için kullanımdan kaldırıldı. 30 Haziran 2024'te veya sonrasında artık desteklenmeyecek. Bu boyutun tanımı uygun şekilde güncellenmiştir.isCurated
boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu yalnızca oynatma listesi raporlarındaviews
metriği yerineplaylistViews
metriğini alacak şekilde güncellemeniz de gerekir. Oynatma listesi raporları içinviews
metriği hâlâ desteklendiğinden, farklı bir anlama gelse de, metrik adını güncellemezseniz API veri döndürmeye devam eder. Elbette, uygulamanızı hemviews
hem deplaylistViews
öğelerini alıp görüntüleyecek şekilde değiştirebilirsiniz.Yeni raporlarda,
isCurated
boyutuna ek olarak aşağıdaki API işlevleri artık desteklenmemektedir:continent
vesubcontinent
gibi konum filtreleri, yeni kanal oynatma listesi raporları için desteklenmez.redViews
veestimatedRedMinutesWatched
metrikleri artık yeni kanal oynatma listesi raporları için desteklenmemektedir. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.subscribedStatus
veyoutubeProduct
boyutları artık kanal oynatma listesi raporlarına filtre olarak desteklenmemektedir. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.
-
Kanal raporları belgelerinin oynatma listesi raporları bölümü, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı şekilde açıklanacak şekilde güncellendi:
- Toplu video metrikleri, kanalın oynatma listelerinde bu kanala ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca
isCurated
boyutunu kullanmayan API istekleri için desteklenir. - Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahipsiz videoların görüntülemelerini de içerir (yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiyse) ve görüntüleme sayısını içerir.
- Desteklenen oynatma listesi metrikleri bölümü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.
- Toplu video metrikleri, kanalın oynatma listelerinde bu kanala ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca
-
Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metrikler henüz içerik sahibi raporlarında desteklenmemektedir. Bu metriklerin yalnızca raporları almaya yönelik API isteği
isCurated
boyutunu kullanmıyorsa desteklendiğini unutmayın. Her metriğin tanımı için metrics belgelerine bakın: -
views
metriğinin davranışı artık oynatma listesi raporunu alan API isteğininisCurated
boyutunu kullanıp kullanmadığına bağlıdır:- Bir istek
isCurated
boyutunu içerdiğindeviews
metriği, kanalın oynatma listeleri bağlamında videoların kaç kez görüntülendiğini belirten oynatma listesi içi bir metriktir. - İstek
isCurated
boyutunu içermediğindeviews
metriği, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğinden bağımsız olarak kanalın oynatma listelerindeki bir videonun toplam görüntülenme sayısını belirten toplu bir video metriğidir. Toplam görüntüleme sayısı yalnızca oynatma listesinin sahibi olan kanala ait videoların görüntülemelerini içerir.
isCurated
boyutunu kullanmayan bu raporlarda,playlistViews
metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrikte, oynatma listesindeki tüm videoların görüntüleme sayısı, videonun sahibi olan kanaldan bağımsız olarak sayılır.
- Bir istek
-
Her oynatma listesi raporu için kanal raporları belgelerinde artık API isteğinin
isCurated
boyutunu içerip içermediğine bağlı olarak ilgili raporda desteklenen metrikleri gösteren tablolar yer alıyor. Örnek için zamana dayalı oynatma listesi raporlarını tanımlayan bölüme bakın.
4 Aralık 2023
YouTube Analytics (Targeted Sorgular) API'si, iki insightTrafficSourceType
boyut değerini birleştirecek şekilde güncellendi. Daha önce, bir oynatma listesinin parçası olarak oynatılan videolar (PLAYLIST
) ile oynatma listesindeki tüm videoları listeleyen bir sayfadan gelen görüntülemeleri (YT_PLAYLIST_PAGE
) birbirinden ayıran bu boyut, artık PLAYLIST
boyut değeriyle ilişkilendirilecek.
15 Aralık 2022
YouTube Analytics (Hedeflenen Sorgular) API'si iki yeni boyutu ve bir yeni raporu destekler:
-
Yeni bir rapor, şehre göre kullanıcı etkinliğini gösterir. Bu rapor, kanallar ve içerik sahipleri tarafından kullanılabilir. Bu rapor, YouTube'un kullanıcı etkinliğinin gerçekleştiği şehirle ilgili tahminini tanımlayan yeni
city
boyutunu içerir. -
Yeni
creatorContentType
boyutu, veri satırındaki kullanıcı etkinliği metrikleriyle ilişkilendirilen YouTube içeriğinin türünü tanımlar.LIVE_STREAM
,SHORTS
,STORY
veVIDEO_ON_DEMAND
değerleri desteklenir.creatorContentType
boyutu, tüm kanal ve içerik sahibi video raporları için isteğe bağlı bir boyut olarak desteklenir. -
YouTube Analytics API örnek istekler kılavuzu artık her iki yeni boyut için de örnekler içeriyor.
-
7DayTotals
ve30DayTotals
boyutlarına yapılan referanslar dokümanlardan kaldırıldı. Ekim 2019'da bu boyutların kullanımdan kaldırılacağı duyuruldu.
26 Ağustos 2022
YouTube Analytics (Targeted Sorgular) API'si ve YouTube Reporting (Bulk Reports) API, yeni bir trafik kaynağı ayrıntı değerini destekliyor:
- YouTube Analytics API (Targeted Sorgular) API'de
insightTrafficSourceType
boyutunun değeriSUBSCRIBER
iseinsightTrafficSourceDetail
değeripodcasts
olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfasından yönlendirildiğini gösterir. - YouTube Reporting (Bulk Reports) API'de
traffic_source_type
boyutunun değeri3
isetraffic_source_detail
değeripodcasts
olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfasından yönlendirildiğini gösterir.
11 Şubat 2022
gender
boyutu için geçerli değerler grubu, 11 Ağustos 2022'de veya bu tarihten sonra değişecek. Bu, API uygulamanızda geriye dönük olarak uyumsuz bir değişiklik olabilir. YouTube API Hizmetleri Hizmet Şartları'nın Geriye dönük olarak uyumsuz değişiklikler bölümü uyarınca bu değişiklik, yürürlüğe girmeden altı ay önce duyurulur. Yeni değer grubuna sorunsuz bir şekilde geçiş yapmak için lütfen API uygulamanızı 11 Ağustos 2022'den önce güncelleyin.
Yapılan spesifik değişiklikler şunlardır:
- YouTube Analytics (Hedeflenen Sorgular) API'sinde
gender
boyutu şu anda iki değeri desteklemektedir:female
vemale
. 11 Ağustos 2022'de veya sonrasında bu boyut üç değeri destekleyecek:female
,male
veuser_specified
. - YouTube Reporting (Bulk Reports) API'de
gender
boyutu şu anda üç değeri desteklemektedir:FEMALE
,MALE
veGENDER_OTHER
. 11 Ağustos 2022'de veya sonrasında, desteklenen değer grubuFEMALE
,MALE
veUSER_SPECIFIED
olarak değişecek.
9 Şubat 2022
13 Aralık 2021 itibarıyla iki metrik, klipleri döngüye alma trafiğini hariç tutacak şekilde güncellendi. Bu değişiklik hem YouTube Analytics (Targeted Sorgular) API'yi hem de YouTube Reporting (Bulk Reports) API'yi etkiler.
- YouTube Analytics (Targeted Sorgular) API'deki
averageViewDuration
veaverageViewPercentage
metrikleri, 13 Aralık 2021 itibarıyla klipleri döngüye alan trafiğini hariç tutar. - YouTube Reporting (Bulk Reports) API'deki
average_view_duration_seconds
veaverage_view_duration_percentage
metrikleri, 13 Aralık 2021 itibarıyla klipleri döngüye alan trafiği hariç tutar.
2 Şubat 2022
Bu YouTube Reporting (Bulk Reports) API, görüntülemelerin Live Redirects'ten kaynaklandığını belirten yeni bir trafik kaynağı boyut değerini destekler:
- YouTube Reporting (Bulk Reports) API'de
traffic_source_type
boyutu,28
değerini destekler.
Bu trafik kaynağı türü için traffic_source_detail
boyutu, görüntüleyenin yönlendirildiği kanal kimliğini belirtir.
23 Eylül 2020
Hem bu YouTube Analytics (Targeted Sorgular) API'si hem de YouTube Reporting (Bulk Reports) API, izleyicinin YouTube Shorts izleme deneyiminde dikey kaydırma yaparak yönlendirildiğini gösteren yeni bir trafik kaynağı boyut değerini destekler:
- YouTube Analytics API (Hedeflenen Sorgular) API'sinde
insightTrafficSourceType
boyutu,SHORTS
değerini destekler. - YouTube Reporting (Bulk Reports) API'de
traffic_source_type
boyutu,24
değerini destekler.
Bu yeni trafik kaynağı türü için trafik kaynağı ayrıntıları boyutu (YouTube Analytics API'deki insightTrafficSourceDetail
veya YouTube Reporting API'de traffic_source_detail
) doldurulmaz.
20 Temmuz 2020
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sini etkileyen iki değişikliği kapsar:
- YouTube Analytics raporlama grubunun maksimum boyutu 200'den 500'e çıkarılmıştır.
reports.query
yöntemininfilters
parametresi, YouTube Analytics verileri alınırken uygulanması gereken filtrelerin listesini tanımlar. Parametre;video
,playlist
vechannel
filtreleri için birden fazla değer belirtme özelliğini destekler ve bu filtreler için belirtilebilecek maksimum kimlik sayısı 200'den 500'e çıkarılmıştır.
13 Şubat 2020
Bu güncelleme, YouTube Analytics (Targeted Sorgular) API'si ve YouTube Reporting (Bulk Reports) API ile ilgili aşağıdaki değişiklikleri içerir. Bu değişiklikler hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
Her iki API'de de bildirimler için olası trafik kaynağı ayrıntı değerleri grubu değişiyor.
Hedeflenen sorgularda bildirimler insightTrafficSourceType=NOTIFICATION
olarak raporlanır. Toplu raporlarda bildirimler traffic_source_type=17
olarak raporlanır.
Yeni değerler, yüklenen videolar ve canlı yayınlarla (daha önce uploaded
olarak raporlanan) ilgili bildirimleri iki kategoriye ayırır:
uploaded_push
: Görüntülemelerin kaynağı, video yüklendiğinde abonelere gönderilen push bildirimleridir.uploaded_other
: Video yüklendiğinde abonelere gönderilen, push olmayan bildirimler (e-posta veya Gelen Kutusu bildirimleri gibi) kaynaklı görüntülemeler.
Bu değerler, 13.01.2020 (13 Ocak 2020) ile başlayan zaman aralığı için döndürülür.
Ayrıca bu değerlerin, bildirimleri değil, belirli YouTube görüntülemelerini sağlayan trafik kaynaklarını temsil ettiğini hatırlatmak isteriz. Örneğin, bir rapor satırında views=3
, traffic_source_type=17
(NOTIFICATION
) ve traffic_source_detail=uploaded_push
değerleri gösteriliyorsa satır, üç görüntülemenin, izleyicilerin video yüklendiğinde gönderilen push bildirimlerini tıklaması sonucu oluştuğunu belirtir.
15 Ekim 2019
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:
-
Not: Bu, kullanımdan kaldırma duyurusudur.
YouTube,
7DayTotals
ve30DayTotals
boyutları için sağladığı desteği kaldırıyor. 15 Nisan 2020 tarihine kadar bu boyutları kullanarak veri almaya devam edebilirsiniz. Bu tarihte veya bu tarihten sonra,7DayTotals
ya da30DayTotals
boyutunu kullanarak rapor alma girişimleri hata döndürür.Kullanıcıların,
day
boyutunu kullanarak sorgulama yaparak ve yedi ya da 30 günlük dönemlere ait verileri toplayarak veya türeterek bu boyutlar için bazı verileri yeniden oluşturabileceğini unutmayın. Örneğin:- Yedi günlük bir dönemdeki görüntüleme sayısı, ilgili dönemin her bir gününden elde edilen görüntüleme sayıları toplanarak hesaplanabilir.
- Yedi günlük bir döneme ait görüntüleyiciPercentage değeri, o gün için her gün meydana gelen görüntüleme sayısı ile o günkü görüntüleme yüzdesi çarpılarak o gün videoyu izlerken giriş yapmış olan izleyicilerin sayısının elde edilmesi sağlanarak hesaplanabilir. Ardından, tüm dönem için giriş yapmış olan izleyicilerin sayısı tüm dönem için toplanabilir ve tüm dönem için görüntüleyici Yüzdesi değerini elde etmek üzere söz konusu dönemdeki toplam görüntüleme sayısına bölünebilir.
- Aynı görüntüleyen farklı günlerde benzersiz bir görüntüleyen olarak hesaplanabileceğinden, yedi günlük bir dönemdeki benzersiz görüntüleyen sayısı hesaplanamaz. Ancak 30 günlük bir dönemdeki benzersiz görüntüleyen sayısıyla ilgili verilerden yola çıkmak için
30DayTotals
boyutu yerinemonth
boyutunu kullanabilirsiniz.month
boyutu takvim aylarını ifade ederken30DayTotals
boyutu, belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemleri hesaplar.
27 Haziran 2019
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:
-
API'nin 1. sürümü artık tamamen kullanımdan kaldırıldığı için dokümanlar, kullanımdan kaldırma bildirimi ve sürüm 2'ye nasıl güncelleme yapılacağının açıklandığı geçiş kılavuzu da dahil olmak üzere bu sürüme yapılan referansları kaldıracak şekilde güncellendi.
1 Kasım 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:
-
API sürüm 1'in desteği sonlandırıldı. Henüz yapmadıysanız lütfen hizmet kesintilerini en aza indirmek için API istemcilerinizi en kısa sürede API'nın 2 sürümünü kullanacak şekilde güncelleyin. Daha fazla ayrıntı için taşıma kılavuzuna bakın.
Bu kullanımdan kaldırma programının ilk olarak 26 Nisan 2018'de duyurulduğunu unutmayın.
17 Eylül 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:
-
Veri Modeli'ne genel bakış belgesindeki yeni veri anonimleştirme bölümünde, metrikler belirli bir eşiği karşılamadığında bazı YouTube Analytics verilerinin sınırlı olduğu açıklanmaktadır. Bu durum çeşitli durumlarda görülebilir. Pratikte bu, bir raporda aşağıdaki durumlarda verilerinizin tümünü (veya herhangi birini) içermeyebileceği anlamına gelir:
-
Belirli bir dönemde bir video veya kanal sınırlı trafiğe sahipse
veya
-
Değerleri belirli bir eşiği karşılamayan bir filtre veya boyut (ör. trafik kaynağı veya ülke) seçtiniz.
Yeni bölümde, YouTube Analytics raporlarında sınırlı olabilecek veri türleriyle ilgili açıklamalar da yer almaktadır.
-
-
Oynatma konumu, trafik kaynağı ve cihaz türü/işletim sistemi raporlarında
redViews
veestimatedRedMinutesWatched
metriklerinin artık desteklenmediğini belirtmek üzere kanal raporları ve içerik sahibi raporları dokümanları güncellendi.
18 Haziran 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:
- Aşağıdaki yöntemler için kapsam şartları değiştirildi:
reports.query
yöntemine yapılan isteklerinhttps://www.googleapis.com/auth/youtube.readonly
kapsamına erişimi olmalıdır.groupItems.list
yöntemine yapılan isteklerin şunlardan birine erişimi olmalıdır:https://www.googleapis.com/auth/youtube
kapsamı
veyahttps://www.googleapis.com/auth/youtube.readonly
kapsamı
ve
https://www.googleapis.com/auth/yt-analytics.readonly
kapsamı
İlk seçenek bir okuma-yazma kapsamı, ikinci seçenek ise iki salt okunur kapsam kullanır.
23 Mayıs 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:
- API'ye Genel Bakış, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkili verileri nasıl işlediğini açıklayan yeni bir bölüm olan metrikleri ve silinen öğeleri içerir.
- API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklara ait ek meta verileri almak için YouTube Data API'yı kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (bölüm III.E.4.b ila III.E.4.d) belirtildiği gibi, API istemcileri, depolanan kaynak meta verilerini 30 gün sonra söz konusu API'den silmeli veya yenilemelidir.
22 Mayıs 2018
Bu güncelleme, YouTube Reporting (Bulk Reports) API'de yapılan aşağıdaki değişiklikleri içerir:
- Aşağıdaki değişikliklerin Temmuz 2018'de yürürlüğe girmesi planlanmaktadır. Yeni politikalar, dünya genelinde tüm raporlar ve raporlama işleri için geçerlidir.
-
Değişiklikten sonra, dolgu raporları da dahil olmak üzere API raporlarının çoğu, oluşturuldukları andan itibaren 60 gün boyunca kullanılabilecektir. Ancak geçmiş verileri içeren raporlar, oluşturuldukları andan itibaren 30 gün boyunca kullanılabilir.
Bu duyurudan önce tüm API raporları, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Açıkça belirtmek gerekirse, bu politika değişikliği yürürlüğe girdiğinde, 30 günden eski geçmiş veri raporlarına da artık API üzerinden erişilemeyecektir. 60 günden eski olan diğer raporlara da artık erişilemeyecektir. Bu nedenle, dokümanlarda artık politika değişikliğinden önce oluşturulan raporlara en fazla 180 gün boyunca ulaşılabileceği belirtilmektedir.
-
Değişiklikten sonra, bir raporlama işi planladığınızda YouTube, o günden başlayarak işin planlandığı saatten önceki 30 günlük dönemi kapsayan raporlar oluşturur. Değişiklikten önce, bir raporlama işi planladığınızda YouTube, işin planlandığı zamandan önceki 180 günlük dönemi kapsayan raporlar oluşturur.
-
-
En iyi uygulamalar bölümü, raporlarda tanımlanan kaynaklar için ek meta veriler almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (bölüm III.E.4.b ila III.E.4.d) belirtildiği gibi, API istemcileri, depolanan kaynak meta verilerini 30 gün sonra söz konusu API'den silmeli veya yenilemelidir.
-
Rapor özellikleri bölümü, rapor verileri filtrelenmese bile, 1 Haziran 2018 veya sonrası bir döneme ait verileri içeren raporların, raporun oluşturulduğu tarihten en az 30 gün önce silinen YouTube kaynaklarına referans içermeyeceğini belirtecek şekilde güncellendi.
-
API'ye genel bakışın geçmiş veriler bölümü, yeni bir raporlama işi planladığınızda geçmiş raporların genellikle birkaç gün içinde yayınlanacağını belirtecek şekilde güncellendi. Daha önce dokümanlarda bu tür raporların kullanılabilir hale gelmesinin 30 günü bulabileceği belirtiliyordu.
-
API'ye genel bakışın dolgu verileri bölümü, dolgu verilerini daha önce yayınlanan bir veri kümesinin yerini alan veri kümesi olarak daha net tanımlamak için güncellendi.
26 Nisan 2018
YouTube Analytics (Targeted Sorgular) API'nin (v2) 2. sürümü artık herkese açık. Aşağıdaki listede, yeni API sürümüyle ilgili ürün ve belge değişiklikleri tanımlanmaktadır:
-
v2 API, v1 API ile neredeyse aynıdır. Ancak, büyük olasılıkla kodunuzu aşağıda listelenen değişiklikleri yansıtacak şekilde güncellemeniz gerekecektir. Bu değişikliklerin tümü yeni taşıma kılavuzunda ayrıntılı olarak açıklanmıştır.
- API'nin
v1
olan sürümüv2
olarak değiştirildi. - API istekleri için
https://www.googleapis.com/youtube/analytics/v1
olan temel URLhttps://youtubeanalytics.googleapis.com/v2
olarak değiştirildi. reports.query
yöntemi için bazı parametrelerin adları güncellenmiştir. Daha açık belirtmek gerekirse, v1 API'sindekiend-date
gibi kısa çizgi içeren parametre adları, v2 API'de kısa çizgi (endDate
) yerine büyük/küçük harf kullanır. API'nin grup oluşturma ve yönetme yöntemlerinde parametre adları için büyük/küçük harf kullanımı zaten kullanıldığından, bu değişiklik parametre adlarının API'de tutarlı olmasını sağlar.- v2 API, Google'ın küresel HTTP toplu uç noktasına (
www.googleapis.com/batch
) gönderilen toplu istekleri desteklemez. v2 API'sinde toplu istekler gönderiyorsanız bunun yerinehttps://youtubeanalytics.googleapis.com/v2
uç noktasını kullanmanız gerekir.
Ayrıca v2 API'sinde desteklenmeyen birkaç v1 özelliği vardır:
reports.query
yöntemi artıkalt
,quotaUser
veuserIp
istek parametrelerini desteklemiyor.- v2 API, farklı API'lere yapılan isteklerden oluşan grupları destekleyen bir toplu işlem uç noktası sağlamaz. (Bununla birlikte, bir grup, aynı API'nin farklı yöntemlerine yapılan isteklerden oluşabilir.) Google, global toplu işlem uç noktasını tüm API'lerinde kullanımdan kaldıracağı için bu kullanımdan kaldırma işlemi YouTube Analytics API'ye özel bir durum değildir.
- v2 API, API v1'de desteklenen JSON-RPC protokolünü desteklemez. Bununla birlikte, desteğin sonlandırılması YouTube Analytics API'ye özel değildir.
- API'nin
-
Not: Bu, kullanımdan kaldırma duyurusudur.
API Sürüm 1'in (v1) desteği sonlandırılmıştır ve 31 Ekim 2018 tarihine kadar desteklenecektir. v1 API'ye yapılan tüm istekler bu tarihten sonra çalışmayı durduracaktır. Bu nedenle, API üzerinden YouTube Analytics verilerine erişiminizde kesinti yaşamamak için lütfen 31 Ekim 2018 tarihine kadar v2 API'ye yükseltme yaptığınızdan emin olun.
21 Şubat 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:
- Görüntüleme istatistiklerini izleyicilerin yaş grubu ve cinsiyetine göre birleştiren izleyici demografisi raporları artık kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlayan
youtubeProduct
boyutunu desteklemiyor.
18 Ocak 2018
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Reporting API (Toplu Raporlar)
- Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan
operating_system
boyutu artık aşağıdaki değeri desteklemektedir:25
: KaiOS
- Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan
-
YouTube Analytics API (Hedeflenen Sorgular)
operatingSystem
boyutu,KAIOS
boyut değerini destekler.
20 Aralık 2017
Bu güncelleme, YouTube Reporting API ile ilgili iki değişiklik içeriyor:
-
API sunucusu artık raporları indiren istekler için gzip sıkıştırmasını desteklemektedir. gzip sıkıştırma işleminin diğer API isteği türleri için desteklenmediğini unutmayın. gzip sıkıştırmasının etkinleştirilmesi her API yanıtı için gereken bant genişliğini azaltır. Uygulamanızın API yanıtlarını açmak için ek CPU zamanı gerekse de daha az ağ kaynağı tüketmenin sağlayacağı avantaj, genellikle maliyetten daha ağır basar.
gzip kodlamalı bir yanıt almak için
Accept-Encoding
HTTP istek başlığını aşağıdaki örnekte gösterildiği gibigzip
olarak ayarlayın:Accept-Encoding: gzip
Bu işlev, API'lere genel bakış bölümünde ve
report
kaynağınındownloadUrl
özelliğinin tanımında açıklanmıştır. -
age group
vegender
boyutlarıyla ilgili dokümanlar, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bunun dokümanlarla ilgili bir düzeltme olduğunu ve API işlevi veya davranışındaki bir değişikliği yansıtmadığını unutmayın. Daha ayrıntılı olarak belirtmek gerekirse, aşağıdaki değerler değişmiştir:age_group
boyutu değerleri büyük harf kullanır,AGE
kelimesi ile yaş grubundaki sayıların arasında alt çizgi içerir ve kısa çizgi yerine alt çizgi kullanın. Bu nedenle,age13-17
veage18-24
gibi değerler sırasıylaAGE_13_17
veAGE_18_24
olarak düzeltildi.gender
boyutu değerlerinde büyük harf kullanılmıştır. Bu nedenle,female
,male
vegender_other
değerleriFEMALE
,MALE
veGENDER_OTHER
olarak düzeltildi.
10 Ağustos 2017
10 Ağustos 2016'da bu belgeyle YouTube Analytics API'nin earnings
metriğinin kullanımdan kaldırıldığını duyurduk. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue
adlı yeni bir metriği de destekliyor.)
earnings
metriği temel bir metrik olduğu için duyuru tarihinden itibaren bir yıl süreyle desteklendi. Ancak bu yıllık dönem sona erdiğinden earnings
metriği artık desteklenmemektedir. Sonuç olarak, earnings
metriğini belirten API istekleri artık 400
HTTP yanıt kodu döndürüyor. Uygulamanızı henüz earnings
metriği yerine estimatedRevenue
metriğini kullanacak şekilde güncellemediyseniz lütfen mümkün olan en kısa sürede güncelleyin.
API dokümanları, earnings
metriğine ilişkin kalan referansları kaldıracak şekilde güncellendi.
6 Temmuz 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Analytics API (Hedeflenen Sorgular)
-
API dokümanları, API yanıtlarının sorgulanmakta olan tüm metriklerin kullanılabilir olduğu istenen tarih aralığındaki son güne kadar olan verileri içerdiğini yansıtacak şekilde güncellenmiştir.
Örneğin, bir istekte 5 Temmuz 2017 bitiş tarihi belirtiliyorsa ve istenen tüm metriklerin değerleri yalnızca 3 Temmuz 2017'ye kadar kullanılabiliyorsa bu tarih, verilerin yanıta dahil edileceği son tarih olur. (İstenen metriklerden bazılarının verileri 4 Temmuz 2017 için kullanılabilir olsa bile bu durum geçerlidir.)
-
adType
boyutu artıkreservedBumperInstream
değerini desteklemektedir. Bu değer, bir video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklam anlamına gelir. Reklam biçimi,auctionBumperInstream
reklamı ile aynıdır, ancak bu tür, açık artırma yerine ayırma yöntemiyle satılan reklamları ifade eder.
-
-
YouTube Reporting API (Toplu Raporlar)
-
ad_type
boyutu, artık ayırtılarak satılan bumper reklamları ifade eden20
değerini destekliyor. Bumper reklamlar, video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklamlardır. Bu boyut için19
değerinin, ayrılmış olarak değil, açık artırmayla satılan bumper reklamları da ifade ettiğini unutmayın. -
Aşağıdaki YouTube Reporting API raporlarının raporlama işleri silindi:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Bu rapor türlerinin kullanımdan kaldırıldığı 15 Eylül 2016 tarihinde duyurulmuştur ve 15 Aralık 2016'dan sonra bu rapor türleri için artık rapor oluşturulmamıştır. Önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 15 Haziran 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.
-
24 Mayıs 2017
Aşağıdaki YouTube Reporting API raporları için tüm raporlama işleri silindi:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
Bu rapor türlerinin kullanımdan kaldırıldığı 22 Haziran 2016 tarihinde duyurulmuştur ve 22 Eylül 2016'dan sonra bu rapor türleri için artık rapor oluşturulmamıştır. Önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 22 Mart 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.
22 Mayıs 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Reporting API (Toplu Raporlar)
- Videoları paylaşmak için kullanılan hizmeti tanımlayan
sharing_service
boyutu artık aşağıdaki değerleri desteklemektedir:85
: YouTube Müzik86
: YouTube Oyun87
: YouTube Çocuk88
: YouTube TV
Ayrıca,
52
değerini tanımlamak için kullanılan ad, dokümanlardaki Kakao (Kakao Talk) şeklinde güncellendi. Böylece,73
değerinden daha net bir şekilde ayırt edilebilir (Kakao Story). Bu değişiklik, bu hizmetlerle paylaşılan videoların API davranışında veya sınıflandırmasında herhangi bir değişikliğe işaret etmez.
- Videoları paylaşmak için kullanılan hizmeti tanımlayan
-
YouTube Analytics API (Hedeflenen Sorgular)
sharingService
boyutu artık aşağıdaki değerleri desteklemektedir:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
28 Mart 2017
İçerik Stüdyosu'nda YouTube Analytics üzerinden gelir verilerine erişebilen kanal sahipleri, artık bu gelir verilerine YouTube Analytics API aracılığıyla da erişebilir:
-
API, gelirle ilgili aşağıdaki metrikleri destekler:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
Bu metrikler aşağıdaki raporlarda desteklenir:
-
Kanal sahipleri artık
adType
boyutunu ve isteğe bağlıday
boyutunu destekleyen bir reklam performansı raporu da alabilir. -
YouTube Analytics API örnek istekler rehberinde artık kanal geliri raporları için bir bölüm bulunmaktadır.
17 Mart 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Analytics API, her ikisi de YouTube Red izleyici sayısıyla ilgili olan
redViews
veestimatedRedMinutesWatched
metriklerini destekler. Aslında, API bir süredir bu metrikleri desteklemektedir ve YouTube Reporting API, 15 Eylül 2016'da duyurulduğu üzere her iki metriği de zaten desteklemektedir.redViews
metriği, bir videonun YouTube Red üyeleri tarafından görüntülenme sayısını tanımlar.estimatedRedMinutesWatched
metriği, YouTube Red üyelerinin bir videoyu izlediği dakika sayısını tanımlar.
Kanal raporları ve içerik sahibi raporları dokümanları, hangi raporların iki yeni metriği desteklediğini gösterecek şekilde güncellendi. Halihazırda
views
veestimatedMinutesWatched
metriklerini destekleyen tüm raporlarda desteklenmektedir.
3 Mart 2017
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
YouTube Reporting API (Toplu Raporlar)
-
date
boyutunun tanımı, boyut değerinin, belirtilen gün, ay ve yılda Pasifik saatiyle 00:00'da başlayan ve Pasifik saatiyle 23:59'da sona eren dönemi ifade edecek şekilde düzeltildi. Yılın zamanına bağlı olarak, Pasifik saati UTC-7 veya UTC-8'dir.Tarihler genellikle 24 saatlik bir dönemi temsil etse de, saatlerin ileriye ayarlandığı tarihler 23 saatlik bir süreyi, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Önceden dokümanlarda, her tarihin benzersiz bir 24 saatlik bir dönemi temsil ettiği ve Pasifik saatinin her zaman UTC-8 olduğu belirtiliyordu.)
Bu düzeltmenin gerçek API davranışında bir değişikliği temsil etmediğini unutmayın.
- Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan
operating_system
boyutu artık aşağıdaki değerleri desteklemektedir:22
: Tizen23
: Firefox24
: RealMedia
-
content_owner_basic_a1
rapor türündeki tüm raporlama işleri silindi. Bu rapor türü 19 Ağustos 2016 itibarıyla tamamen kullanımdan kaldırılmıştı ancak daha önce oluşturulancontent_owner_basic_a1
raporları, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 19 Şubat 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.
-
-
YouTube Analytics API (Hedeflenen Sorgular)
-
time periods
ile ilgili boyutların açıklaması, boyut değerinin, belirtilen gün, ay ve yılda Pasifik saatiyle 00:00'da başlayan ve Pasifik saatiyle 23:59'da sona eren dönemi ifade edecek şekilde düzeltildi. Yılın zamanına bağlı olarak, Pasifik saati UTC-7 veya UTC-8'dir.Tarihler genellikle 24 saatlik bir dönemi temsil etse de, saatlerin ileriye ayarlandığı tarihler 23 saatlik bir süreyi, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce dokümanlarda Pasifik saatinin UTC-8 olduğu belirtiliyordu ve bir günün 24 saatlik bir süreyi temsil edememe olasılığından bahsedilmiyordu.)
Bu düzeltmenin gerçek API davranışında bir değişikliği temsil etmediğini unutmayın.
-
Kanal raporları dokümanları, kanal raporlarının şu anda kazanç veya reklam performansı metriklerini içermediğini belirtecek şekilde güncellendi. Dolayısıyla,
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
kapsamı şu anda kanal raporlarındaki parasal verilere erişim izni vermemektedir. operatingSystem
boyutu, üç yeni boyut değerini destekler:FIREFOX
REALMEDIA
TIZEN
-
8 Şubat 2017
YouTube Analytics API artık isteğe bağlı include-historical-channel-data
parametresini desteklemektedir. Bu parametrenin yalnızca içerik sahibi raporları alırken geçerli olduğunu unutmayın.
Bu parametre içerik sahibinin, bir API yanıtının kanalların içerik sahibine bağlanmasından önceki döneme ait izlenme süresini ve görüntüleme verilerini içermesi gerektiğini belirtmesine olanak tanır. Varsayılan parametre değeri false
'dir. Yani, API yanıtı varsayılan olarak yalnızca kanalların içerik sahibine bağlandığı zamana ait izlenme süresi ve görüntüleme verilerini içerir.
Bu kurallar, API isteği birden fazla kanal için veri aldığında da geçerlidir:
- Parametre değeri
false
ise belirli bir kanal için döndürülen izlenme süresi ve görüntüleme verileri, kanalın içerik sahibine bağlandığı tarihe dayanır.
Farklı kanalların farklı tarihlerde bir içerik sahibine bağlanmış olabileceğini unutmayın. API isteği birden çok kanal için veri alıyorsa ve parametre değerifalse
ise API yanıtı, ilgili her kanalın bağlantı tarihine göre izlenme süresi ve görüntüleme verilerini içerir. - Parametre değeri
true
ise yanıt, API isteğinde belirtilen başlangıç ve bitiş tarihlerine göre tüm kanallar için izlenme süresi ve görüntüleme verilerini döndürür.
15 Aralık 2016
Aşağıdaki YouTube Reporting API raporları artık desteklenmemektedir ve dokümanlardan kaldırılmıştır. Her raporun daha yeni bir sürümü mevcut. (Bu raporlarla ilgili kullanımdan kaldırma duyurusu 15 Eylül 2016 tarihinde yapılmıştır.)
-
Kanal raporları
channel_basic_a1
-channel_basic_a2
raporuyla değiştirildi.channel_province_a1
-channel_province_a2
raporuyla değiştirildi.channel_playback_location_a1
-channel_playback_location_a2
raporuyla değiştirildi.channel_traffic_source_a1
-channel_traffic_source_a2
raporuyla değiştirildi.channel_device_os_a1
-channel_device_os_a2
raporuyla değiştirildi.channel_subtitles_a1
-channel_subtitles_a2
raporuyla değiştirildi.channel_combined_a1
-channel_combined_a2
raporuyla değiştirildi.
-
İçerik sahibi raporları
content_owner_basic_a2
-content_owner_basic_a3
raporuyla değiştirildi.content_owner_province_a1
-content_owner_province_a2
raporuyla değiştirildi.content_owner_playback_location_a1
-content_owner_playback_location_a2
raporuyla değiştirildi.content_owner_traffic_source_a1
-content_owner_traffic_source_a2
raporuyla değiştirildi.content_owner_device_os_a1
-content_owner_device_os_a2
raporuyla değiştirildi.content_owner_subtitles_a1
-content_owner_subtitles_a2
raporuyla değiştirildi.content_owner_combined_a1
-content_owner_combined_a2
raporuyla değiştirildi.content_owner_asset_basic_a1
-content_owner_asset_basic_a2
raporuyla değiştirildi.content_owner_asset_province_a1
-content_owner_asset_province_a2
raporuyla değiştirildi.content_owner_asset_playback_location_a1
-content_owner_asset_playback_location_a2
raporuyla değiştirildi.content_owner_asset_traffic_source_a1
-content_owner_asset_traffic_source_a2
raporuyla değiştirildi.content_owner_asset_device_os_a1
-content_owner_asset_device_os_a2
raporuyla değiştirildi.content_owner_asset_combined_a1
-content_owner_asset_combined_a2
raporuyla değiştirildi.
API referans belgelerindeki mevcut rapor türlerinin listesi de güncellenmiştir.
11 Kasım 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Bitiş ekranı raporları
- Kanal videoları için bitiş ekranı raporu, kanalın tüm videolarına ilişkin istatistikleri içerir.
- İçerik sahibi videolarına ilişkin bitiş ekranı raporu, içerik sahibinin tüm kanallarındaki videolara ilişkin istatistikleri içerir.
- İçerik sahibi öğeleri için bitiş ekranı raporu, bitiş ekranlarının gösterildiği videolarla ilişkili öğelerin istatistiklerini içerir.
-
Bitiş ekranı boyutları
end_screen_element_type
: İstatistiklerle ilişkilendirilen bitiş ekranı öğesinin türü.end_screen_element_id
: YouTube'un bitiş ekranı öğesini benzersiz şekilde tanımlamak için kullandığı kimliktir.
Bitiş ekranı metrikleri
Not: Bitiş ekranı metrikleriyle ilgili veriler 1 Mayıs 2016 tarihinden itibaren kullanılabilmektedir.
end_screen_element_impressions
: Bitiş ekranı öğesi gösterimlerinin toplam sayısı. Gösterilen her bitiş ekranı öğesi için bir gösterim kaydedilir.end_screen_element_clicks
: Bitiş ekranı öğelerinin tıklanma sayısı.end_screen_element_click_rate
: Bitiş ekranı öğelerinin tıklama oranı.
-
Aşağıdaki raporlar artık desteklenmemektedir ve dokümanlardan kaldırılmıştır. Her raporun daha yeni bir sürümü mevcut. (Bu raporlarla ilgili kullanımdan kaldırma duyurusu 22 Haziran 2016'da yapılmıştır.)
content_owner_ad_performance_a1
-content_owner_ad_rates_a1
raporuyla değiştirildi.content_owner_estimated_earnings_a1
-content_owner_estimated_revenue_a1
raporuyla değiştirildi.content_owner_asset_estimated_earnings_a1
-content_owner_asset_estimated_revenue_a1
raporuyla değiştirildi.
-
Aşağıdaki listede yer alan metrikler tamamen kullanımdan kaldırılmıştır ve artık desteklenmemektedir. 10 Ağustos 2016 tarihinde duyurulduğu üzere, aynı verileri ifade eden yeni metrikler halihazırda desteklenmektedir. Aşağıdaki tabloda kullanımdan kaldırılan metrik adı ve yeni metrik adı gösterilmektedir:
Kullanımdan kaldırılan metrik Yeni metrik adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Dünya genelinde video başına aylık reklam geliri
- Video başına ülke başına günlük reklam geliri
- Dünya genelinde öğe başına aylık reklam geliri
- Öğe başına ülke başına günlük reklam geliri
- Hak talepleri (bu rapor, gelir verilerini içermez)
-
API, YouTube Red izleyici sayısıyla ilgili iki yeni metriği desteklemektedir:
red_views
: Bir videonun YouTube Red üyeleri tarafından görüntülenme sayısı.red_watch_time_minutes
: YouTube Red üyelerinin bir videoyu izlediği dakika sayısı.
-
API, 20 raporun yeni sürümünü destekler. Yeni sürümlerin tümü yeni
red_views
vered_watch_time_minutes
metriklerini destekler.Her rapor için yeni rapor türü kimliğindeki sayı, eski rapor türü kimliğindekinden bir sayı yüksektir. (Bu raporların eski sürümleri, bu düzeltme geçmişinde daha sonra açıklandığı üzere artık kullanımdan kaldırılmıştır.) Örneğin,
channel_basic_a1
raporu kullanımdan kaldırıldı vechannel_basic_a2
raporuyla değiştirildi.Aşağıdaki listeler yeni rapor türü kimliklerini tanımlar:
Kanal videosu raporları
İçerik sahibine ait video raporları
İçerik sahibi öğe raporları
-
Not: Bu, kullanımdan kaldırma duyurusudur.
Yukarıda listelenen raporların eski sürümlerinden herhangi birini oluşturmak için zaten işleriniz varsa, yeniden adlandırılan raporlar için yeni işler oluşturmanız gerekeceğini unutmayın. Yeni rapor sürümlerinin yayınlanmasıyla birlikte, aşağıdaki rapor sürümleri de kullanımdan kaldırılmıştır:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
Bu raporlardan herhangi birinde işleriniz varsa YouTube'un 15 Aralık 2016 tarihinden sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Üretilen raporlar, oluşturulduğu andan itibaren 180 gün boyunca kullanılabilir durumda kalır.
-
content_owner_basic_a1
raporu tamamen kullanımdan kaldırıldı ve dokümanlardan kaldırıldı. YouTube artık bu tür yeni raporlar oluşturmayacaktır. Bununla birlikte, önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olacaktır.content_owner_basic_a1
raporunun yerini alan, 19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklanancontent_owner_basic_a2
raporudur. -
YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak açıklanan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), geçerli Hizmet Şartları'nda kapsamlı bir güncelleme seti sunmaktadır. 10 Şubat 2017'de yürürlüğe girecek olan Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak bazı destekleyici dokümanlar içerir.
Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde yapılacak değişikliklerin durumu da söz konusu düzeltme geçmişinde açıklanacaktır. Söz konusu düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına ilgili dokümandaki bağlantıdan abone olabilirsiniz.
-
YouTube Analytics API (Hedeflenen Sorgular)
-
Not: Bu, kullanımdan kaldırma duyurusudur.
Aşağıdaki tabloda yer alan metrikler kullanımdan kaldırılıyor. Aynı zamanda, aynı verileri ifade eden yeni metrikler de kullanıma sunuluyor. Bu durum, eski metriklerin yeniden adlandırıldığı anlamına geliyor. Ancak YouTube Analytics API, tabloda listelenen kullanımdan kaldırılma tarihlerine kadar her iki metrik adını da destekleyecek.
Eski metrik adı Yeni metrik adı Destek tarihi earnings
estimatedRevenue
10 Ağustos 2017 adEarnings
estimatedAdRevenue
4 Kasım 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 Kasım 2016 impressionBasedCpm
cpm
4 Kasım 2016 impressions
adImpressions
4 Kasım 2016 earnings
metriğinin temel metrik olduğunu, bu nedenle bu duyurunun yapıldığı tarihten itibaren bir yıl boyunca destekleneceğini unutmayın. Temel metrik dışındaki diğer metrikler, 4 Kasım 2016'ya kadar üç ay boyunca desteklenecektir.Örneğin, 4 Kasım 2016'ya kadar bir API isteği
impressionBasedCpm
metriğini,cpm
metriğini veya her ikisini birden belirtebilir. Ancak, bu tarihten sonra yalnızcacpm
metriği desteklenecektir. insightTrafficSourceType
boyutu, iki yeni boyut değerini destekler:CAMPAIGN_CARD
: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklandığını belirtir.END_SCREEN
: Veriler, başka bir videonun bitiş ekranından elde edilen izlemelerle ilgilidir.
Her iki yeni trafik kaynağı için de bir
traffic source detail
raporu alabilirsiniz. Her iki durumda dainsightTrafficSourceDetail
boyutu, izleyicinin yönlendirildiği videoyu tanımlar.-
adType
boyutu artıkauctionBumperInstream
değerini desteklemektedir. Bu değer, bir video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklam anlamına gelir.
-
-
YouTube Reporting API (Toplu Raporlar)
traffic_source_type
boyutu artık aşağıdaki değerleri desteklemektedir:19
: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklandığını belirtir.20
: Veriler, başka bir videonun bitiş ekranından elde edilen izlemelerle ilgilidir.
Her iki yeni trafik kaynağı için de
traffic_source_detail
boyutu, izleyicinin yönlendirildiği videoyu tanımlar.-
API'nin temel metrikler listesi,
estimated_partner_revenue
temel metrik olarak listelenecek veearnings
metriği bu listeden kaldırılacak. (earnings
metriği, YouTube Reporting API'de hiçbir zaman desteklenmemektedir.) -
ad_type
boyutu artık bumper reklamlar anlamına gelen19
değerini desteklemektedir. Bu değer, bir videonun görüntülenmesinden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklamlardır.
-
YouTube Analytics API (Hedeflenen Sorgular)
- Aşağıdaki kanal raporları için desteklenen metriklerin listesi kart metriklerini içerecek şekilde güncellenmiştir. Bu raporlardaki kart metrikleri desteği 28 Haziran 2016'da eklenmiştir ve bu tarihe ait düzeltme geçmişi girişinde değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar:
- ABD eyaletleri için temel kullanıcı etkinliği
- Belirli dönemler için ABD eyaletlerindeki kullanıcı etkinliği
- Eyale göre kullanıcı etkinliği
- Abone olma durumuna göre kullanıcı etkinliği
- Eyaletler için abone olma durumuna göre kullanıcı etkinliği
- Eyalet bazında en popüler videolar
- Abone olan veya abone olmayan izleyiciler için en popüler videolar
-
Filtre listeleri, hem kanal kitleyi elde tutma raporları hem de içerik sahibi kitleyi elde tutma raporları için,
video
filtresinin gerekli olduğunu vegroup
filtresinin desteklenmediğini yansıtacak şekilde düzeltilmiştir.Daha önce her iki raporun dokümanlarında, raporun bu iki filtreden biri kullanılarak veya iki filtre kullanılmadan alınabileceği belirtiliyordu.
- Aşağıdaki kanal raporları için desteklenen metriklerin listesi kart metriklerini içerecek şekilde güncellenmiştir. Bu raporlardaki kart metrikleri desteği 28 Haziran 2016'da eklenmiştir ve bu tarihe ait düzeltme geçmişi girişinde değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar:
-
YouTube Reporting API (Toplu Raporlar)
- API'ye genel bakış bölümündeki bir raporun indirme URL'sinin nasıl alınacağını açıklayan bölüm, YouTube'un veri mevcut olmadığı günler için indirilebilir raporlar oluşturduğunu belirtecek şekilde düzeltildi. Bu raporlar bir başlık satırı içerir ancak ek veri içermez. Bu bilgiler, 12 Nisan 2016 tarihinde aynı dokümanın Rapor özellikleri bölümünde zaten güncellenmişti.
content_owner_asset_cards_a1
raporundaki boyutlar listesi, raporuncard_id
boyutunu kullandığını yansıtacak şekilde düzeltildi. Daha önce, dokümanlarda boyut adı hatalı bir şekildecard_title
olarak listeleniyordu.
- Temel istatistikler(kanallar, içerik sahipleri)
- Zamana dayalı(kanallar, içerik sahipleri)
- Kullanıcının bulunduğu coğrafya (kanallar, içerik sahipleri)
- Abone olma durumuna göre kullanıcı etkinliği (kanallar, içerik sahipleri)
- En popüler videolar (kanallar, içerik sahipleri)
-
API'ye genel bakışın Rapor özellikleri bölümü, raporların, oluşturuldukları andan itibaren 180 gün boyunca API aracılığıyla kullanılabildiğini netleştirmek amacıyla güncellendi.
Önceden dokümanlarda raporların, API isteğinin gönderildiği tarihten önceki 180 gün boyunca kullanılabildiği belirtiliyordu. Teknik olarak doğru olmakla birlikte, orijinal metin en iyi ihtimalle biraz kafa karıştırıcıydı.
-
API, üç raporun yeni sürümlerini destekler. Bu raporlardan ikisi yeni ve yeniden adlandırılmış metrikler de içermektedir:
-
content_owner_ad_rates_a1
raporu,content_owner_ad_performance_a1
raporunun yeni sürümüdür. Yeni adı verilen rapor, önceki sürümle aynı. -
Yeni sürümleri olan iki rapor yeniden adlandırıldı:
content_owner_estimated_earnings_a1
raporunun yeni sürümünün adıcontent_owner_estimated_revenue_a1
.content_owner_asset_estimated_earnings_a1
raporunun yeni sürümünün adıcontent_owner_asset_estimated_revenue_a1
.
Yeniden adlandırılan her iki rapor da öncekilerden aşağıda belirtilen yönlerden farklıdır:
- Şirket, YouTube Red aboneliklerinden elde edilen toplam kazancı tahmin eden yeni
estimated_partner_red_revenue
metriğini ekliyor. - Şirket, ücretli içerikler ve takipçi bağışları gibi işlemlerden elde edilen gelirden iş ortağı tarafından alınan geri ödemelerin çıkarılmasıyla elde edilen geliri tahmin eden yeni
estimated_partner_transaction_revenue
metriğini ekliyor. estimated_partner_ad_sense_revenue
metriğiniestimated_partner_ad_auction_revenue
olarak yeniden adlandırıyor.estimated_partner_double_click_revenue
metriğiniestimated_partner_ad_reserved_revenue
olarak yeniden adlandırıyor.
Bu raporların eski sürümlerinden birini oluşturmak için zaten işleriniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerekeceğini unutmayın. Yeni rapor sürümlerinin yayınlanmasıyla birlikte
content_owner_ad_performance_a1
,content_owner_estimated_earnings_a1
vecontent_owner_asset_estimated_earnings_a1
raporları kullanımdan kaldırılmıştır.Bu raporlardan herhangi birinde işleriniz varsa YouTube'un 22 Eylül 2016'dan sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Üretilen raporlar, oluşturulduğu andan itibaren 180 gün boyunca kullanılabilir durumda kalır.
-
-
reportType
kaynağınınid
özelliğinin tanımı, mevcut rapor grubunu yansıtacak şekilde güncellendi. -
İki metriğin adları, raporlarda görünen adlarla eşleşecek şekilde belgelerde düzeltilmiştir. Bu, yalnızca dokümanla ilgili bir düzeltmedir ve gerçek rapor içeriklerinde bir değişikliği yansıtmaz:
estimated_partner_adsense_revenue
metriğinin adıestimated_partner_ad_sense_revenue
olarak güncellendi. Bununla birlikte, bu metriğin yalnızca bu güncellemeyle desteği sonlandırılan iki raporda göründüğünü unutmayın. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların yeni sürümlerindeestimated_partner_ad_auction_revenue
olarak yeniden adlandırılmıştır.estimated_partner_doubleclick_revenue
metriğinin adıestimated_partner_double_click_revenue
olarak güncellendi. Bu metriğin yalnızca, bu güncellemeyle birlikte kullanımdan kaldırılan iki raporda yer aldığını tekrar hatırlatmak isteriz. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların yeni sürümlerindeestimated_partner_ad_reserved_revenue
olarak yeniden adlandırılmıştır.
-
Reporting API'nin boyutlar dokümanları,
elapsed_video_time_percentage
veaudience_retention_type
mülklerinin artık listelenmemesi için güncellendi. Bu boyutlar, şu anda API aracılığıyla kullanılabilen hiçbir rapor tarafından desteklenmemektedir. -
API, içerik sahipleri için kullanıcı etkinliği raporunun yeni bir sürümünü destekler. Yeni raporun rapor türü kimliği:
content_owner_basic_a2
. Raporun önceki sürümünden (content_owner_basic_a1
) farklı olarak, yeni sürümlikes
vedislikes
metriklerini destekler.content_owner_basic_a1
raporunu oluşturmak için zaten bir işiniz varsacontent_owner_basic_a2
raporu için yeni bir iş oluşturmanız gerekir. YouTube, içerik sahiplerini otomatik olarak yeni rapor sürümüne taşımaz veya yeni rapor sürümünü oluşturmak için otomatik olarak bir iş oluşturmaz. Bazı uygulamalarda, yeni, beklenmedik bir işin görünmesi yıkıcı bir değişiklik olabilir.Yeni raporun yayınlanmasıyla birlikte,
content_owner_basic_a1
raporu kullanımdan kaldırıldı. Bu rapor için bir işiniz varsa YouTube'un 19 Ağustos 2016'dan sonra bu iş için yeni raporlar oluşturmasını beklememelisiniz. Üretilen raporlar, oluşturulduğu andan itibaren 180 gün boyunca kullanılabilir durumda kalır. -
reportType
,job
vereport
kaynaklarının tümü, ilişkili kaynağın kullanımdan kaldırılmış bir rapor türünü temsil edip etmediğini tanımlayan yeni bir özelliği destekler:-
reportType
kaynağınındeprecateTime
özelliği, rapor türünün kullanımdan kaldırılacağı tarih ve saati belirtir. Bu özellik, yalnızca kullanımdan kaldırıldığı duyurulan raporlar için bir değere sahiptir ve bu değer, YouTube'un bu türde raporlar oluşturmayı durduracağı tarihi temsil eder.Bir rapor türünün kullanımdan kaldırıldığı duyurulduktan sonra YouTube, üç ay daha o türde raporlar oluşturur. Örneğin, 19 Mayıs 2016 tarihli bu güncellemeyle,
content_owner_basic_a1
raporunun kullanımdan kaldırılacağı bildirilmiştir. Dolayısıyla, söz konusu rapor türüne ilişkindeprecateTime
, 19 Ağustos 2016'da YouTube'un bu türde raporlar oluşturmayı durduracağı zamanı belirtir. -
job
kaynağınınexpireTime
özelliği, işin süresinin dolduğu veya sona ereceği tarih ve saati belirtir. İşle ilişkili rapor türünün desteği sonlandırıldıysa veya iş için oluşturulan raporlar uzun süre indirilmediyse bu özelliğin bir değeri vardır. Bu tarih, YouTube'un artık iş için yeni rapor oluşturmayacağı zamanı gösterir. -
report
kaynağınınjobExpireTime
özelliği, raporla ilişkilendirilen işin süresinin dolduğu veya süresinin dolacağı tarih ve saati belirtir. Bu özellik, bu listenin bir önceki öğesinde açıklandığı gibijob
kaynağındakiexpireTime
özelliği ile aynı değeri içerir.
-
-
Kullanımdan kaldırılmış bir rapor için iş oluşturmaya çalışırsanız
jobs.create
yöntemi artık400
HTTP yanıt kodu (Bad Request
) döndürüyor. Ayrıca, yöntemin belgelerinde artık bir API isteğinin başarısız olmasına yol açan diğer çeşitli nedenler de listelenmektedir. -
YouTube artık raporlama işinin ilk planlandığı tarihten önceki 180 günlük dönemi kapsayan veriler oluşturmaktadır. Daha önce Reporting API geçmiş verileri yayınlamıyordu. Bu değişiklik, bu duyurudan önce oluşturulanlar da dahil olmak üzere tüm işleri etkiler.
Geçmiş raporlar, kullanılabilir olur olmaz gönderilir. Bununla birlikte, bir iş için geçmiş verilerin tamamının yayınlanması yaklaşık bir ay sürer. Yani, bir raporlama işi planladıktan bir ay sonra, yaklaşık yedi aylık verilere erişiminiz olur. (Bu duyurudan önce oluşturulmuş işlerle ilgili tüm geçmiş veriler duyurudan itibaren bir ay içinde yayınlanmalıdır.)
Geçmiş verilerin yalnızca 1 Temmuz 2015 itibarıyla kullanılabileceğini unutmayın. Sonuç olarak, 28 Aralık 2015'ten önce oluşturulan işlerin geçmiş verileri 180 günden daha az olacak.
Bu değişikliklerin tümü, Reporting API'ye genel bakışın yeni geçmiş veriler bölümünde açıklanmaktadır.
-
YouTube Reporting API'ye genel bakışın rapor özellikleri bölümü aşağıdaki değişikliklerle güncellendi:
-
Söz konusu dokümanlarda artık raporların oluşturulduktan sonraki 180 gün süreyle kullanılabildiği ve bu nedenle API istemcileri tarafından indirilebildiği belirtilmektedir. Önceden dokümanlarda raporların, API isteğinin gönderildiği tarihten altı ay öncesine kadar kullanılabildiği belirtiliyordu.
-
Söz konusu dokümanlar, API'nin artık veri mevcut olmadığı günler için indirilebilir raporlar oluşturduğunu yansıtacak şekilde güncellenmiştir. Bu raporlar başlık satırları içerir ancak ek veriler içermez.
-
-
YouTube Reporting API, yakında reklam geliri veya YouTube Red abonelik geliri verilerini içeren, otomatik olarak oluşturulmuş, sistem tarafından yönetilen bir grup raporu destekleyecek. Raporlar, halihazırda YouTube İçerik Stüdyosu'nda manuel olarak indirilebilir gelir raporlarına erişebilen içerik sahipleri tarafından kullanılabilecek. Bu nedenle, yeni API işlevi bu verilere programatik erişim sağlayacaktır.
Sistem tarafından yönetilen raporların kullanıma sunulmasına hazırlık olarak aşağıdaki API değişiklikleri duyurulmaktadır:
-
job
kaynağının yenisystemManaged
özelliği, kaynağın sistem tarafından yönetilen raporlar oluşturan bir işi tanımlayıp tanımlamadığını gösterir. YouTube, YouTube içerik sahipleri için sistem tarafından yönetilen raporları otomatik olarak oluşturur ve içerik sahipleri bu raporları oluşturan işleri değiştiremez veya silemez. -
jobs.list
yönteminin yeniincludeSystemManaged
parametresi, API yanıtının sistem tarafından yönetilen raporlar için işleri içerip içermediğini gösterir.false
, parametrenin varsayılan değeridir. -
jobs.reports.list
yönteminin yenistartTimeAtOrAfter
parametresi, API yanıtının yalnızca rapordaki en eski verilerin belirtilen tarihte veya daha sonra olması durumunda rapor içermesi gerektiğini belirtir. Benzer şekildestartTimeBefore
parametresi, API yanıtının yalnızca rapordaki en erken verilerin belirtilen tarihten önce olması durumunda rapor içermesi gerektiğini belirtir.Yöntemin, raporun oluşturulduğu zamanla ilişkilendirilen
createdAfter
parametresinden farklı olarak, yeni parametreler rapordaki verilerle ilişkilidir. -
reportType
kaynağının yenisystemManaged
özelliği, kaynağın sistem tarafından yönetilen bir raporu tanımlayıp tanımlamadığını gösterir. -
reportTypes.list
yönteminin yeniincludeSystemManaged
parametresi, API yanıtının sistem tarafından yönetilen raporları içerip içermeyeceğini gösterir.false
, parametrenin varsayılan değeridir.
-
- YouTube Reporting API'deki
sharing_service
boyutu şu yeni değerleri destekler:82
: iOS sistem etkinliği iletişim kutusu83
: Google Gelen Kutusu84
: Android Messenger
- YouTube Analytics API'deki
sharingService
boyutu, şu yeni değerleri destekler:ANDROID_MESSENGER
: Android MessengerINBOX
: Google Gelen KutusuIOS_SYSTEM_ACTIVITY_DIALOG
: iOS sistem etkinliği iletişim kutusu
playback_location_type
boyutu, iki yeni boyut değerini destekler:7
: Veriler, YouTube ana sayfası veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.8
: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
traffic_source_type
boyutu, artık boyut değeri olarak18
özelliğini desteklemektedir. Bu değer, video görüntüleme sayısının bir oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını gösterir. Bu kaynak, video bir oynatma listesinin parçası olarak video oynatılırken görüntülemelerin gerçekleştiğini belirten14
kaynak türünden farklı.insightPlaybackLocationType
boyutu, iki yeni boyut değerini destekler:BROWSE
: Veriler, YouTube ana sayfası veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.SEARCH
: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
insightTrafficSourceType
boyutu, artık boyut değeri olarakYT_PLAYLIST_PAGE
özelliğini desteklemektedir. Bu değer, video görüntüleme sayısının bir oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını gösterir. Bu kaynak, video bir oynatma listesinin parçası olarak video oynatılırken görüntülemelerin gerçekleştiğini belirtenPLAYLIST
kaynak türünden farklıdır.- YouTube Reporting API'de
operating_system
boyutu, Chromecast üzerinden gerçekleşen görüntülemeleri tanımlamak için21
değerini kullanır. - YouTube Analytics API'sinde
operatingSystem
boyutu, Chromecast üzerinden gerçekleşen görüntülemeleri tanımlamak içinCHROMECAST
değerini kullanır. -
YouTube Analytics API artık çeşitli kanal ve içerik sahibi raporlarında kullanılabilen üç yeni oynatma ayrıntısı boyutunu destekliyor:
liveOrOnDemand
: Bu boyut, rapordaki verilerin canlı yayın sırasında gerçekleşen kullanıcı etkinliğini açıklayıp açıklamadığını gösterir.subscribedStatus
: Bu boyut, verilerdeki kullanıcı etkinliği metriklerinin videonun veya oynatma listesinin kanalına abone olan izleyicilerle ilişkilendirilip ilişkilendirilmediğini gösterir.youtubeProduct
: Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube mülkünü tanımlar. Olası değerler şunlardır: temel YouTube web sitesi (veya YouTube uygulaması), YouTube Oyun ve YouTube Çocuk.
Söz konusu dokümanlar, kanallar ve içerik sahipleri tarafından kullanılabilen yeni oynatma ayrıntıları raporlarını tanımlayacak şekilde güncellendi. Ayrıca, bu boyutlardan bir ya da daha fazlasının söz konusu raporlarda isteğe bağlı olarak boyut ve/veya filtre olarak kullanılabileceğini belirtmek üzere daha birçok rapor güncellenmiştir.
-
Raporları açıklayan tabloların biçimi, her bir raporu almak için kullanılabilecek geçerli boyut, metrik ve filtre kombinasyonlarını belirlemenizi kolaylaştırmak amacıyla değiştirilmiştir. Kanallar için "Cihaz Türü" raporunun açıklandığı aşağıdaki tabloda yeni biçim gösterilmektedir:
İçindekiler Boyutlar: Gerekli deviceType 0 veya daha fazlasını kullanın day, liveOrOnDemand, subscribedStatus, youtubeProduct Metrikler: 1 veya daha fazlasını kullanın görüntülemeler, estimatedMinutesWatched Filtreler: 0 veya 1 kullanın ülke, il, kıta, subContinent 0 veya 1 kullanın video, grup 0 veya daha fazlasını kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct Zorunlu ve isteğe bağlı alanları açıklayan terminoloji, kanal ve içerik sahibi raporlarına ilişkin dokümanlarda açıklanmıştır.
-
YouTube Analytics API, API kullanıcısının birden çok değeri (
video
,playlist
vechannel
) destekleyen filtrelerden veri alamadığı öğeleri artık otomatik olarak kaldırıyor. Daha önce, API kullanıcısı belirtilen öğelerden en az birinin verilerine erişememesi durumunda API sunucusu hata döndürüyordu.Örneğin, bir kullanıcının
video
filtresinde 20 video kimliği listelendiği bir API isteği gönderdiğini varsayalım. Kullanıcı, videolardan 18'ine sahiptir. Bununla birlikte, bir video kimliği başka bir kanala ait videoyu, başka bir kimlik ise silinen ve bu nedenle artık mevcut olmayan bir videoyu tanımlar. Bu durumda API sunucusu, hata döndürmek yerine artık kullanıcının erişemediği iki videoyu bırakır ve API yanıtı, API kullanıcısının sahip olduğu 18 videoyla ilgili verileri içerir. -
Boş bir YouTube Analytics
group
için veri isteğinde bulunursanız API artık hata yerine boş bir veri kümesi döndürür. -
Bir gruba öğe eklemeye çalışırsanız ancak söz konusu varlığa erişiminiz yoksa YouTube Analytics API'nin
groupItems.insert
yöntemi artık yetkisiz (403
HTTP yanıt kodu) hatası döndürüyor. Daha önce API, varlığı gruba eklemenize izin veriyordu, ancak daha sonra söz konusu grubun rapor verilerini almaya çalıştığınızda yetkisiz bir hata döndürüyordu. -
YouTube Analytics API'nin
groups.list
yöntemi artık sayfalara ayırmayı desteklemektedir. API yanıtı mevcut tüm grupları içermiyorsa yanıtınnextPageToken
parametresi, sonraki sonuç sayfasını almak için kullanılabilecek bir jeton belirtir. Ek sonuçlar almak için yönteminpageToken
parametresini bu değere ayarlayın. -
YouTube Analytics API artık seçilen rapor boyutları için YouTube Red aboneliklerinden elde edilen toplam tahmini geliri bildiren
redPartnerRevenue
metriğini destekliyor. Bu metriğin değeri, hem müzik hem de müzik dışı içeriklerden elde edilen kazançları yansıtır ve ay sonu ayarlamasına tabidir.YouTube Analytics API'nin içerik sahibi raporları listesi,
redPartnerRevenue
metriğini destekleyen video raporlarını tanımlayacak şekilde güncellendi:- Temel istatistikler
- Zamana dayalı
- Kullanıcının coğrafi konumu
- En popüler videolar – Bu raporda sıralama metriği olarak
redPartnerRevenue
desteklenmektedir. Yani, YouTube Red kazançlarına göre sıralanmış bir video listesi alabilirsiniz.
-
YouTube Analytics API'si için en iyi videolar raporu tanımı artık bu raporun şu kazanç metriklerini de desteklediğini yansıtmaktadır:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
veimpressionBasedCpm
. -
YouTube Reporting API'nin
date
boyutuyla ilgili dokümanlar, tarihlerin Pasifik saatiyle 00:00'dan (UTC-8) başlayan 24 saatlik dönemi ifade ettiğini yansıtacak şekilde düzeltildi. Daha önce, dokümanlarda tarihin 00:00'da (GMT) başladığı belirtiliyordu.Ayrıca YouTube Analytics API dokümanları, tarihle ilgili tüm boyutların (
day
,7DayTotals
,30DayTotals
vemonth
) Pasifik saatiyle 00:00'dan (UTC-8) başlayan tarihleri kapsadığını belirtecek şekilde güncellenmiştir. -
YouTube Reporting API'nin
jobs.reports.list()
yöntemi artıkcreatedAfter
sorgu parametresini destekliyor. Belirtilirse bu parametre, API yanıtının yalnızca belirtilen tarih ve saatten sonra oluşturulan raporları (doldurulmuş verilerle yeni raporlar dahil) listeleyeceğini belirtir. Parametre değerinin döndürülen verilerle ilişkili tarihlerle değil, raporun oluşturulduğu zamanla ilgili olduğunu unutmayın.Parametre değeri, RFC3339 UTC "Zulu" biçiminde ve mikrosaniyelik doğrulukta bir zaman damgasıdır. Örnek:
"2015-10-02T15:01:23.045678Z"
.YouTube Reporting API'nin en iyi uygulamaları, aynı raporun tekrar tekrar işlenmesini önlemek için
createdAfter
parametresini nasıl kullanabileceğinizi açıklayacak şekilde güncellendi. -
job
kaynağınıncreateTime
özelliği ilereport
kaynağınınstartTime
,endTime
vecreateTime
özelliklerinin tümü, özellik değerlerinin nanosaniye cinsinden değil, mikrosaniye cinsinden doğru olduğunu belirtecek şekilde düzeltildi. Ayrıca, tüm tanımlar artık özellik değerinin bir zaman damgası olduğunu doğru bir şekilde yansıtmaktadır. -
YouTube Analytics API'nin
sharingService
boyutuyla ilgili belgeler, olası boyut değerlerinin listesini içerecek şekilde güncellendi. Listede yeni desteklenen hizmetler bulunur.YouTube Reporting API'nin
sharing_service
boyutunun tanımı da yeni desteklenen değerleri listeleyecek şekilde güncellendi.59
değerinden büyük olan numaralandırma değerleri, listedeki yeni değerlerdir. -
Yeni YouTube Reporting API, bir kanal veya içerik sahibi için YouTube Analytics verilerini içeren toplu veri raporlarını alır. Büyük veri kümelerini içe aktarabilen ve bu verileri filtrelemek, sıralamak ve madencilik yapmak için araçlar sunan uygulamalar için tasarlanmıştır.
Her YouTube Reporting API raporu, önceden tanımlanmış bir boyut ve metrik grubu içerir. (YouTube Analytics API raporlarında metrikler ve boyutlar da kullanılır.) Raporlarda, her veri satırında benzersiz bir boyut değerleri kombinasyonu bulunur. Tek tek videolar, ülkeler, canlı videolar, abone olan kullanıcılar vb. için metrikleri hesaplamak amacıyla satırlardaki verileri boyut değerlerine göre birleştirebilirsiniz.
Her biri YouTube'un oluşturması gereken bir raporu tanımlayan raporlama işlerini planlamak için API'yi kullanabilirsiniz. Bir iş oluşturmanızın ardından YouTube, eşzamansız olarak indirilebilen günlük bir rapor oluşturur. Her raporda benzersiz bir 24 saatlik döneme ait veriler bulunur.
-
Farklı API'ler olmalarına rağmen YouTube Analytics API ve YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini alabilmelerini sağlar. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'nin dokümanları tek bir belge grubu olarak yayınlanmaktadır.
- Doküman grubundaki Kılavuzlar sekmesi, API isteklerini yetkilendirme talimatları dahil olmak üzere her iki API'de ortak olan bilgileri içerir.
- Toplu raporlar sekmesinde, referans belgeleri ve YouTube Reporting API'ye özel diğer içerikler yer alır.
- Hedeflenen sorgular sekmesinde, referans belgeleri ve YouTube Analytics API'ye özel diğer içerikler yer alır.
- Örnekler sekmesinde, iki API'den biri için kullanılabilen kod örnekleri listelenir.
- Araçlar sekmesinde, geliştiricilerin bu iki API'den birini uygulamasına yardımcı olmak için kullanılabilecek ek kaynaklar listelenir.
-
API belgeleri, API'nin daha kolay anlaşılmasını sağlamak amacıyla yeniden yapılandırıldı. Dolayısıyla, bu değişiklikler yeni özellikleri açıklamaz:
-
Dokümanlar artık mevcut tüm kanal raporlarının listelendiği bir sayfa ve mevcut tüm içerik sahibi raporlarının listelendiği başka bir sayfa içeriyor. Önceden bu dokümanlarda kanal video raporları, kanal oynatma listesi raporları ve benzerleri için ayrı sayfalar bulunuyordu.
-
Yeni veri modeline genel bakış, API'nin nasıl çalıştığına dair daha net bir tanıtım sağlamayı amaçlar. Bu belgede özellikle, YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığı daha iyi açıklanmaktadır.
-
API'nin raporları almak için kullandığınız
reports.query
yöntemi artık ayrı olarak belgelenmektedir. Söz konusu sayfadaki bilgiler daha önce başka sayfalardaydı. Yeni sayfa, rapor almak için göndermeniz gereken bilgileri daha kolay bir şekilde tanımlamanıza yardımcı olacak şekilde tasarlanmıştır.
-
-
Yeni
adEarnings
metriği, Google tarafından satılan tüm reklam kaynaklarından elde edilen toplam tahmini kazançları (net gelir) içerir. Temel bir metrik değildir. API,earnings
metriğini zaten destekleyen tüm raporlar içinadEarnings
metriğini destekler.Ayrıca,
earnings
metriğinin tanımı, değerinin Google tarafından satılan tüm reklam kaynaklarının yanı sıra reklam dışı kaynaklardan elde edilen toplam tahmini kazançları içerdiğini yansıtacak şekilde düzeltildi. Daha önce tanım, hatalı bir şekilde, metriğin yalnızca reklam kaynaklarından gelen kazançları içerdiğini belirtiyordu. -
primaryAdGrossRevenue
metriği kullanımdan kaldırıldı. Bunun yerine, gelir verilerini almak içingrossRevenue
metriğini kullanın. -
Kullanımdan kaldırılan
primaryAdGrossRevenue
metriğine ek olarak, reklam performansı raporları artıkmonetizedPlaybacks
veplaybackBasedCpm
metriklerini desteklememektedir. Bununla birlikte, bazı video raporları bu metrikleri desteklemeye devam etmektedir. -
API artık video raporları için iki yeni metriği destekliyor:
videosAddedToPlaylists
vevideosRemovedFromPlaylists
. Hem kanallar hem de içerik sahipleri için video raporu listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.videosAddedToPlaylists
: Sorgu kapsamındaki videoların herhangi bir YouTube oynatma listesine eklenme sayısıdır. Videolar, video sahibinin oynatma listesine veya diğer kanalların oynatma listelerine eklenmiş olabilir.videosRemovedFromPlaylists
: Sorgu kapsamındaki videoların YouTube oynatma listelerinden kaldırılma sayısıdır. Videolar, video sahibinin oynatma listesinden veya diğer kanalların oynatma listelerinden kaldırılmış olabilir.
Her iki metrik de "Daha Sonra İzle" oynatma listesi gibi varsayılan oynatma listelerini içerir. Ancak kanalın yüklenen oynatma listesi veya kullanıcının izleme geçmişi gibi videoların otomatik olarak eklendiği oynatma listeleri bu kapsamda yer almaz. Ayrıca bu metriklerin mutlak ekleme ve silme sayısını yansıttığını da unutmayın. Yani bir kullanıcı bir oynatma listesine video ekler, sonra kaldırır ve sonra tekrar eklerse metrikler videonun iki oynatma listesine eklendiğini ve bir oynatma listesinden kaldırıldığını gösterir.
Bu metriklere ilişkin veriler 1 Ekim 2014 tarihinden itibaren kullanılabilmektedir.
-
favoritesAdded
vefavoritesRemoved
metriklerinin ikisi de bu duyuru tarihinden itibaren geçerli olacak şekilde kullanımdan kaldırılmıştır. Bunlar hem temel metriklerdir hem de hizmet şartlarında belirtilen Kullanımdan Kaldırma Politikası'na tabidir. -
Yeni
currency
parametresi, kazanç metriklerini ABD doları (USD
) dışındaki bir para biriminde almanızı sağlar. Parametre ayarlanmışsa API,earnings
,grossRevenue
,playbackBasedCpm
veimpressionBasedCpm
metriklerinin değerlerini belirtilen para birimine dönüştürür. Döndürülen değerler, günlük olarak değişen döviz kurları kullanılarak hesaplanan tahmini değerlerdir.Parametre değeri üç harfli bir ISO 4217 para birimi kodudur. Varsayılan değer:
USD
. Parametre tanımı, desteklenen para birimi kodlarının listesini içerir. -
API artık YouTube Analytics grupları oluşturma ve yönetmenin yanı sıra bu gruplar için rapor verilerini alma özelliğini de desteklemektedir.
-
Grup oluşturma ve yönetme
Bu güncellemeyle grup oluşturma ve yönetmeyle ilgili
group
vegroupItem
kaynakları kullanıma sunulmuştur.group
kaynağı, bir Analytics grubunu temsil eder. Analytics grubu 200 adede kadar kanal, video, oynatma listesi veya öğeden oluşan bir özel koleksiyondur. API, bu kaynak içinlist
,insert
,update
vedelete
yöntemlerini destekler.groupItem
kaynağı, Analytics grubundaki bir öğeyi temsil eder. API, bu kaynak içinlist
,insert
vedelete
yöntemlerini destekler.
Örneğin,
groups.insert
yöntemini kullanarak bir grup oluşturabilir ve ardındangroupItems.insert
yöntemini kullanarak bu gruba öğeler ekleyebilirsiniz. -
Bir grup için rapor verileri alma
Boyutlar dokümanları, birçok kanal raporu ve içerik sahibi raporu için filtre olarak kullanılabilecek
group
boyutunu içerecek şekilde güncellendi.group
filtresini kullandığınızda API, söz konusu gruptaki tüm öğelerin verilerini döndürür. API'nin şu anda öğe grupları için rapor oluşturma özelliğini desteklemediğini unutmayın.
YouTube Analytics grupları hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.
-
-
API artık
show
boyutunu desteklemiyor. -
API artık
video
,playlist
,channel
veshow
boyutları filtre olarak kullanıldığında bu boyutlar için birden fazla değer belirtme özelliğini destekliyor. Birden fazla değer belirtmek içinfilters
parametre değerini API yanıtının filtrelenmesi gereken video, oynatma listesi, kanal veya program kimliklerinin virgülle ayrılmış listesine ayarlayın. Parametre değeri en fazla 200 kimlik belirtebilir.Aynı filtre için birden çok değer belirtirseniz o filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu, filtre belirli bir rapor için desteklenen boyut olarak listelenmemiş olsa bile geçerlidir. Filtreyi boyutlar listesine eklerseniz API, sonuçları gruplandırmak için filtre değerlerini de kullanır.
Bu işlevle ilgili tüm ayrıntılar için
filters
parametre tanımına bakın. -
Bir kanal raporu alırken, artık
ids
parametresinin değerinichannel==MINE
olarak ayarlayarak kimliği doğrulanmış kullanıcının kanalı için verileri alabilirsiniz. (Belirtilen kanalın verilerini almak içinids
parametresinichannel==CHANNEL_ID
olarak da ayarlayabilirsiniz.) -
API artık bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikleri içeren oynatma listesi raporlarını desteklemektedir. Oynatma listesi raporları, kanallar ve içerik sahipleri tarafından kullanılabilir.
Tüm oynatma listesi raporları
views
veestimatedMinutesWatched
metriklerini, bazıları daaverageViewDuration
metriğini destekler.Buna ek olarak tüm oynatma listesi raporları aşağıdaki yeni metrikleri destekler. Bu metriklerin her birinin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini yansıttığını unutmayın.
playlistStarts
: İzleyicilerin bir oynatma listesini başlatma sayısı.viewsPerPlaylistStart
: Bir oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme sayısıdır.averageTimeInPlaylist
: Oynatma listesi başlatıldıktan sonra izleyicinin oynatma listesindeki videoları izlediği dakika cinsinden tahmini ortalama süredir.
Oynatma listesi raporu alma isteklerinde
isCurated
filtresinin kullanılması gerekir. Bu filtre1
(isCurated==1
) olarak ayarlanmalıdır. -
API artık kitleyi elde tutma raporunu desteklemektedir. Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. Raporun yeni
elapsedVideoTimeRatio
boyutu, ilgili metrik değerleri için geçen video miktarını ölçer:-
audienceWatchRatio
metriği, videonun belirli bir noktasında videoyu izleyen izleyicilerin mutlak oranını belirtir. Bu oran, videonun bir bölümünün izlenme sayısının toplam görüntülenme sayısıyla karşılaştırılmasıyla hesaplanır.Belirli bir video görüntülemesinde videonun bir bölümünün birden fazla kez izlenebileceğini (veya hiç izlenmeyeceğini) unutmayın. Örneğin, kullanıcılar bir videoyu geri sarıp videonun aynı bölümünü birden çok kez izlerse videonun bu bölümünün mutlak oranı,
1
değerinden daha büyük olabilir. -
relativeRetentionPerformance
metriği, videonun oynatmalar sırasında benzer uzunluktaki tüm YouTube videolarına kıyasla izleyicileri elde tutmada ne kadar başarılı olduğunu gösterir. 0 değeri, videonun benzer uzunluktaki diğer tüm videolardan daha kötü bir şekilde izleyicileri elde tuttuğunu belirtirken 1 değeri, videonun izleyicileri benzer uzunluktaki diğer tüm videolardan daha iyi tuttuğunu ifade eder. Ortanca değer 0,5 ise benzer uzunluktaki videoların yarısının izleyicileri daha iyi tutarken yarısının daha kötü izleyicileri elde tuttuğunu gösterir.
Raporun yalnızca organik görüntülemeler, Yayın içi (In-stream) TrueView reklamlarındaki görüntülemeler veya Görüntülü (In-display) TrueView reklamlarındaki görüntülemelerle ilişkili verileri döndürmesi için
audienceType
filtresini de kullanabilirsiniz. (Organik görüntülemeler, video araması veya önerilen bir videonun tıklanması gibi kullanıcı işlemlerinin doğrudan sonucudur.) -
-
API, ek açıklamalarla ilgili birtakım yeni metrikleri destekler. Aşağıda listelenen metrikler, daha önce
annotationClickThroughRate
veannotationCloseRate
metriklerini destekleyen tüm raporlarla alınabilir.annotationImpressions
: Ek açıklama gösterimlerinin toplam sayısı.annotationClickableImpressions
: Gösterilen ve tıklanabilen ek açıklamaların sayısı.annotationClosableImpressions
: Gösterilen ve kapatılmış olabilecek ek açıklamaların sayısı.annotationClicks
: Tıklanan ek açıklamaların toplam sayısı.annotationCloses
: Kapatılan ek açıklamaların toplam sayısı.
Yeni metriklerin tümü temel metrikler olup Kullanımdan Kaldırma Politikası'na tabidir. Ancak, yeni metrikler için 16 Temmuz 2013 tarihinden itibaren kullanılabilir verilerin bulunduğunu unutmayın. (
annotationClickThroughRate
veannotationCloseRate
metriklerine ilişkin veriler 10 Haziran 2012 tarihinden itibaren mevcuttur.) -
GOOGLE_SEARCH
artıkinsightTrafficSourceType
boyutu için ayrı bir değer olarak raporlanmamaktadır. Bunun yerine, Google arama sonuçlarından gelen yönlendirmeler artıkEXT_URL
trafik kaynağı türüyle ilişkilendiriliyor. Bu nedenle,insightTrafficSourceType
filtresiniGOOGLE_SEARCH
olarak ayarlayan birinsightTrafficSourceDetail
raporu alınması da artık mümkün değildir. -
İçerik sahibi raporları dokümanı, içerik sahibi tarafından hak talebinde bulunulan veya yüklenen içerikler için
subscribersGained
vesubscribersLost
metriklerinin alınabileceğini yansıtacak şekilde güncellendi.Değişiklik, artık
claimedStatus
veuploaderType
filtrelerini destekleyen içerik sahipleri için ilk temel istatistikler raporunda görünür. -
Örnek istekler dokümanı, kanal ve içerik sahibi raporları için yakın zamanda kullanıma sunulana benzer bir sekme biçimi kullanılarak, örnekleri kategoriler halinde gruplandıracak şekilde yeniden tasarlandı. Yeni tasarımda, örnekler aşağıdaki kategorilere göre gruplandırılır:
- Temel istatistikler
- Zamana dayalı
- Coğrafi
- Oynatma konumu
- Trafik kaynağı
- Cihaz/İşletim Sistemi
- Demografik grup
- Sosyal
- Kazançlar/Reklamlar (yalnızca içerik sahibi raporları için)
-
Örnek talepler belgesi, artık kanal raporlarında veya içerik sahibi raporlarında bölgeye özel verilerin alınmasına ilişkin yeni örnekler içeriyor.
-
ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler: Bu rapor, kanal videolarına ilişkin görüntüleme sayılarının ve diğer istatistiklerin eyalet bazında dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.yi kapsar. Örnekte
province
boyutu ve ayrıca, yanıtı yalnızca ABD ile ilgili sonuçları içerecek şekilde kısıtlamak içinfilters
parametresi kullanılır. -
Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet): Bu rapor, bir kanalın videolarını izleyen Kaliforniya'daki izleyicilerin yaş grubu ve cinsiyetiyle veya içerik sahibinin raporlarında içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili istatistikleri alır. Bu örnekte, yanıtın yalnızca belirli bir ille ilgili verileri içermesi için
filters
parametresi kullanılmıştır.
-
-
province
boyutunun tanımı,dimensions
parametre değerineprovince
eklendiğinde, isteğinfilters
parametre değerinecountry==US
eklenerek verilerin ABD ile kısıtlanması gerektiğini de belirtecek şekilde güncellendi. -
Desteklenen kanal ve içerik sahibi raporlarını listeleyen dokümanlar yeniden tasarlandı. Her doküman, tüm olası raporları listeleyen bir tablo sağlamak yerine, raporları kategoriler halinde gruplandırır:
- Temel istatistikler
- Zamana dayalı
- Coğrafi
- Oynatma konumu
- Trafik kaynağı
- Cihaz/İşletim Sistemi
- Demografik grup
- Sosyal
- En popüler videolar
Her dokümanda bu kategoriler bir sekme listesi olarak görüntülenir ve herhangi bir sekmeyi tıklayarak o kategoride desteklenen raporları görebilirsiniz.
-
API artık üç yeni coğrafi boyutu destekliyor:
province
,continent
vesubContinent
.-
province
boyutu, ABD eyaletleri ve District of Columbia ile ilgili istatistikleri almanızı sağlar. API, bu boyutun iki kullanımını destekler:-
API, istatistikleri duruma göre ayıran iki raporu destekler. Her iki rapor da kanallar ve içerik sahipleri tarafından kullanılabilir.
- Temel istatistik raporu, görüntüleme sayısı ve tahmini izlenen dakika sayısı gibi çeşitli istatistikler sağlar.
- Zamana dayalı rapor aynı istatistikleri sağlar, ancak verileri günlük, 7 günlük, 30 günlük veya aylık olarak toplar.
-
Bir raporu yalnızca belirli bir duruma ait istatistikleri içerecek şekilde sınırlamak için
filters
sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografik raporlar ve en çok görüntülenen video raporları dahil olmak üzere çeşitli raporlar bu filtreleme türünü destekler.
-
-
continent
boyutu, bir kıtayı tanımlayan Birleşmiş Milletler (BM) istatistiksel bölge kodunu belirtir. Bu boyut yalnızca filtre olarak kullanılabilir. -
subContinent
boyutu, bir kıtanın alt bölgesini tanımlayan Birleşmiş Milletler (BM) istatistiksel bölge kodunu belirtir. Bu boyut yalnızca filtre olarak kullanılabilir.Her alt bölge yalnızca bir kıtayla ilişkili olduğundan,
subContinent
filtresini kullanırkencontinent
filtresini de kullanmanız gerekmez. (Aslında, bir istek her iki boyutu da kullanıyorsa API bir hata döndürür.)
-
-
Dokümanlar düzeltildi. Böylece,
insightTrafficSourceDetail
boyutu geçerli filtre değeri olarakinsightTrafficSourceType
PROMOTED
değerini içermeyecek. -
YouTube Analytics API artık Hizmet Şartları'nda açıklanan Kullanımdan Kaldırma Politikası'na tabidir. Ancak API'nin temel olmayan boyutları ve temel olmayan metrikleri, Kullanımdan Kaldırma Politikası'na tabi değildir. Boyutlar ve metrics sayfaları, temel boyutları ve temel metrikleri listeleyecek şekilde güncellendi. Ayrıca bu sayfalardaki tanımlar, temel boyutları ve metrikleri açıkça tanımlayacak şekilde güncellendi.
-
API artık
insightPlaybackLocationType
boyutu için değer olarakEXTERNAL_APP
değerini desteklemektedir. Bu güncellemeyle birlikte 10 Eylül 2013 itibarıyla oynatmalar artıkMOBILE
oynatma olarak kategorize edilmeyecektir. Bununla birlikte, bu tarihten önce gerçekleşen mobil oynatmalar bu değerle sınıflandırılmaya devam edecektir.Bu güncellemeyle birlikte mobil oynatmalar, oynatmaların gerçekleştiği uygulamanın türüne bağlı olarak artık
WATCH
,EMBEDDED
veyaEXTERNAL_APP
olarak sınıflandırılıyor. -
API artık
insightTrafficSourceType
boyutu için değer olarakPLAYLIST
değerini desteklemektedir. Değer, video görüntülemelerinin bir oynatma listesinden yönlendirildiğini gösterir. Daha önce bu görüntülemeler boyutunYT_OTHER_PAGE
kategorisi kullanılarak sınıflandırılırdı. -
API artık raporları birden fazla boyut ve metriğe göre sıralama özelliğini desteklemektedir. Örnek istekler dokümanı, bu işlevin gösterildiği İstekleri birden fazla boyuta/metriğe göre sıralama adlı yeni bir örnek içeriyor. İstek, trafik kaynağı verilerini alır ve
sort
parametre değeriday,-views
olur. Sonuçlar kronolojik olarak sıralanır ancak her güne ait sonuç kümesinde, ilk satırda en çok görüntüleme sağlayan trafik kaynağına ilişkin veriler, ikinci satırda ise bir sonraki en yüksek görüntüleme sayısına sahip olan kaynağa ait veriler yer alır ve bu böyle devam eder. -
API artık iki yeni boyutu destekliyor:
deviceType
veoperatingSystem
. Bu boyutlar, izleyicilerin videolarınızı izlediği cihazlarla ilgili verileri almak için kullanılabilir. API, boyutlardan birinin veya her ikisinin kullanıldığı raporları destekler.-
deviceType
raporu; masaüstü, mobil ve tablet cihazlar dahil olmak üzere farklı cihaz türleri için görüntüleme sayılarını ve tahmini izlenme süresini görmenize olanak tanır. Cihaz türü raporunu yalnızca Android veya iOS gibi belirli bir işletim sistemini çalıştıran cihazlara ilişkin istatistikleri içerecek şekilde sınırlandırmak içinoperatingSystem
filtresini de kullanabilirsiniz. -
operatingSystem
raporu; Android, iOS, Linux gibi farklı işletim sistemleri için görüntüleme sayılarını ve tahmini izlenme sürelerini almanızı sağlar. İşletim sistemi raporunu yalnızca mobil cihazlar veya tabletler gibi belirli bir cihaz türüne ilişkin istatistikleri içerecek şekilde sınırlamak içindeviceType
filtresini de kullanabilirsiniz.
Yeni cihaz türü ve işletim sistemi raporları, kanallar ve içerik sahipleri tarafından kullanılabilir.
-
-
Örnek istekler dokümanı, kanallar için üç cihaz raporu ve içerik sahipleri için üç cihaz raporu içerecek şekilde güncellendi.
-
insightPlaybackLocationType
boyutu,YT_OTHER
değerini döndürebilir. Bu değer, bu boyuttaki diğer değerlerden biri kullanılarak sınıflandırılmayan görünümleri tanımlar. -
İçerik sahibi raporları dokümanı, en çok kazanç sağlayan videoları belirlemek için en başarılı videolar raporunu azalan düzende sıralayabileceğinizi belirtecek şekilde güncellendi. Bu rapor, Kullanıcı etkinliği ve kazanç raporları bölümünün ikinci tablosunda listelenen ilk rapordur.
-
YouTube artık deneysel API özelliklerini ve hizmetlerini tanımlamamaktadır. Bunun yerine, artık kullanımdan kaldırma politikasına tabi olan YouTube API'lerinin bir listesini sunuyoruz.
-
API artık görüntüleme metrikleri, etkileşim metrikleri, kazanç metrikleri ve reklam performansı metrikleri gibi diğer metriklerle birlikte izlenme süresi metriklerini (
estimatedMinutesWatched
,averageViewDuration
veaverageViewPercentage
) alma özelliğini destekliyor.Mevcut kanal raporlarının ve içerik sahibi raporlarının listesi, bu değişikliği yansıtacak şekilde güncellenmiştir. (İzlenme süresi metrikleri, listelenen diğer raporların bir parçası olarak alınabildiği için listeler artık daha kısadır.)
Örnek API istekleri belgesi de güncellendi.
-
insightPlaybackLocationDetail
veinsightTrafficSourceDetail
boyutlarını kullanan raporlar aşağıdaki şekillerde iyileştirilmiştir:-
Artık isteğe bağlı
country
filtresini destekliyorlar. -
İçerik sahipleri artık bu raporları aşağıdaki yeni
filter
kombinasyonlarından herhangi birini kullanarak alabilir. Tüm bu kombinasyonların isteğe bağlıcountry
filtresini de desteklediğini unutmayın.-
Oynatma konumu ayrıntısı
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
Trafik kaynağı ayrıntıları
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
Yeni Örnek API istekleri belgesinde, YouTube Analytics API kullanılarak çeşitli rapor türlerinin nasıl alınacağını gösteren örnekler yer almaktadır. Her örnek, isteğin aldığı raporun kısa bir açıklamasını içerir ve ardından isteğe ilişkin boyutları, metrikleri, filtreleri ve sıralama parametrelerini gösterir.
-
insightTrafficSourceType
boyutu, artık geçerli değer olarakSUBSCRIBER
değerini desteklemektedir. Bu değer, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden gelen video görüntüleme sayısını belirtir. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı, ana sayfa feed'ini veya görüntülemelerin yönlendirildiği diğer sayfayı belirtir. -
API artık iki yeni metriği destekliyor:
annotationClickThroughRate
veannotationCloseRate
. Bu metrikler, izleyicilerin videolarınız sırasında gösterilen ek açıklamalarla kurduğu etkileşimlere dayanıyor. Hem kanal raporları hem de içerik sahibi raporları listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellenmiştir.annotationClickThroughRate
: İzleyicilerin tıkladığı ek açıklamaların toplam tıklanabilir ek açıklama gösterimi sayısına oranı.annotationCloseRate
: Görüntüleyenlerin kapattığı ek açıklamaların toplam ek açıklama gösterimi sayısına oranı.
-
API artık kazanç ve reklam performansı metriklerinin yanı sıra yeni reklam performansı raporlarını da destekliyor. Metriklere ve raporlara yalnızca YouTube İş Ortağı Programı'na katılan YouTube içerik iş ortakları erişebilir.
-
Yeni desteklenen raporlar, oynatmaya dayalı reklam performansı metriklerini ve gösterime dayalı reklam performansı metriklerini destekler. Reklam performans raporları hakkında daha fazla bilgi için içerik sahibi raporları dokümanlarına bakın.
-
Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporlarının listesi, bu metrikleri destekleyen iki yeni rapor da dahil olmak üzere raporları tanımlayacak şekilde güncellendi.
earnings
– Google tarafından satılan tüm reklam kaynaklarından elde edilen toplam tahmini kazançlar.grossRevenue
– Google veya DoubleClick iş ortaklarından elde edilen tahmini brüt gelir.primaryAdGrossRevenue
- Google veya DoubleClick iş ortaklarından gelen, raporun kapsadığı video oynatmaları için birincil reklam türü altında toplanıp sınıflandırılan tahmini brüt gelir.monetizedPlaybacks
: En az bir reklam gösteriminin gösterildiği oynatmaların sayısıdır.playbackBasedCpm
– Bin oynatma başına tahmini brüt gelir.impressions
- Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.impressionBasedCpm
– Bin reklam gösterimi başına tahmini brüt gelir.
Not: Tüm ayrıntılar için metrik tanımlarını inceleyin.
-
Kazançları veya reklam performansı metriklerini alan tüm istekler, yeni
https://www.googleapis.com/auth/yt-analytics-monetary.readonly
kapsamını kullanarak erişim izni veren bir yetkilendirme jetonu göndermelidir.
-
-
API belgeleri, farklı rapor türlerinin ayrı sayfalarda açıklanacağı şekilde yeniden düzenlendi. Bu nedenle, artık farklı kanal raporu ve içerik sahibi raporu türlerini açıklayan ayrı sayfalar bulunuyor.
-
API'nin referans kılavuzunda artık bir examples bölümü var. Bu bölümde Java, JavaScript, Python ve Ruby istemci kitaplıklarını kullanarak API'nin nasıl çağrılacağını gösteren kod örnekleri yer alıyor. JavaScript kod örneği, örnek uygulama dokümanlarında ayrıntılı olarak açıklanan örnekle aynıdır.
-
API referans kılavuzunda artık API'yi çağırmanızı, API isteğini görmenizi ve yanıtta gerçek verileri almanızı sağlayan APIs Explorer bulunuyor.
-
Bu API, hem kanallar hem de içerik sahipleri için aşağıda açıklanan bir dizi yeni raporu desteklemektedir. Her rapor, kanal raporu veya içerik sahibi raporu olarak sunulur. Boyutlar ve metrics sayfaları da uygun şekilde güncellendi.
-
Oynatma konumu raporu, farklı türlerdeki sayfalarda veya uygulamalarda gerçekleşen video görüntülemelerinin sayısını belirtir.
-
Oynatma konumu ayrıntı raporu, belirli bir video için en çok görüntülemeyi oluşturan yerleşik oynatıcıları tanımlar. En iyi yerleştirilmiş oynatıcılarla ilişkili URL'leri belirleyerek oynatma konumu raporuna göre daha ayrıntılı bir görünüm sunar.
-
Trafik kaynağı raporu, farklı yönlendiren türlerinden kaynaklanan video görüntülemelerinin sayısını tanımlar.
-
Trafik kaynağı ayrıntı raporu, belirtilen bir video ve belirtilen trafik kaynağı türü için en çok görüntülemeyi oluşturan yönlendirenleri tanımlar. Örneğin bu rapor, belirli bir videoya en çok trafik gönderen ilgili videoları gösterir. Bu rapor çeşitli trafik kaynakları için desteklenir.
-
İzlenme süresi raporları, izleyicilerin içeriklerinizi izlerken geçirdiği süreyi gösterir. Raporlar, belirli bir zaman dilimi (gün, önceki yedi gün, önceki 30 gün vb.) veya ülke için verileri birleştirebilir. Bir rapor, verileri güne veya ülkeye göre topluyorsa, her video görüntülemesinin ortalama uzunluğunun yanı sıra, her videonun kullanıcıların izlediği ortalama yüzdesini de belirtebilir.
-
-
YouTube Analytics API artık tüm geliştiricilerin kullanımına sunulmuştur. Önceden erişim isteğinde bulunmak zorunda kalmadan, APIs console üzerindeki Hizmetler panelinden projeniz için API'yi etkinleştirebilirsiniz.
-
Yeni Başlarken bölümü, YouTube Analytics API kullanan bir uygulama oluşturmaya ilişkin ön koşulları ve temel adımları özetler.
-
Yeni kota kullanımını anlama bölümü, API kota kullanımınızı optimize etmeye ilişkin yönergeler sağlar. API sunucusu, her istek için bir sorgu maliyeti hesaplar ve bu maliyet, API kullanım kotanızdan düşülür. Farklı rapor türleri çok farklı sorgu maliyetlerine sahip olabileceğinden kotanızı verimli bir şekilde kullanmayı planlamalısınız. Uygulamanız yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemelidir.
-
Geçici boyutlar bölümü, bu boyutların, Analytics raporunun verileri belirli bir döneme göre toplaması gerektiğini belirttiğini açıklayacak şekilde güncellenmiştir. API artık aşağıdaki ek zamansal boyutları desteklemektedir:
7DayTotals
– Rapordaki veriler, her satırda yedi günlük bir döneme ait veriler yer alacak şekilde toplanır.30DayTotals
– Rapordaki veriler, her satırda 30 günlük bir döneme ait veriler yer alacak şekilde toplanır.month
- Rapordaki veriler takvim ayına göre toplanır.
Benzer şekilde, kullanılabilir raporlar bölümü de API'nın bu boyutları kullanan raporlara verdiği desteği yansıtacak şekilde güncellenmiştir.
-
Raporlama varlığı boyutları bölümü, içerik sahibi raporlarını almaya yönelik API isteklerinin, verileri bu boyutlardan birini (
video
,channel
veyashow
) ya daclaimedStatus
veuploaderType
boyutlarının desteklenen bir kombinasyonunu kullanarak filtrelemesi gerektiğini bildirmek için güncellendi. -
API artık en çok görüntülenen video raporları için iki yeni sıralama seçeneğini destekliyor. Kanal raporları veya içerik sahibi raporları olarak sunulan bu raporlarda, ülke bazında metrikler (görüntüleme sayısı, yorumlar, beğeniler vb.) yer alır ve bu metrikler videoya göre ayrılır. Artık bu raporları, videonun izleme sayfasından bir kanala abone olan veya kanal aboneliğinden çıkan kullanıcıların sayısına göre sıralayabilirsiniz.
-
subscribersGained
vesubscribersLost
metrics tanımları, bir kanalın video izleme sayfası, kanal sayfası ve YouTube ana sayfasında gösterilen rehber gibi çeşitli yerlerde abone kazanabileceğini veya kaybedebileceğini açıklayacak şekilde güncellendi. Bu metrikler videoya özel bir raporda göründüğünde, yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.
YouTube Reporting API, üç yeni bitiş ekranı raporunun yanı sıra bu raporlar için yeni boyut ve metrikleri de destekler. Raporlar, bir videonun oynatılması durduktan sonra görüntülenen bitiş ekranlarıyla ilgili gösterim ve tıklama istatistikleri sağlar.
YouTube Yardım Merkezi'nden, videolarınıza bitiş ekranı ekleme hakkında daha ayrıntılı bilgi edinebilirsiniz.
8 Kasım 2016
Bu güncelleme, YouTube Analytics API'de yapılan aşağıdaki değişiklikleri içerir:
27 Ekim 2016
YouTube artık YouTube İçerik Stüdyosu'nun Raporlar bölümünde ilgili raporlara erişimi olan içerik sahipleri için otomatik olarak bir dizi sistem tarafından yönetilen reklam geliri raporu oluşturmaktadır. Sistem tarafından yönetilen yeni API raporları, manuel olarak indirilebilir İçerik Stüdyosu raporlarında da bulunan verilere programatik erişim sağlamak için tasarlanmıştır.
Sistem tarafından yönetilen raporlara genel bakış sayfasında, yeni raporlara kısa bir genel bakış sunulur ve raporların API üzerinden alınması süreci açıklanmaktadır. İş ortaklarının raporları oluşturmak için işleri planlaması gerekmediğinden bu süreç, YouTube Analytics için toplu raporların alınmasından biraz farklıdır.
reportType
kaynağının id
özelliği, API aracılığıyla erişebileceğiniz sistem tarafından yönetilen raporların listesini içerecek şekilde güncellendi:
27 Eylül 2016
Not: Bu, kullanımdan kaldırma duyurusudur.
YouTube Analytics API'nin uniques
metriği kullanımdan kaldırıldı. Bu, temel bir metrik değildir ve 31 Ekim 2016 tarihine kadar desteklenecektir.
15 Eylül 2016
Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir:
19 Ağustos 2016
Bu güncelleme, aşağıdaki YouTube Reporting API değişikliğini içerir:
11 Ağustos 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
10 Ağustos 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
18 Temmuz 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
28 Haziran 2016
YouTube Analytics API dokümanları, çok sayıda kanal ve içerik sahibi raporundaki kart metrikleri desteğini yansıtacak şekilde güncellendi. Yeni desteklenen metrikler şunlardır:
Metrikler aşağıdaki rapor türlerinde desteklenir:
22 Haziran 2016
Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir. İlk değişiklik genel olarak API ile ilgilidir, geri kalan değişiklikler yalnızca içerik sahibi raporlarını etkiler:
19 Mayıs 2016
Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir:
12 Nisan 2016
Bu güncelleme, yalnızca YouTube Reporting API'yi etkileyen aşağıdaki değişiklikleri içerir:
28 Mart 2016
YouTube Reporting API ve YouTube Analytics API, artık çeşitli ek paylaşım hizmetleri için görüntüleme istatistiklerini döndürüyor.
16 Mart 2016
Bu güncelleme hem YouTube Reporting API'yi hem de YouTube Analytics API'yi etkileyen aşağıdaki değişiklikleri içerir:
YouTube Reporting API
YouTube Analytics API
8 Şubat 2016
YouTube Analytics API için desteklenen metriklerin listesi, kart metrikleri artık ilgili API'de desteklenen metrikler olarak listelenmeyecek şekilde güncellendi. (Söz konusu API'nin raporlarının hiçbirinin, kart metriklerini desteklediği belgelenmemiştir.)
Kart metriklerini, çok sayıda kanal ve içerik sahibi raporu için destekleyen YouTube Reporting API'yi kullanarak alabileceğinizi unutmayın.
6 Ocak 2016
YouTube Reporting API ve YouTube Analytics API, Chromecast cihazlarda gerçekleşen izlemeleri artık özel olarak tanımlıyor.
21 Aralık 2015
Dokümanlarda annotation_clickable_impressions
ve annotation_closable_impressions
metriklerinin adları, raporlarda döndürülen adlarla eşleşecek şekilde güncellenmiştir. Önceden, adlar clickable_annotation_impressions
ve closable_annotation_impressions
olarak belgeleniyordu.
18 Aralık 2015
Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli açıklamalar yapılmasını ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekmektedir. YouTube API Hizmet Şartlarımıza bu şartla ilgili bir bildirim ekledik.
15 Aralık 2015
Bu güncelleme, YouTube Analytics API'yi etkileyen aşağıdaki değişiklikleri içermektedir:
10 Kasım 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
29 Ekim 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
8 Ekim 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
24 Eylül 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
20 Ağustos 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
22 Temmuz 2015
Bu güncelleme yalnızca içerik sahipleri için geçerli olan birkaç değişiklik içeriyor:
1 Haziran 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
31 Mart 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
16 Mart 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
25 Şubat 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
13 Şubat 2015
Bu güncelleme aşağıdaki değişiklikleri içerir:
28 Ağustos 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
16 Temmuz 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
31 Ocak 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
16 Ocak 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
6 Ocak 2014
Bu güncelleme aşağıdaki değişiklikleri içerir:
30 Eylül 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
16 Temmuz 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
23 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
10 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
6 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
3 Mayıs 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
28 Mart 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
21 Mart 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
4 Şubat 2013
Bu güncelleme aşağıdaki değişiklikleri içerir:
14 Kasım 2012
Bu güncelleme aşağıdaki değişiklikleri içerir:
2 Ekim 2012
Bu güncelleme aşağıdaki değişiklikleri içerir:
12 Eylül 2012
Bu güncelleme aşağıdaki değişiklikleri içerir: