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 (Hedeflenen Sorgular) API'si, kanallar için üç yeni raporu destekler:
-
TPA'ya göre kullanıcı etkinliği rapor, Tanımlanmış Pazar Alanı'na göre kullanıcı etkinliği istatistiklerini sağlayan coğrafi bir rapordur (TPA). Bu rapor için
filters
parametre değerinicountry==US
. -
Aynı anda izleyen kullanıcı sayısı rapor, tek bir canlı yayının farklı bölümleri için eşzamanlı izleyici sayısını gösterir videosunu izleyin.
-
Üye iptalleri raporu, kullanıcıların aboneliklerini neden iptal ettiklerini Kanal üyelikleri.
Bu raporda, yeni
membershipsCancellationSurveyReason
. Kullanıcının kanal üyeliğini neden iptal ettiğini belirten boyut. Ayrıca yenimembershipsCancellationSurveyResponses
. Bu metrik, kaç kanal üyeliğinin bu nedenle iptal edildiğini gösterir.
Ayrıca, Kitle Elde tutma raporu, üç yeni metriği destekleyecek şekilde iyileştirildi:
7 Nisan 2024
YouTube Analytics (Hedeflenen Sorgular) API'sinde içerik sahibiyle ilgili çeşitli güncellemeler vardır oynatma listesi raporları. Güncellemeler, kanal oynatma listesi raporlarıyla ilgili güncellemelerle aynıdır. 19 Ocak 2024'te duyurulacaktır.
Aşağıdaki düzeltme geçmişi girişi,
19 Ocak 2024 tarihli girişle aynı bilgileri girin. Bununla birlikte, içerik sahibinin
oynatma listesi raporları
isCurated
boyuta kadar
31 Aralık 2024 itibarıyla bu boyut, kanal oynatma listesi raporlarında desteklenecek.
30 Haziran 2024.
-
Not: Bu, kullanımdan kaldırma duyurusudur.
isCurated
boyutu, içerik sahibi oynatma listesi raporları için kullanımdan kaldırılmıştır. Artık mümkün olmayacak 31 Aralık 2024'te veya sonrasında desteklenmelidir. Söz konusu boyutun tanımı güncellenmiştir buna göre hazırlar.isCurated
öğesini kaldırdığınızda geriye dönük uyumluluğu korumak için boyutunu almak içinplaylistViews
metriğini almak üzere kodunuzu da güncellemeniz gerekir.views
metriğine karşılık gelir.views
tarihinden beri oynatma listesi raporları için desteklenmeye devam etse de API, farklı bir anlama gelse de metrik adını güncellemezseniz veri döndürmeye devam eder. Tabii ki uygulamanızda değişiklik hemviews
hem deplaylistViews
öğesini almak ve görüntülemek için.isCurated
boyutuna ek olarak, aşağıdaki API işlevleri de yeni raporlarda artık desteklenmiyor:continent
vesubcontinent
gibi konum filtreleri aynı değildir yeni kanal oynatma listesi raporlarında desteklenir.redViews
veestimatedRedMinutesWatched
metrikleri artık kullanılmıyor yeni kanal oynatma listesi raporlarında desteklenir. Bu metrikler YouTube Studio'da kullanılamadığından Bu değişiklik, API işlevini Studio uygulamasında bulunan işlevlerle uyumlu hale getirecek.subscribedStatus
veyoutubeProduct
boyutları artık kullanılmıyor Kanal oynatma listesi raporlarında filtre olarak desteklenir. Bu filtreler şurada kullanılamamaktadır: Bu değişiklik, YouTube Studio'daki API işlevlerini Studio uygulaması.
-
Oynatma listesi raporları bölümü, daha ayrıntılı olarak açıklandığı şekilde güncellendi. oynatma listesi raporları için desteklenen metrik türleri:
- Toplu video metrikleri
Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz:
Bu içerik sahibinin oynatma listeleri de Birleştirilmiş 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şimini yansıtmalıdır. Bu metrikler verilerini dahil edeceği zaman, oynatma listesindeki sahip olunmayan videolardan gelen izlemeleri de içerir. oynatma listesi bağlamında yer verildiğinden emin oluruz.
- Desteklenen oynatma listesi metrikleri bölümü, şu anda izlediğiniz toplu video metriklerini ve oynatma listesi içi oynatma listesi raporları için desteklenir.
- Toplu video metrikleri
Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz:
Bu içerik sahibinin oynatma listeleri de Birleştirilmiş video metrikleri:
yalnızca
-
Aşağıdaki yeni oynatma listesi içi metrikler, şunlar için oynatma listesi raporlarında desteklenmektedir: içerik sahipleri. Bu metriklerin yalnızca API isteği, raporlarda
isCurated
boyutu kullanılmaz. Bkz. metrics belgesi her metriğin tanımı: -
views
cihazının davranışı metriği artık oynatma listesi raporunu alan API isteğininisCurated
boyut:- Bir istek
isCurated
boyutunu içerdiğindeviews
metriği, oynatma listesinde yer alıyor bu video bağlamında görüntüleme sayısını gösteren metrik oynatma listeleri oluşturun. - Bir istek
isCurated
boyutunu içermediğindeviews
metriği, toplam sayıyı belirten birleştirilmiş bir video metriğidir içerik sahibinin oynatma listelerindeki videoların kaç kez izlendiğine bakılmaksızın görüntüleme sayısı oynatma listesi bağlamında gerçekleşti. Toplu toplam yalnızca şu içeriklerin görüntülemelerini içerir: Oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videolar.
isCurated
boyutunun kullanılmadığı bu raporlarda,playlistViews
metriği, videoların görüntülenme sayısını belirtir bir bağlam sunar. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını Video ve YouTube'u kullanabilirsiniz.
- Bir istek
-
Her bir oynatma listesi raporu için içerik sahibi raporları Şuna bağlı olarak, artık ilgili rapor için desteklenen metrikleri gösteren tablolar API isteğinin
isCurated
boyutunu içerip içermediği. Daha ayrıntılı bilgi için zamana dayalı oynatma listesi raporları inceleyebilirsiniz.
19 Ocak 2024
YouTube Analytics (Targeted Sorgular) API'sinde kanal oynatma listesiyle ilgili çeşitli güncellemeler vardır. raporlar. Güncellemeler, kullanımdan kaldırılmış bir boyutun yanı sıra yeni ve güncellenmiş birkaç metrik içeriyor:
-
Not: Bu, kullanımdan kaldırma duyurusudur.
isCurated
boyutun kanal raporları için desteği sonlandırılmıştır. Artık desteklenmeyecek veya (30 Haziran 2024 tarihinden sonra) Bu boyutun tanımı buna göre güncellenmiştir.isCurated
öğesini kaldırdığınızda geriye dönük uyumluluğu korumak için boyutunu almak içinplaylistViews
metriğini almak üzere kodunuzu da güncellemeniz gerekir.views
metriğine karşılık gelir.views
tarihinden beri oynatma listesi raporları için desteklenmeye devam etse de API, farklı bir anlama gelse de metrik adını güncellemezseniz veri döndürmeye devam eder. Tabii ki uygulamanızda değişiklik hemviews
hem deplaylistViews
öğesini almak ve görüntülemek için.isCurated
boyutuna ek olarak, aşağıdaki API işlevleri de yeni raporlarda artık desteklenmiyor:continent
vesubcontinent
gibi konum filtreleri aynı değildir yeni kanal oynatma listesi raporlarında desteklenir.redViews
veestimatedRedMinutesWatched
metrikleri artık kullanılmıyor yeni kanal oynatma listesi raporlarında desteklenir. Bu metrikler YouTube Studio'da kullanılamadığından Bu değişiklik, API işlevini Studio uygulamasında bulunan işlevlerle uyumlu hale getirecek.subscribedStatus
veyoutubeProduct
boyutları artık kullanılmıyor Kanal oynatma listesi raporlarında filtre olarak desteklenir. Bu filtreler şurada kullanılamamaktadır: Bu değişiklik, YouTube Studio'daki API işlevlerini Studio uygulaması.
-
Oynatma listesi raporları bölümü, daha ayrıntılı bir şekilde açıklandığı şekilde güncellendi. oynatma listesi raporları için desteklenen metrik türleri:
- Toplu video metrikleri
Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz:
kanaldaki oynatma listelerinden de
gösterilir. Birleştirilmiş 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şimini yansıtmalıdır. Bu metrikler verilerini dahil edeceği zaman, oynatma listesindeki sahip olunmayan videolardan gelen izlemeleri de içerir. oynatma listesi bağlamında yer verildiğinden emin oluruz.
- Desteklenen oynatma listesi metrikleri bölümü, şu anda izlediğiniz toplu video metriklerini ve oynatma listesi içi oynatma listesi raporları için desteklenir.
- Toplu video metrikleri
Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz:
kanaldaki oynatma listelerinden de
gösterilir. Birleştirilmiş video metrikleri:
yalnızca
-
Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenmektedir. Bu metrikler, içerik sahibi raporları için henüz desteklenmemektedir. Bu metriklerin yalnızca raporları almak için kullanılan API isteği
isCurated
boyutu. Bkz. metrics belgesi her metriğin tanımı: -
views
cihazının davranışı metriği artık oynatma listesi raporunu alan API isteğininisCurated
boyut:- Bir istek
isCurated
boyutunu içerdiğindeviews
metriği, oynatma listesinde yer alıyor bu video bağlamında görüntüleme sayısını gösteren metrik kanal oynatma listeleri oluşturun. - Bir istek
isCurated
boyutunu içermediğindeviews
metriği, toplam sayıyı belirten birleştirilmiş bir video metriğidir Bu videonun izlenme oranından bağımsız olarak, kanalın oynatma listelerindeki videoların görüntülenme sayısı görüntüleme sayısı oynatma listesi bağlamında gerçekleşti. Toplu toplam yalnızca şu içeriklerin görüntülemelerini içerir: Oynatma listesinin sahibi olan kanala ait videolar.
isCurated
boyutunun kullanılmadığı bu raporlarda,playlistViews
metriği, videoların görüntülenme sayısını belirtir bir bağlam sunar. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını Video ve YouTube'u kullanabilirsiniz.
- Bir istek
-
Kanal, her oynatma listesi raporu için Şuna bağlı olarak, artık ilgili rapor için desteklenen metrikleri gösteren tablolar API isteğinin
isCurated
boyutunu içerip içermediği. Daha ayrıntılı bilgi için zamana dayalı oynatma listesi raporları inceleyebilirsiniz.
4 Aralık 2023
YouTube Analytics (Hedeflenen Sorgular) API'si,
insightTrafficSourceType
.
boyut değerleri. Önceden, bir oynatma listesinin parçası olarak oynatılan videolar arasındaki fark
(PLAYLIST
) ve oynatma listesindeki tüm videoların listelendiği bir sayfadan gelen görüntülemeler
(YT_PLAYLIST_PAGE
). Bundan sonra, her iki görüntüleme türü de
PLAYLIST
boyut değeri.
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 sunar. Bu rapor şunlar için kullanılabilir: kanallar ve içerik sahipleri ile bağlantı kurabilir. Bu rapor yeni
city
içeriyor YouTube'un, kullanıcı etkinliğinin gerçekleştiği şehirle ilgili tahminini tanımlayan boyuttur. -
Yeni
creatorContentType
boyut, kullanıcı etkinliğiyle ilişkilendirilmiş YouTube içeriğinin türünü tanımlar kullanabilirsiniz. Desteklenen değerler:LIVE_STREAM
,SHORTS
,STORY
veVIDEO_ON_DEMAND
.creatorContentType
boyutu, tüm reklamverenler için isteğe bağlı bir boyut olarak desteklenir. kanal ve içerik sahibi video raporları -
YouTube Analytics API örnek istekleri kılavuzunda artık her iki yeni boyut için de örnekler bulunmaktadır.
-
7DayTotals
ve30DayTotals
boyutlarına yapılan referanslar belgelerden kaldırılmıştır. Bu boyutların kullanımdan kaldırılacağı Ekim ayında duyurulmuştur 2019.
26 Ağustos 2022
YouTube Analytics (Hedeflenen Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si yeni bir trafik kaynağı ayrıntı değerini destekler:
- YouTube Analytics API (Targeted Sorgular) API'sinde
insightTrafficSourceType
. boyutun değeriSUBSCRIBER
iseinsightTrafficSourceDetail
değeripodcasts
olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfası. - YouTube Reporting (Toplu Raporlar) API'sinde
traffic_source_type
. boyutun değeri3
isetraffic_source_detail
değeripodcasts
olarak ayarlanabilir; bu, trafiğin Podcasts hedef sayfası.
11 Şubat 2022
gender
boyutu için geçerli değerler grubu Ağustos'ta veya sonrasında değişecek
11 Eylül 2022 tarihinde sona erecektir. Bu, API uygulamanızda geriye dönük olarak uyumsuz bir değişiklik olabilir.
Geri
YouTube API Hizmetleri Hizmet Şartları'ndaki Uyumsuz Değişiklikler
altı ay önce duyurulacaktır. Lütfen API uygulamanızı güncelleyin
.
Yapılan değişiklikler spesifik olarak şunlardır:
- YouTube Analytics (Targeted Sorgular) API'sinde
Şu anda
gender
boyut şu iki değeri destekler:female
vemale
. 11 Ağustos 2022 tarihinde veya sonrasında boyut üç değeri destekler:female
,male
veuser_specified
. - YouTube Reporting (Toplu Raporlar) API'sinde
Şu anda
gender
boyut üç değeri destekler:FEMALE
,MALE
veGENDER_OTHER
. 11 Ağustos 2022'de veya sonrasında, desteklenen değerler grubuFEMALE
olarak değişecek.MALE
veUSER_SPECIFIED
.
9 Şubat 2022
İki metrik, hariç tutulacak şekilde güncellendi Şu andan itibaren döngülerdeki klipler trafiği 13 Aralık 2021. Bu değişiklik hem YouTube Analytics (Hedeflenen Sorgular) API'sini hem de YouTube Reporting (Toplu Raporlar) API'si.
- YouTube Analytics (Targeted Sorgular) API'sinde
averageViewDuration
veaverageViewPercentage
Her iki metrik de döngü klipleri hariç tutar elde etti. - YouTube Reporting (Toplu Raporlar) API'sinde
average_view_duration_seconds
veaverage_view_duration_percentage
Her iki metrik de döngü klipleri hariç tutar elde etti.
2 Şubat 2022
Bu YouTube Reporting (Toplu Raporlar) API'si, şu özelliklere sahip yeni bir trafik kaynağı boyut değerini destekler: görüntülemelerin kaynaklandığı yeri Live Redirect'ler:
- YouTube Reporting (Toplu Raporlar) API'sinde
traffic_source_type
. boyutu,28
değerini destekliyor.
Bu trafik kaynağı türü için
traffic_source_detail
.
boyut, izleyicinin yönlendirildiği kanal kimliğini belirtir.
23 Eylül 2020
Bu YouTube Analytics (Hedeflenen Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si İzleyicinin yönlendirdiğini gösteren yeni bir trafik kaynağı boyut değerini destekler YouTube Shorts izleme deneyiminde dikey kaydırma:
- YouTube Analytics API (Targeted Sorgular) API'sinde
insightTrafficSourceType
. boyutu,SHORTS
değerini destekliyor. - YouTube Reporting (Toplu Raporlar) API'sinde
traffic_source_type
. boyutu,24
değerini destekliyor.
Trafik kaynağı ayrıntısı boyutu:
insightTrafficSourceDetail
.
YouTube Analytics API veya
traffic_source_detail
değeri — bu yeni trafik kaynağı türü için doldurulmaz.
20 Temmuz 2020
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sini etkileyen iki değişikliği kapsamaktadır:
- YouTube Analytics raporlamasının maksimum boyutu grubunda 200 olan varlık sayısı 500'e yükselmiştir.
reports.query
yöntemininfilters
parametresi, YouTube Analytics alınırken uygulanması gereken filtrelerin listesini tanımlar dışı verilerdir. Parametre,video
,playlist
, vechannel
filtre 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 (Hedeflenen Sorgular) ile ilgili aşağıdaki değişiklikleri içerir API ve YouTube Reporting (Toplu Raporlar) API'si. Bu değişiklikler hakkında daha fazla bilgiyi YouTube Yardım Merkezi.
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 bildirildi. İçinde
toplu raporlar
bildirimler traffic_source_type=17
olarak bildirildi.
Yeni değerler, daha önce yüklenen videolar ve canlı yayınlarla ilgili bildirimleri böler.
uploaded
olarak raporlandı ve iki kategoriye ayrılır:
uploaded_push
- Görüntülemelerin kaynağı, adresine gönderilen push bildirimleri Video yüklendiğinde abone sayısıuploaded_other
- Push dışı bildirimlerden kaynaklanan görüntülemeler. Örneğin: Video yüklendiğinde abonelere gönderilen e-posta veya gelen kutusu bildirimleri.
Bu değerler, 13.01.2020 (13 Ocak 2020) arasındaki zaman aralığı için döndürülür.
Ayrıca, bu değerlerin bildirimlerin kendisini değil trafiği temsil ettiğini hatırlatmak isteriz.
belirli YouTube görüntülemelerini sağlayan
kaynaklar hakkında bilgi edinin. Örneğin, bir rapor satırında views=3
gösteriliyorsa
traffic_source_type=17
(NOTIFICATION
) ve
traffic_source_detail=uploaded_push
, satır, üç görüntülemenin
izleyicilerin video yüklendiğinde gönderilen push bildirimlerini tıklamasından kaynaklandı.
15 Ekim 2019
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API ile 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 daha sonra,7DayTotals
ya da30DayTotals
boyutunu kullanarak rapor almaya çalışırsanız hata döndürülür.Kullanıcıların,
day
boyutunu kullanarak sorgu yaparak ve 7 ya da 30 günlük dönemlerde verileri toplayarak veya türeterek bu boyutlara ait verilerin bir kısmını yeniden oluşturabileceğini unutmayın. Örneğin:- Yedi günlük dönemdeki görüntüleme sayısı, söz konusu dönemin her günündeki görüntüleme sayısı toplanarak hesaplanabilir.
- Yedi günlük bir dönem için izleyici yüzdesi, videoyu izlerken oturum açan izleyicilerin sayısını elde etmek amacıyla, her gün gerçekleşen görüntüleme sayısı ile ilgili gündeki izleyici Yüzdesi sayısının çarpılmasıyla hesaplanabilir. Ardından, oturum açmış izleyicilerin sayısı tüm dönem için eklenebilir ve söz konusu dönemdeki toplam görüntüleme sayısına bölünür. Böylece tüm dönem için izleyici yüzdesi elde edilir.
- Aynı izleyici, farklı günlerde tekil izleyici 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 izleyici sayısıyla ilgili verileri tahmin etmek için
30DayTotals
boyutu yerinemonth
boyutunu kullanabilirsiniz.month
boyutu takvim aylarını gösterirken30DayTotals
boyutunun belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemler hesapladığını unutmayın.
27 Haziran 2019
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API ile ilgili aşağıdaki değişiklikleri içerir:
-
API'nin 1. sürümü artık tamamen kullanımdan kaldırıldığından, kullanımdan kaldırma bildirimi ve sürüm 2'ye nasıl güncelleme yapılacağını açıklayan geçiş rehberi de dahil olmak üzere dokümanlarda bu sürümle ilgili referanslar kaldırıldı.
1 Kasım 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API ile ilgili aşağıdaki değişiklikleri içerir:
-
API Sürüm 1 artık kullanımdan kaldırıldı. Henüz yapmadıysanız hizmet kesintilerini en aza indirmek için lütfen en kısa sürede API istemcilerinizi API'nin 2. sürümünü kullanacak şekilde güncelleyin. Daha ayrıntılı bilgi için taşıma rehberini inceleyin.
Kullanımdan kaldırma takviminin ilk olarak 26 Nisan 2018'de duyurulduğunu unutmayın.
17 Eylül 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API ile 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, aşağıdaki durumlarda bir raporun verilerinizin tamamını (veya hiçbirini) içermeyebileceği anlamına gelir:
-
Belirli bir dönemde videonun veya kanalın sınırlı trafiği olması
veya
-
değerlerin belirli bir eşiği karşılamayan bir filtre veya boyut (ör. trafik kaynağı veya ülke) seçtiyseniz.
Yeni bölüm, YouTube Analytics raporlarında sınırlı olabilecek veri türleriyle ilgili bir tartışma da içerir.
-
-
Kanal raporları ve içerik sahibi raporları dokümanları,
redViews
veestimatedRedMinutesWatched
metriklerinin artık oynatma konumu, trafik kaynağı ve cihaz türü/işletim sistemi raporlarında desteklenmediğini yansıtacak şekilde güncellendi.
18 Haziran 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde yapılan aşağıdaki değişiklikleri içerir:
- Aşağıdaki yöntemler için kapsam şartları değişti:
reports.query
yöntemine yapılan isteklerinhttps://www.googleapis.com/auth/youtube.readonly
kapsamına erişimi olmalıdır.groupItems.list
yöntemi için yapılan istekler şunlardan birine erişebilmelidir: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, okuma-yazma kapsamı olan bir kapsam kullanırken ikinci seçenek iki salt okunur kapsam kullanır.
23 Mayıs 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde yapılan aşağıdaki değişiklikleri içerir:
- API'ye Genel Bakış, metrikleri ve silinen öğeleri toplama adlı yeni bir bölüm içerir. Bu bölümde, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkilendirilen verileri nasıl ele aldığı açıklanmaktadır.
- API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklar için ek meta verileri almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d arasındaki bölümler) belirtildiği üzere API istemcileri, söz konusu API'de depolanan kaynak meta verilerini 30 gün sonra silmeli veya yenilemelidir.
22 Mayıs 2018
Bu güncelleme, YouTube Reporting (Bulk Reports) API ile ilgili 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 rapor ve raporlama işlerinde geçerlidir.
-
Değişiklikten sonra, dolgu raporları da dahil olmak üzere çoğu API raporu, oluşturuldukları andan itibaren 60 gün süreyle kullanılabilecek. 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 boyunca kullanılabilir durumdaydı. Bu politika değişikliği yürürlüğe girdikten sonra, 30 günden eski geçmiş veri raporlarına da API üzerinden erişilemeyecek. 60 günden eski olan diğer raporlara da artık erişemezsiniz. Bu nedenle dokümanlarda artık, politika değişikliğinden önce oluşturulan raporların 180 güne kadar kullanılabileceği belirtiliyor.
-
Değişiklikten sonra, bir raporlama işi planladığınızda YouTube, o günden itibaren işin planlandığı zamandan ö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 belirlenen kaynaklar için ek meta verileri almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d arasındaki bölümler) belirtildiği üzere API istemcileri, söz konusu API'de depolanan kaynak meta verilerini 30 gün sonra silmeli veya yenilemelidir.
-
Rapor özellikleri bölümü, rapor verileri filtrelenmese de 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 silinmiş YouTube kaynaklarına referans vermeyeceğ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ılabilmesinin 30 güne kadar sürebileceğini belirtiliyordu.
-
API'ye genel bakışın dolgu verileri bölümü, dolgu verilerini daha önce yayınlanan bir kümenin yerini alan bir veri kümesi olarak daha net bir şekilde tanımlayacak şekilde güncellendi.
26 Nisan 2018
YouTube Analytics (Targeted Sorgular) API'sinin (v2) 2. sürümü artık herkesin kullanımına açıktır. Aşağıdaki liste, yeni API sürümüyle ilgili ürün ve belge değişikliklerini tanımlar:
-
v2 API, v1 API ile neredeyse aynıdır. Ancak, aşağıda listelenen değişiklikleri yansıtmak için büyük olasılıkla kodunuzu güncellemeniz gerekecektir. Bu değişikliklerin tümü yeni taşıma rehberinde ayrıntılı olarak açıklanmaktadır.
- API'nin
v1
olan sürümüv2
olarak değişti. - API istekleri için temel URL
https://www.googleapis.com/youtube/analytics/v1
ikenhttps://youtubeanalytics.googleapis.com/v2
olarak değiştirildi. reports.query
yöntemine ilişkin bazı parametrelerin adları güncellendi. Özellikle, v1 API'sindeend-date
gibi kısa çizgi içeren parametre adlarında v2 API'de kısa çizgi (endDate
) yerine büyük/küçük harf kullanılır. API'nin grup oluşturma ve yönetme yöntemleri parametre adları için zaten büyük/küçük harf kullanımı kullandığından bu değişiklik, API genelinde parametre adlarını tutarlı hale getirir.- v2 API, Google'ın global HTTP toplu uç noktasına (
www.googleapis.com/batch
) gönderilen toplu istekleri desteklemez. Toplu istekleri v2 API'de gönderiyorsanız bunun yerinehttps://youtubeanalytics.googleapis.com/v2
uç noktasını kullanmanız gerekir.
Ayrıca bazı v1 özellikleri v2 API'de desteklenmez:
reports.query
yöntemi artıkalt
,quotaUser
veuserIp
istek parametrelerini desteklememektedir.- v2 API, farklı API'lere yapılan isteklerden oluşan grupları destekleyen bir toplu uç nokta sağlamaz. (Ancak bir grup, aynı API'nin farklı yöntemlerine yapılan isteklerden oluşabilir.) Google, global toplu uç noktasını tüm API'lerinde kullanımdan kaldırdığı için bu kullanımdan kaldırma süreci YouTube Analytics API'ye özel değildir.
- v2 API, API v1'de desteklenen JSON-RPC protokolünü desteklemiyor. Bu desteğin sonlandırılmasının YouTube Analytics API'ye özel olmadığını tekrar hatırlatmak isteriz.
- API'nin
-
Not: Bu, kullanımdan kaldırma duyurusudur.
API'nin 1. sürümü (v1) artık kullanımdan kaldırıldı ve 31 Ekim 2018'e kadar desteklenecek. v1 API'ye yapılan tüm istekler bu tarihten sonra çalışmayı durduracak. Bu nedenle, YouTube Analytics verilerine API aracılığıyla erişiminizin kesintiye uğramaması için en geç 31 Ekim 2018 tarihine kadar v2 API'ye geçmeyi unutmayın.
21 Şubat 2018
Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'de yapılan aşağıdaki değişiklikleri içerir:
- Görüntüleme istatistiklerini görüntüleyen demografi verilerini temel alan, izleyici demografi raporları yaş grubu ve cinsiyet, kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlayan
youtubeProduct
boyutunu artık 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 şu 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çerir:
-
API sunucusu artık rapor indiren istekler için gzip sıkıştırmasını desteklemektedir. gzip sıkıştırmanın diğer API isteği türleri için desteklenmediğini unutmayın. gzip sıkıştırmasının etkinleştirilmesi, her bir 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 süresine ihtiyacı olacak olsa da daha az ağ kaynağı tüketmenin avantajı, genellikle bu maliyetten daha ağır basar.
gzip kodlu 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'ye genel bakış ve
report
kaynağınındownloadUrl
özelliğinin tanımında açıklanmaktadır. -
age group
vegender
boyutlarıyla ilgili belgeler, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bu düzeltmenin belgelerle ilgili olduğunu ve API işlevlerinde veya davranışında herhangi bir değişiklik olmadığını hatırlatmak isteriz. Özellikle aşağıdaki değerler değişti:age_group
boyutu için belirtilen değerler büyük harf,AGE
kelimesi ile yaş grubundaki sayılar arasında alt çizgi ve kısa çizgi yerine alt çizgi kullanır. 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üzeltilmiştir.
10 Ağustos 2017
Bu belge, 10 Ağustos 2016'da YouTube Analytics API'nin earnings
metriğinin kullanımdan kaldırıldığını duyurdu. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue
adlı yeni bir metrik için destek eklemiştir.)
earnings
metriği temel metrik olduğundan, duyurunun yapıldığı tarihten itibaren bir yıl boyunca destekleniyordu. Ancak bu yıllık dönem sona erdiğinden earnings
metriği artık desteklenmiyor. 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 bu işlemi en kısa sürede yapın.
API dokümanları, earnings
metriğine yönelik 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 belgeleri, API yanıtlarının, istenen tarih aralığında sorgulanan tüm metriklerin kullanılabilir olduğu son güne kadar olan verileri içerdiğini yansıtacak şekilde güncellendi.
Örneğin, bir istekte bitiş tarihi 5 Temmuz 2017 ise ve istenen tüm metriklerin değerleri yalnızca 3 Temmuz 2017'ye kadar kullanılabilirse bu, verilerin yanıta dahil edileceği son tarih olur. (İstenen metriklerin bazılarına ait veriler 4 Temmuz 2017'de mevcut olsa bile bu durum geçerlidir.)
-
adType
boyutu artıkreservedBumperInstream
değerini destekliyor. Bu değer, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamı ifade eder. Reklam biçimiauctionBumperInstream
reklamı ile aynı olsa da bu tür, açık artırma yerine ayrılmış olarak satılan reklamları ifade eder.
-
-
YouTube Reporting API (Toplu Raporlar)
-
ad_type
boyutu artık, ayrılmış olarak satılan bumper reklamları ifade eden20
değerini destekliyor. Bumper reklamlar, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamlardır. Bu boyut için19
değerinin, ayrılmış bir şekilde değil, açık artırma yöntemiyle satılan bumper reklamları ifade ettiğini unutmayın. -
Aşağıdaki YouTube Reporting API raporları için 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 15 Eylül 2016'da kullanımdan kaldırılacağı duyuruldu ve 15 Aralık 2016'dan sonra bu rapor türleri için artık rapor oluşturulmadı. Önceden oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılmaya devam ediyordu. Bu sayede, bazı raporlara 15 Haziran 2017 gibi geç bir tarihte erişebiliyordu. 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 22 Haziran 2016'da kullanımdan kaldırılacağı duyuruldu ve 22 Eylül 2016'dan sonra bu rapor türleri için artık rapor oluşturulmadı. Önceden oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılmaya devam ediyordu. Bu sayede, bazı raporlara 22 Mart 2017 gibi geç bir tarihte erişebiliyordu. 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 destekliyor:85
: YouTube Music86
: YouTube Oyun87
: YouTube Çocuk88
: YouTube TV
Ayrıca,
52
değerini tanımlamak için kullanılan ad,73
değerinden (Kakao Story) daha net bir şekilde ayırt edilebilmesi için dokümanlarda Kakao (Kakao Talk) olarak güncellendi. Bu değişiklikle birlikte, bu hizmetlerle paylaşılan videoların API davranışı veya sınıflandırmasında herhangi bir değişiklik yapılmamıştır.
- Videoları paylaşmak için kullanılan hizmeti tanımlayan
-
YouTube Analytics API (Hedeflenen Sorgular)
sharingService
boyutu artık aşağıdaki değerleri destekliyor: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
boyutunun yanı sıra isteğe bağlıday
boyutunu da destekleyen bir reklam performans raporu alabilir. -
YouTube Analytics API örnek istekler kılavuzunda 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
redViews
veestimatedRedMinutesWatched
metriklerini destekler. Hatta bu API bir süredir bu metrikleri destekliyordu. YouTube Reporting API, 15 Eylül 2016'da duyurulduğu gibi her iki metriği de desteklemektedir.redViews
metriği, bir videonun YouTube Red üyeleri tarafından kaç kez görüntülendiğini tanımlar.estimatedRedMinutesWatched
metriği, YouTube Red üyelerinin bir videoyu kaç dakika izlediğine dair metriği belirler.
Kanal raporları ve içerik sahibi raporları dokümanları, hangi raporların iki yeni metriği desteklediğini gösterecek şekilde güncellendi. Bunlar,
views
veestimatedMinutesWatched
metriklerini zaten 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 Pasifik saati ile 00:00'da başlayıp 23:59'da sona eren süreyi ifade edecek şekilde düzeltildi. Belirtilen gün, ay ve yılda Pasifik saati. 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 doğru ayarlandığı tarihler 23 saatlik, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik zaman dilimini temsil eder. (Daha önce, dokümanlarda her tarihin 24 saatlik benzersiz 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 boyunca kullanılabilir durumdaydı. Bu sayede, bazı raporlara 19 Şubat 2017 gibi geç bir tarihte erişebiliyordu. 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 Pasifik saati ile 00:00'da başlayıp 23:59'da sona eren süreyi ifade edecek şekilde düzeltildi. Belirtilen gün, ay ve yılda Pasifik saati. 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 doğru ayarlandığı tarihler 23 saatlik, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik zaman dilimini temsil eder. (Daha önce, dokümanlarda Pasifik saatinin UTC-8 olduğu belirtiliyordu ve bir günün 24 saatlik bir süreyi temsil etmeme olasılığı belirtilmiyordu.)
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ı metrikleri 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ınırken kullanılabilir olduğunu unutmayın.
Bu parametre, içerik sahibinin bir API yanıtının kanalları içermesi gerektiğini belirtmesine olanak tanır: Kanalların içerik sahibine bağlanmasından önceki döneme ait izlenme süresi ve görüntüleme verileri. Varsayılan parametre değeri false
şeklindedir. Bu, API yanıtının varsayılan olarak yalnızca kanalların içerik sahibine bağlandıkları andan itibaren izlenme süresi ve görüntüleme verilerini içerdiği anlamına gelir.
Bu kurallar, API isteği birden çok kanala ait verileri aldığında da geçerli olur:
- Parametre değeri
false
ise belirli bir kanal için döndürülen izlenme süresi ve görüntüleme sayısı verileri, kanalın içerik sahibine bağlandığı tarihe dayanır.
Bir içerik sahibine farklı tarihlerde farklı kanallar bağlanmış olabilir. API isteği birden fazla kanal için veri alıyorsa ve parametre değerifalse
ise API yanıtı, ilgili her kanalın bağlanma 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ın 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 belgelerden 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'da yapılmıştır.)
-
Kanal raporları
channel_basic_a1
-channel_basic_a2
raporuyla değiştirilir.channel_province_a1
-channel_province_a2
raporuyla değiştirilir.channel_playback_location_a1
-channel_playback_location_a2
raporuyla değiştirilir.channel_traffic_source_a1
-channel_traffic_source_a2
raporuyla değiştirilir.channel_device_os_a1
-channel_device_os_a2
raporuyla değiştirilir.channel_subtitles_a1
-channel_subtitles_a2
raporuyla değiştirilir.channel_combined_a1
-channel_combined_a2
raporuyla değiştirilir.
-
İçerik sahibi raporları
content_owner_basic_a2
-content_owner_basic_a3
raporuyla değiştirilir.content_owner_province_a1
-content_owner_province_a2
raporuyla değiştirilir.content_owner_playback_location_a1
-content_owner_playback_location_a2
raporuyla değiştirilir.content_owner_traffic_source_a1
-content_owner_traffic_source_a2
raporuyla değiştirilir.content_owner_device_os_a1
-content_owner_device_os_a2
raporuyla değiştirilir.content_owner_subtitles_a1
-content_owner_subtitles_a2
raporuyla değiştirilir.content_owner_combined_a1
-content_owner_combined_a2
raporuyla değiştirilir.content_owner_asset_basic_a1
-content_owner_asset_basic_a2
raporuyla değiştirilir.content_owner_asset_province_a1
-content_owner_asset_province_a2
raporuyla değiştirilir.content_owner_asset_playback_location_a1
-content_owner_asset_playback_location_a2
raporuyla değiştirilir.content_owner_asset_traffic_source_a1
-content_owner_asset_traffic_source_a2
raporuyla değiştirilir.content_owner_asset_device_os_a1
-content_owner_asset_device_os_a2
raporuyla değiştirilir.content_owner_asset_combined_a1
-content_owner_asset_combined_a2
raporuyla değiştirilir.
API referans belgelerindeki geçerli rapor türleri listesi de güncellendi.
11 Kasım 2016
Bu güncelleme aşağıdaki değişiklikleri içerir:
-
Bitiş ekranı raporları
- Kanal videoları ile ilgili bitiş ekranı raporu, kanaldaki tüm videoların istatistiklerini içerir.
- İçerik sahibi videolarına ilişkin bitiş ekranı raporu, içerik sahibinin kanallarındaki videolara ilişkin istatistikleri içerir.
- İçerik sahibi öğeleriyle ilgili bitiş ekranı raporu, bitiş ekranlarının görüntülendiği videolarla ilişkili öğelere ait istatistikleri içerir.
-
Bitiş ekranı boyutları
end_screen_element_type
: İstatistiklerle ilişkili 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 itibarıyla 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ı öğeleri için 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ştirilir.content_owner_estimated_earnings_a1
-content_owner_estimated_revenue_a1
raporuyla değiştirilir.content_owner_asset_estimated_earnings_a1
-content_owner_asset_estimated_revenue_a1
raporuyla değiştirilir.
-
Aşağıdaki listede bulunan metrikler kullanımdan kaldırılmıştır ve artık desteklenmemektedir. 10 Ağustos 2016'da duyurulduğu gibi, aynı verileri referans alan yeni metrikler zaten desteklenmektedir. Aşağıdaki tabloda, desteği sonlandırılmış metrik adı ve yeni metrik adı gösterilmektedir:
Kullanımdan kaldırılan metrik Yeni metrik adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- Video başına aylık dünya genelindeki reklam geliri
- Video başına ülke başına günlük reklam geliri
- Öğe başına aylık, dünya genelindeki 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 destekler:
red_views
: Bir videonun YouTube Red üyeleri tarafından görüntülenme sayısıdır.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ıdır. (Bu raporların eski sürümleri, bu düzeltme geçmişinin ilerleyen bölümlerinde açıklandığı gibi artık kullanımdan kaldırılmıştır.) Örneğin,
channel_basic_a1
raporu kullanımdan kaldırıldı ve artıkchannel_basic_a2
raporuyla değiştirildi.Aşağıdaki listeler yeni rapor türü kimliklerini tanımlar:
Kanal videosu raporları
İçerik sahibi 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 üzere zaten işleriniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerektiğini unutmayın. Yeni rapor sürümlerinin kullanıma sunulmasıyla birlikte aşağıdaki rapor sürümleri 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 raporların herhangi birinde işiniz varsa YouTube'un 15 Aralık 2016'dan sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam eder.
-
content_owner_basic_a1
raporu tamamen kullanımdan kaldırıldı ve dokümanlardan kaldırıldı. YouTube artık bu türden yeni raporlar oluşturmayacak. Bununla birlikte, daha önce oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam edecek.content_owner_basic_a1
raporunun yerini, 19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklandığı gibicontent_owner_basic_a2
raporu alacaktır. -
YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda kapsamlı güncellemeler sağlar. Bu güncelleme, 10 Şubat 2017'de yürürlüğe girecek Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak birkaç destekleyici belge içerir.
Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmaktadır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de söz konusu düzeltme geçmişinde açıklanacaktır. Söz konusu dokümandaki bir bağlantıdan, düzeltme geçmişinde yapılan değişiklikleri içeren bir RSS özet akışına abone olabilirsiniz.
-
YouTube Analytics API (Hedeflenen Sorgular)
-
Not: Bu, kullanımdan kaldırma duyurusudur.
Aşağıdaki tabloda yer alan metriklerin desteği sonlandırılıyor. Aynı zamanda, aynı verilere atıfta bulunan yeni metrikler de kullanıma sunuluyor. Bu durum, eski metriklerin yeniden adlandırıldığı anlamına gelir. Ancak YouTube Analytics API, tabloda listelenen kullanımdan kaldırma tarihlerine kadar her iki metrik adını da destekleyecektir.
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 metrikler olmayan diğer metrikler, 4 Kasım 2016 tarihine kadar üç ay boyunca desteklenecektir.Örneğin, 4 Kasım 2016 tarihine 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. Bu özellik, 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ı gösterir.END_SCREEN
: Veriler, başka bir videonun son ekranından gelen görüntülemelerle ilgilidir.
Her iki yeni trafik kaynağı için de
traffic source detail
raporu alabilirsiniz. Her iki durumda dainsightTrafficSourceDetail
boyutu, izleyicinin yönlendirildiği videoyu tanımlar.-
adType
boyutu artıkauctionBumperInstream
değerini destekliyor. Bu değer, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamı ifade eder.
-
-
YouTube Reporting API (Toplu Raporlar)
traffic_source_type
boyutu artık aşağıdaki değerleri destekliyor:19
: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Bu özellik, 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ı gösterir.20
: Veriler, başka bir videonun son ekranından gelen görüntülemelerle 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
bu listeden kaldırılacak şekilde düzeltildi. (earnings
metriği, YouTube Reporting API'de hiçbir zaman desteklenmemektedir.) -
ad_type
boyutu artık, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamlar olan bumper reklamlarla ilişkili19
değerini artık destekliyor.
-
YouTube Analytics API (Hedeflenen Sorgular)
- Aşağıdaki kanal raporlarında desteklenen metriklerin listesi, kart metriklerini içerecek şekilde güncellendi. Bu raporlara kart metrikleri için destek 28 Haziran 2016 tarihinde eklenmiş olup bu tarihe ait düzeltme geçmişi girişinde bu değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar şunlardır:
- ABD eyaletleri için temel kullanıcı etkinliği
- ABD eyaletlerindeki belirli dönemler için kullanıcı etkinliği
- Eyalete göre kullanıcı etkinliği
- Abone olma durumuna göre kullanıcı etkinliği
- İller için abone durumuna göre kullanıcı etkinliği
- Eyaletlere göre 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üzeltildi.Daha önce, her iki raporun dokümanlarında, raporun bu iki filtreden biri veya iki filtre de kullanılarak alınabileceği yanlış bir şekilde belirtiliyordu.
- Aşağıdaki kanal raporlarında desteklenen metriklerin listesi, kart metriklerini içerecek şekilde güncellendi. Bu raporlara kart metrikleri için destek 28 Haziran 2016 tarihinde eklenmiş olup bu tarihe ait düzeltme geçmişi girişinde bu değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar şunlardır:
-
YouTube Reporting API (Toplu Raporlar)
- API'ye genel bakış sayfasında, bir raporun indirme URL'sinin nasıl alınacağını açıklayan bölüm, YouTube'un veri bulunmayan günler için indirilebilir raporlar oluşturduğunu belirtecek şekilde düzeltilmiştir. 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 konum (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 için güncellendi.
Daha önce belgeler, API isteğinin gönderildiği tarihten en fazla 180 gün öncesine kadar raporların kullanılabilir olduğunu belirtiyordu. Teknik açıdan da doğru olsa da orijinal metin en iyi ihtimalle biraz kafa karıştırıcıydı.
-
API, üç raporun yeni sürümünü destekler. Bu raporlardan ikisi de yeni ve yeniden adlandırılmış metrikler içerir:
-
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ı. -
Sürümleri yeni 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 şu yönleriyle farklılık gösterir:
- YouTube Premium aboneliklerinden elde edilen toplam kazançları tahmin eden yeni
estimated_partner_red_revenue
metriğini eklerler. - Ücretli içerik ve Takipçi Desteği gibi işlemlerden elde edilen gelirden iş ortağı tarafından alınan geri ödemelerin çıkarılmasıyla hesaplanan yeni
estimated_partner_transaction_revenue
metriğini ekler. estimated_partner_ad_sense_revenue
metriğiestimated_partner_ad_auction_revenue
olarak yeniden adlandırıldı.estimated_partner_double_click_revenue
metriğiestimated_partner_ad_reserved_revenue
olarak yeniden adlandırıldı.
Bu raporların eski sürümlerinden herhangi birini oluşturmak üzere zaten işleriniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerektiğini unutmayın. Yeni rapor sürümlerinin kullanıma sunulması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 raporların herhangi birinde işiniz varsa YouTube'un 22 Eylül 2016'dan sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam eder.
-
-
reportType
kaynağınınid
özelliğinin tanımı, mevcut rapor grubunu yansıtacak şekilde güncellendi. -
İki metriğin adı, dokümanlarda görünen adlarla eşleşecek şekilde düzeltilmiştir. Bu düzeltme yalnızca dokümanla ilgili bir düzeltmedir ve gerçek rapor içeriklerinde yapılan bir değişikliği yansıtmaz:
estimated_partner_adsense_revenue
metriğinin adıestimated_partner_ad_sense_revenue
olarak güncellendi. Ancak, 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ıldı.estimated_partner_doubleclick_revenue
metriğinin adıestimated_partner_double_click_revenue
olarak güncellendi. Bu metriğin yalnızca bu güncellemeyle desteği sonlandırılan iki raporda göründüğü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ıldı.
-
Reporting API'nin boyutlar dokümanları,
elapsed_video_time_percentage
veaudience_retention_type
mülklerinin listelenmemesi için güncellendi. Bu boyutlar, şu anda API üzerinden kullanılabilen raporlar 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 işiniz zaten varsacontent_owner_basic_a2
raporu için yeni bir iş oluşturmanız gerekir. YouTube, içerik sahiplerini yeni rapor sürümüne otomatik olarak taşımaz veya yeni rapor sürümünü oluşturmak için otomatik olarak bir iş oluşturmaz. Bazı uygulamalarda, yeni ve beklenmedik bir işin ortaya çıkması yıkıcı bir değişiklik olabilir.Yeni raporun kullanıma sunulması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. Oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam eder. -
reportType
,job
vereport
kaynaklarının tümü, ilişkilendirilmiş 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 mülkte yalnızca desteğinin sonlandırıldığı bildirilen raporlar için bir değer bulunur. Bu değer, YouTube'un bu türden raporlar oluşturmayı durduracağı tarihi temsil eder.Bir rapor türünün desteğinin sonlandırıldığı duyurulduktan sonra YouTube, bu tür raporları üç ay daha oluşturur. Örneğin, 19 Mayıs 2016'da yapılan bu güncellemede
content_owner_basic_a1
raporunun kullanımdan kaldırılacağı duyurulmuştur. Böylece, söz konusu rapor türünündeprecateTime
özelliği 19 Ağustos 2016'da bir zaman belirtir ve YouTube bu tarihten sonra bu türden raporlar oluşturmayı durdurur. -
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ü kullanımdan kaldırıldıysa veya iş için oluşturulan raporlar uzun süredir indirilmemişse bu mülkte bir değer bulunur. Tarih, YouTube'un artık iş için yeni raporlar oluşturmayacağı zamanı belirtir. -
report
kaynağınınjobExpireTime
özelliği, raporla ilişkilendirilen işin süresinin dolduğu veya sona ereceği tarih ve saati belirtir. Bu özellik, bu listede önceki öğede açıklandığı gibi,job
kaynağındakiexpireTime
özelliğiyle aynı değeri içerir.
-
-
Desteği sonlandırılan 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 bu yöntemin dokümanlarında artık bir API isteğinin başarısız olmasına yol açan birkaç diğer neden daha listelenmektedir. -
YouTube artık bir raporlama işinin ilk planlanan zamanından önceki 180 günlük dönemi kapsayan veriler oluşturmaktadır. Daha önce Reporting API geçmiş verileri sunmuyordu. Bu değişiklik, bu duyurudan önce oluşturulanlar dahil olmak üzere tüm işleri etkileyecektir.
Geçmiş raporlar kullanıma sunulur sunulmaz yayınlanır ancak bir iş için tüm geçmiş verilerin yayınlanması yaklaşık bir ay sürer. Dolayısıyla, bir raporlama işi planladıktan bir ay sonra, yaklaşık yedi aylık verilere erişebilirsiniz. (Bu duyurudan önce oluşturulan işlere ait tüm geçmiş veriler, duyurudan sonraki bir ay içinde yayınlanmalıdır.)
Geçmiş veriler, yalnızca 1 Temmuz 2015 itibarıyla kullanılabilir. Sonuç olarak, 28 Aralık 2015'ten önce oluşturulan işlerde 180 günden az geçmiş veri olacaktır.
Bu değişikliklerin tamamı, 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:
-
Dokümanlar artık raporların oluşturulduktan sonraki 180 gün boyunca kullanılabilir olduğunu ve bu nedenle API istemcileri tarafından indirilebileceğini belirtmektedir. Daha önce belgeler, API isteğinin gönderildiği tarihten altı ay öncesine kadar raporların kullanılabilir olduğunu belirtiyordu.
-
Belgeler, API'nin artık veri bulunmadığı günler için indirilebilir raporlar oluşturduğunu yansıtacak şekilde güncellendi. Bu raporlar başlık satırları içerir ancak ek veriler içermez.
-
-
YouTube Reporting API yakında reklam geliri veya YouTube Premium abonelik geliri verilerini içeren, otomatik olarak oluşturulmuş, sistem tarafından yönetilen bir grup raporu destekleyecek. Raporlar, YouTube İçerik Stüdyosu'nda manuel olarak indirilebilen gelir raporlarına erişebilen içerik sahipleri tarafından kullanılabilecek. Böylece, 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 kapsamında aşağıdaki API değişiklikleri duyurulmuştur:
-
job
kaynağının yenisystemManaged
özelliği, kaynağın sistem tarafından yönetilen raporlar oluşturan bir işi açıklayıp tanımlamadığını gösterir. YouTube, YouTube içerik sahipleri için otomatik olarak sistem tarafından yönetilen raporlar oluşturur. İç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 raporlara yönelik işleri içerip içermediğini gösterir. Parametrenin varsayılan değeri:false
. -
jobs.reports.list
yönteminin yenistartTimeAtOrAfter
parametresi, API yanıtının yalnızca rapordaki en eski verilerin belirtilen tarihte veya sonrasında olması durumunda raporları içermesi gerektiğini belirtir. Benzer şekildestartTimeBefore
parametresi, API yanıtının yalnızca rapordaki en erken veriler belirtilen tarihten önce olması durumunda raporları içermesi gerektiğini belirtir.Raporun oluşturulma zamanıyla ilişkili olan yöntemin
createdAfter
parametresinden farklı olarak, yeni parametreler rapordaki verilerle ilgilidir. -
reportType
kaynağının yenisystemManaged
özelliği, kaynağın sistem tarafından yönetilen bir raporu açıklayı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çermediğini gösterir. Parametrenin varsayılan değeri:false
.
-
- YouTube Reporting API'de
sharing_service
boyutu şu yeni değerleri destekler:82
: iOS sistem etkinliği iletişim kutusu83
: Google Gelen Kutusu84
: Android Messenger
- YouTube Analytics API'de
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ında 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, boyut değeri olarak artık18
değerini destekliyor. Bu değer, video görüntülemelerinin, oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını belirtir. Bu kaynak, görüntülemelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini gösteren14
kaynak türünden farklıdır.insightPlaybackLocationType
boyutu iki yeni boyut değerini destekler:BROWSE
: Veriler, YouTube ana sayfasında 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, boyut değeri olarak artıkYT_PLAYLIST_PAGE
değerini destekliyor. Bu değer, video görüntülemelerinin, oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını belirtir. Bu kaynak, görüntülemelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini gösterenPLAYLIST
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'de
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ı bir 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şkili olup olmadığını gösterir.youtubeProduct
: Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube mülkünü tanımlar. Olası değerler arasında temel YouTube web sitesi (veya YouTube uygulaması), YouTube Gaming ve YouTube Kids yer alır.
Dokümanlar, kanallar ve içerik sahipleri tarafından kullanılabilen yeni oynatma ayrıntısı raporlarını tanımlayacak şekilde güncellendi. Ayrıca diğer birçok raporda, bu boyutlardan bir veya daha fazlasının bu raporlarda isteğe bağlı olarak boyut ve/veya filtre olarak kullanılabileceğini belirten bir güncelleme yapıldı.
-
Raporları açıklayan tabloların biçimi, her bir raporu almak için kullanılabilecek geçerli boyut, metrik ve filtre kombinasyonlarını tanımlamanızı kolaylaştırmak amacıyla değiştirilmiştir. "Cihaz Türü"nü açıklayan aşağıdaki tablo yeni biçimi gösterir:
İçindekiler Boyutlar: Zorunlu deviceType 0 veya daha yüksek bir değer kullanın day, liveOrOnDemand, subscribedStatus, youtubeProduct Metrikler: 1 veya daha fazla alan kullanın görüntüleme sayısı, estimatedMinutesWatched Filtreler: 0 veya 1 değerini kullanın ülke, il, kıta, subContinent 0 veya 1 değerini kullanın video, grup 0 veya daha yüksek bir değer kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct Zorunlu ve isteğe bağlı alanları açıklayan terminoloji, kanal ve içerik sahibi raporlarındaki belgelerde açıklanmaktadır.
-
YouTube Analytics API, API kullanıcısının birden çok değeri destekleyen filtrelerden veri alamadığı öğeleri artık otomatik olarak bırakıyor (
video
,playlist
vechannel
). Önceden, API kullanıcısı belirtilen öğelerden en az birinin verilerine erişemezse API sunucusu hata döndürürdü.Örneğin, bir kullanıcının,
video
filtresinin 20 video kimliği listelediği bir API isteği gönderdiğini varsayalım. Kullanıcı, videoların 18'ine sahip olur. Ancak, bir video kimliği başka bir kanala ait videoyu tanımlarken, başka bir kimlik de 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 videoya ilişkin verileri içerir. -
Boş bir YouTube Analytics
group
için veri isterseniz API artık hata yerine boş bir veri kümesi döndürüyor. -
Bir gruba öğe eklemeye çalışırsanız ancak söz konusu öğeye erişiminiz yoksa YouTube Analytics API'nin
groupItems.insert
yöntemi artık yetkisiz bir (403
HTTP yanıt kodu) hatası döndürüyor. Daha önce API, varlığı gruba eklemenize izin veriyordu, ancak daha sonra söz konusu grup için rapor verilerini almaya çalıştığınızda yetkisiz bir hata döndürüyordu. -
YouTube Analytics API'nin
groups.list
yöntemi artık sayfalandırmayı desteklemektedir. API yanıtı kullanılabilir tüm grupları içermiyorsa yanıtınnextPageToken
parametresi, sonraki sonuç sayfasını almak için kullanılabilecek bir jetonu 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 Premium aboneliklerinden elde edilen toplam tahmini geliri bildiren
redPartnerRevenue
metriğini desteklemektedir. 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'nın 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 bulunduğu coğrafya
- En iyi videolar: Bu raporda
redPartnerRevenue
metriği de bir sıralama metriği olarak desteklenmektedir. Bu sayede, videoların YouTube Red kazançlarına göre sıralanmış bir listesini alabilirsiniz.
-
YouTube Analytics API için en iyi videolar rapor tanımı, artık bu raporun şu kazanç metriklerini de desteklediğini göstermektedir:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
veimpressionBasedCpm
. -
YouTube Reporting API'nin
date
boyutuyla ilgili dokümanlar, tarihlerin Pasifik saatine göre 00:00'da (UTC-8) başlayan 24 saatlik dönemi referans alacak şekilde düzeltildi. Daha önce, dokümanlarda tarihin 00:00'da (GMT) başladığı belirtiliyordu.Ayrıca YouTube Analytics API belgelerinde, tarihle ilgili tüm boyutların (
day
,7DayTotals
,30DayTotals
vemonth
) Pasifik saatine göre 00:00'da (UTC-8) başlayan tarihlere işaret ettiği unutulmamalıdır. -
YouTube Reporting API'nin
jobs.reports.list()
yöntemi artıkcreatedAfter
sorgu parametresini destekliyor. Belirtilirse bu parametre, API yanıtında, doldurulmuş veriler içeren yeni raporlar da dahil olmak üzere yalnızca belirtilen tarih ve saatten sonra oluşturulan raporların listelenmesi gerektiğini belirtir. Parametre değerinin, döndürülen verilerle ilişkilendirilen tarihlerle değil, raporun oluşturulduğu zamanda olduğunu unutmayın.Parametre değeri, RFC3339 UTC "Zulu" zaman damgasıdır biçiminde, mikrosaniyelere kadar doğrulukta. Örnek:
"2015-10-02T15:01:23.045678Z"
.YouTube Reporting API en iyi uygulamaları da 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ğinin vereport
kaynağınınstartTime
,endTime
vecreateTime
özelliklerinin tanımlarının tümü, özellik değerlerinin nanosaniye yerine mikrosaniye olarak doğru olduğu unutulmamalıdır. 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 bir dizi hizmet yer alır.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 sıralama değerleri listedeki yeni değerlerdir. -
Yeni YouTube Reporting API, bir kanal veya içerik sahibine ait YouTube Analytics verilerini içeren toplu veri raporlarını alır. Büyük veri kümelerini içe aktarabilen uygulamalar için tasarlanmıştır. Bu verileri filtreleme, sıralama ve maden çıkarma araçlarına sahiptir.
Her YouTube Reporting API raporu, önceden tanımlanmış bir dizi boyut ve metrik içerir. (YouTube Analytics API raporlarında metrikler ve boyutlar da kullanılır.) Raporda, her veri satırında boyut değerlerinin benzersiz bir kombinasyonu bulunur. Tek tek videolar, ülkeler, canlı videolar, abone olunan kullanıcılar vb. ile ilgili metrikleri hesaplamak için boyut değerlerine göre satırlar arasında verileri birleştirebilirsiniz.
Raporlama işlerini planlamak için API'yi kullanabilirsiniz. Bu işlerin her biri, YouTube'un oluşturması gereken bir raporu tanımlar. Bir iş oluşturduğunuzda, YouTube eşzamansız olarak indirilebilen günlük rapor oluşturur. Her raporda benzersiz bir 24 saatlik döneme ait veriler yer alır.
-
Farklı API'ler olmalarına rağmen, hem YouTube Analytics API hem de YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini alabilmesini sağlar. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'ye ilişkin belgeler tek bir belge seti olarak yayınlanmaktadır.
- Doküman kümesindeki Kılavuzlar sekmesi, API isteklerinin yetkilendirilmesine ilişkin talimatlar da dahil olmak üzere her iki API için ortak bilgileri içerir.
- Toplu raporlar sekmesi, referans belgeleri ve özellikle YouTube Reporting API'ye yönelik diğer içerikleri içerir.
- Hedeflenen sorgular sekmesi, referans belgeleri ve özellikle YouTube Analytics API'ye yönelik diğer içerikleri içerir.
- Örnekler sekmesinde, iki API'den biri için mevcut olan kod örnekleri listelenir.
- Araçlar sekmesinde, geliştiricilerin iki API'den birini uygulamasına yardımcı olacak ek kaynaklar listelenir.
-
API belgeleri, API'nin daha kolay anlaşılmasını sağlamak için yeniden yapılandırıldı. Dolayısıyla, bu değişiklikler yeni özellikleri açıklamamaktadır:
-
Dokümanlar artık mevcut tüm kanal raporlarının listelendiği bir sayfayı ve mevcut tüm içerik sahibi raporlarının listelendiği başka bir sayfayı içerir. Daha önce belgelerde kanal videosu raporları, kanal oynatma listesi raporları vb. için ayrı sayfalar yer alıyordu.
-
Yeni veri modeline genel bakış bölümünde, API'nin işleyiş şekli hakkında daha net bir tanıtımın sağlanması amaçlanmaktadır. Daha ayrıntılı olarak belirtmek gerekirse, bu doküman YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığını daha iyi açıklamaya çalışmaktadır.
-
API'nin raporları almak için kullandığınız
reports.query
yöntemi artık ayrı olarak belgelenmektedir. Bu sayfadaki bilgiler daha önce başka sayfalarda yer alıyordu. Yeni sayfa, bir raporu almak için göndermeniz gereken bilgileri daha kolay 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 tahmini toplam kazançları (net gelir) içerir. Temel metrik değildir. API, halihazırdaearnings
metriğini 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ından ve reklam dışı kaynaklardan elde edilen toplam tahmini kazançları içerdiğini yansıtacak şekilde düzeltildi. Daha önce tanım, metriğin yalnızca reklam kaynaklarından elde edilen kazançları içerdiğini yanlış bir şekilde 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ı da artıkmonetizedPlaybacks
veplaybackBasedCpm
metriklerini desteklememektedir. Ancak bazı video raporları bu metrikleri hâlâ desteklemektedir. -
API artık video raporları için iki yeni metriği destekliyor:
videosAddedToPlaylists
vevideosRemovedFromPlaylists
. Kanallar ve içerik sahipleri için video raporları listeleri, yeni metrikleri destekleyen raporları belirlemek üzere güncellendi.videosAddedToPlaylists
: Sorgu kapsamındaki videoların YouTube oynatma listelerine eklenme sayısıdır. Videolar, video sahibinin oynatma listesine veya diğer kanalların videolarına eklenmiş olabilir. oynatma listeleri.videosRemovedFromPlaylists
: Sorgu kapsamındaki videoların tüm YouTube oynatma listelerinden kaldırılma sayısıdır. Videolar, video sahibinin oynatma listesinden veya diğer kanallardan kaldırılmış olabilir. oynatma listeleri.
Her iki metrik de "Daha Sonra İzle" gibi varsayılan oynatma listelerini içerir. oynatma listesi. Bununla birlikte, videoların otomatik olarak eklendiği oynatma listeleri (ör. kanalın yüklenen oynatma listesi veya kullanıcının izleme geçmişi) sayılmaz. Ayrıca bu metriklerin mutlak ekleme ve silme sayısını yansıttığını da unutmayın. Dolayısıyla, kullanıcı bir oynatma listesine video ekler, ardından bu videoyu 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 itibarıyla kullanılabilmektedir.
-
Bu duyurudan itibaren geçerli olmak üzere
favoritesAdded
vefavoritesRemoved
metrikleri için destek sonlandırıldı. Bunların her ikisi de temel metriklerdir ve Hizmet Şartları'nda belirtilen Kullanımdan Kaldırma Politikası'na tabidir. -
Yeni
currency
parametresi, kazanç metriklerini ABD doları (USD
) dışında bir para biriminde almanızı sağlar. Parametre ayarlanırsa APIearnings
,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 tahminlerdir.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önetme özelliğinin yanı sıra bu gruplar için rapor verileri alma özelliğini de desteklemektedir.
-
Grup oluşturma ve yönetme
Bu güncellemeyle, grup oluşturmak ve yönetmek için kullanabileceğiniz
group
vegroupItem
kaynakları kullanıma sunuluyor.group
kaynağı, 200 adede kadar kanal, video, oynatma listesi veya öğeden oluşan özel bir koleksiyon olan Analytics grubunu temsil eder. API, bu kaynak içinlist
,insert
,update
vedelete
yöntemlerini destekler.groupItem
kaynağı, Analytics grubundaki bir öğeyi temsil ediyor. API, bu kaynak içinlist
,insert
vedelete
yöntemlerini destekler.
Yani, örneğin,
groups.insert
yöntemini kullanarak bir grup oluşturabilir ve ardındangroupItems.insert
yöntemini kullanarak öğeleri bu gruba ekleyebilirsiniz. -
Bir grup için rapor verilerini alma
Boyutlar belgesi, birçok kanal raporu ve içerik sahibi raporunda 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. -
video
,playlist
,channel
veshow
boyutları filtre olarak kullanıldığında API artık bu boyutlar için birden fazla değer belirtme özelliğini desteklemektedir. Birden çok 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 fazla değer belirtirseniz söz konusu filtreyi istek için belirttiğiniz boyut listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen bir boyut olarak listelenmese bile geçerlidir. Filtreyi boyut 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 kanaldan veri 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.Ayrıca, tüm oynatma listesi raporları aşağıdaki yeni metrikleri destekler. Bu metriklerin 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ı.averageTimeInPlaylist
: Bir izleyicinin, oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları görüntülediği tahmini ortalama süre (dakika cinsinden).
Oynatma listesi raporu almak için tüm istekler
isCurated
filtresini kullanmalıdır. Bu filtrenin1
(isCurated==1
) olarak ayarlanması gerekir. -
API artık kitleyi elde tutma raporunu desteklemektedir. Bu rapor, videonun kitleyi elde tutma becerisini ölçer. Raporun yeni
elapsedVideoTimeRatio
boyutu, ilgili metrik değerleri için video geçen süreyi ölçer:-
audienceWatchRatio
metriği, videonun belirli bir noktasında videoyu izleyen kullanıcıların mutlak oranını tanımlar. Bu oran, videonun bir bölümünün izlenme sayısı ile videonun toplam görüntüleme sayısının 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ç izlenemeyeceğini unutmayın). Örneğin, kullanıcılar videonun aynı bölümünü birden fazla kez geri sarıp izlerse videonun bu kısmının mutlak oranı en az
1
olabilir. -
relativeRetentionPerformance
metriği, bir videonun benzer uzunluktaki tüm YouTube videolarına kıyasla oynatma sırasında izleyicileri elde tutma konusunda ne kadar başarılı olduğunu gösterir. 0 değeri, videonun izleyicileri benzer uzunluktaki diğer tüm videolardan daha kötü tuttuğunu; 1 değeri ise videonun, izleyicileri benzer uzunluktaki diğer tüm videolardan daha iyi tuttuğunu belirtir. 0,5 ortanca değeri, benzer uzunluktaki videoların yarısının izleyicileri daha iyi tutarken diğer yarısının izleyicilerini daha kötü tuttuğunu ifade eder.
Raporun yalnızca organik görüntülemelerle, Yayın içi (In-stream) TrueView reklamlarından gelen görüntülemeler veya Görüntülü (In-display) TrueView reklamlarından gelen görüntülemelerle ilişkili verileri döndürmesi için
audienceType
filtresini de kullanabilirsiniz. (Organik görüntülemeler, video arama veya önerilen bir videonun tıklanması gibi kullanıcı işleminin doğrudan sonucudur.) -
-
API, notlarla ilgili birçok yeni metriği 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örünen ve tıklanabilen ek açıklamaların sayısı.annotationClosableImpressions
: Gösterilen ve kapatılabilecek 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 metriklerdir ve Kullanımdan Kaldırma Politikası'na tabidir. Ancak, 16 Temmuz 2013 tarihinden itibaren yeni metriklere ilişkin verilerin kullanılabildiğini unutmayın. (
annotationClickThroughRate
veannotationCloseRate
metriklerine ilişkin veriler, 10 Haziran 2012 tarihinden itibaren kullanılabilir.) -
GOOGLE_SEARCH
artıkinsightTrafficSourceType
boyutu için ayrı bir değer olarak raporlanmamaktadır. Bunun yerine, Google arama sonuçlarından yapılan yönlendirmeler artıkEXT_URL
trafik kaynağı türüyle ilişkilendirilmektedir. Sonuç olarak,insightTrafficSourceType
filtresiniGOOGLE_SEARCH
olarak ayarlayan birinsightTrafficSourceDetail
raporu almak da artık mümkün değildir. -
İçerik sahibi raporları belgesi, içerik sahibi tarafından hak talebinde bulunulan veya yüklenen içerikler için
subscribersGained
vesubscribersLost
metriklerinin artık alınabileceğini yansıtacak şekilde güncellendi.Değişiklik, içerik sahipleri için ilk temel istatistikler raporunda görünür ve artık
claimedStatus
veuploaderType
filtrelerini desteklemektedir. -
Örnek istekler dokümanı, yakın zamanda kanal ve içerik sahibi raporları için kullanıma sunulan sekmeye benzer bir sekme biçimi kullanılarak örnekleri kategoriler halinde gruplandırmak üzere yeniden tasarlandı. Yeni tasarımda örnekler aşağıdaki kategorilere ayrılmıştı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 istekler belgesi, artık kanal raporlarında veya içerik sahibi raporlarında eyalete özgü verileri almayla ilgili yeni örnekler içeriyor.
-
ABD eyaletleri ve Washington D.C. için eyalete özel metrikler: Bu rapor, bir kanalın videolarına ait görüntüleme sayılarının ve diğer istatistiklerin bölge bazında dökümünü alır. Veriler, ABD eyaletlerini ve Washington D.C'yi kapsar. Örnekte
province
boyutu kullanılmıştır ve ayrıca, yanıtı yalnızca ABD'ye ilişkin sonuçları içerecek şekilde kısıtlamak içinfilters
parametresi kullanılmıştır. -
Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet): Bu rapor, Kaliforniya'da bir kanalın videolarını izleyen veya içerik sahibi raporlarında içerik sahibinin hak talebinde bulunulan içeriklerini izleyen kullanıcıların yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Bu örnekte, yanıtın yalnızca belirli bir ille ilgili verileri içermesini sağlamak için
filters
parametresi kullanılmaktadır.
-
-
province
boyutunun tanımı,dimensions
parametre değerineprovince
eklendiğinde,filters
parametre değerinecountry==US
eklenerek isteğin verileri ABD ile de sınırlaması gerektiğini dikkate alacak şekilde güncellendi. -
Desteklenen kanal ve içerik sahibi raporlarının listelendiği dokümanlar yeniden tasarlandı. Olası tüm raporları listeleyen bir tablo sağlamak yerine her bir doküman, 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. Herhangi bir sekmeyi tıklayarak ilgili kategorideki desteklenen raporları görebilirsiniz.
-
API artık üç yeni coğrafi boyutu desteklemektedir:
province
,continent
vesubContinent
.-
province
boyutu, ABD eyaletlerine ve Kolombiya Bölgesi'ne ait istatistikleri almanıza olanak tanır. API, bu boyutun iki kullanımını destekler:-
API, istatistikleri eyalete 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ıları ve tahmini izleme süresi gibi çeşitli istatistikler sunar.
- Zamana dayalı rapor da aynı istatistikleri sunar ancak verileri günlük, 7 günlük, 30 günlük veya aylık bazda toplar.
-
Bir raporu yalnızca belirli bir duruma ilişkin istatistikleri içerecek şekilde kısıtlamak için
filters
sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografi raporları ve en çok görüntülenen video raporları dahil olmak üzere birçok rapor 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 da kullanılabilir.Her alt bölge yalnızca bir kıtayla ilişkilendirildiğinden,
subContinent
filtresini kullanırkencontinent
filtresini de kullanmanız gerekmez. (Aslında, istekte her iki boyut da kullanılıyorsa API hata döndürür.)
-
-
Dokümanlar,
insightTrafficSourceDetail
boyutunun geçerli bir filtre değeri olarakinsightTrafficSourceType
değeriniPROMOTED
içermeyecek şekilde düzeltildi. -
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 metrikler sayfaları, temel boyutlar ve temel metrikler listelenecek şekilde güncellendi. Ayrıca bu sayfalardaki tanımlar, temel boyutları ve metrikleri açıkça tanımlamak için güncellenmiştir.
-
API artık
insightPlaybackLocationType
boyutu içinEXTERNAL_APP
değerini desteklemektedir. Bu güncellemeyle birlikte, 10 Eylül 2013 itibarıyla oynatmalar artıkMOBILE
oynatma olarak sınıflandırılmamaktadır, ancak 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 uygulama türüne bağlı olarak artık
WATCH
,EMBEDDED
veyaEXTERNAL_APP
oynatma olarak sınıflandırılacak. -
API artık
insightTrafficSourceType
boyutu içinPLAYLIST
değerini desteklemektedir. Bu 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ıyordu. -
API artık raporları birden fazla boyut ve metriğe göre sıralama özelliğini destekliyor. Örnek istekler dokümanı, bu işlevi gösteren yeni bir örnek içerir: İstekleri birden çok boyuta/metriğe göre sıralama. İstek, trafik kaynağı verilerini alır ve
sort
parametre değeriday,-views
. Sonuçlar kronolojik olarak sıralanır. Ancak her güne ait sonuç kümesinde ilk satırda, en çok görüntüleme alan trafik kaynağına ait veriler, ikinci satırda ise sonraki en yüksek görüntüleme sayısına sahip kaynakla ilgili veriler yer alır. -
API artık iki yeni boyutu (
deviceType
veoperatingSystem
) desteklemektedir. Bunlar, izleyicilerin videolarınızı izlediği cihazlarla ilgili verileri almak için kullanılabilir. API, boyutlardan birinin veya her ikisinin de kullanıldığı raporları destekler.-
deviceType
raporu; masaüstü, mobil ve tablet cihazlar da dahil olmak üzere farklı cihaz türleri için görüntüleme sayılarını ve tahmini izlenme süresini almanıza olanak tanır. Ayrıca, cihaz türü raporunu yalnızca Android veya iOS gibi belirli bir işletim sistemini çalıştıran cihazlara ait istatistikleri içerecek şekilde kısıtlamak 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üresini öğrenmenize olanak tanır. İşletim sistemi raporunu yalnızca mobil cihazlar veya tabletler gibi belirli bir cihaz türüne ait istatistikleri içerecek şekilde kısıtlamak için dedeviceType
filtresini 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, içerik sahipleri için üç cihaz raporu içerecek şekilde güncellendi.
-
insightPlaybackLocationType
boyutu, boyutun diğer değerlerinden biri kullanılarak sınıflandırılmamış görüntülemeleri tanımlayanYT_OTHER
değerini döndürebilir. -
İçerik sahibi raporları belgesi, en yüksek kazancı sağlayan videoları belirlemek için en başarılı video raporunu azalan düzende sıralayabileceğinizi yansıtacak şekilde güncellendi. Bu rapor, Kullanıcı etkinliği ve kazanç raporları bölümünün ikinci tablosunda listelenen ilk rapordur.
-
YouTube, deneysel API özelliklerini ve hizmetlerini artık tanımlamamaktadır. Bunun yerine artık kullanımdan kaldırma politikasına tabi YouTube API'lerinin listesini sunuyoruz.
-
API artık görüntüleme metrikleri, etkileşim metrikleri, kazanç metrikleri ve reklam performansı metrikleri gibi diğer metriklerin yanı sıra izlenme süresi metriklerini (
estimatedMinutesWatched
,averageViewDuration
veaverageViewPercentage
) alma özelliğini de destekliyor.Mevcut kanal raporları 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ğinden, listeler şu anda aslında daha kısadır.)
Örnek API istekleri belgesi de güncellendi.
-
insightPlaybackLocationDetail
veinsightTrafficSourceDetail
boyutlarını kullanan raporlar aşağıdaki şekillerde iyileştirilmiştir:-
Bu filtreler artık isteğe bağlı
country
filtresini destekliyor. -
İçerik sahipleri artık bu raporları aşağıdaki yeni
filter
kombinasyonlarından herhangi birini kullanarak alabilir. Bu kombinasyonların tümünün, isteğe bağlıcountry
filtresini de desteklediğini unutmayın.-
Oynatma konumu ayrıntıları
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 belgesi, YouTube Analytics API kullanılarak farklı türde raporların nasıl alınacağını gösteren örnekler sunar. 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 bir değer olarakSUBSCRIBER
değerini destekliyor. Bu değer, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden yönlendirilen video görüntülemelerini tanımlar. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı, görüntülemelerin yönlendirildiği ana sayfa feed'ini veya diğer sayfayı belirtir. -
API artık iki yeni metriği destekliyor:
annotationClickThroughRate
veannotationCloseRate
. Bunlar, izleyicilerinizin videolarınız sırasında gösterilen ek açıklamalarla olan etkileşimleriyle ilgili. Kanal raporları ve içerik sahibi raporları listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.annotationClickThroughRate
– İzleyicilerin tıkladığı ek açıklamaların, tıklanabilir ek açıklama gösterimlerinin toplam 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 yeni reklam performansı raporlarının yanı sıra kazanç ve reklam performansı metriklerini de desteklemektedir. 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 desteklemektedir. Reklam performansı raporları hakkında daha fazla bilgi için içerik sahibi raporları belgelerine bakın.
-
Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporları listesi, iki yeni raporu da içeren ve bu metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.
earnings
: Google'ın sattığı 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, raporun kapsadığı video oynatmaları için birincil reklam türü altında toplanan ve sınıflandırılan tahmini brüt gelir.monetizedPlaybacks
– En az bir reklam gösterimi yapılan oynatmaların sayısı.playbackBasedCpm
: Bin oynatma başına tahmini brüt gelirdir.impressions
– Sunulan doğrulanmış reklam gösterimlerinin sayısı.impressionBasedCpm
– Bin reklam gösterimi başına tahmini brüt gelir.
Not: Tüm ayrıntıları öğrenmek 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 kanal raporlarının ve içerik sahibi raporlarının farklı türlerini açıklayan ayrı sayfalar bulunmaktadır.
-
API'nin referans kılavuzunda artık bir örnekler bölümü bulunmaktadır. 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 almaktadır. 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ıza, API isteğini görmenize ve yanıtta gerçek verileri almanıza olanak tanıyan APIs Explorer özelliği yer alıyor.
-
API, hem kanallar hem de içerik sahipleri için birçok yeni raporu destekler. Bunlar aşağıda açıklanmıştır. Her rapor, kanal raporu veya içerik sahibi raporu olarak sunulur. Boyutlar ve metrikler sayfaları da buna göre güncellendi.
-
Oynatma konumu raporu, farklı sayfa türleri 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 fazla görüntülemeyi oluşturan yerleşik oynatıcıları tanımlar. En çok yerleştirilmiş oynatıcılarla ilişkili URL'leri tanımlayarak oynatma konumu raporundan daha ayrıntılı bir görünüm sunar.
-
Trafik kaynağı raporu, farklı yönlendiren türlerinden gelen video görüntülemelerinin sayısını tanımlar.
-
Trafik kaynağı ayrıntı raporu, belirli bir video ve belirtilen bir trafik kaynağı türü için en fazla görüntülemeyi oluşturan yönlendirenleri tanımlar. Örneğin, bu raporda belirli bir videoya en çok trafik gönderen ilgili videolar gösterilebilir. Bu rapor çeşitli trafik kaynakları için desteklenir.
-
İzlenme süresi raporları, izleyicilerin içeriklerinizi izlerken harcadıkları süreyi gösterir. Raporlar belirli bir zaman aralığına (gün, önceki yedi gün, önceki 30 gün vb.) veya ülkeye ilişkin verileri toplayabilir. Bir rapor, verileri güne veya ülkeye göre topluyorsa her video görüntülemenin 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. Öncelikle erişim isteğinde bulunmak zorunda kalmadan APIs console içindeki Hizmetler panelinden projenize ilişkin API'yi etkinleştirebilirsiniz.
-
Yeni Başlarken bölümünde, YouTube Analytics API kullanan bir uygulama oluşturmak için ön koşullar ve temel adımlar özetlenmektedir.
-
Yeni kota kullanımını anlama bölümü, API kota kullanımınızı optimize etmeye yönelik yönergeler sağlamaktadır. API sunucusu, her istek için bir sorgu maliyeti hesaplar ve bu maliyet, API kullanım kotanızdan düşülür. Farklı rapor türlerinin sorgu maliyetleri oldukça farklı olabilir. Bu nedenle, kotanızı verimli bir şekilde kullanmayı planlamanız ve uygulamanızın yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemesi gerekir.
-
Geçici boyutlar bölümü, bu boyutların Analytics raporunun verileri belirli bir döneme göre toplaması gerektiğini açıklayacak şekilde güncellendi. 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 birleştirilir.month
– Rapordaki veriler takvim ayına göre toplanır.
Benzer şekilde, kullanılabilir raporlar bölümü, API'nin bu boyutları kullanan raporlara yönelik desteğini yansıtacak şekilde güncellenmiştir.
-
Rapor eden varlık boyutları bölümü, içerik sahibi raporlarını almaya yönelik API isteklerinde verileri bu boyutlardan biri (
video
,channel
veyashow
) ya daclaimedStatus
veuploaderType
boyutlarının desteklenen bir kombinasyonu kullanılarak filtrelemesi gerektiğini belirtecek şekilde güncellendi. -
API artık üstteki video raporları için iki yeni sıralama seçeneğini destekliyor. Kanal raporları veya içerik sahibi raporları olarak sunulan bu raporlar ülke bazında metrikler (görüntüleme sayısı, yorumlar, beğeniler vb.) içerir ve bu metriklerin videoya göre dökümü yapılır. Artık bu raporları videonun izleme sayfasından bir kanala abone olan veya kanaldan abonelikten çıkan kullanıcı sayısına göre sıralayabilirsiniz.
-
subscribersGained
vesubscribersLost
metriklerinin tanımları, bir kanalın video izleme sayfası, kanal sayfası ve YouTube ana sayfasında görünen rehber de dahil olmak üzere ç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ından istatistikleri içerir.
YouTube Reporting API, üç yeni bitiş ekranı raporunun yanı sıra bu raporlar için yeni boyut ve metrikleri destekler. Raporlar, bir videonun oynatılması durduktan sonra görüntülenen bitiş ekranlarına ilişkin gösterim ve tıklama istatistiklerini sağlar.
YouTube Yardım Merkezi'nde videolarınıza bitiş ekranı ekleme hakkında daha ayrıntılı bilgi bulabilirsiniz.
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, İçerik Stüdyosu'nun Raporlar bölümündeki ilgili raporlara erişimi olan içerik sahipleri için artık otomatik olarak sistem tarafından yönetilen bir dizi reklam geliri raporu oluşturuyor. Sistem tarafından yönetilen yeni API raporları, manuel olarak indirilebilen İçerik Stüdyosu raporlarında da bulunan verilere programatik erişim sağlayacak şekilde tasarlanmıştır.
Sistem tarafından yönetilen raporlara genel bakış, yeni raporlara kısa bir genel bakış sağlar ve API aracılığıyla bu raporları alma sürecini açıklar. İş ortaklarının raporları oluşturmak için işleri planlamasına gerek olmadığından bu işlem, YouTube Analytics için toplu rapor alma işleminden 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 bir 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 metrik değildir ve 31 Ekim 2016 tarihine kadar desteklenecektir.
15 Eylül 2016
Bu güncelleme, YouTube Reporting API'de yapılan aşağıdaki değişiklikleri içerir:
19 Ağustos 2016
Bu güncelleme, YouTube Reporting API'de yapılan aşağıdaki değişikliği 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 belgeleri, çok sayıda kanal ve içerik sahibi raporunda 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, YouTube Reporting API'de yapılan aşağıdaki değişiklikleri içerir. İlk değişiklik genel olarak API ile ilgilidir, kalan değişiklikler yalnızca içerik sahibi raporlarını etkiler:
19 Mayıs 2016
Bu güncelleme, YouTube Reporting API'de yapılan aşağıdaki değişiklikleri içerir:
12 Nisan 2016
Bu güncelleme aşağıdaki değişiklikleri içerir. Bunların tümü yalnızca YouTube Reporting API'yi etkiler:
28 Mart 2016
YouTube Reporting API ve YouTube Analytics API artık birçok ek paylaşım hizmeti 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'si için desteklenen metriklerin listesi, kart metriklerinin artık söz konusu API için desteklenen metrikler olarak listelenmemesini sağlayacak şekilde güncellendi. (Söz konusu API'nin raporlarından hiçbirinin kart metriklerini desteklediği belirtilmemiştir.)
Birçok kanal ve içerik sahibi raporunda bu metrikleri destekleyen YouTube Reporting API'yi kullanarak kart metriklerini almaya devam edebilirsiniz.
6 Ocak 2016
Hem YouTube Reporting API hem de YouTube Analytics API artık bir Chromecast cihazı üzerinden gerçekleşen görüntülemeleri özel olarak tanımlamaktadır.
21 Aralık 2015
Dokümanlardaki annotation_clickable_impressions
ve annotation_closable_impressions
metriklerinin adları, raporlarda döndürülen adlarla eşleşecek şekilde güncellenmiştir. Daha önce adlar clickable_annotation_impressions
ve closable_annotation_impressions
olarak belgeleniyordu.
18 Aralık 2015
Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması zorunludur. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. Bu şartla ilgili bir bildirimi YouTube API Hizmet Şartlarımıza ekledik.
15 Aralık 2015
Bu güncelleme, her biri YouTube Analytics API'yi etkileyen aşağıdaki değişiklikleri içerir:
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üncellemede, yalnızca içerik sahipleri için geçerli olan çeşitli değişiklikler bulunuyor:
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: