Düzeltme Geçmişi

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. Abone ol

7 Nisan 2024

YouTube Analytics (Targeted Sorgular) API'de, içerik sahibi oynatma listesi raporlarıyla ilgili çeşitli güncellemeler bulunmaktadır. Güncellemeler, 19 Ocak 2024'te duyurulan kanal oynatma listesi raporlarıyla ilgili güncellemelerle aynıdır.

Aşağıdaki düzeltme geçmişi girişi, 19 Ocak 2024 tarihli girişle neredeyse aynı bilgileri sağlar. Bununla birlikte, içerik sahibi oynatma listesi raporlarının 31 Aralık 2024'e kadar isCurated boyutunu, bu boyutun ise 30 Haziran 2024'e kadar kanal oynatma listesi raporlarında destekleneceğini unutmayın.

  • Not: Bu, kullanımdan kaldırma duyurusudur.

    isCurated boyutu, içerik sahibi oynatma listesi raporları için kullanımdan kaldırıldı. 31 Aralık 2024'te veya sonrasında artık desteklenmeyecek. Bu boyutun tanımı uygun şekilde güncellenmiştir.

    isCurated boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu yalnızca oynatma listesi raporlarında views metriği yerine playlistViews metriğini alacak şekilde güncellemeniz de gerekir. Oynatma listesi raporları için views metriği hâlâ desteklendiğinden, farklı bir anlama gelse de, metrik adını güncellemezseniz API veri döndürmeye devam eder. Elbette, uygulamanızı hem views hem de playlistViews öğelerini alıp görüntüleyecek şekilde değiştirebilirsiniz.

    Yeni raporlarda, isCurated boyutuna ek olarak aşağıdaki API işlevleri artık desteklenmemektedir:

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporları için desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporları için desteklenmemektedir. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarına filtre olarak desteklenmemektedir. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.

  • İçerik sahibi raporları dokümanlarının oynatma listesi raporları bölümü, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı şekilde açıklanacak şekilde güncellendi:

    • Toplu video metrikleri, içerik sahibinin oynatma listelerinde bu içerik sahibine ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahipsiz videoların görüntülemelerini de içerir (yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiyse) ve görüntüleme sayısını içerir.
    • Desteklenen oynatma listesi metrikleri bölümü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.

  • İçerik sahiplerine yönelik oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metriklerin yalnızca raporları almaya yönelik API isteğinin isCurated boyutunu kullanmaması durumunda desteklendiğini unutmayın. Her metriğin tanımı için metrics belgelerine bakın:

  • views metriğinin davranışı artık oynatma listesi raporunu alan API isteğinin isCurated boyutunu kullanıp kullanmadığına bağlıdır:

    • İstek isCurated boyutunu içerdiğinde views metriği, oynatma listesi içi metriktir. Bu metrik, videoların içerik sahibinin oynatma listeleri bağlamında görüntülenme sayısını belirtir.
    • İstek isCurated boyutunu içermediğinde views metriği, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğinden bağımsız olarak içerik sahibinin oynatma listelerindeki videoların toplam görüntülenme sayısını belirten toplu bir video metriğidir. Toplu toplam yalnızca oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videoların görüntülemelerini içerir.

      isCurated boyutunu kullanmayan bu raporlarda, playlistViews metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrikte, oynatma listesindeki tüm videoların görüntüleme sayısı, videonun sahibi olan kanaldan bağımsız olarak sayılır.

  • Her oynatma listesi raporu için içerik sahibi raporları dokümanlarında, artık API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak bu rapor için desteklenen metrikleri gösteren tablolar yer alıyor. Örnek için zamana dayalı oynatma listesi raporlarını tanımlayan bölüme bakın.

19 Ocak 2024

YouTube Analytics (Targeted Sorgular) API'sinde kanal oynatma listesi raporlarıyla ilgili çeşitli güncellemeler bulunmaktadır. Güncellemeler, kullanımdan kaldırılmış bir boyutun yanı sıra birkaç yeni ve güncellenmiş metrik içerir:

  • Not: Bu, kullanımdan kaldırma duyurusudur.

    isCurated boyutu, kanal raporları için kullanımdan kaldırıldı. 30 Haziran 2024'te veya sonrasında artık desteklenmeyecek. Bu boyutun tanımı uygun şekilde güncellenmiştir.

    isCurated boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu yalnızca oynatma listesi raporlarında views metriği yerine playlistViews metriğini alacak şekilde güncellemeniz de gerekir. Oynatma listesi raporları için views metriği hâlâ desteklendiğinden, farklı bir anlama gelse de, metrik adını güncellemezseniz API veri döndürmeye devam eder. Elbette, uygulamanızı hem views hem de playlistViews öğelerini alıp görüntüleyecek şekilde değiştirebilirsiniz.

    Yeni raporlarda, isCurated boyutuna ek olarak aşağıdaki API işlevleri artık desteklenmemektedir:

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporları için desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporları için desteklenmemektedir. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarına filtre olarak desteklenmemektedir. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, API işlevselliği ile Studio uygulamasındaki işlevler uyumlu hâle getirildi.

  • Kanal raporları belgelerinin oynatma listesi raporları bölümü, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı şekilde açıklanacak şekilde güncellendi:

    • Toplu video metrikleri, kanalın oynatma listelerinde bu kanala ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplanan video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahipsiz videoların görüntülemelerini de içerir (yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiyse) ve görüntüleme sayısını içerir.
    • Desteklenen oynatma listesi metrikleri bölümü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.

  • Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metrikler henüz içerik sahibi raporlarında desteklenmemektedir. Bu metriklerin yalnızca raporları almaya yönelik API isteği isCurated boyutunu kullanmıyorsa desteklendiğini unutmayın. Her metriğin tanımı için metrics belgelerine bakın:

  • views metriğinin davranışı artık oynatma listesi raporunu alan API isteğinin isCurated boyutunu kullanıp kullanmadığına bağlıdır:

    • Bir istek isCurated boyutunu içerdiğinde views metriği, kanalın oynatma listeleri bağlamında videoların kaç kez görüntülendiğini belirten oynatma listesi içi bir metriktir.
    • İstek isCurated boyutunu içermediğinde views metriği, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğinden bağımsız olarak kanalın oynatma listelerindeki bir videonun toplam görüntülenme sayısını belirten toplu bir video metriğidir. Toplam görüntüleme sayısı yalnızca oynatma listesinin sahibi olan kanala ait videoların görüntülemelerini içerir.

      isCurated boyutunu kullanmayan bu raporlarda, playlistViews metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrikte, oynatma listesindeki tüm videoların görüntüleme sayısı, videonun sahibi olan kanaldan bağımsız olarak sayılır.

  • Her oynatma listesi raporu için kanal raporları belgelerinde artık API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak ilgili raporda desteklenen metrikleri gösteren tablolar yer alıyor. Örnek için zamana dayalı oynatma listesi raporlarını tanımlayan bölüme bakın.

4 Aralık 2023

YouTube Analytics (Targeted Sorgular) API'si, iki insightTrafficSourceType boyut değerini birleştirecek şekilde güncellendi. Daha önce, bir oynatma listesinin parçası olarak oynatılan videolar (PLAYLIST) ile oynatma listesindeki tüm videoları listeleyen bir sayfadan gelen görüntülemeleri (YT_PLAYLIST_PAGE) birbirinden ayıran bu boyut, artık PLAYLIST boyut değeriyle ilişkilendirilecek.

15 Aralık 2022

YouTube Analytics (Hedeflenen Sorgular) API'si iki yeni boyutu ve bir yeni raporu destekler:

  • Yeni bir rapor, şehre göre kullanıcı etkinliğini gösterir. Bu rapor, kanallar ve içerik sahipleri tarafından kullanılabilir. Bu rapor, YouTube'un kullanıcı etkinliğinin gerçekleştiği şehirle ilgili tahminini tanımlayan yeni city boyutunu içerir.

  • Yeni creatorContentType boyutu, veri satırındaki kullanıcı etkinliği metrikleriyle ilişkilendirilen YouTube içeriğinin türünü tanımlar. LIVE_STREAM, SHORTS, STORY ve VIDEO_ON_DEMAND değerleri desteklenir.

    creatorContentType boyutu, tüm kanal ve içerik sahibi video raporları için isteğe bağlı bir boyut olarak desteklenir.

  • YouTube Analytics API örnek istekler kılavuzu artık her iki yeni boyut için de örnekler içeriyor.

  • 7DayTotals ve 30DayTotals boyutlarına yapılan referanslar dokümanlardan kaldırıldı. Ekim 2019'da bu boyutların kullanımdan kaldırılacağı duyuruldu.

26 Ağustos 2022

YouTube Analytics (Targeted Sorgular) API'si ve YouTube Reporting (Bulk Reports) API, yeni bir trafik kaynağı ayrıntı değerini destekliyor:

  • YouTube Analytics API (Targeted Sorgular) API'de insightTrafficSourceType boyutunun değeri SUBSCRIBER ise insightTrafficSourceDetail değeri podcasts olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfasından yönlendirildiğini gösterir.
  • YouTube Reporting (Bulk Reports) API'de traffic_source_type boyutunun değeri 3 ise traffic_source_detail değeri podcasts olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfasından yönlendirildiğini gösterir.

11 Şubat 2022

gender boyutu için geçerli değerler grubu, 11 Ağustos 2022'de veya bu tarihten sonra değişecek. Bu, API uygulamanızda geriye dönük olarak uyumsuz bir değişiklik olabilir. YouTube API Hizmetleri Hizmet Şartları'nın Geriye dönük olarak uyumsuz değişiklikler bölümü uyarınca bu değişiklik, yürürlüğe girmeden altı ay önce duyurulur. Yeni değer grubuna sorunsuz bir şekilde geçiş yapmak için lütfen API uygulamanızı 11 Ağustos 2022'den önce güncelleyin.

Yapılan spesifik değişiklikler şunlardır:

  • YouTube Analytics (Hedeflenen Sorgular) API'sinde gender boyutu şu anda iki değeri desteklemektedir: female ve male. 11 Ağustos 2022'de veya sonrasında bu boyut üç değeri destekleyecek: female, male ve user_specified.
  • YouTube Reporting (Bulk Reports) API'de gender boyutu şu anda üç değeri desteklemektedir: FEMALE, MALE ve GENDER_OTHER. 11 Ağustos 2022'de veya sonrasında, desteklenen değer grubu FEMALE, MALE ve USER_SPECIFIED olarak değişecek.

9 Şubat 2022

13 Aralık 2021 itibarıyla iki metrik, klipleri döngüye alma trafiğini hariç tutacak şekilde güncellendi. Bu değişiklik hem YouTube Analytics (Targeted Sorgular) API'yi hem de YouTube Reporting (Bulk Reports) API'yi etkiler.

2 Şubat 2022

Bu YouTube Reporting (Bulk Reports) API, görüntülemelerin Live Redirects'ten kaynaklandığını belirten yeni bir trafik kaynağı boyut değerini destekler:

Bu trafik kaynağı türü için traffic_source_detail boyutu, görüntüleyenin yönlendirildiği kanal kimliğini belirtir.

23 Eylül 2020

Hem bu YouTube Analytics (Targeted Sorgular) API'si hem de YouTube Reporting (Bulk Reports) API, izleyicinin YouTube Shorts izleme deneyiminde dikey kaydırma yaparak yönlendirildiğini gösteren yeni bir trafik kaynağı boyut değerini destekler:

Bu yeni trafik kaynağı türü için trafik kaynağı ayrıntıları boyutu (YouTube Analytics API'deki insightTrafficSourceDetail veya YouTube Reporting API'de traffic_source_detail) doldurulmaz.

20 Temmuz 2020

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sini etkileyen iki değişikliği kapsar:

  • YouTube Analytics raporlama grubunun maksimum boyutu 200'den 500'e çıkarılmıştır.
  • reports.query yönteminin filters parametresi, YouTube Analytics verileri alınırken uygulanması gereken filtrelerin listesini tanımlar. Parametre; video, playlist ve channel filtreleri için birden fazla değer belirtme özelliğini destekler ve bu filtreler için belirtilebilecek maksimum kimlik sayısı 200'den 500'e çıkarılmıştır.

13 Şubat 2020

Bu güncelleme, YouTube Analytics (Targeted Sorgular) API'si ve YouTube Reporting (Bulk Reports) API ile ilgili aşağıdaki değişiklikleri içerir. Bu değişiklikler hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.

Her iki API'de de bildirimler için olası trafik kaynağı ayrıntı değerleri grubu değişiyor. Hedeflenen sorgularda bildirimler insightTrafficSourceType=NOTIFICATION olarak raporlanır. Toplu raporlarda bildirimler traffic_source_type=17 olarak raporlanır.

Yeni değerler, yüklenen videolar ve canlı yayınlarla (daha önce uploaded olarak raporlanan) ilgili bildirimleri iki kategoriye ayırır:

  • uploaded_push: Görüntülemelerin kaynağı, video yüklendiğinde abonelere gönderilen push bildirimleridir.
  • uploaded_other: Video yüklendiğinde abonelere gönderilen, push olmayan bildirimler (e-posta veya Gelen Kutusu bildirimleri gibi) kaynaklı görüntülemeler.

Bu değerler, 13.01.2020 (13 Ocak 2020) ile başlayan zaman aralığı için döndürülür.

Ayrıca bu değerlerin, bildirimleri değil, belirli YouTube görüntülemelerini sağlayan trafik kaynaklarını temsil ettiğini hatırlatmak isteriz. Örneğin, bir rapor satırında views=3, traffic_source_type=17 (NOTIFICATION) ve traffic_source_detail=uploaded_push değerleri gösteriliyorsa satır, üç görüntülemenin, izleyicilerin video yüklendiğinde gönderilen push bildirimlerini tıklaması sonucu oluştuğunu belirtir.

15 Ekim 2019

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:

  • Not: Bu, kullanımdan kaldırma duyurusudur.

    YouTube, 7DayTotals ve 30DayTotals boyutları için sağladığı desteği kaldırıyor. 15 Nisan 2020 tarihine kadar bu boyutları kullanarak veri almaya devam edebilirsiniz. Bu tarihte veya bu tarihten sonra, 7DayTotals ya da 30DayTotals boyutunu kullanarak rapor alma girişimleri hata döndürür.

    Kullanıcıların, day boyutunu kullanarak sorgulama yaparak ve yedi ya da 30 günlük dönemlere ait verileri toplayarak veya türeterek bu boyutlar için bazı verileri yeniden oluşturabileceğini unutmayın. Örneğin:

    • Yedi günlük bir dönemdeki görüntüleme sayısı, ilgili dönemin her bir gününden elde edilen görüntüleme sayıları toplanarak hesaplanabilir.
    • Yedi günlük bir döneme ait görüntüleyiciPercentage değeri, o gün için her gün meydana gelen görüntüleme sayısı ile o günkü görüntüleme yüzdesi çarpılarak o gün videoyu izlerken giriş yapmış olan izleyicilerin sayısının elde edilmesi sağlanarak hesaplanabilir. Ardından, tüm dönem için giriş yapmış olan izleyicilerin sayısı tüm dönem için toplanabilir ve tüm dönem için görüntüleyici Yüzdesi değerini elde etmek üzere söz konusu dönemdeki toplam görüntüleme sayısına bölünebilir.
    • Aynı görüntüleyen farklı günlerde benzersiz bir görüntüleyen olarak hesaplanabileceğinden, yedi günlük bir dönemdeki benzersiz görüntüleyen sayısı hesaplanamaz. Ancak 30 günlük bir dönemdeki benzersiz görüntüleyen sayısıyla ilgili verilerden yola çıkmak için 30DayTotals boyutu yerine month boyutunu kullanabilirsiniz. month boyutu takvim aylarını ifade ederken 30DayTotals boyutu, belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemleri hesaplar.

27 Haziran 2019

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:

  • API'nin 1. sürümü artık tamamen kullanımdan kaldırıldığı için dokümanlar, kullanımdan kaldırma bildirimi ve sürüm 2'ye nasıl güncelleme yapılacağının açıklandığı geçiş kılavuzu da dahil olmak üzere bu sürüme yapılan referansları kaldıracak şekilde güncellendi.

1 Kasım 2018

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:

  • API sürüm 1'in desteği sonlandırıldı. Henüz yapmadıysanız lütfen hizmet kesintilerini en aza indirmek için API istemcilerinizi en kısa sürede API'nın 2 sürümünü kullanacak şekilde güncelleyin. Daha fazla ayrıntı için taşıma kılavuzuna bakın.

    Bu kullanımdan kaldırma programının ilk olarak 26 Nisan 2018'de duyurulduğunu unutmayın.

17 Eylül 2018

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'siyle ilgili aşağıdaki değişiklikleri içerir:

  • Veri Modeli'ne genel bakış belgesindeki yeni veri anonimleştirme bölümünde, metrikler belirli bir eşiği karşılamadığında bazı YouTube Analytics verilerinin sınırlı olduğu açıklanmaktadır. Bu durum çeşitli durumlarda görülebilir. Pratikte bu, bir raporda aşağıdaki durumlarda verilerinizin tümünü (veya herhangi birini) içermeyebileceği anlamına gelir:

    1. Belirli bir dönemde bir video veya kanal sınırlı trafiğe sahipse

      veya

    2. Değerleri belirli bir eşiği karşılamayan bir filtre veya boyut (ör. trafik kaynağı veya ülke) seçtiniz.

    Yeni bölümde, YouTube Analytics raporlarında sınırlı olabilecek veri türleriyle ilgili açıklamalar da yer almaktadır.

  • Oynatma konumu, trafik kaynağı ve cihaz türü/işletim sistemi raporlarında redViews ve estimatedRedMinutesWatched metriklerinin artık desteklenmediğini belirtmek üzere kanal raporları ve içerik sahibi raporları dokümanları güncellendi.

18 Haziran 2018

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:

  • Aşağıdaki yöntemler için kapsam şartları değiştirildi:
    • reports.query yöntemine yapılan isteklerin https://www.googleapis.com/auth/youtube.readonly kapsamına erişimi olmalıdır.
    • groupItems.list yöntemine yapılan isteklerin şunlardan birine erişimi olmalıdır:
      • https://www.googleapis.com/auth/youtube kapsamı
        veya
      • https://www.googleapis.com/auth/youtube.readonly kapsamı
        ve
        https://www.googleapis.com/auth/yt-analytics.readonly kapsamı

      İlk seçenek bir okuma-yazma kapsamı, ikinci seçenek ise iki salt okunur kapsam kullanır.

23 Mayıs 2018

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:

  • API'ye Genel Bakış, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkili verileri nasıl işlediğini açıklayan yeni bir bölüm olan metrikleri ve silinen öğeleri içerir.
  • API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklara ait ek meta verileri almak için YouTube Data API'yı kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (bölüm III.E.4.b ila III.E.4.d) belirtildiği gibi, API istemcileri, depolanan kaynak meta verilerini 30 gün sonra söz konusu API'den silmeli veya yenilemelidir.

22 Mayıs 2018

Bu güncelleme, YouTube Reporting (Bulk Reports) API'de yapılan aşağıdaki değişiklikleri içerir:

  • Aşağıdaki değişikliklerin Temmuz 2018'de yürürlüğe girmesi planlanmaktadır. Yeni politikalar, dünya genelinde tüm raporlar ve raporlama işleri için geçerlidir.

    • Değişiklikten sonra, dolgu raporları da dahil olmak üzere API raporlarının çoğu, oluşturuldukları andan itibaren 60 gün boyunca kullanılabilecektir. Ancak geçmiş verileri içeren raporlar, oluşturuldukları andan itibaren 30 gün boyunca kullanılabilir.

      Bu duyurudan önce tüm API raporları, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Açıkça belirtmek gerekirse, bu politika değişikliği yürürlüğe girdiğinde, 30 günden eski geçmiş veri raporlarına da artık API üzerinden erişilemeyecektir. 60 günden eski olan diğer raporlara da artık erişilemeyecektir. Bu nedenle, dokümanlarda artık politika değişikliğinden önce oluşturulan raporlara en fazla 180 gün boyunca ulaşılabileceği belirtilmektedir.

    • Değişiklikten sonra, bir raporlama işi planladığınızda YouTube, o günden başlayarak işin planlandığı saatten önceki 30 günlük dönemi kapsayan raporlar oluşturur. Değişiklikten önce, bir raporlama işi planladığınızda YouTube, işin planlandığı zamandan önceki 180 günlük dönemi kapsayan raporlar oluşturur.

  • En iyi uygulamalar bölümü, raporlarda tanımlanan kaynaklar için ek meta veriler almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (bölüm III.E.4.b ila III.E.4.d) belirtildiği gibi, API istemcileri, depolanan kaynak meta verilerini 30 gün sonra söz konusu API'den silmeli veya yenilemelidir.

  • Rapor özellikleri bölümü, rapor verileri filtrelenmese bile, 1 Haziran 2018 veya sonrası bir döneme ait verileri içeren raporların, raporun oluşturulduğu tarihten en az 30 gün önce silinen YouTube kaynaklarına referans içermeyeceğini belirtecek şekilde güncellendi.

  • API'ye genel bakışın geçmiş veriler bölümü, yeni bir raporlama işi planladığınızda geçmiş raporların genellikle birkaç gün içinde yayınlanacağını belirtecek şekilde güncellendi. Daha önce dokümanlarda bu tür raporların kullanılabilir hale gelmesinin 30 günü bulabileceği belirtiliyordu.

  • API'ye genel bakışın dolgu verileri bölümü, dolgu verilerini daha önce yayınlanan bir veri kümesinin yerini alan veri kümesi olarak daha net tanımlamak için güncellendi.

26 Nisan 2018

YouTube Analytics (Targeted Sorgular) API'nin (v2) 2. sürümü artık herkese açık. Aşağıdaki listede, yeni API sürümüyle ilgili ürün ve belge değişiklikleri tanımlanmaktadır:

  • v2 API, v1 API ile neredeyse aynıdır. Ancak, büyük olasılıkla kodunuzu aşağıda listelenen değişiklikleri yansıtacak şekilde güncellemeniz gerekecektir. Bu değişikliklerin tümü yeni taşıma kılavuzunda ayrıntılı olarak açıklanmıştır.

    • API'nin v1 olan sürümü v2 olarak değiştirildi.
    • API istekleri için https://www.googleapis.com/youtube/analytics/v1 olan temel URL https://youtubeanalytics.googleapis.com/v2 olarak değiştirildi.
    • reports.query yöntemi için bazı parametrelerin adları güncellenmiştir. Daha açık belirtmek gerekirse, v1 API'sindeki end-date gibi kısa çizgi içeren parametre adları, v2 API'de kısa çizgi (endDate) yerine büyük/küçük harf kullanır. API'nin grup oluşturma ve yönetme yöntemlerinde parametre adları için büyük/küçük harf kullanımı zaten kullanıldığından, bu değişiklik parametre adlarının API'de tutarlı olmasını sağlar.
    • v2 API, Google'ın küresel HTTP toplu uç noktasına (www.googleapis.com/batch) gönderilen toplu istekleri desteklemez. v2 API'sinde toplu istekler gönderiyorsanız bunun yerine https://youtubeanalytics.googleapis.com/v2 uç noktasını kullanmanız gerekir.

    Ayrıca v2 API'sinde desteklenmeyen birkaç v1 özelliği vardır:

    • reports.query yöntemi artık alt, quotaUser ve userIp istek parametrelerini desteklemiyor.
    • v2 API, farklı API'lere yapılan isteklerden oluşan grupları destekleyen bir toplu işlem uç noktası sağlamaz. (Bununla birlikte, bir grup, aynı API'nin farklı yöntemlerine yapılan isteklerden oluşabilir.) Google, global toplu işlem uç noktasını tüm API'lerinde kullanımdan kaldıracağı için bu kullanımdan kaldırma işlemi YouTube Analytics API'ye özel bir durum değildir.
    • v2 API, API v1'de desteklenen JSON-RPC protokolünü desteklemez. Bununla birlikte, desteğin sonlandırılması YouTube Analytics API'ye özel değildir.

  • Not: Bu, kullanımdan kaldırma duyurusudur.

    API Sürüm 1'in (v1) desteği sonlandırılmıştır ve 31 Ekim 2018 tarihine kadar desteklenecektir. v1 API'ye yapılan tüm istekler bu tarihten sonra çalışmayı durduracaktır. Bu nedenle, API üzerinden YouTube Analytics verilerine erişiminizde kesinti yaşamamak için lütfen 31 Ekim 2018 tarihine kadar v2 API'ye yükseltme yaptığınızdan emin olun.

21 Şubat 2018

Bu güncelleme, YouTube Analytics (Hedeflenen Sorgular) API'sinde aşağıdaki değişiklikleri içerir:

  • Görüntüleme istatistiklerini izleyicilerin yaş grubu ve cinsiyetine göre birleştiren izleyici demografisi raporları artık kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlayan youtubeProduct boyutunu desteklemiyor.

18 Ocak 2018

Bu güncelleme aşağıdaki değişiklikleri içerir:

  • YouTube Reporting API (Toplu Raporlar)

    • Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan operating_system boyutu artık aşağıdaki değeri desteklemektedir:
      • 25: KaiOS

  • YouTube Analytics API (Hedeflenen Sorgular)

20 Aralık 2017

Bu güncelleme, YouTube Reporting API ile ilgili iki değişiklik içeriyor:

  • API sunucusu artık raporları indiren istekler için gzip sıkıştırmasını desteklemektedir. gzip sıkıştırma işleminin diğer API isteği türleri için desteklenmediğini unutmayın. gzip sıkıştırmasının etkinleştirilmesi her API yanıtı için gereken bant genişliğini azaltır. Uygulamanızın API yanıtlarını açmak için ek CPU zamanı gerekse de daha az ağ kaynağı tüketmenin sağlayacağı avantaj, genellikle maliyetten daha ağır basar.

    gzip kodlamalı bir yanıt almak için Accept-Encoding HTTP istek başlığını aşağıdaki örnekte gösterildiği gibi gzip olarak ayarlayın:

    Accept-Encoding: gzip

    Bu işlev, API'lere genel bakış bölümünde ve report kaynağının downloadUrl özelliğinin tanımında açıklanmıştır.

  • age group ve gender boyutlarıyla ilgili dokümanlar, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bunun dokümanlarla ilgili bir düzeltme olduğunu ve API işlevi veya davranışındaki bir değişikliği yansıtmadığını unutmayın. Daha ayrıntılı olarak belirtmek gerekirse, aşağıdaki değerler değişmiştir:

    • age_group boyutu değerleri büyük harf kullanır, AGE kelimesi ile yaş grubundaki sayıların arasında alt çizgi içerir ve kısa çizgi yerine alt çizgi kullanın. Bu nedenle, age13-17 ve age18-24 gibi değerler sırasıyla AGE_13_17 ve AGE_18_24 olarak düzeltildi.
    • gender boyutu değerlerinde büyük harf kullanılmıştır. Bu nedenle, female, male ve gender_other değerleri FEMALE, MALE ve GENDER_OTHER olarak düzeltildi.

10 Ağustos 2017

10 Ağustos 2016'da bu belgeyle YouTube Analytics API'nin earnings metriğinin kullanımdan kaldırıldığını duyurduk. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue adlı yeni bir metriği de destekliyor.)

earnings metriği temel bir metrik olduğu için duyuru tarihinden itibaren bir yıl süreyle desteklendi. Ancak bu yıllık dönem sona erdiğinden earnings metriği artık desteklenmemektedir. Sonuç olarak, earnings metriğini belirten API istekleri artık 400 HTTP yanıt kodu döndürüyor. Uygulamanızı henüz earnings metriği yerine estimatedRevenue metriğini kullanacak şekilde güncellemediyseniz lütfen mümkün olan en kısa sürede güncelleyin.

API dokümanları, earnings metriğine ilişkin kalan referansları kaldıracak şekilde güncellendi.

6 Temmuz 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

  • YouTube Analytics API (Hedeflenen Sorgular)

    • API dokümanları, API yanıtlarının sorgulanmakta olan tüm metriklerin kullanılabilir olduğu istenen tarih aralığındaki son güne kadar olan verileri içerdiğini yansıtacak şekilde güncellenmiştir.

      Örneğin, bir istekte 5 Temmuz 2017 bitiş tarihi belirtiliyorsa ve istenen tüm metriklerin değerleri yalnızca 3 Temmuz 2017'ye kadar kullanılabiliyorsa bu tarih, verilerin yanıta dahil edileceği son tarih olur. (İstenen metriklerden bazılarının verileri 4 Temmuz 2017 için kullanılabilir olsa bile bu durum geçerlidir.)

    • adType boyutu artık reservedBumperInstream değerini desteklemektedir. Bu değer, bir video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklam anlamına gelir. Reklam biçimi, auctionBumperInstream reklamı ile aynıdır, ancak bu tür, açık artırma yerine ayırma yöntemiyle satılan reklamları ifade eder.

  • YouTube Reporting API (Toplu Raporlar)

    • ad_type boyutu, artık ayırtılarak satılan bumper reklamları ifade eden 20 değerini destekliyor. Bumper reklamlar, video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklamlardır. Bu boyut için 19 değerinin, ayrılmış olarak değil, açık artırmayla satılan bumper reklamları da ifade ettiğini unutmayın.

    • Aşağıdaki YouTube Reporting API raporlarının raporlama işleri silindi:

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      Bu rapor türlerinin kullanımdan kaldırıldığı 15 Eylül 2016 tarihinde duyurulmuştur ve 15 Aralık 2016'dan sonra bu rapor türleri için artık rapor oluşturulmamıştır. Önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 15 Haziran 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

24 Mayıs 2017

Aşağıdaki YouTube Reporting API raporları için tüm raporlama işleri silindi:

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Bu rapor türlerinin kullanımdan kaldırıldığı 22 Haziran 2016 tarihinde duyurulmuştur ve 22 Eylül 2016'dan sonra bu rapor türleri için artık rapor oluşturulmamıştır. Önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 22 Mart 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

22 Mayıs 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

  • YouTube Reporting API (Toplu Raporlar)

    • Videoları paylaşmak için kullanılan hizmeti tanımlayan sharing_service boyutu artık aşağıdaki değerleri desteklemektedir:

      • 85: YouTube Müzik
      • 86: YouTube Oyun
      • 87: YouTube Çocuk
      • 88: YouTube TV

      Ayrıca, 52 değerini tanımlamak için kullanılan ad, dokümanlardaki Kakao (Kakao Talk) şeklinde güncellendi. Böylece, 73 değerinden daha net bir şekilde ayırt edilebilir (Kakao Story). Bu değişiklik, bu hizmetlerle paylaşılan videoların API davranışında veya sınıflandırmasında herhangi bir değişikliğe işaret etmez.

  • YouTube Analytics API (Hedeflenen Sorgular)

    • sharingService boyutu artık aşağıdaki değerleri desteklemektedir:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 Mart 2017

İçerik Stüdyosu'nda YouTube Analytics üzerinden gelir verilerine erişebilen kanal sahipleri, artık bu gelir verilerine YouTube Analytics API aracılığıyla da erişebilir:

17 Mart 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

  • YouTube Analytics API, her ikisi de YouTube Red izleyici sayısıyla ilgili olan redViews ve estimatedRedMinutesWatched metriklerini destekler. Aslında, API bir süredir bu metrikleri desteklemektedir ve YouTube Reporting API, 15 Eylül 2016'da duyurulduğu üzere her iki metriği de zaten desteklemektedir.

    • redViews metriği, bir videonun YouTube Red üyeleri tarafından görüntülenme sayısını tanımlar.
    • estimatedRedMinutesWatched metriği, YouTube Red üyelerinin bir videoyu izlediği dakika sayısını tanımlar.

    Kanal raporları ve içerik sahibi raporları dokümanları, hangi raporların iki yeni metriği desteklediğini gösterecek şekilde güncellendi. Halihazırda views ve estimatedMinutesWatched metriklerini destekleyen tüm raporlarda desteklenmektedir.

3 Mart 2017

Bu güncelleme aşağıdaki değişiklikleri içerir:

  • YouTube Reporting API (Toplu Raporlar)

    • date boyutunun tanımı, boyut değerinin, belirtilen gün, ay ve yılda Pasifik saatiyle 00:00'da başlayan ve Pasifik saatiyle 23:59'da sona eren dönemi ifade edecek şekilde düzeltildi. Yılın zamanına bağlı olarak, Pasifik saati UTC-7 veya UTC-8'dir.

      Tarihler genellikle 24 saatlik bir dönemi temsil etse de, saatlerin ileriye ayarlandığı tarihler 23 saatlik bir süreyi, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Önceden dokümanlarda, her tarihin benzersiz bir 24 saatlik bir dönemi temsil ettiği ve Pasifik saatinin her zaman UTC-8 olduğu belirtiliyordu.)

      Bu düzeltmenin gerçek API davranışında bir değişikliği temsil etmediğini unutmayın.

    • Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan operating_system boyutu artık aşağıdaki değerleri desteklemektedir:
      • 22: Tizen
      • 23: Firefox
      • 24: 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şturulan content_owner_basic_a1 raporları, oluşturuldukları andan itibaren 180 gün süreyle kullanılabilir durumdaydı. Bu nedenle, bazı raporlara 19 Şubat 2017'den itibaren erişilebildi. Ancak, raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

  • YouTube Analytics API (Hedeflenen Sorgular)

    • time periods ile ilgili boyutların açıklaması, boyut değerinin, belirtilen gün, ay ve yılda Pasifik saatiyle 00:00'da başlayan ve Pasifik saatiyle 23:59'da sona eren dönemi ifade edecek şekilde düzeltildi. Yılın zamanına bağlı olarak, Pasifik saati UTC-7 veya UTC-8'dir.

      Tarihler genellikle 24 saatlik bir dönemi temsil etse de, saatlerin ileriye ayarlandığı tarihler 23 saatlik bir süreyi, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce dokümanlarda Pasifik saatinin UTC-8 olduğu belirtiliyordu ve bir günün 24 saatlik bir süreyi temsil edememe olasılığından bahsedilmiyordu.)

      Bu düzeltmenin gerçek API davranışında bir değişikliği temsil etmediğini unutmayın.

    • Kanal raporları dokümanları, kanal raporlarının şu anda kazanç veya reklam performansı metriklerini içermediğini belirtecek şekilde güncellendi. Dolayısıyla, https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamı şu anda kanal raporlarındaki parasal verilere erişim izni vermemektedir.

    • operatingSystem boyutu, üç yeni boyut değerini destekler:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 Şubat 2017

YouTube Analytics API artık isteğe bağlı include-historical-channel-data parametresini desteklemektedir. Bu parametrenin yalnızca içerik sahibi raporları alırken geçerli olduğunu unutmayın.

Bu parametre içerik sahibinin, bir API yanıtının kanalların içerik sahibine bağlanmasından önceki döneme ait izlenme süresini ve görüntüleme verilerini içermesi gerektiğini belirtmesine olanak tanır. Varsayılan parametre değeri false'dir. Yani, API yanıtı varsayılan olarak yalnızca kanalların içerik sahibine bağlandığı zamana ait izlenme süresi ve görüntüleme verilerini içerir.

Bu kurallar, API isteği birden fazla kanal için veri aldığında da geçerlidir:

  • Parametre değeri false ise belirli bir kanal için döndürülen izlenme süresi ve görüntüleme verileri, kanalın içerik sahibine bağlandığı tarihe dayanır.

    Farklı kanalların farklı tarihlerde bir içerik sahibine bağlanmış olabileceğini unutmayın. API isteği birden çok kanal için veri alıyorsa ve parametre değeri false ise API yanıtı, ilgili her kanalın bağlantı tarihine göre izlenme süresi ve görüntüleme verilerini içerir.
  • Parametre değeri true ise yanıt, API isteğinde belirtilen başlangıç ve bitiş tarihlerine göre tüm kanallar için izlenme süresi ve görüntüleme verilerini döndürür.

15 Aralık 2016

Aşağıdaki YouTube Reporting API raporları artık desteklenmemektedir ve dokümanlardan kaldırılmıştır. Her raporun daha yeni bir sürümü mevcut. (Bu raporlarla ilgili kullanımdan kaldırma duyurusu 15 Eylül 2016 tarihinde yapılmıştır.)

API referans belgelerindeki mevcut rapor türlerinin listesi de güncellenmiştir.

11 Kasım 2016

Bu güncelleme aşağıdaki değişiklikleri içerir:

    YouTube Reporting API, üç yeni bitiş ekranı raporunun yanı sıra bu raporlar için yeni boyut ve metrikleri de destekler. Raporlar, bir videonun oynatılması durduktan sonra görüntülenen bitiş ekranlarıyla ilgili gösterim ve tıklama istatistikleri sağlar.

    8 Kasım 2016

    Bu güncelleme, YouTube Analytics API'de yapılan aşağıdaki değişiklikleri içerir:

    • Aşağıdaki listede yer alan metrikler tamamen kullanımdan kaldırılmıştır ve artık desteklenmemektedir. 10 Ağustos 2016 tarihinde duyurulduğu üzere, aynı verileri ifade eden yeni metrikler halihazırda desteklenmektedir. Aşağıdaki tabloda kullanımdan kaldırılan metrik adı ve yeni metrik adı gösterilmektedir:

      Kullanımdan kaldırılan metrik Yeni metrik
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 Ekim 2016

    YouTube artık YouTube İçerik Stüdyosu'nun Raporlar bölümünde ilgili raporlara erişimi olan içerik sahipleri için otomatik olarak bir dizi sistem tarafından yönetilen reklam geliri raporu oluşturmaktadır. Sistem tarafından yönetilen yeni API raporları, manuel olarak indirilebilir İçerik Stüdyosu raporlarında da bulunan verilere programatik erişim sağlamak için tasarlanmıştır.

    Sistem tarafından yönetilen raporlara genel bakış sayfasında, yeni raporlara kısa bir genel bakış sunulur ve raporların API üzerinden alınması süreci açıklanmaktadır. İş ortaklarının raporları oluşturmak için işleri planlaması gerekmediğinden bu süreç, YouTube Analytics için toplu raporların alınmasından biraz farklıdır.

    reportType kaynağının id özelliği, API aracılığıyla erişebileceğiniz sistem tarafından yönetilen raporların listesini içerecek şekilde güncellendi:

    • Dünya genelinde video başına aylık reklam geliri
    • Video başına ülke başına günlük reklam geliri
    • Dünya genelinde öğe başına aylık reklam geliri
    • Öğe başına ülke başına günlük reklam geliri
    • Hak talepleri (bu rapor, gelir verilerini içermez)

    27 Eylül 2016

    Not: Bu, kullanımdan kaldırma duyurusudur.

    YouTube Analytics API'nin uniques metriği kullanımdan kaldırıldı. Bu, temel bir metrik değildir ve 31 Ekim 2016 tarihine kadar desteklenecektir.

    15 Eylül 2016

    Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir:

    19 Ağustos 2016

    Bu güncelleme, aşağıdaki YouTube Reporting API değişikliğini içerir:

    • content_owner_basic_a1 raporu tamamen kullanımdan kaldırıldı ve dokümanlardan kaldırıldı. YouTube artık bu tür yeni raporlar oluşturmayacaktır. Bununla birlikte, önceden oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olacaktır.

      content_owner_basic_a1 raporunun yerini alan, 19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklanan content_owner_basic_a2 raporudur.

    11 Ağustos 2016

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak açıklanan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), geçerli Hizmet Şartları'nda kapsamlı bir güncelleme seti sunmaktadır. 10 Şubat 2017'de yürürlüğe girecek olan Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak bazı destekleyici dokümanlar içerir.

      Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde yapılacak değişikliklerin durumu da söz konusu düzeltme geçmişinde açıklanacaktır. Söz konusu düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına ilgili dokümandaki bağlantıdan abone olabilirsiniz.

    10 Ağustos 2016

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Analytics API (Hedeflenen Sorgular)

      • Not: Bu, kullanımdan kaldırma duyurusudur.

        Aşağıdaki tabloda yer alan metrikler kullanımdan kaldırılıyor. Aynı zamanda, aynı verileri ifade eden yeni metrikler de kullanıma sunuluyor. Bu durum, eski metriklerin yeniden adlandırıldığı anlamına geliyor. Ancak YouTube Analytics API, tabloda listelenen kullanımdan kaldırılma tarihlerine kadar her iki metrik adını da destekleyecek.

        Eski metrik adı Yeni metrik adı Destek tarihi
        earnings estimatedRevenue 10 Ağustos 2017
        adEarnings estimatedAdRevenue 4 Kasım 2016
        redPartnerRevenue estimatedRedPartnerRevenue 4 Kasım 2016
        impressionBasedCpm cpm 4 Kasım 2016
        impressions adImpressions 4 Kasım 2016

        earnings metriğinin temel metrik olduğunu, bu nedenle bu duyurunun yapıldığı tarihten itibaren bir yıl boyunca destekleneceğini unutmayın. Temel metrik dışındaki diğer metrikler, 4 Kasım 2016'ya kadar üç ay boyunca desteklenecektir.

        Örneğin, 4 Kasım 2016'ya kadar bir API isteği impressionBasedCpm metriğini, cpm metriğini veya her ikisini birden belirtebilir. Ancak, bu tarihten sonra yalnızca cpm metriği desteklenecektir.

      • insightTrafficSourceType boyutu, iki yeni boyut değerini destekler:
        • CAMPAIGN_CARD: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklandığını belirtir.
        • END_SCREEN: Veriler, başka bir videonun bitiş ekranından elde edilen izlemelerle ilgilidir.

        Her iki yeni trafik kaynağı için de bir traffic source detail raporu alabilirsiniz. Her iki durumda da insightTrafficSourceDetail boyutu, izleyicinin yönlendirildiği videoyu tanımlar.

      • adType boyutu artık auctionBumperInstream değerini desteklemektedir. Bu değer, bir video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklam anlamına gelir.

    • YouTube Reporting API (Toplu Raporlar)

      • traffic_source_type boyutu artık aşağıdaki değerleri desteklemektedir:
        • 19: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklandığını belirtir.
        • 20: Veriler, başka bir videonun bitiş ekranından elde edilen izlemelerle ilgilidir.

        Her iki yeni trafik kaynağı için de traffic_source_detail boyutu, izleyicinin yönlendirildiği videoyu tanımlar.

      • API'nin temel metrikler listesi, estimated_partner_revenue temel metrik olarak listelenecek ve earnings metriği bu listeden kaldırılacak. (earnings metriği, YouTube Reporting API'de hiçbir zaman desteklenmemektedir.)

      • ad_type boyutu artık bumper reklamlar anlamına gelen 19 değerini desteklemektedir. Bu değer, bir videonun görüntülenmesinden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklamlardır.

    18 Temmuz 2016

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Analytics API (Hedeflenen Sorgular)

      • Aşağıdaki kanal raporları için desteklenen metriklerin listesi kart metriklerini içerecek şekilde güncellenmiştir. Bu raporlardaki kart metrikleri desteği 28 Haziran 2016'da eklenmiştir ve bu tarihe ait düzeltme geçmişi girişinde değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar:
        • ABD eyaletleri için temel kullanıcı etkinliği
        • Belirli dönemler için ABD eyaletlerindeki kullanıcı etkinliği
        • Eyale göre kullanıcı etkinliği
        • Abone olma durumuna göre kullanıcı etkinliği
        • Eyaletler için abone olma durumuna göre kullanıcı etkinliği
        • Eyalet bazında en popüler videolar
        • Abone olan veya abone olmayan izleyiciler için en popüler videolar

      • Filtre listeleri, hem kanal kitleyi elde tutma raporları hem de içerik sahibi kitleyi elde tutma raporları için, video filtresinin gerekli olduğunu ve group filtresinin desteklenmediğini yansıtacak şekilde düzeltilmiştir.

        Daha önce her iki raporun dokümanlarında, raporun bu iki filtreden biri kullanılarak veya iki filtre kullanılmadan alınabileceği belirtiliyordu.

    • YouTube Reporting API (Toplu Raporlar)

      • API'ye genel bakış bölümündeki bir raporun indirme URL'sinin nasıl alınacağını açıklayan bölüm, YouTube'un veri mevcut olmadığı günler için indirilebilir raporlar oluşturduğunu belirtecek şekilde düzeltildi. Bu raporlar bir başlık satırı içerir ancak ek veri içermez. Bu bilgiler, 12 Nisan 2016 tarihinde aynı dokümanın Rapor özellikleri bölümünde zaten güncellenmişti.
      • content_owner_asset_cards_a1 raporundaki boyutlar listesi, raporun card_id boyutunu kullandığını yansıtacak şekilde düzeltildi. Daha önce, dokümanlarda boyut adı hatalı bir şekilde card_title olarak listeleniyordu.

    28 Haziran 2016

    YouTube Analytics API dokümanları, çok sayıda kanal ve içerik sahibi raporundaki kart metrikleri desteğini yansıtacak şekilde güncellendi. Yeni desteklenen metrikler şunlardır:

    Metrikler aşağıdaki rapor türlerinde desteklenir:

    22 Haziran 2016

    Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir. İlk değişiklik genel olarak API ile ilgilidir, geri kalan değişiklikler yalnızca içerik sahibi raporlarını etkiler:

    • API'ye genel bakışın Rapor özellikleri bölümü, raporların, oluşturuldukları andan itibaren 180 gün boyunca API aracılığıyla kullanılabildiğini netleştirmek amacıyla güncellendi.

      Önceden dokümanlarda raporların, API isteğinin gönderildiği tarihten önceki 180 gün boyunca kullanılabildiği belirtiliyordu. Teknik olarak doğru olmakla birlikte, orijinal metin en iyi ihtimalle biraz kafa karıştırıcıydı.

    • API, üç raporun yeni sürümlerini destekler. Bu raporlardan ikisi yeni ve yeniden adlandırılmış metrikler de içermektedir:

      • content_owner_ad_rates_a1 raporu, content_owner_ad_performance_a1 raporunun yeni sürümüdür. Yeni adı verilen rapor, önceki sürümle aynı.

      • Yeni sürümleri olan iki rapor yeniden adlandırıldı:

        • content_owner_estimated_earnings_a1 raporunun yeni sürümünün adı content_owner_estimated_revenue_a1.
        • content_owner_asset_estimated_earnings_a1 raporunun yeni sürümünün adı content_owner_asset_estimated_revenue_a1.

        Yeniden adlandırılan her iki rapor da öncekilerden aşağıda belirtilen yönlerden farklıdır:

      Bu raporların eski sürümlerinden birini oluşturmak için zaten işleriniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerekeceğini unutmayın. Yeni rapor sürümlerinin yayınlanmasıyla birlikte content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 ve content_owner_asset_estimated_earnings_a1 raporları kullanımdan kaldırılmıştır.

      Bu raporlardan herhangi birinde işleriniz varsa YouTube'un 22 Eylül 2016'dan sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Üretilen raporlar, oluşturulduğu andan itibaren 180 gün boyunca kullanılabilir durumda kalır.

    • reportType kaynağının id özelliğinin tanımı, mevcut rapor grubunu yansıtacak şekilde güncellendi.

    • İki metriğin adları, raporlarda görünen adlarla eşleşecek şekilde belgelerde düzeltilmiştir. Bu, yalnızca dokümanla ilgili bir düzeltmedir ve gerçek rapor içeriklerinde bir değişikliği yansıtmaz:

      • estimated_partner_adsense_revenue metriğinin adı estimated_partner_ad_sense_revenue olarak güncellendi. Bununla birlikte, bu metriğin yalnızca bu güncellemeyle desteği sonlandırılan iki raporda göründüğünü unutmayın. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların yeni sürümlerinde estimated_partner_ad_auction_revenue olarak yeniden adlandırılmıştır.
      • estimated_partner_doubleclick_revenue metriğinin adı estimated_partner_double_click_revenue olarak güncellendi. Bu metriğin yalnızca, bu güncellemeyle birlikte kullanımdan kaldırılan iki raporda yer aldığını tekrar hatırlatmak isteriz. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların yeni sürümlerinde estimated_partner_ad_reserved_revenue olarak yeniden adlandırılmıştır.

    • Reporting API'nin boyutlar dokümanları, elapsed_video_time_percentage ve audience_retention_type mülklerinin artık listelenmemesi için güncellendi. Bu boyutlar, şu anda API aracılığıyla kullanılabilen hiçbir rapor tarafından desteklenmemektedir.

    19 Mayıs 2016

    Bu güncelleme, aşağıdaki YouTube Reporting API değişikliklerini içerir:

    • 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üm likes ve dislikes metriklerini destekler.

      content_owner_basic_a1 raporunu oluşturmak için zaten bir işiniz varsa content_owner_basic_a2 raporu için yeni bir iş oluşturmanız gerekir. YouTube, içerik sahiplerini otomatik olarak yeni rapor sürümüne taşımaz veya yeni rapor sürümünü oluşturmak için otomatik olarak bir iş oluşturmaz. Bazı uygulamalarda, yeni, beklenmedik bir işin görünmesi yıkıcı bir değişiklik olabilir.

      Yeni raporun yayınlanmasıyla birlikte, content_owner_basic_a1 raporu kullanımdan kaldırıldı. Bu rapor için bir işiniz varsa YouTube'un 19 Ağustos 2016'dan sonra bu iş için yeni raporlar oluşturmasını beklememelisiniz. Üretilen raporlar, oluşturulduğu andan itibaren 180 gün boyunca kullanılabilir durumda kalır.

    • reportType, job ve report kaynaklarının tümü, ilişkili kaynağın kullanımdan kaldırılmış bir rapor türünü temsil edip etmediğini tanımlayan yeni bir özelliği destekler:

      • reportType kaynağının deprecateTime özelliği, rapor türünün kullanımdan kaldırılacağı tarih ve saati belirtir. Bu özellik, yalnızca kullanımdan kaldırıldığı duyurulan raporlar için bir değere sahiptir ve bu değer, YouTube'un bu türde raporlar oluşturmayı durduracağı tarihi temsil eder.

        Bir rapor türünün kullanımdan kaldırıldığı duyurulduktan sonra YouTube, üç ay daha o türde raporlar oluşturur. Örneğin, 19 Mayıs 2016 tarihli bu güncellemeyle, content_owner_basic_a1 raporunun kullanımdan kaldırılacağı bildirilmiştir. Dolayısıyla, söz konusu rapor türüne ilişkin deprecateTime, 19 Ağustos 2016'da YouTube'un bu türde raporlar oluşturmayı durduracağı zamanı belirtir.

      • job kaynağının expireTime özelliği, işin süresinin dolduğu veya sona ereceği tarih ve saati belirtir. İşle ilişkili rapor türünün desteği sonlandırıldıysa veya iş için oluşturulan raporlar uzun süre indirilmediyse bu özelliğin bir değeri vardır. Bu tarih, YouTube'un artık iş için yeni rapor oluşturmayacağı zamanı gösterir.

      • report kaynağının jobExpireTime özelliği, raporla ilişkilendirilen işin süresinin dolduğu veya süresinin dolacağı tarih ve saati belirtir. Bu özellik, bu listenin bir önceki öğesinde açıklandığı gibi job kaynağındaki expireTime özelliği ile aynı değeri içerir.

    • Kullanımdan kaldırılmış bir rapor için iş oluşturmaya çalışırsanız jobs.create yöntemi artık 400 HTTP yanıt kodu (Bad Request) döndürüyor. Ayrıca, yöntemin belgelerinde artık bir API isteğinin başarısız olmasına yol açan diğer çeşitli nedenler de listelenmektedir.

    12 Nisan 2016

    Bu güncelleme, yalnızca YouTube Reporting API'yi etkileyen aşağıdaki değişiklikleri içerir:

    • YouTube artık raporlama işinin ilk planlandığı tarihten önceki 180 günlük dönemi kapsayan veriler oluşturmaktadır. Daha önce Reporting API geçmiş verileri yayınlamıyordu. Bu değişiklik, bu duyurudan önce oluşturulanlar da dahil olmak üzere tüm işleri etkiler.

      Geçmiş raporlar, kullanılabilir olur olmaz gönderilir. Bununla birlikte, bir iş için geçmiş verilerin tamamının yayınlanması yaklaşık bir ay sürer. Yani, bir raporlama işi planladıktan bir ay sonra, yaklaşık yedi aylık verilere erişiminiz olur. (Bu duyurudan önce oluşturulmuş işlerle ilgili tüm geçmiş veriler duyurudan itibaren bir ay içinde yayınlanmalıdır.)

      Geçmiş verilerin yalnızca 1 Temmuz 2015 itibarıyla kullanılabileceğini unutmayın. Sonuç olarak, 28 Aralık 2015'ten önce oluşturulan işlerin geçmiş verileri 180 günden daha az olacak.

      Bu değişikliklerin tümü, Reporting API'ye genel bakışın yeni geçmiş veriler bölümünde açıklanmaktadır.

    • YouTube Reporting API'ye genel bakışın rapor özellikleri bölümü aşağıdaki değişikliklerle güncellendi:

      • Söz konusu dokümanlarda artık raporların oluşturulduktan sonraki 180 gün süreyle kullanılabildiği ve bu nedenle API istemcileri tarafından indirilebildiği belirtilmektedir. Önceden dokümanlarda raporların, API isteğinin gönderildiği tarihten altı ay öncesine kadar kullanılabildiği belirtiliyordu.

      • Söz konusu dokümanlar, API'nin artık veri mevcut olmadığı günler için indirilebilir raporlar oluşturduğunu yansıtacak şekilde güncellenmiştir. Bu raporlar başlık satırları içerir ancak ek veri içermez.

    • YouTube Reporting API, yakında reklam geliri veya YouTube Red abonelik geliri verilerini içeren, otomatik olarak oluşturulmuş, sistem tarafından yönetilen bir grup raporu destekleyecek. Raporlar, halihazırda YouTube İçerik Stüdyosu'nda manuel olarak indirilebilir gelir raporlarına erişebilen içerik sahipleri tarafından kullanılabilecek. Bu nedenle, yeni API işlevi bu verilere programatik erişim sağlayacaktır.

      Sistem tarafından yönetilen raporların kullanıma sunulmasına hazırlık olarak aşağıdaki API değişiklikleri duyurulmaktadır:

      • job kaynağının yeni systemManaged özelliği, kaynağın sistem tarafından yönetilen raporlar oluşturan bir işi tanımlayıp tanımlamadığını gösterir. YouTube, YouTube içerik sahipleri için sistem tarafından yönetilen raporları otomatik olarak oluşturur ve içerik sahipleri bu raporları oluşturan işleri değiştiremez veya silemez.

      • jobs.list yönteminin yeni includeSystemManaged parametresi, API yanıtının sistem tarafından yönetilen raporlar için işleri içerip içermediğini gösterir. false, parametrenin varsayılan değeridir.

      • jobs.reports.list yönteminin yeni startTimeAtOrAfter parametresi, API yanıtının yalnızca rapordaki en eski verilerin belirtilen tarihte veya daha sonra olması durumunda rapor içermesi gerektiğini belirtir. Benzer şekilde startTimeBefore parametresi, API yanıtının yalnızca rapordaki en erken verilerin belirtilen tarihten önce olması durumunda rapor içermesi gerektiğini belirtir.

        Yöntemin, raporun oluşturulduğu zamanla ilişkilendirilen createdAfter parametresinden farklı olarak, yeni parametreler rapordaki verilerle ilişkilidir.

      • reportType kaynağının yeni systemManaged özelliği, kaynağın sistem tarafından yönetilen bir raporu tanımlayıp tanımlamadığını gösterir.

      • reportTypes.list yönteminin yeni includeSystemManaged parametresi, API yanıtının sistem tarafından yönetilen raporları içerip içermeyeceğini gösterir. false, parametrenin varsayılan değeridir.

    28 Mart 2016

    YouTube Reporting API ve YouTube Analytics API, artık çeşitli ek paylaşım hizmetleri için görüntüleme istatistiklerini döndürüyor.

    • YouTube Reporting API'deki sharing_service boyutu şu yeni değerleri destekler:
      • 82: iOS sistem etkinliği iletişim kutusu
      • 83: Google Gelen Kutusu
      • 84: Android Messenger
    • YouTube Analytics API'deki sharingService boyutu, şu yeni değerleri destekler:
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google Gelen Kutusu
      • IOS_SYSTEM_ACTIVITY_DIALOG: iOS sistem etkinliği iletişim kutusu

    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

    • playback_location_type boyutu, iki yeni boyut değerini destekler:
      • 7: Veriler, YouTube ana sayfası veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
      • 8: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
    • traffic_source_type boyutu, artık boyut değeri olarak 18 özelliğini desteklemektedir. Bu değer, video görüntüleme sayısının bir oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını gösterir. Bu kaynak, video bir oynatma listesinin parçası olarak video oynatılırken görüntülemelerin gerçekleştiğini belirten 14 kaynak türünden farklı.

    YouTube Analytics API

    • insightPlaybackLocationType boyutu, iki yeni boyut değerini destekler:
      • BROWSE: Veriler, YouTube ana sayfası veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
      • SEARCH: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
    • insightTrafficSourceType boyutu, artık boyut değeri olarak YT_PLAYLIST_PAGE özelliğini desteklemektedir. Bu değer, video görüntüleme sayısının bir oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını gösterir. Bu kaynak, video bir oynatma listesinin parçası olarak video oynatılırken görüntülemelerin gerçekleştiğini belirten PLAYLIST kaynak türünden farklıdır.

    8 Şubat 2016

    YouTube Analytics API için desteklenen metriklerin listesi, kart metrikleri artık ilgili API'de desteklenen metrikler olarak listelenmeyecek şekilde güncellendi. (Söz konusu API'nin raporlarının hiçbirinin, kart metriklerini desteklediği belgelenmemiştir.)

    Kart metriklerini, çok sayıda kanal ve içerik sahibi raporu için destekleyen YouTube Reporting API'yi kullanarak alabileceğinizi unutmayın.

    6 Ocak 2016

    YouTube Reporting API ve YouTube Analytics API, Chromecast cihazlarda gerçekleşen izlemeleri artık özel olarak tanımlıyor.

    • YouTube Reporting API'de operating_system boyutu, Chromecast üzerinden gerçekleşen görüntülemeleri tanımlamak için 21 değerini kullanır.
    • YouTube Analytics API'sinde operatingSystem boyutu, Chromecast üzerinden gerçekleşen görüntülemeleri tanımlamak için CHROMECAST değerini kullanır.

    21 Aralık 2015

    Dokümanlarda annotation_clickable_impressions ve annotation_closable_impressions metriklerinin adları, raporlarda döndürülen adlarla eşleşecek şekilde güncellenmiştir. Önceden, adlar clickable_annotation_impressions ve closable_annotation_impressions olarak belgeleniyordu.

    18 Aralık 2015

    Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli açıklamalar yapılmasını ve bu kullanıcılardan izin alınmasını zorunlu kılar. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekmektedir. YouTube API Hizmet Şartlarımıza bu şartla ilgili bir bildirim ekledik.

    15 Aralık 2015

    Bu güncelleme, YouTube Analytics API'yi etkileyen aşağıdaki değişiklikleri içermektedir:

    • YouTube Analytics API artık çeşitli kanal ve içerik sahibi raporlarında kullanılabilen üç yeni oynatma ayrıntısı boyutunu destekliyor:

      • liveOrOnDemand: Bu boyut, rapordaki verilerin canlı yayın sırasında gerçekleşen kullanıcı etkinliğini açıklayıp açıklamadığını gösterir.
      • subscribedStatus: Bu boyut, verilerdeki kullanıcı etkinliği metriklerinin videonun veya oynatma listesinin kanalına abone olan izleyicilerle ilişkilendirilip ilişkilendirilmediğini gösterir.
      • youtubeProduct: Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube mülkünü tanımlar. Olası değerler şunlardır: temel YouTube web sitesi (veya YouTube uygulaması), YouTube Oyun ve YouTube Çocuk.

      Söz konusu dokümanlar, kanallar ve içerik sahipleri tarafından kullanılabilen yeni oynatma ayrıntıları raporlarını tanımlayacak şekilde güncellendi. Ayrıca, bu boyutlardan bir ya da daha fazlasının söz konusu raporlarda isteğe bağlı olarak boyut ve/veya filtre olarak kullanılabileceğini belirtmek üzere daha birçok rapor güncellenmiştir.

    • Raporları açıklayan tabloların biçimi, her bir raporu almak için kullanılabilecek geçerli boyut, metrik ve filtre kombinasyonlarını belirlemenizi kolaylaştırmak amacıyla değiştirilmiştir. Kanallar için "Cihaz Türü" raporunun açıklandığı aşağıdaki tabloda yeni biçim gösterilmektedir:

      İçindekiler
      Boyutlar:
      Gerekli deviceType
      0 veya daha fazlasını kullanın day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Metrikler:
      1 veya daha fazlasını kullanın görüntülemeler, estimatedMinutesWatched
      Filtreler:
      0 veya 1 kullanın ülke, il, kıta, subContinent
      0 veya 1 kullanın video, grup
      0 veya daha fazlasını kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Zorunlu ve isteğe bağlı alanları açıklayan terminoloji, kanal ve içerik sahibi raporlarına ilişkin dokümanlarda açıklanmıştır.

    • YouTube Analytics API, API kullanıcısının birden çok değeri (video, playlist ve channel) destekleyen filtrelerden veri alamadığı öğeleri artık otomatik olarak kaldırıyor. Daha önce, API kullanıcısı belirtilen öğelerden en az birinin verilerine erişememesi durumunda API sunucusu hata döndürüyordu.

      Örneğin, bir kullanıcının video filtresinde 20 video kimliği listelendiği bir API isteği gönderdiğini varsayalım. Kullanıcı, videolardan 18'ine sahiptir. Bununla birlikte, bir video kimliği başka bir kanala ait videoyu, başka bir kimlik ise silinen ve bu nedenle artık mevcut olmayan bir videoyu tanımlar. Bu durumda API sunucusu, hata döndürmek yerine artık kullanıcının erişemediği iki videoyu bırakır ve API yanıtı, API kullanıcısının sahip olduğu 18 videoyla ilgili verileri içerir.

    • Boş bir YouTube Analytics group için veri isteğinde bulunursanız API artık hata yerine boş bir veri kümesi döndürür.

    • Bir gruba öğe eklemeye çalışırsanız ancak söz konusu varlığa erişiminiz yoksa YouTube Analytics API'nin groupItems.insert yöntemi artık yetkisiz (403 HTTP yanıt kodu) hatası döndürüyor. Daha önce API, varlığı gruba eklemenize izin veriyordu, ancak daha sonra söz konusu grubun rapor verilerini almaya çalıştığınızda yetkisiz bir hata döndürüyordu.

    • YouTube Analytics API'nin groups.list yöntemi artık sayfalara ayırmayı desteklemektedir. API yanıtı mevcut tüm grupları içermiyorsa yanıtın nextPageToken parametresi, sonraki sonuç sayfasını almak için kullanılabilecek bir jeton belirtir. Ek sonuçlar almak için yöntemin pageToken parametresini bu değere ayarlayın.

    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:

    • YouTube Reporting API'nin date boyutuyla ilgili dokümanlar, tarihlerin Pasifik saatiyle 00:00'dan (UTC-8) başlayan 24 saatlik dönemi ifade ettiğini yansıtacak şekilde düzeltildi. Daha önce, dokümanlarda tarihin 00:00'da (GMT) başladığı belirtiliyordu.

      Ayrıca YouTube Analytics API dokümanları, tarihle ilgili tüm boyutların (day, 7DayTotals, 30DayTotals ve month) Pasifik saatiyle 00:00'dan (UTC-8) başlayan tarihleri kapsadığını belirtecek şekilde güncellenmiştir.

    • YouTube Reporting API'nin jobs.reports.list() yöntemi artık createdAfter sorgu parametresini destekliyor. Belirtilirse bu parametre, API yanıtının yalnızca belirtilen tarih ve saatten sonra oluşturulan raporları (doldurulmuş verilerle yeni raporlar dahil) listeleyeceğini belirtir. Parametre değerinin döndürülen verilerle ilişkili tarihlerle değil, raporun oluşturulduğu zamanla ilgili olduğunu unutmayın.

      Parametre değeri, RFC3339 UTC "Zulu" biçiminde ve mikrosaniyelik doğrulukta bir zaman damgasıdır. Örnek: "2015-10-02T15:01:23.045678Z".

      YouTube Reporting API'nin en iyi uygulamaları, aynı raporun tekrar tekrar işlenmesini önlemek için createdAfter parametresini nasıl kullanabileceğinizi açıklayacak şekilde güncellendi.

    • job kaynağının createTime özelliği ile report kaynağının startTime, endTime ve createTime özelliklerinin tümü, özellik değerlerinin nanosaniye cinsinden değil, mikrosaniye cinsinden doğru olduğunu belirtecek şekilde düzeltildi. Ayrıca, tüm tanımlar artık özellik değerinin bir zaman damgası olduğunu doğru bir şekilde yansıtmaktadır.

    8 Ekim 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Analytics API'nin sharingService boyutuyla ilgili belgeler, olası boyut değerlerinin listesini içerecek şekilde güncellendi. Listede yeni desteklenen hizmetler bulunur.

      YouTube Reporting API'nin sharing_service boyutunun tanımı da yeni desteklenen değerleri listeleyecek şekilde güncellendi. 59 değerinden büyük olan numaralandırma değerleri, listedeki yeni değerlerdir.

    24 Eylül 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Yeni YouTube Reporting API, bir kanal veya içerik sahibi için YouTube Analytics verilerini içeren toplu veri raporlarını alır. Büyük veri kümelerini içe aktarabilen ve bu verileri filtrelemek, sıralamak ve madencilik yapmak için araçlar sunan uygulamalar için tasarlanmıştır.

      Her YouTube Reporting API raporu, önceden tanımlanmış bir boyut ve metrik grubu içerir. (YouTube Analytics API raporlarında metrikler ve boyutlar da kullanılır.) Raporlarda, her veri satırında benzersiz bir boyut değerleri kombinasyonu bulunur. Tek tek videolar, ülkeler, canlı videolar, abone olan kullanıcılar vb. için metrikleri hesaplamak amacıyla satırlardaki verileri boyut değerlerine göre birleştirebilirsiniz.

      Her biri YouTube'un oluşturması gereken bir raporu tanımlayan raporlama işlerini planlamak için API'yi kullanabilirsiniz. Bir iş oluşturmanızın ardından YouTube, eşzamansız olarak indirilebilen günlük bir rapor oluşturur. Her raporda benzersiz bir 24 saatlik döneme ait veriler bulunur.

    • Farklı API'ler olmalarına rağmen YouTube Analytics API ve YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini alabilmelerini sağlar. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'nin dokümanları tek bir belge grubu olarak yayınlanmaktadır.

      • Doküman grubundaki Kılavuzlar sekmesi, API isteklerini yetkilendirme talimatları dahil olmak üzere her iki API'de ortak olan bilgileri içerir.
      • Toplu raporlar sekmesinde, referans belgeleri ve YouTube Reporting API'ye özel diğer içerikler yer alır.
      • Hedeflenen sorgular sekmesinde, referans belgeleri ve YouTube Analytics API'ye özel diğer içerikler yer alır.
      • Örnekler sekmesinde, iki API'den biri için kullanılabilen kod örnekleri listelenir.
      • Araçlar sekmesinde, geliştiricilerin bu iki API'den birini uygulamasına yardımcı olmak için kullanılabilecek ek kaynaklar listelenir.

    20 Ağustos 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API belgeleri, API'nin daha kolay anlaşılmasını sağlamak amacıyla yeniden yapılandırıldı. Dolayısıyla, bu değişiklikler yeni özellikleri açıklamaz:

      • Dokümanlar artık mevcut tüm kanal raporlarının listelendiği bir sayfa ve mevcut tüm içerik sahibi raporlarının listelendiği başka bir sayfa içeriyor. Önceden bu dokümanlarda kanal video raporları, kanal oynatma listesi raporları ve benzerleri için ayrı sayfalar bulunuyordu.

      • Yeni veri modeline genel bakış, API'nin nasıl çalıştığına dair daha net bir tanıtım sağlamayı amaçlar. Bu belgede özellikle, YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığı daha iyi açıklanmaktadır.

      • API'nin raporları almak için kullandığınız reports.query yöntemi artık ayrı olarak belgelenmektedir. Söz konusu sayfadaki bilgiler daha önce başka sayfalardaydı. Yeni sayfa, rapor almak için göndermeniz gereken bilgileri daha kolay bir şekilde tanımlamanıza yardımcı olacak şekilde tasarlanmıştır.

    22 Temmuz 2015

    Bu güncelleme yalnızca içerik sahipleri için geçerli olan birkaç değişiklik içeriyor:

    • Yeni adEarnings metriği, Google tarafından satılan tüm reklam kaynaklarından elde edilen toplam tahmini kazançları (net gelir) içerir. Temel bir metrik değildir. API, earnings metriğini zaten destekleyen tüm raporlar için adEarnings metriğini destekler.

      Ayrıca, earnings metriğinin tanımı, değerinin Google tarafından satılan tüm reklam kaynaklarının yanı sıra reklam dışı kaynaklardan elde edilen toplam tahmini kazançları içerdiğini yansıtacak şekilde düzeltildi. Daha önce tanım, hatalı bir şekilde, metriğin yalnızca reklam kaynaklarından gelen kazançları içerdiğini belirtiyordu.

    • primaryAdGrossRevenue metriği kullanımdan kaldırıldı. Bunun yerine, gelir verilerini almak için grossRevenue metriğini kullanın.

    • Kullanımdan kaldırılan primaryAdGrossRevenue metriğine ek olarak, reklam performansı raporları artık monetizedPlaybacks ve playbackBasedCpm metriklerini desteklememektedir. Bununla birlikte, bazı video raporları bu metrikleri desteklemeye devam etmektedir.

    1 Haziran 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API artık video raporları için iki yeni metriği destekliyor: videosAddedToPlaylists ve videosRemovedFromPlaylists. Hem kanallar hem de içerik sahipleri için video raporu listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.

      • videosAddedToPlaylists: Sorgu kapsamındaki videoların herhangi bir YouTube oynatma listesine eklenme sayısıdır. Videolar, video sahibinin oynatma listesine veya diğer kanalların oynatma listelerine eklenmiş olabilir.
      • videosRemovedFromPlaylists: Sorgu kapsamındaki videoların YouTube oynatma listelerinden kaldırılma sayısıdır. Videolar, video sahibinin oynatma listesinden veya diğer kanalların oynatma listelerinden kaldırılmış olabilir.

      Her iki metrik de "Daha Sonra İzle" oynatma listesi gibi varsayılan oynatma listelerini içerir. Ancak kanalın yüklenen oynatma listesi veya kullanıcının izleme geçmişi gibi videoların otomatik olarak eklendiği oynatma listeleri bu kapsamda yer almaz. Ayrıca bu metriklerin mutlak ekleme ve silme sayısını yansıttığını da unutmayın. Yani bir kullanıcı bir oynatma listesine video ekler, sonra kaldırır ve sonra tekrar eklerse metrikler videonun iki oynatma listesine eklendiğini ve bir oynatma listesinden kaldırıldığını gösterir.

      Bu metriklere ilişkin veriler 1 Ekim 2014 tarihinden itibaren kullanılabilmektedir.

    31 Mart 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • favoritesAdded ve favoritesRemoved metriklerinin ikisi de bu duyuru tarihinden itibaren geçerli olacak şekilde kullanımdan kaldırılmıştır. Bunlar hem temel metriklerdir hem de hizmet şartlarında belirtilen Kullanımdan Kaldırma Politikası'na tabidir.

    16 Mart 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Yeni currency parametresi, kazanç metriklerini ABD doları (USD) dışındaki bir para biriminde almanızı sağlar. Parametre ayarlanmışsa API, earnings, grossRevenue, playbackBasedCpm ve impressionBasedCpm metriklerinin değerlerini belirtilen para birimine dönüştürür. Döndürülen değerler, günlük olarak değişen döviz kurları kullanılarak hesaplanan tahmini değerlerdir.

      Parametre değeri üç harfli bir ISO 4217 para birimi kodudur. Varsayılan değer: USD. Parametre tanımı, desteklenen para birimi kodlarının listesini içerir.

    25 Şubat 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API artık YouTube Analytics grupları oluşturma ve yönetmenin yanı sıra bu gruplar için rapor verilerini alma özelliğini de desteklemektedir.

      • Grup oluşturma ve yönetme

        Bu güncellemeyle grup oluşturma ve yönetmeyle ilgili group ve groupItem kaynakları kullanıma sunulmuştur.

        • group kaynağı, bir Analytics grubunu temsil eder. Analytics grubu 200 adede kadar kanal, video, oynatma listesi veya öğeden oluşan bir özel koleksiyondur. API, bu kaynak için list, insert, update ve delete yöntemlerini destekler.
        • groupItem kaynağı, Analytics grubundaki bir öğeyi temsil eder. API, bu kaynak için list, insert ve delete yöntemlerini destekler.

        Örneğin, groups.insert yöntemini kullanarak bir grup oluşturabilir ve ardından groupItems.insert yöntemini kullanarak bu gruba öğeler ekleyebilirsiniz.

      • Bir grup için rapor verileri alma

        Boyutlar dokümanları, birçok kanal raporu ve içerik sahibi raporu için filtre olarak kullanılabilecek group boyutunu içerecek şekilde güncellendi. group filtresini kullandığınızda API, söz konusu gruptaki tüm öğelerin verilerini döndürür. API'nin şu anda öğe grupları için rapor oluşturma özelliğini desteklemediğini unutmayın.

      YouTube Analytics grupları hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.

    13 Şubat 2015

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API artık show boyutunu desteklemiyor.

    28 Ağustos 2014

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API artık video, playlist, channel ve show boyutları filtre olarak kullanıldığında bu boyutlar için birden fazla değer belirtme özelliğini destekliyor. Birden fazla değer belirtmek için filters parametre değerini API yanıtının filtrelenmesi gereken video, oynatma listesi, kanal veya program kimliklerinin virgülle ayrılmış listesine ayarlayın. Parametre değeri en fazla 200 kimlik belirtebilir.

      Aynı filtre için birden çok değer belirtirseniz o filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu, filtre belirli bir rapor için desteklenen boyut olarak listelenmemiş olsa bile geçerlidir. Filtreyi boyutlar listesine eklerseniz API, sonuçları gruplandırmak için filtre değerlerini de kullanır.

      Bu işlevle ilgili tüm ayrıntılar için filters parametre tanımına bakın.

    16 Temmuz 2014

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Bir kanal raporu alırken, artık ids parametresinin değerini channel==MINE olarak ayarlayarak kimliği doğrulanmış kullanıcının kanalı için verileri alabilirsiniz. (Belirtilen kanalın verilerini almak için ids parametresini channel==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 ve estimatedMinutesWatched metriklerini, bazıları da averageViewDuration metriğini destekler.

      Buna ek olarak tüm oynatma listesi raporları aşağıdaki yeni metrikleri destekler. Bu metriklerin her birinin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini yansıttığını unutmayın.

      • playlistStarts: İzleyicilerin bir oynatma listesini başlatma sayısı.
      • viewsPerPlaylistStart: Bir oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme sayısıdır.
      • averageTimeInPlaylist: Oynatma listesi başlatıldıktan sonra izleyicinin oynatma listesindeki videoları izlediği dakika cinsinden tahmini ortalama süredir.

      Oynatma listesi raporu alma isteklerinde isCurated filtresinin kullanılması gerekir. Bu filtre 1 (isCurated==1) olarak ayarlanmalıdır.

    • API artık kitleyi elde tutma raporunu desteklemektedir. Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. Raporun yeni elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için geçen video miktarını ölçer:

      • audienceWatchRatio metriği, videonun belirli bir noktasında videoyu izleyen izleyicilerin mutlak oranını belirtir. Bu oran, videonun bir bölümünün izlenme sayısının toplam görüntülenme sayısıyla karşılaştırılmasıyla hesaplanır.

        Belirli bir video görüntülemesinde videonun bir bölümünün birden fazla kez izlenebileceğini (veya hiç izlenmeyeceğini) unutmayın. Örneğin, kullanıcılar bir videoyu geri sarıp videonun aynı bölümünü birden çok kez izlerse videonun bu bölümünün mutlak oranı, 1 değerinden daha büyük olabilir.

      • relativeRetentionPerformance metriği, videonun oynatmalar sırasında benzer uzunluktaki tüm YouTube videolarına kıyasla izleyicileri elde tutmada ne kadar başarılı olduğunu gösterir. 0 değeri, videonun benzer uzunluktaki diğer tüm videolardan daha kötü bir şekilde izleyicileri elde tuttuğunu belirtirken 1 değeri, videonun izleyicileri benzer uzunluktaki diğer tüm videolardan daha iyi tuttuğunu ifade eder. Ortanca değer 0,5 ise benzer uzunluktaki videoların yarısının izleyicileri daha iyi tutarken yarısının daha kötü izleyicileri elde tuttuğunu gösterir.

      Raporun yalnızca organik görüntülemeler, Yayın içi (In-stream) TrueView reklamlarındaki görüntülemeler veya Görüntülü (In-display) TrueView reklamlarındaki görüntülemelerle ilişkili verileri döndürmesi için audienceType filtresini de kullanabilirsiniz. (Organik görüntülemeler, video araması veya önerilen bir videonun tıklanması gibi kullanıcı işlemlerinin doğrudan sonucudur.)

    • API, ek açıklamalarla ilgili birtakım yeni metrikleri destekler. Aşağıda listelenen metrikler, daha önce annotationClickThroughRate ve annotationCloseRate metriklerini destekleyen tüm raporlarla alınabilir.

      Yeni metriklerin tümü temel metrikler olup Kullanımdan Kaldırma Politikası'na tabidir. Ancak, yeni metrikler için 16 Temmuz 2013 tarihinden itibaren kullanılabilir verilerin bulunduğunu unutmayın. (annotationClickThroughRate ve annotationCloseRate metriklerine ilişkin veriler 10 Haziran 2012 tarihinden itibaren mevcuttur.)

    • GOOGLE_SEARCH artık insightTrafficSourceType boyutu için ayrı bir değer olarak raporlanmamaktadır. Bunun yerine, Google arama sonuçlarından gelen yönlendirmeler artık EXT_URL trafik kaynağı türüyle ilişkilendiriliyor. Bu nedenle, insightTrafficSourceType filtresini GOOGLE_SEARCH olarak ayarlayan bir insightTrafficSourceDetail raporu alınması da artık mümkün değildir.

    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:

    • Örnek istekler dokümanı, kanal ve içerik sahibi raporları için yakın zamanda kullanıma sunulana benzer bir sekme biçimi kullanılarak, örnekleri kategoriler halinde gruplandıracak şekilde yeniden tasarlandı. Yeni tasarımda, örnekler aşağıdaki kategorilere göre gruplandırılır:

      • Temel istatistikler
      • Zamana dayalı
      • Coğrafi
      • Oynatma konumu
      • Trafik kaynağı
      • Cihaz/İşletim Sistemi
      • Demografik grup
      • Sosyal
      • Kazançlar/Reklamlar (yalnızca içerik sahibi raporları için)

    • Örnek talepler belgesi, artık kanal raporlarında veya içerik sahibi raporlarında bölgeye özel verilerin alınmasına ilişkin yeni örnekler içeriyor.

      • ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler: Bu rapor, kanal videolarına ilişkin görüntüleme sayılarının ve diğer istatistiklerin eyalet bazında dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.yi kapsar. Örnekte province boyutu ve ayrıca, yanıtı yalnızca ABD ile ilgili sonuçları içerecek şekilde kısıtlamak için filters parametresi kullanılır.

      • Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet): Bu rapor, bir kanalın videolarını izleyen Kaliforniya'daki izleyicilerin yaş grubu ve cinsiyetiyle veya içerik sahibinin raporlarında içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili istatistikleri alır. Bu örnekte, yanıtın yalnızca belirli bir ille ilgili verileri içermesi için filters parametresi kullanılmıştır.

    • province boyutunun tanımı, dimensions parametre değerine province eklendiğinde, isteğin filters parametre değerine country==US eklenerek verilerin ABD ile kısıtlanması gerektiğini de belirtecek şekilde güncellendi.

    6 Ocak 2014

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Desteklenen kanal ve içerik sahibi raporlarını listeleyen dokümanlar yeniden tasarlandı. Her doküman, tüm olası raporları listeleyen bir tablo sağlamak yerine, raporları kategoriler halinde gruplandırır:

      • Temel istatistikler
      • Zamana dayalı
      • Coğrafi
      • Oynatma konumu
      • Trafik kaynağı
      • Cihaz/İşletim Sistemi
      • Demografik grup
      • Sosyal
      • En popüler videolar

      Her dokümanda bu kategoriler bir sekme listesi olarak görüntülenir ve herhangi bir sekmeyi tıklayarak o kategoride desteklenen raporları görebilirsiniz.

    • API artık üç yeni coğrafi boyutu destekliyor: province, continent ve subContinent.

      • province boyutu, ABD eyaletleri ve District of Columbia ile ilgili istatistikleri almanızı sağlar. API, bu boyutun iki kullanımını destekler:

        • API, istatistikleri duruma göre ayıran iki raporu destekler. Her iki rapor da kanallar ve içerik sahipleri tarafından kullanılabilir.

          • Temel istatistik raporu, görüntüleme sayısı ve tahmini izlenen dakika sayısı gibi çeşitli istatistikler sağlar.
          • Zamana dayalı rapor aynı istatistikleri sağlar, ancak verileri günlük, 7 günlük, 30 günlük veya aylık olarak toplar.

        • Bir raporu yalnızca belirli bir duruma ait istatistikleri içerecek şekilde sınırlamak için filters sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografik raporlar ve en çok görüntülenen video raporları dahil olmak üzere çeşitli raporlar bu filtreleme türünü destekler.

      • continent boyutu, bir kıtayı tanımlayan Birleşmiş Milletler (BM) istatistiksel bölge kodunu belirtir. Bu boyut yalnızca filtre olarak kullanılabilir.

      • subContinent boyutu, bir kıtanın alt bölgesini tanımlayan Birleşmiş Milletler (BM) istatistiksel bölge kodunu belirtir. Bu boyut yalnızca filtre olarak kullanılabilir.

        Her alt bölge yalnızca bir kıtayla ilişkili olduğundan, subContinent filtresini kullanırken continent filtresini de kullanmanız gerekmez. (Aslında, bir istek her iki boyutu da kullanıyorsa API bir hata döndürür.)

    • Dokümanlar düzeltildi. Böylece, insightTrafficSourceDetail boyutu geçerli filtre değeri olarak insightTrafficSourceType PROMOTED değerini içermeyecek.

    30 Eylül 2013

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Analytics API artık Hizmet Şartları'nda açıklanan Kullanımdan Kaldırma Politikası'na tabidir. Ancak API'nin temel olmayan boyutları ve temel olmayan metrikleri, Kullanımdan Kaldırma Politikası'na tabi değildir. Boyutlar ve metrics sayfaları, temel boyutları ve temel metrikleri listeleyecek şekilde güncellendi. Ayrıca bu sayfalardaki tanımlar, temel boyutları ve metrikleri açıkça tanımlayacak şekilde güncellendi.

    • API artık insightPlaybackLocationType boyutu için değer olarak EXTERNAL_APP değerini desteklemektedir. Bu güncellemeyle birlikte 10 Eylül 2013 itibarıyla oynatmalar artık MOBILE oynatma olarak kategorize edilmeyecektir. Bununla birlikte, bu tarihten önce gerçekleşen mobil oynatmalar bu değerle sınıflandırılmaya devam edecektir.

      Bu güncellemeyle birlikte mobil oynatmalar, oynatmaların gerçekleştiği uygulamanın türüne bağlı olarak artık WATCH, EMBEDDED veya EXTERNAL_APP olarak sınıflandırılıyor.

    • API artık insightTrafficSourceType boyutu için değer olarak PLAYLIST değerini desteklemektedir. Değer, video görüntülemelerinin bir oynatma listesinden yönlendirildiğini gösterir. Daha önce bu görüntülemeler boyutun YT_OTHER_PAGE kategorisi kullanılarak sınıflandırılırdı.

    16 Temmuz 2013

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API artık raporları birden fazla boyut ve metriğe göre sıralama özelliğini desteklemektedir. Örnek istekler dokümanı, bu işlevin gösterildiği İstekleri birden fazla boyuta/metriğe göre sıralama adlı yeni bir örnek içeriyor. İstek, trafik kaynağı verilerini alır ve sort parametre değeri day,-views olur. Sonuçlar kronolojik olarak sıralanır ancak her güne ait sonuç kümesinde, ilk satırda en çok görüntüleme sağlayan trafik kaynağına ilişkin veriler, ikinci satırda ise bir sonraki en yüksek görüntüleme sayısına sahip olan kaynağa ait veriler yer alır ve bu böyle devam eder.

    • API artık iki yeni boyutu destekliyor: deviceType ve operatingSystem. Bu boyutlar, izleyicilerin videolarınızı izlediği cihazlarla ilgili verileri almak için kullanılabilir. API, boyutlardan birinin veya her ikisinin kullanıldığı raporları destekler.

      • deviceType raporu; masaüstü, mobil ve tablet cihazlar dahil olmak üzere farklı cihaz türleri için görüntüleme sayılarını ve tahmini izlenme süresini görmenize olanak tanır. Cihaz türü raporunu yalnızca Android veya iOS gibi belirli bir işletim sistemini çalıştıran cihazlara ilişkin istatistikleri içerecek şekilde sınırlandırmak için operatingSystem filtresini de kullanabilirsiniz.

      • operatingSystem raporu; Android, iOS, Linux gibi farklı işletim sistemleri için görüntüleme sayılarını ve tahmini izlenme sürelerini almanızı sağlar. İşletim sistemi raporunu yalnızca mobil cihazlar veya tabletler gibi belirli bir cihaz türüne ilişkin istatistikleri içerecek şekilde sınırlamak için deviceType filtresini de kullanabilirsiniz.

      Yeni cihaz türü ve işletim sistemi raporları, kanallar ve içerik sahipleri tarafından kullanılabilir.

    • Örnek istekler dokümanı, kanallar için üç cihaz raporu ve içerik sahipleri için üç cihaz raporu içerecek şekilde güncellendi.

    • insightPlaybackLocationType boyutu, YT_OTHER değerini döndürebilir. Bu değer, bu boyuttaki diğer değerlerden biri kullanılarak sınıflandırılmayan görünümleri tanımlar.

    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:

    • API artık görüntüleme metrikleri, etkileşim metrikleri, kazanç metrikleri ve reklam performansı metrikleri gibi diğer metriklerle birlikte izlenme süresi metriklerini (estimatedMinutesWatched, averageViewDuration ve averageViewPercentage) alma özelliğini destekliyor.

      Mevcut kanal raporlarının ve içerik sahibi raporlarının listesi, bu değişikliği yansıtacak şekilde güncellenmiştir. (İzlenme süresi metrikleri, listelenen diğer raporların bir parçası olarak alınabildiği için listeler artık daha kısadır.)

      Örnek API istekleri belgesi de güncellendi.

    • insightPlaybackLocationDetail ve insightTrafficSourceDetail boyutlarını kullanan raporlar aşağıdaki şekillerde iyileştirilmiştir:

      • Artık isteğe bağlı country filtresini destekliyorlar.

      • İçerik sahipleri artık bu raporları aşağıdaki yeni filter kombinasyonlarından herhangi birini kullanarak alabilir. Tüm bu kombinasyonların isteğe bağlı country filtresini de desteklediğini unutmayın.

        • Oynatma konumu ayrıntısı

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • Trafik kaynağı ayrıntıları

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    3 Mayıs 2013

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Yeni Örnek API istekleri belgesinde, YouTube Analytics API kullanılarak çeşitli rapor türlerinin nasıl alınacağını gösteren örnekler yer almaktadır. Her örnek, isteğin aldığı raporun kısa bir açıklamasını içerir ve ardından isteğe ilişkin boyutları, metrikleri, filtreleri ve sıralama parametrelerini gösterir.

    • insightTrafficSourceType boyutu, artık geçerli değer olarak SUBSCRIBER değerini desteklemektedir. Bu değer, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden gelen video görüntüleme sayısını belirtir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, ana sayfa feed'ini veya görüntülemelerin yönlendirildiği diğer sayfayı belirtir.

    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:

    • API artık kazanç ve reklam performansı metriklerinin yanı sıra yeni reklam performansı raporlarını da destekliyor. Metriklere ve raporlara yalnızca YouTube İş Ortağı Programı'na katılan YouTube içerik iş ortakları erişebilir.

      • Yeni desteklenen raporlar, oynatmaya dayalı reklam performansı metriklerini ve gösterime dayalı reklam performansı metriklerini destekler. Reklam performans raporları hakkında daha fazla bilgi için içerik sahibi raporları dokümanlarına bakın.

      • Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporlarının listesi, bu metrikleri destekleyen iki yeni rapor da dahil olmak üzere raporları tanımlayacak şekilde güncellendi.

        • earnings – Google tarafından satılan tüm reklam kaynaklarından elde edilen toplam tahmini kazançlar.
        • grossRevenue – Google veya DoubleClick iş ortaklarından elde edilen tahmini brüt gelir.
        • primaryAdGrossRevenue - Google veya DoubleClick iş ortaklarından gelen, raporun kapsadığı video oynatmaları için birincil reklam türü altında toplanıp sınıflandırılan tahmini brüt gelir.
        • monetizedPlaybacks: En az bir reklam gösteriminin gösterildiği oynatmaların sayısıdır.
        • playbackBasedCpm – Bin oynatma başına tahmini brüt gelir.
        • impressions - Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
        • impressionBasedCpm – Bin reklam gösterimi başına tahmini brüt gelir.

        Not: Tüm ayrıntılar için metrik tanımlarını inceleyin.

      • Kazançları veya reklam performansı metriklerini alan tüm istekler, yeni https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamını kullanarak erişim izni veren bir yetkilendirme jetonu göndermelidir.

    • API belgeleri, farklı rapor türlerinin ayrı sayfalarda açıklanacağı şekilde yeniden düzenlendi. Bu nedenle, artık farklı kanal raporu ve içerik sahibi raporu türlerini açıklayan ayrı sayfalar bulunuyor.

    4 Şubat 2013

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API'nin referans kılavuzunda artık bir examples bölümü var. Bu bölümde Java, JavaScript, Python ve Ruby istemci kitaplıklarını kullanarak API'nin nasıl çağrılacağını gösteren kod örnekleri yer alıyor. JavaScript kod örneği, örnek uygulama dokümanlarında ayrıntılı olarak açıklanan örnekle aynıdır.

    14 Kasım 2012

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • API referans kılavuzunda artık API'yi çağırmanızı, API isteğini görmenizi ve yanıtta gerçek verileri almanızı sağlayan APIs Explorer bulunuyor.

    • Bu API, hem kanallar hem de içerik sahipleri için aşağıda açıklanan bir dizi yeni raporu desteklemektedir. Her rapor, kanal raporu veya içerik sahibi raporu olarak sunulur. Boyutlar ve metrics sayfaları da uygun şekilde güncellendi.

      • Oynatma konumu raporu, farklı türlerdeki sayfalarda veya uygulamalarda gerçekleşen video görüntülemelerinin sayısını belirtir.

      • Oynatma konumu ayrıntı raporu, belirli bir video için en çok görüntülemeyi oluşturan yerleşik oynatıcıları tanımlar. En iyi yerleştirilmiş oynatıcılarla ilişkili URL'leri belirleyerek oynatma konumu raporuna göre daha ayrıntılı bir görünüm sunar.

      • Trafik kaynağı raporu, farklı yönlendiren türlerinden kaynaklanan video görüntülemelerinin sayısını tanımlar.

      • Trafik kaynağı ayrıntı raporu, belirtilen bir video ve belirtilen trafik kaynağı türü için en çok görüntülemeyi oluşturan yönlendirenleri tanımlar. Örneğin bu rapor, belirli bir videoya en çok trafik gönderen ilgili videoları gösterir. Bu rapor çeşitli trafik kaynakları için desteklenir.

      • İzlenme süresi raporları, izleyicilerin içeriklerinizi izlerken geçirdiği süreyi gösterir. Raporlar, belirli bir zaman dilimi (gün, önceki yedi gün, önceki 30 gün vb.) veya ülke için verileri birleştirebilir. Bir rapor, verileri güne veya ülkeye göre topluyorsa, her video görüntülemesinin ortalama uzunluğunun yanı sıra, her videonun kullanıcıların izlediği ortalama yüzdesini de belirtebilir.

    2 Ekim 2012

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • YouTube Analytics API artık tüm geliştiricilerin kullanımına sunulmuştur. Önceden erişim isteğinde bulunmak zorunda kalmadan, APIs console üzerindeki Hizmetler panelinden projeniz için API'yi etkinleştirebilirsiniz.

    • Yeni Başlarken bölümü, YouTube Analytics API kullanan bir uygulama oluşturmaya ilişkin ön koşulları ve temel adımları özetler.

    12 Eylül 2012

    Bu güncelleme aşağıdaki değişiklikleri içerir:

    • Yeni kota kullanımını anlama bölümü, API kota kullanımınızı optimize etmeye ilişkin yönergeler sağlar. API sunucusu, her istek için bir sorgu maliyeti hesaplar ve bu maliyet, API kullanım kotanızdan düşülür. Farklı rapor türleri çok farklı sorgu maliyetlerine sahip olabileceğinden kotanızı verimli bir şekilde kullanmayı planlamalısınız. Uygulamanız yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemelidir.

    • Geçici boyutlar bölümü, bu boyutların, Analytics raporunun verileri belirli bir döneme göre toplaması gerektiğini belirttiğini açıklayacak şekilde güncellenmiştir. API artık aşağıdaki ek zamansal boyutları desteklemektedir:

      • 7DayTotals – Rapordaki veriler, her satırda yedi günlük bir döneme ait veriler yer alacak şekilde toplanır.
      • 30DayTotals – Rapordaki veriler, her satırda 30 günlük bir döneme ait veriler yer alacak şekilde toplanır.
      • month - Rapordaki veriler takvim ayına göre toplanır.

      Benzer şekilde, kullanılabilir raporlar bölümü de API'nın bu boyutları kullanan raporlara verdiği desteği yansıtacak şekilde güncellenmiştir.

    • Raporlama varlığı boyutları bölümü, içerik sahibi raporlarını almaya yönelik API isteklerinin, verileri bu boyutlardan birini (video, channel veya show) ya da claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak filtrelemesi gerektiğini bildirmek için güncellendi.

    • API artık en çok görüntülenen video raporları için iki yeni sıralama seçeneğini destekliyor. Kanal raporları veya içerik sahibi raporları olarak sunulan bu raporlarda, ülke bazında metrikler (görüntüleme sayısı, yorumlar, beğeniler vb.) yer alır ve bu metrikler videoya göre ayrılır. Artık bu raporları, videonun izleme sayfasından bir kanala abone olan veya kanal aboneliğinden çıkan kullanıcıların sayısına göre sıralayabilirsiniz.

    • subscribersGained ve subscribersLost metrics tanımları, bir kanalın video izleme sayfası, kanal sayfası ve YouTube ana sayfasında gösterilen rehber gibi çeşitli yerlerde abone kazanabileceğini veya kaybedebileceğini açıklayacak şekilde güncellendi. Bu metrikler videoya özel bir raporda göründüğünde, yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.