Düzeltme Geçmişi

Bu sayfada, hem YouTube Reporting API hem de YouTube Analytics API ile ilgili API değişiklikleri ve doküman güncellemeleri listelenmektedir. Her iki API de geliştiricilerin YouTube Analytics verilerine farklı şekillerde erişmesine olanak tanır. Bu değişiklik kaydına abone olun. Abone ol

15 Kasım 2024

Not: Aşağıdaki değişiklik 18 Kasım 2024'ten itibaren geçerlidir.

YouTube Analytics (Hedeflenen Sorgular) API dokümanları, Trafik Kaynağı raporları için API'nin reports.query yönteminin artık sorgulanan video sayısı x tarih aralığındaki gün sayısı çarpımı 50.000'i aşarsa hata döndürdüğünü belirtecek şekilde güncellendi. Örneğin, 500 video kimliğiyle ilgili verileri alan bir sorgu en fazla 100 güne ait veriler isteyebilir.

Bu değişiklik hem kanallar hem de içerik sahipleri ile ilgili raporları etkiler.

Bir isteğin döndürdüğü satır sayısını azaltmak için sorgunuzu daha az video belirten veya daha kısa tarih aralıkları belirleyen birden çok sorguya bölün. Kural olarak, büyük veri kümeleri için toplu raporlar önerilir.

6 Mayıs 2024

YouTube Analytics (Hedefli Sorgular) API, kanallar için üç yeni raporu destekler:

Ayrıca, Kitleyi elde tutma raporu üç yeni metriği desteklemek için geliştirildi:

7 Nisan 2024

YouTube Analytics (Hedefli Sorgular) API'sinde, içerik sahibi oynatma listesi raporlarıyla ilgili birkaç güncelleme yapıldı. Bu güncellemeler, 19 Ocak 2024'te duyurulan kanal şarkı 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. Ancak isCurated boyutunun, içerik sahibi oynatma listesi raporlarında 31 Aralık 2024'e kadar, kanal oynatma listesi raporlarında ise 30 Haziran 2024'e kadar destekleneceğini unutmayın.

  • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

    isCurated boyutunun, içerik sahibi oynatma listesi raporlarında desteği sonlandırıldı. 31 Aralık 2024'ten itibaren desteklenmeyecektir. Söz konusu boyutun tanımı buna göre güncellendi.

    isCurated boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu, yalnızca oynatma listesi raporları için views metriği yerine playlistViews metriğini alacak şekilde de güncellemeniz gerekir. views metriği, oynatma listesi raporları için farklı bir anlama sahip olsa da hâlâ desteklenmektedir. Bu nedenle, metrik adını güncellemezseniz API yine veri döndürür. Elbette, hem views hem de playlistViews değerini alıp görüntülemek için uygulamanızı değiştirebilirsiniz.

    isCurated boyutuna ek olarak, aşağıdaki API işlevi artık yeni raporlarda desteklenmiyor:

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporlarında desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporlarında desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamadığından bu değişiklik, API işlevini Studio uygulamasındaki işlevle uyumlu hale getirir.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarında filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamadığından bu değişiklik, API işlevini Studio uygulamasındaki işlevle uyumlu hale getirir.

  • İçerik sahibi raporları dokümanının oynatma listesi raporları bölümünde, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı bir şekilde açıklanacak şekilde güncelleme yapıldı:

    • Toplu video metrikleri, içerik sahibinin oynatma listelerindeki ve sahibine ait olan tüm videolar için toplanmış kullanıcı etkinliği ve gösterim metrikleri sağlar. Toplu video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi metrikleri oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, oynatma listesindeki sahip olunmayan videolardan gelen görüntülemeleri de içerir ancak yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiğinde.
    • Desteklenen oynatma listesi metrikleri bölümünde, oynatma listesi raporları için desteklenen toplu video metrikleri ve oynatma listesi metrikleri tanımlanır.

  • İçerik sahiplerinin oynatma listesi raporlarında aşağıdaki yeni oynatma listesi metrikleri desteklenir. Bu metriklerin yalnızca raporları almak için gönderilen API isteğinde isCurated boyutunun kullanılmadığı durumlarda desteklendiğini unutmayın. Her bir metriğin tanımı için metrikler dokümanlarına 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çeriyorsa views metriği, videoların içerik sahibinin oynatma listeleri bağlamında kaç kez görüntülendiğini gösteren bir oynatma listesi metriğidir.
    • Bir istek isCurated boyutunu içermediğinde views metriği, içerik sahibinin oynatma listelerindeki videoların oynatma listesi bağlamında görüntülenip görüntülenmediğine bakılmaksızın toplam görüntüleme 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 boyutunun kullanılmadığı bu raporlarda playlistViews metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını, videoların hangi kanala ait olduğundan bağımsız olarak hesaplar.

  • Her oynatma listesi raporu için içerik sahibi raporları dokümanında artık API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak söz konusu 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 (Hedefli Sorgular) API'sinde kanal oynatma listesi raporlarıyla ilgili birkaç güncelleme yapıldı. Güncellemeler arasında desteği sonlandırılmış bir boyut ve birkaç yeni ve güncellenmiş metrik yer alır:

  • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

    isCurated boyutu, kanal raporları için kullanımdan kaldırılmıştır. 30 Haziran 2024'ten itibaren desteklenmeyecek. Söz konusu boyutun tanımı buna göre güncellendi.

    isCurated boyutunu kaldırdığınızda geriye dönük uyumluluğu korumak için kodunuzu, yalnızca oynatma listesi raporları için views metriği yerine playlistViews metriğini alacak şekilde de güncellemeniz gerekir. views metriği, oynatma listesi raporları için farklı bir anlama sahip olsa da hâlâ desteklenmektedir. Bu nedenle, metrik adını güncellemezseniz API yine veri döndürür. Elbette, hem views hem de playlistViews değerini alıp görüntülemek için uygulamanızı değiştirebilirsiniz.

    isCurated boyutuna ek olarak, aşağıdaki API işlevi artık yeni raporlarda desteklenmiyor:

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporlarında desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporlarında desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamadığından bu değişiklik, API işlevini Studio uygulamasındaki işlevle uyumlu hale getirir.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarında filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamadığından bu değişiklik, API işlevini Studio uygulamasındaki işlevle uyumlu hale getirir.

  • Kanal raporları dokümanının oynatma listesi raporları bölümünde, oynatma listesi raporlarında desteklenen metrik türleri daha ayrıntılı bir şekilde açıklanacak şekilde güncelleme yapıldı:

    • Toplu video metrikleri, kanalın oynatma listelerindeki ve kanala ait olan tüm videolar için toplu kullanıcı etkinliği ve gösterim metrikleri sağlar. Toplu video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi metrikleri oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, oynatma listesindeki sahip olunmayan videolardan gelen görüntülemeleri de içerir ancak yalnızca bu görüntülemeler oynatma listesi bağlamında gerçekleştiğinde.
    • Desteklenen oynatma listesi metrikleri bölümünde, oynatma listesi raporları için desteklenen toplu video metrikleri ve oynatma listesi metrikleri tanımlanır.

  • Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi metrikleri desteklenir. Bu metrikler henüz içerik sahibi raporları için desteklenmemektedir. Bu metriklerin yalnızca raporları almak için gönderilen API isteğinde isCurated boyutunun kullanılmadığı durumlarda desteklendiğini unutmayın. Her bir metriğin tanımı için metrikler dokümanlarına 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çeriyorsa views metriği, videoların kanalın oynatma listeleri bağlamında kaç kez görüntülendiğini gösteren bir oynatma listesi metriğidir.
    • Bir istek isCurated boyutunu içermiyorsa views metriği, bu videonun kanalın oynatma listelerinde görüntülenme sayısını belirten toplu bir video metriğidir. Bu görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediği dikkate alınmaz. Toplu toplam, yalnızca oynatma listesinin sahibi olan kanala ait videoların görüntülemelerini içerir.

      isCurated boyutunun kullanılmadığı bu raporlarda playlistViews metriği, videoların oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını, videoların hangi kanala ait olduğundan bağımsız olarak hesaplar.

  • Her oynatma listesi raporu için kanal raporları dokümanında artık API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak söz konusu 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.

4 Aralık 2023

YouTube Analytics (Hedefli Sorgular) API'si, iki insightTrafficSourceType boyut değerini birleştirecek şekilde güncellendi. Daha önce bu boyut, oynatma listesi kapsamında oynatılan videolar (PLAYLIST) ile oynatma listesindeki tüm videoların listelendiği bir sayfadan gelen görüntülemeler (YT_PLAYLIST_PAGE) arasında ayrım yapıyordu. Bundan sonra her iki görüntüleme türü de PLAYLIST boyut değeriyle ilişkilendirilecek.

15 Aralık 2022

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

  • Yeni bir rapor, şehire göre kullanıcı etkinliğini sağlar. 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şkili YouTube içeriği türünü tanımlar. Desteklenen değerler: LIVE_STREAM, SHORTS, STORY ve VIDEO_ON_DEMAND.

    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ümandan kaldırıldı. Bu boyutların desteğinin sonlandırılacağı Ekim 2019'da duyurulmuştu.

26 Ağustos 2022

Hem YouTube Analytics (Hedefli Sorgular) API hem de YouTube Reporting (Toplu Raporlar) API, yeni bir trafik kaynağı ayrıntısı değerini destekler:

  • YouTube Analytics API (Hedeflenen Sorgular) API'sinde, 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 (Toplu Raporlar) API'sinde, traffic_source_type boyutunun değeri 3 ise traffic_source_detail değeri podcasts olarak ayarlanabilir. Bu, trafiğin Podcast'ler hedef sayfasından yönlendirildiğini gösterir.

11 Şubat 2022

gender boyutu için geçerli değer grubu 11 Ağustos 2022'den itibaren değişecek. Bu, API uygulamanızda geriye dönük uyumsuz bir değişiklik olabilir. YouTube API Hizmetleri Hizmet Şartları'nın Geriye dönük uyumsuz değişiklikler bölümünde belirtildiği üzere bu değişiklik, yürürlüğe girmeden altı ay önce duyurulmuştur. Yeni değer grubuna sorunsuz bir geçiş sağlamak için lütfen API uygulamanızı 11 Ağustos 2022'den önce güncelleyin.

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

  • YouTube Analytics (Hedefli Sorgular) API'sinde gender boyutu şu anda female ve male olmak üzere iki değeri desteklemektedir. 11 Ağustos 2022'de veya sonrasında bu boyut female, male ve user_specified olmak üzere üç değeri destekleyecektir.
  • YouTube Reporting (Toplu Raporlar) API'de gender boyutu şu anda FEMALE, MALE ve GENDER_OTHER olmak üzere üç değeri desteklemektedir. 11 Ağustos 2022'de veya sonrasında desteklenen değerler FEMALE, MALE ve USER_SPECIFIED olarak değişecek.

9 Şubat 2022

İki metrik, 13 Aralık 2021 itibarıyla döngü halinde oynatılan klipler trafiğini hariç tutacak şekilde güncellendi. Bu değişiklik hem YouTube Analytics (Hedefli Sorgular) API'sini hem de YouTube Reporting (Toplu Raporlar) API'sini etkiler.

2 Şubat 2022

Bu YouTube Reporting (Toplu Raporlar) API'si, görüntülemelerin canlı yönlendirmelerden geldiğini belirten yeni bir trafik kaynağı boyutu değerini destekler:

  • YouTube Reporting (Toplu Raporlar) API'sinde traffic_source_type boyutu 28 değerini destekler.

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

23 Eylül 2020

Bu YouTube Analytics (Hedefli Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si, izleyicinin YouTube Shorts izleme deneyiminde dikey kaydırma yaparak yönlendirildiğini belirten yeni bir trafik kaynağı boyutu değerini destekler:

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

20 Temmuz 2020

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

  • YouTube Analytics raporlama grubunun maksimum boyutu 200'den 500 öğeye çıkarıldı.
  • 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. Bu filtreler için belirtilebilecek maksimum kimlik sayısı 200'den 500'e yükseltildi.

13 Şubat 2020

Bu güncelleme, YouTube Analytics (Hedefli Sorgular) API ve YouTube Reporting (Toplu Raporlar) 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ısı 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, daha önce uploaded olarak raporlanan, yüklenen videolar ve canlı yayınlarla ilgili bildirimleri iki kategoriye ayırır:

  • uploaded_push: Video yüklendiğinde abonelere gönderilen push bildirimlerinden gelen görüntülemeler
  • uploaded_other: Video yüklendiğinde abonelere gönderilen e-posta veya gelen kutusu bildirimleri gibi push olmayan bildirimler kaynaklı görüntüleme sayısıdır.

Bu değerler, 13.01.2020 (13 Ocak 2020) tarihinde 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 varsa bu satır, izleyicilerin video yüklendiğinde gönderilen push bildirimleri tıklamasıyla üç görüntüleme elde edildiğini gösterir.

15 Ekim 2019

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

  • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

    YouTube, 7DayTotals ve 30DayTotals boyutları için desteği kaldırıyor. Bu boyutları kullanarak verileri 15 Nisan 2020'ye kadar alabilirsiniz. Bu tarihte veya sonrasında 7DayTotals veya 30DayTotals boyutunu kullanarak rapor alma girişimleri hata döndürür.

    Kullanıcıların, day boyutunu kullanarak sorgu oluşturarak ve verileri yedi veya 30 günlük dönemlerde toplayarak ya da türeterek bu boyutlara ait verilerin bir kısmını yeniden oluşturabileceğini unutmayın. Örneğin:

    • Yedi günlük bir dönemin görüntüleme sayısı, ilgili dönemin her bir günündeki görüntüleme sayısı toplanarak hesaplanabilir.
    • Yedi günlük bir dönem için izleyici yüzdesi, her gün gerçekleşen görüntüleme sayısını o güne ait izleyici yüzdesiyle çarparak hesaplanabilir. Böylece, videoyu o gün izlerken oturum açmış olan izleyici sayısını elde edebilirsiniz. Ardından, oturum açmış izleyici sayısı tüm dönem için toplanabilir ve ilgili döneme ait toplam görüntüleme sayısına bölünerek tüm dönem için izleyici yüzdesi elde edilebilir.
    • Aynı izleyici farklı günlerde benzersiz izleyici olarak hesaplanabileceğinden, yedi günlük bir dönem için benzersiz izleyici sayısı hesaplanamaz. Ancak 30 günlük bir dönemdeki benzersiz izleyici sayısıyla ilgili verileri tahmin etmek için 30DayTotals boyutu yerine month boyutunu kullanabilirsiniz. month boyutunun takvim aylarını, 30DayTotals boyutunun ise belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemleri hesapladığını unutmayın.

27 Haziran 2019

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

  • API'nin 1. sürümü için artık destek sonlandırıldığı için dokümanlar, kullanımdan kaldırılma bildirimi ve 2. sürüme nasıl güncelleneceğini açıklayan taşıma 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 (Hedefli Sorgular) API ile ilgili aşağıdaki değişiklikleri içerir:

  • API'nin 1. sürümü artık kullanımdan kaldırıldı. Henüz yapmadıysanız hizmet kesintilerini en aza indirmek için lütfen API istemcilerinizi API'nin 2. sürümünü kullanacak şekilde en kısa sürede güncelleyin. Daha fazla bilgi için taşıma kılavuzuna bakın.

    Bu desteğin sonlandırılmasıyla ilgili planın ilk olarak 26 Nisan 2018'de duyurulduğunu unutmayın.

17 Eylül 2018

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

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

    1. Video veya kanalın belirli bir dönemdeki trafiği sınırlıysa

      veya

    2. Değerlerinin belirli bir eşiği karşılamadığı trafik kaynağı veya ülke gibi bir filtre ya da boyut seçtiyseniz.

    Yeni bölümde, YouTube Analytics raporlarında sınırlı olabilecek veri türleri hakkında da bilgi verilmektedir.

  • Kanal raporları ve içerik sahibi raporları belgeleri, oynatma konumu, trafik kaynağı ve cihaz türü/işletim sistemi raporlarında redViews ve estimatedRedMinutesWatched metriklerinin artık desteklenmediğini yansıtacak şekilde güncellendi.

18 Haziran 2018

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

  • Aşağıdaki yöntemler için kapsam koşulları değişti:
    • 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 aşağıdakilerden 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, salt okunur bir kapsam olan tek bir kapsam kullanır. İkinci seçenek ise iki salt okunur kapsam kullanır.

23 Mayıs 2018

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

  • API'ye Genel Bakış bölümünde, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkili verileri nasıl işlediğini açıklayan toplu metrikler ve silinen öğeler adlı yeni bir bölüm yer alıyor.
  • API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklarla ilgili ek meta veriler almak için YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ila III.E.4.d bölümleri) belirtildiği gibi, API istemcileri 30 gün sonra ilgili API'deki depolanan kaynak meta verilerini silmeli veya yenilemelidir.

22 Mayıs 2018

Bu güncelleme, YouTube Reporting (Toplu Raporlar) API ile ilgili aşağıdaki değişiklikleri içerir:

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

    • Değişiklikten sonra, doldurma raporları da dahil olmak üzere çoğu API raporu, oluşturulduktan sonraki 60 gün boyunca kullanılabilir. Ancak geçmiş verileri içeren raporlar, oluşturulduktan sonraki 30 gün boyunca kullanılabilir.

      Bu duyurudan önce tüm API raporları, oluşturulduktan sonraki 180 gün boyunca kullanılabilirdi. Bu politika değişikliği yürürlüğe girdiğinde, 30 günden eski geçmiş veri raporlarına da API üzerinden erişilemeyecek. 60 günden eski diğer tüm raporlara da artık erişilemeyecek. Bu nedenle, dokümanda artık politika değişikliğinden önce oluşturulan raporların 180 gün geçmeyecek şekilde kullanılabileceği belirtilmektedir.

    • Değişiklikten sonra, bir raporlama işi planladığınızda YouTube, o günden itibaren ve işin planlandığı tarihten önceki 30 günlük dönemi kapsayan raporlar oluşturur. Değişiklik öncesinde, bir raporlama işi planladığınızda YouTube, işin planlandığı zamandan önceki 180 günlük dönemi kapsayan raporlar oluşturuyordu.

  • En iyi uygulamalar bölümünde, raporlarda tanımlanan kaynaklarla ilgili ek meta veriler almak için YouTube Data API'yi kullanabileceğinizi hatırlatmak üzere güncelleme yapıldı. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ila III.E.4.d bölümleri) belirtildiği gibi, API istemcileri 30 gün sonra ilgili API'deki depolanan kaynak meta verilerini silmeli veya yenilemelidir.

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

  • API'ye genel bakıştaki 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ınlandığını belirtecek şekilde güncellendi. Daha önce dokümanda, bu tür raporların kullanılabilir hale gelmesinin 30 günü bulabileceği belirtiliyordu.

  • API'ye genel bakıştaki dolgu verileri bölümü, dolgu verilerini daha önce yayınlanmış bir veri kümesinin yerini alan bir veri kümesi olarak daha net bir şekilde tanımlayacak şekilde güncellendi.

26 Nisan 2018

YouTube Analytics (Hedefli Sorgular) API'sinin 2. sürümü (v2) artık herkese açıktır. Aşağıdaki listede, yeni API sürümüyle ilgili ürün ve doküman değişiklikleri belirtilmiştir:

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

    • API'nin sürümü v1 yerine v2 olarak değişti.
    • API isteklerinin ana URL'si https://www.googleapis.com/youtube/analytics/v1 yerine https://youtubeanalytics.googleapis.com/v2 olarak değiştirildi.
    • reports.query yönteminin bazı parametrelerinin adları güncellendi. Daha açık belirtmek gerekirse, v1 API'deki end-date gibi kısa çizgi içeren parametre adları, v2 API'de kısa çizgi yerine büyük/küçük harf kullanımı (endDate) ile yazılmıştır. API'nin grup oluşturma ve yönetme yöntemlerinde zaten parametre adları için büyük/küçük harf kullanımı olduğundan bu değişiklik, parametre adlarını API genelinde tutarlı hale getirir.
    • v2 API, Google'ın genel HTTP toplu uç noktasına (www.googleapis.com/batch) gönderilen toplu istekleri desteklemez. v2 API'de toplu istek gönderiyorsanız bunun yerine https://youtubeanalytics.googleapis.com/v2 uç noktasını kullanmanız gerekir.

    Ayrıca, v1 API'sindeki bazı özellikler v2 API'sinde desteklenmez:

    • reports.query yöntemi artık alt, quotaUser ve userIp istek parametrelerini desteklemiyor.
    • v2 API, farklı API'lere gönderilen isteklerden oluşan toplu işlemleri destekleyen bir toplu uç nokta sağlamaz. (Ancak bir toplu istek, aynı API'nin farklı yöntemlerine yönelik isteklerden oluşabilir.) Google, tüm API'lerinde genel toplu uç noktayı kullanımdan kaldırdığı için bu desteğin sonlandırılması YouTube Analytics API'ye özgü değildir.
    • v2 API, API v1'de desteklenen JSON-RPC protokolünü desteklemez. Bu desteğin sonlandırılması, YouTube Analytics API'ye özgü değildir.

  • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

    API'nin 1. sürümü (v1) kullanımdan kaldırıldı ve 31 Ekim 2018'e kadar destek verilecek. Bu tarihten sonra v1 API'ye yapılan tüm istekler çalışmayacaktır. Bu nedenle, API üzerinden YouTube Analytics verilerine erişiminizin kesintiye uğramaması için lütfen 31 Ekim 2018'den en geç önce API'nin 2. sürümüne geçtiğinizden emin olun.

21 Şubat 2018

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

  • İzleyici demografisi raporları, izleyici yaş grubuna ve cinsiyetine göre izleme istatistiklerini toplar. Bu 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çerir:

  • API sunucusu artık rapor indiren istekler için gzip sıkıştırmayı destekliyor. Gzip sıkıştırmasının diğer API isteği türleri için desteklenmediğini unutmayın. Gzip sıkıştırmasını etkinleştirmek, her API yanıtı için gereken bant genişliğini azaltır. Ayrıca, uygulamanızın API yanıtlarını sıkıştırmasını kaldırmak için ek CPU süresine ihtiyacı olsa da daha az ağ kaynağı tüketmenin avantajı genellikle bu maliyetten ağır basar.

    Gzip ile kodlanmış bir yanıt almak için Accept-Encoding HTTP istek üst bilgisini aşağıdaki örnekte gösterildiği gibi gzip olarak ayarlayın:

    Accept-Encoding: gzip

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

  • age group ve gender boyutlarının dokümanları, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bu düzeltmenin dokümanda yapıldığını ve API işlevselliğinde veya davranışında bir değişikliğe işaret etmediğini unutmayın. Özellikle aşağıdaki değerler değişti:

    • age_group boyutunun değerleri büyük harflerle yazılır, AGE kelimesi ile yaş grubundaki sayılar arasında alt çizgi bulunur ve kısa çizgi yerine alt çizgi kullanılır. Bu nedenle, age13-17 ve age18-24 gibi değerler sırasıyla AGE_13_17 ve AGE_18_24 olarak düzeltildi.
    • gender boyutunun değerleri büyük harflerle yazılı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, YouTube Analytics API'nin earnings metriğinin kullanımdan kaldırıldığı bu dokümanda duyurulmuştu. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue adlı yeni bir metrik için destek ekledi.)

earnings metriği temel bir metrik olduğundan, duyuru tarihinden itibaren bir yıl boyunca desteklendi. Ancak bir yıl süren bu dönem sona erdiğinden earnings metriği artık desteklenmiyor. Sonuç olarak, earnings metriğini belirten API istekleri artık 400 HTTP yanıt kodu döndürüyor. Uygulamanızı earnings metriği yerine estimatedRevenue metriği kullanacak şekilde güncellemediyseniz lütfen en kısa sürede bunu yapın.

API dokümanları, earnings metriğine yapılan geri 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 istenen tarih aralığındaki son güne kadarki verileri içerdiğini (sorgulanan tüm metriklerin mevcut olduğu tarih) yansıtacak şekilde güncellendi.

      Örneğin, bir istek için bitiş tarihi 5 Temmuz 2017 olarak belirtilmişse ve istenen tüm metriklerin değerleri yalnızca 3 Temmuz 2017'ye kadar mevcutsa yanıta verilerin dahil edildiği son tarih bu tarih olur. (İstenen metriklerden bazıları için 4 Temmuz 2017'ye ait veriler mevcut olsa bile bu durum geçerlidir.)

    • adType boyutu artık reservedBumperInstream değerini desteklemektedir. Bu değer, videonun görüntülenebilmesi için oynatılan ve 6 saniyeye kadar süren atlanamayan bir video reklamı ifade eder. Reklam biçimi auctionBumperInstream reklamıyla aynıdır ancak bu tür, açık artırma yerine ayrılmış olarak satılan reklamları ifade eder.

  • YouTube Reporting API (Toplu Raporlar)

    • ad_type boyutu artık rezerve olarak satılan bumper reklamları ifade eden 20 değerini desteklemektedir. Bumper reklamlar, videonun görüntülenebilmesi için oynatılan, 6 saniyeye kadar süren ve atlanamayan video reklamlardır. Bu boyut için 19 değerinin, ayrılmış olarak değil de açık artırma ile 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 desteğinin 15 Eylül 2016'da sonlandırıldığı duyuruldu ve 15 Aralık 2016'dan sonra bu rapor türleri için rapor oluşturulmadı. Daha önce oluşturulan raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir durumda kalıyordu. Bu nedenle, bazı raporlara en geç 15 Haziran 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek yoktur.

24 Mayıs 2017

Aşağıdaki YouTube Reporting API raporlarıyla ilgili 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 desteğinin 22 Haziran 2016'da sonlandırıldığı duyuruldu ve 22 Eylül 2016'dan sonra bu rapor türleri için rapor oluşturulmadı. Daha önce oluşturulan raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir durumda kalıyordu. Bu nedenle, bazı raporlara en geç 22 Mart 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek yoktur.

22 Mayıs 2017

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

  • YouTube Reporting API (Toplu Raporlar)

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

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Ayrıca, 52 değerini tanımlamak için kullanılan ad, 73 değerinden (Kakao Story) daha net bir şekilde ayırt edilebilmesi için dokümanda Kakao (Kakao Talk) olarak güncellendi. Bu değişiklik, API davranışında veya bu hizmetlerle paylaşılan videoların 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'ndaki YouTube Analytics üzerinden gelir verilerine erişebilen kanal sahipleri artık YouTube Analytics API üzerinden de bu gelir verilerine erişebilir:

17 Mart 2017

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

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

    • 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 izlerken harcadığı 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. Bu metrikler, views ve estimatedMinutesWatched metriklerini zaten destekleyen tüm raporlarda desteklenir.

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 saati ile 00:00'da başlayıp 23:59'da sona eren dönemi ifade ettiğini belirtecek ş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 ileri ayarlandığı tarihler 23 saatlik bir dönemi, geri ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce dokümanda, her tarihin benzersiz bir 24 saatlik 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şiklik anlamına gelmediğ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üne ait tüm raporlama işleri silindi. Bu rapor türü, 19 Ağustos 2016 itibarıyla tamamen kullanımdan kaldırılmış olsa da daha önce oluşturulmuş content_owner_basic_a1 raporları, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir durumdaydı. Bu nedenle, bazı raporlara en geç 19 Şubat 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek yoktur.

  • YouTube Analytics API (Hedeflenen Sorgular)

    • time periods ile ilgili boyutların açıklaması, boyut değerinin belirtilen gün, ay ve yılda Pasifik saati ile 00:00'da başlayıp 23:59'da sona eren dönemi ifade ettiğini belirtecek ş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 ileri ayarlandığı tarihler 23 saatlik bir dönemi, geri ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce dokümanda Pasifik saatinin UTC-8 olduğu belirtiliyordu ve bir günün 24 saatlik bir dönemi temsil etmeme olasılığından bahsedilmiyordu.)

      Bu düzeltmenin, gerçek API davranışında bir değişiklik anlamına gelmediğini unutmayın.

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

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

8 Şubat 2017

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

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

Bu kurallar, API isteği birden fazla kanalın verilerini alırsa 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 sayısı verileri, söz konusu kanalın içerik sahibine bağlandığı tarihe dayanır.

    Farklı kanalların içerik sahibine farklı tarihlerde bağlanmış olabileceğini unutmayın. API isteği birden fazla kanalın verilerini 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ın izlenme süresi ve görüntüleme verilerini döndürür.

15 Aralık 2016

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

API referans dokümanlarında mevcut rapor türlerinin listesi de güncellendi.

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 boyutları ve metrikleri destekler. Raporlar, videonun oynatılması sona erdikten sonra görüntülenen bitiş ekranları için gösterim ve tıklama istatistikleri sağlar.

    8 Kasım 2016

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

    • Aşağıdaki listedeki metriklerin desteği tamamen sonlandırıldı ve artık desteklenmiyor. 10 Ağustos 2016'da duyurulduğu gibi, aynı verilere atıfta bulunan yeni metrikler zaten desteklenmektedir. Aşağıdaki tabloda, desteği sonlandırılan metrik adı ve yeni metrik adı gösterilmektedir:

      Desteği sonlandırılan metrik Yeni metrik
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 Ekim 2016

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

    Sistem tarafından yönetilen raporlara genel bakış, yeni raporlara kısaca göz atar ve bunları API aracılığıyla alma sürecini açıklar. İş ortaklarının raporları oluşturmak için iş planlaması yapması gerekmediğinden bu süreç, YouTube Analytics için toplu rapor alma sürecinden biraz farklıdır.

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

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

    27 Eylül 2016

    Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

    YouTube Analytics API'nin uniques metriği kullanımdan kaldırıldı. Temel bir metrik olmayan bu metrik 31 Ekim 2016'ya kadar desteklenecektir.

    15 Eylül 2016

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

    19 Ağustos 2016

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

    • content_owner_basic_a1 raporunun desteği sonlandırıldı ve dokümanlar kaldırıldı. YouTube artık bu tür yeni raporlar oluşturmayacak olsa da daha önce oluşturulmuş raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir.

      content_owner_basic_a1 raporunun yerine 19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklandığı gibi content_owner_basic_a2 raporu kullanılacaktır.

    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 ele alınan yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda zengin bir güncelleme grubu sunar. Bu güncelleme, 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici dokümanlar içerir.

      Yeni dokümanların tamamı Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmaktadır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır. İlgili dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

    10 Ağustos 2016

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

    • YouTube Analytics API (Hedeflenen Sorgular)

      • Not: Bu, desteği sonlandırılan bir özellikle ilgili duyurudur.

        Aşağıdaki tablodaki metriklerin desteği sonlandırılıyor. Aynı zamanda, aynı verileri ifade eden yeni metrikler de kullanıma sunulmaktadır. Bu, eski metriklerin yeniden adlandırıldığı anlamına gelir. Ancak YouTube Analytics API, tabloda listelenen desteği sonlandırma tarihlerine kadar her iki metrik adını da destekleyecektir.

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

        earnings metriğinin temel bir metrik olduğunu ve bu nedenle bu duyurunun tarihinden itibaren bir yıl boyunca destekleneceğini unutmayın. Temel metrik olmayan 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. Bu, görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan ve kullanıcı tarafından yüklenen videolardan geldiğini gösterir.
        • END_SCREEN: Veriler, başka bir videonun son ekranından gelen görüntülemelerle ilgilidir.

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

      • adType boyutu artık auctionBumperInstream değerini desteklemektedir. Bu değer, videonun görüntülenebilmesi için oynatılan ve 6 saniyeye kadar süren atlanamayan bir video reklamı ifade eder.

    • 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. Bu, görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan ve kullanıcı tarafından yüklenen videolardan geldiğini gösterir.
        • 20: Veriler, başka bir videonun son ekranından gelen görüntülemelerle ilgilidir.

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

      • API'nin temel metrik listesi, estimated_partner_revenue'yi temel metrik olarak listeleyecek ve earnings'ı bu listeden çıkaracak şekilde düzeltildi. (earnings metriği YouTube Reporting API'de hiçbir zaman desteklenmemiştir.)

      • ad_type boyutu artık videonun görüntülenebilmesi için oynatılan, 6 saniyeye kadar süren ve atlanamayan video reklamlar olan bumper reklamları belirten 19 değerini desteklemektedir.

    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 listeleri, kart metriklerini içerecek şekilde güncellendi. Bu raporlardaki kart metrikleri için destek aslında 28 Haziran 2016'da eklendi. 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
        • ABD eyaletlerindeki kullanıcı etkinliği (belirli dönemler için)
        • İle göre kullanıcı etkinliği
        • Abonelik durumuna göre kullanıcı etkinliği
        • İllere göre abonelik durumuna göre kullanıcı etkinliği
        • Eyalete göre en popüler videolar
        • Abone olan veya olmayan izleyiciler için en popüler videolar

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

        Daha önce, her iki raporun dokümanlarında da raporun bu iki filtreden biri veya hiçbiri kullanılarak alınabileceği yanlış bir şekilde belirtiliyordu.

    • YouTube Reporting API (Toplu Raporlar)

      • API'ye genel bakış bölümünde, bir raporun indirme URL'sinin nasıl alınacağını açıklayan bölümde, YouTube'un veri bulunmayan günler için indirilebilir raporlar oluşturduğu belirtilecek şekilde düzeltme yapıldı. Bu raporlar bir başlık satırı içerir ancak ek veri içermez. Bu bilgiler, 12 Nisan 2016'da aynı dokümanın Rapor özellikleri bölümünde güncellenmişti.
      • content_owner_asset_cards_a1 raporundaki boyut listesi, raporun card_id boyutunu kullandığını yansıtacak şekilde düzeltildi. Daha önce dokümanda boyut adı yanlışlıkla card_title olarak listeleniyordu.

    28 Haziran 2016

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

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

    22 Haziran 2016

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

    • API'ye genel bakıştaki Rapor özellikleri bölümü, raporların oluşturulduktan sonraki 180 gün boyunca API üzerinden kullanılabileceğini açıkça belirtecek şekilde güncellendi.

      Daha önce dokümanda, raporların API isteğinin gönderildiği tarihten 180 gün öncesine kadar kullanılabileceği belirtiliyordu. Teknik olarak doğru olsa da orijinal metin en iyi ihtimalle oldukça 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çerir:

      • content_owner_ad_rates_a1 raporu, content_owner_ad_performance_a1 raporunun yeni sürümüdür. Yeniden adlandırılan rapor önceki sürümle aynıdır.

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

        • content_owner_estimated_earnings_a1 raporunun yeni sürümü content_owner_estimated_revenue_a1 olarak adlandırılır.
        • content_owner_asset_estimated_earnings_a1 raporunun yeni sürümü content_owner_asset_estimated_revenue_a1 olarak adlandırılır.

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

      Bu raporların eski sürümlerinden herhangi birini oluşturmak için zaten işiniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerektiğ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ının desteği sonlandırıldı.

      Bu raporlardan herhangi biri için işiniz varsa YouTube'un 22 Eylül 2016'dan sonra bu işler için yeni rapor oluşturmasını bekleyemezsiniz. Oluşturulan raporlar, oluşturulduktan sonraki 180 gün boyunca kullanılabilir.

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

    • Belgelerdeki iki metriğin adı, raporlarda görünen adlarla eşleşecek şekilde düzeltildi. Bu yalnızca doküman düzeltmesidir ve gerçek rapor içeriklerinde bir değişiklik yansıtmaz:

      • estimated_partner_adsense_revenue metriğinin adı estimated_partner_ad_sense_revenue olarak güncellendi. Ancak bu metriğin yalnızca bu güncellemeyle desteği sonlandırılan iki raporda göründüğünü unutmayın. Yukarıda açıklandığı gibi, bu metrik bu raporların daha 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 desteği sonlandırılan iki raporda göründüğünü hatırlatmak isteriz. Yukarıda açıklandığı gibi, bu metrik bu raporların daha 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 özelliklerini artık listelemeyecek şekilde güncellendi. Bu boyutlar şu anda API üzerinden kullanılabilen hiçbir raporda desteklenmez.

    19 Mayıs 2016

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

    • API, içerik sahipleri için kullanıcı etkinliği raporunun yeni sürümünü destekler. Yeni raporun rapor türü kimliği content_owner_basic_a2. Raporun önceki sürümünün (content_owner_basic_a1) aksine 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 yeni rapor sürümüne otomatik olarak taşımaz veya yeni rapor sürümünü oluşturacak bir iş otomatik olarak oluşturmaz. Bazı uygulamalarda, beklenmedik yeni bir işin ortaya çıkması önemli bir değişiklik olabilir.

      Yeni raporun yayınlanmasıyla birlikte content_owner_basic_a1 raporu desteği sonlandırılmıştır. Bu rapor için bir işiniz varsa YouTube'un 19 Ağustos 2016'dan sonra bu iş için yeni rapor oluşturmasını bekleyemezsiniz. Oluşturulan raporlar, oluşturulduktan sonraki 180 gün boyunca kullanılabilir.

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

      • reportType kaynağının deprecateTime mülkü, rapor türünün desteğinin sonlandırılacağı tarihi ve saati belirtir. Bu mülk yalnızca desteği sonlandırıldığı duyurulan raporlar için bir değere sahiptir ve değer, YouTube'un bu tür raporları oluşturmayı durduracağı tarihi temsil eder.

        Bir rapor türü kullanımdan kaldırıldıysa YouTube, bu tür raporları üç ay daha oluşturur. Örneğin, 19 Mayıs 2016'da yayınlanan bu güncellemede content_owner_basic_a1 raporunun kullanımdan kaldırıldığı duyurulmaktadır. Bu nedenle, söz konusu rapor türü için deprecateTime, YouTube'un bu tür raporları oluşturmayı durduracağı 19 Ağustos 2016'daki bir zamanı belirtir.

      • job kaynağının expireTime mülkü, işin geçerlilik süresinin sona erdiği veya sona ereceği tarihi ve saati belirtir. İşle ilişkili rapor türü kullanımdan kaldırıldıysa veya iş için oluşturulan raporlar uzun süredir indirilmediyse bu mülk bir değere sahiptir. Bu tarih, YouTube'un iş için artık yeni rapor oluşturmayacağı zamanı gösterir.

      • report kaynağının jobExpireTime mülkü, raporla ilişkili işin süresinin dolduğu veya dolacağını belirten tarih ve saati belirtir. Bu mülk, bu listedeki önceki öğede açıklandığı gibi job kaynağındaki expireTime mülküyle aynı değeri içerir.

    • Desteği sonlandırılan bir rapor için iş oluşturmaya çalıştığınızda jobs.create yöntemi artık 400 HTTP yanıt kodu (Bad Request) döndürüyor. Ayrıca, yöntemin dokümanlarında artık API isteğinin başarısız olmasına neden olan diğer birkaç neden de listelenmiştir.

    12 Nisan 2016

    Bu güncelleme, aşağıdaki değişiklikleri içerir. Bunların tümü yalnızca YouTube Reporting API'yi etkiler:

    • YouTube artık bir raporlama işinin ilk planlandığı zamandan önceki 180 günlük dönemi kapsayan veriler oluşturur. Daha önce Reporting API, geçmiş veriler sağlamamaktaydı. Bu değişiklik, bu duyurudan önce oluşturulanlar da dahil olmak üzere tüm işleri etkiler.

      Geçmiş raporlar, kullanılabilir hale gelir gelmez yayınlanır. Ancak bir işin tüm geçmiş verilerinin yayınlanması yaklaşık bir ay sürer. Bu nedenle, bir raporlama işinin planlanmasından bir ay sonra yaklaşık yedi aylık verilere erişebilirsiniz. (Bu duyurudan önce oluşturulan işlerle ilgili geçmiş verilerin tümü, duyurudan sonraki bir ay içinde yayınlanacaktır.)

      Geçmiş veriler yalnızca 1 Temmuz 2015'ten itibaren kullanılabilir. Sonuç olarak, 28 Aralık 2015'ten önce oluşturulan işlerde 180 günden az geçmiş veri bulunur.

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

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

      • Belgelerde artık raporların oluşturulduktan sonraki 180 gün boyunca kullanılabileceği ve bu nedenle API istemcilerinin indirebileceği belirtiliyor. Daha önce dokümanda, raporların API isteğinin gönderildiği tarihten altı ay öncesine kadar kullanılabileceği belirtiliyordu.

      • API'nin artık veri bulunmayan günler için indirilebilir raporlar oluşturduğu gerçeğini yansıtacak şekilde dokümanlar güncellendi. Bu raporlar başlık satırları içerir ancak ek veri içermez.

    • YouTube Reporting API, yakında reklam geliri verilerini veya YouTube Red abonelik geliri verilerini içeren, otomatik olarak oluşturulan ve sistem tarafından yönetilen bir rapor grubunu destekleyecek. Bu raporlar, YouTube İçerik Stüdyosu'nda manuel olarak indirilebilen gelir raporlarına erişebilen içerik sahipleri tarafından kullanılabilir. 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ırlanırken aşağıdaki API değişiklikleri duyurulmaktadır:

      • job kaynağının yeni systemManaged mülkü, kaynağın sistem tarafından yönetilen raporlar oluşturan bir işi tanımlayıp tanımlamadığını belirtir. YouTube, YouTube içerik sahipleri için sistem tarafından yönetilen raporları otomatik olarak oluşturur. İç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şler içermesi gerekip gerekmediğini belirtir. Parametrenin varsayılan değeri false'tür.

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

        Yöntemin, raporun oluşturulduğu zamanla ilgili createdAfter parametresinin aksine yeni parametreler rapordaki verilerle ilgilidir.

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

      • reportTypes.list yönteminin yeni includeSystemManaged parametresi, API yanıtının sistem tarafından yönetilen raporları içermesi gerekip gerekmediğini belirtir. Parametrenin varsayılan değeri false'tür.

    28 Mart 2016

    YouTube Reporting API ve YouTube Analytics API artık birkaç ek paylaşım hizmetinin görüntüleme istatistiklerini döndürüyor.

    • YouTube Reporting API'de sharing_service boyutu aşağıdaki yeni değerleri destekler:
      • 82: iOS sistem etkinliği iletişim kutusu
      • 83: Google Gelen Kutusu
      • 84: Android Messenger
    • YouTube Analytics API'de sharingService boyutu aşağıdaki 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ında veya ana ekranda, kullanıcının abonelik özet akışında ya da başka bir YouTube 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'yi desteklemektedir. Bu değer, video görüntülemelerinin bir oynatma listesindeki tüm videoların listelendiği bir sayfadan geldiğini gösterir. Bu kaynak, izlenmelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini belirten 14 kaynak türünden farklıdır.

    YouTube Analytics API

    • insightPlaybackLocationType boyutu iki yeni boyut değerini destekler:
      • BROWSE: Veriler, YouTube ana sayfasında veya ana ekranda, kullanıcının abonelik özet akışında ya da başka bir YouTube 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'yi desteklemektedir. Bu değer, video görüntülemelerinin bir oynatma listesindeki tüm videoların listelendiği bir sayfadan geldiğini gösterir. Bu kaynak, videonun oynatma listesi kapsamında oynatıldığı sırada 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 metriklerinin artık bu API için desteklenen metrikler olarak listelenmemesi için güncellendi. (Bu API'nin raporlarının hiçbiri kart metriklerinden herhangi birini desteklediği belgelenmemiştir.)

    YouTube Reporting API'yi kullanarak kart metriklerini almaya devam edebileceğinizi unutmayın. Bu API, kanal ve içerik sahibi raporlarında bu metrikleri destekler.

    6 Ocak 2016

    YouTube Reporting API ve YouTube Analytics API artık Chromecast cihaz üzerinden gerçekleşen görüntülemeleri özel olarak tanımlar.

    • 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'de operatingSystem boyutu, Chromecast üzerinden gerçekleşen görüntülemeleri tanımlamak için CHROMECAST değerini kullanır.

    21 Aralık 2015

    Belgelerde, annotation_clickable_impressions ve annotation_closable_impressions metriklerinin adları, raporlarda döndürülen adlarla eşleşecek şekilde güncellendi. Daha önce bu adlar clickable_annotation_impressions ve closable_annotation_impressions olarak belgelenmişti.

    18 Aralık 2015

    Avrupa Birliği (AB) yasaları, AB'deki son kullanıcılara belirli bilgilerin verilmesini 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 gerekir. YouTube API Hizmet Şartlarımız'a 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çerir:

    • YouTube Analytics API artık çeşitli kanal ve içerik sahibi raporlarında kullanılabilecek üç 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 mi yoksa canlı yayından sonra gerçekleşen kullanıcı etkinliğini mi tanımladığını belirtir.
      • subscribedStatus: Bu boyut, verilerdeki kullanıcı etkinliği metriklerinin videonun veya oynatma listesinin kanalına abone olan izleyicilerle ilişkili olup olmadığını belirtir.
      • youtubeProduct: Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube mülkünü tanımlar. Olası değerler arasında ana YouTube web sitesi (veya YouTube uygulaması), YouTube Gaming ve YouTube Kids yer alır.

      Dokümanlar, kanallar ve içerik sahipleri için sunulan yeni oynatma ayrıntıları raporlarını tanımlayacak şekilde güncellendi. Ayrıca, diğer birçok rapor bu boyutlardan bir veya daha fazlasının isteğe bağlı olarak bu raporlarda boyut ve/veya filtre olarak kullanılabileceğini belirtecek şekilde güncellendi.

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

      İçindekiler
      Boyutlar:
      Zorunlu deviceType
      0 veya daha fazla kullanın day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Metrikler:
      1 veya daha fazla views, estimatedMinutesWatched
      Filtreler:
      0 veya 1 kullanın country, province, continent, subContinent
      0 veya 1 kullanın video, group
      0 veya daha fazla kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

      Zorunlu ve isteğe bağlı alanları açıklayan terminoloji, kanal ve içerik sahibi raporlarıyla ilgili belgelerde açıklanmaktadır.

    • YouTube Analytics API artık API kullanıcısının verilerini alamadığı öğeleri, birden fazla değeri destekleyen filtrelerden (video, playlist ve channel) otomatik olarak çıkarır. Daha önce API kullanıcısı belirtilen öğelerden en az birine ait verilere erişemiyorsa API sunucusu yalnızca bir hata döndürüyordu.

      Örneğin, bir kullanıcının video filtresinin 20 video kimliğini listelediği bir API isteği gönderdiğini varsayalım. Kullanıcı, 18 videonun sahibidir. Ancak bir video kimliği, başka bir kanala ait bir videoyu tanımlarken diğer kimlik, silinmiş ve artık mevcut olmayan bir videoyu tanımlar. Bu durumda API sunucusu, hata döndürmek yerine kullanıcının erişemediği iki videoyu atar ve API yanıtı, API kullanıcısının sahip olduğu 18 videonun verilerini 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.

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

    • YouTube Analytics API'nin groups.list yöntemi artık sayfalandırmayı destekliyor. API yanıtı mevcut tüm grupları içermiyorsa yanıtın nextPageToken parametresi, sonuçların bir sonraki 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 boyutuna ilişkin dokümanlar, tarihlerin Pasifik saati (UTC-8) ile 00:00'da başlayan 24 saatlik süreyi referans aldığını yansıtacak şekilde düzeltildi. Daha önce dokümanda, 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 saati (UTC-8) 00:00'dan itibaren başlayan tarihleri ifade ettiğini belirtecek şekilde güncellendi.

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

      Parametre değeri, mikrosaniye oranında doğruluğa sahip ve RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnek: "2015-10-02T15:01:23.045678Z".

      YouTube Reporting API en iyi uygulamaları da aynı raporu tekrar tekrar işlememek için createdAfter parametresini nasıl kullanabileceğinizi açıklamak üzere güncellendi.

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

    8 Ekim 2015

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

    • YouTube Analytics API'nin sharingService boyutuyla ilgili dokümanlar, olası boyut değerlerinin listesini içerecek şekilde güncellendi. Listede, yeni desteklenen bir dizi hizmet yer alır.

      YouTube Reporting API'nin sharing_service boyutunun tanımı da yeni desteklenen değerleri listeleyecek şekilde güncellendi. 59'ten büyük olan enum 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 sahibine ait 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 madenciliği 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ı da metrikleri ve boyutları kullanır.) Bir rapordaki her veri satırında benzersiz bir boyut değeri kombinasyonu bulunur. Tekil videolar, ülkeler, canlı videolar, abone olan kullanıcılar vb. ile ilgili metrikleri hesaplamak için boyut değerlerine göre satırlardaki verileri toplayabilirsiniz.

      API'yi kullanarak raporlama işlerini planlayabilirsiniz. Bu işlerin her biri, YouTube'un oluşturması gereken bir raporu tanımlar. Bir iş oluşturduktan sonra YouTube, eşzamansız olarak indirilebilen günlük bir rapor oluşturur. Her rapor, benzersiz bir 24 saatlik döneme ait veriler içerir.

    • Farklı API'ler olsa da YouTube Analytics API ve YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini almasını sağlar. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'nin dokümanları tek bir doküman grubu olarak yayınlanmaktadır.

      • Doküman grubundaki Kılavuzlar sekmesi, API isteklerine yetki verme talimatları da dahil olmak üzere her iki API için ortak olan bilgileri içerir.
      • Toplu raporlar sekmesi, YouTube Reporting API'ye özel referans dokümanları ve diğer içerikleri içerir.
      • Hedeflenen sorgular sekmesi, YouTube Analytics API'ye özel referans dokümanları ve diğer içerikleri içerir.
      • Örnekler sekmesinde, iki API'den herhangi biri için kullanılabilen kod örnekleri listelenir.
      • Araçlar sekmesinde, geliştiricilerin iki API'den birini uygulamalarına yardımcı olacak ek kaynaklar listelenir.

    20 Ağustos 2015

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

    • API'nin anlaşılmasını kolaylaştırmak için API dokümanları yeniden yapılandırıldı. Bu nedenle, bu değişiklikler yeni özellikleri açıklamaz:

      • Dokümanlar artık mevcut tüm kanal raporlarını ve mevcut tüm içerik sahibi raporlarını listeleyen bir sayfa içeriyor. Daha önce dokümanda kanal video raporları, kanal oynatma listesi raporları vb. için ayrı sayfalar vardı.

      • Yeni veri modeline genel bakış, API'nin işleyiş şekliyle ilgili daha net bir giriş sunmayı amaçlamaktadır. Bu doküman, YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığını daha iyi açıklamayı amaçlamaktadır.

      • Raporları almak için kullandığınız API'nin reports.query yöntemi artık ayrı olarak belgelenmiştir. Bu sayfadaki bilgiler daha önce başka sayfalarda yer alıyordu. Yeni sayfa, rapor almak için göndermeniz gereken bilgileri daha kolay belirlemenize yardımcı olmak üzere tasarlanmıştır.

    22 Temmuz 2015

    Bu güncelleme, tümü yalnızca içerik sahipleri için geçerli olan çeşitli değişiklikler içerir:

    • Yeni adEarnings metriği, Google tarafından satılan tüm reklamcılık 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 reklamcılık kaynaklarından ve reklamcılık dışı kaynaklardan elde edilen toplam tahmini kazançları içerdiğini yansıtacak şekilde düzeltildi. Daha önce, bu metriğin yalnızca reklamcılık kaynaklarından elde edilen kazançları içerdiği yanlış bir şekilde belirtiliyordu.

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

    • Desteği sonlandırılan primaryAdGrossRevenue metriğine ek olarak reklam performansı raporları artık monetizedPlaybacks ve playbackBasedCpm metriklerini desteklemiyor. Ancak bazı video raporları bu metrikleri hâlâ desteklemektedir.

    1 Haziran 2015

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

    • API artık video raporları için videosAddedToPlaylists ve videosRemovedFromPlaylists olmak üzere iki yeni metriği destekliyor. Kanallar ve içerik sahipleri için video raporlarının listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.

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

      Her iki metrik de "Daha Sonra İzle" gibi varsayılan oynatma listelerini içerir. Ancak bir videonun otomatik olarak eklendiği oynatma listeleri (ör. kanalın yüklemeler oynatma listesi veya kullanıcının izleme geçmişi) bu sayıya dahil edilmez. Ayrıca bu metriklerin, ekleme ve silme işlemlerinin mutlak sayısını yansıttığını unutmayın. Bu nedenle, bir kullanıcı bir videoyu oynatma listesine ekleyip kaldırdıktan sonra tekrar eklerse metrikler, videonun iki oynatma listesine eklendiğini ve bir oynatma listesinden kaldırıldığını gösterir.

      Bu metriklerle ilgili veriler 1 Ekim 2014'ten itibaren kullanılabilir.

    31 Mart 2015

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

    16 Mart 2015

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

    • Yeni currency parametresi, kazanç metriklerini ABD doları (USD) dışında bir para biriminde almanıza olanak tanır. Parametre ayarlanırsa 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 tahminlerdir.

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

    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ın rapor verilerini alma özelliğini de desteklemektedir.

      • Grup oluşturma ve yönetme

        Bu güncellemede, grup oluşturmak ve yönetmek için group ve groupItem kaynakları kullanıma sunulmuştur.

        • group kaynağı, 200'e kadar kanal, video, oynatma listesi veya öğeden oluşan özel bir koleksiyon olan Analytics grubunu temsil eder. API, bu kaynak için list, insert, update ve delete yöntemlerini destekler.
        • groupItem kaynağı, bir 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 öğe ekleyebilirsiniz.

      • Bir grup için rapor verilerini alma

        Boyutlar dokümanları, birçok kanal raporu ve içerik sahibi raporu için filtre olarak kullanılabilen group boyutunu içerecek şekilde güncellendi. group filtresini kullandığınızda API, ilgili 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 göz atı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 parametresi değerini, API yanıtının filtrelenmesi gereken video, oynatma listesi, kanal veya program kimliklerinin virgülle ayrılmış bir listesine ayarlayın. Parametre değeri en fazla 200 kimlik belirtebilir.

      Aynı filtre için birden fazla değer belirtirseniz bu filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen bir 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:

    • Kanal raporunu alırken artık ids parametresinin değerini channel==MINE olarak ayarlayarak kimliği doğrulanmış kullanıcının kanalıyla ilgili verileri alabilirsiniz. (Belirtilen kanalın verilerini almak için ids parametresini channel==CHANNEL_ID olarak ayarlamaya devam edebilirsiniz.)

    • API artık 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ı ise averageViewDuration metriğini de destekler.

      Ayrıca, 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: Oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme sayısı.
      • averageTimeInPlaylist: İzleyicinin, oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları izlemek için harcadığı tahmini ortalama süre (dakika cinsinden).

      Oynatma listesi raporu alma istekleri isCurated filtresini kullanmalıdır. Bu filtre 1 (isCurated==1) olarak ayarlanmalıdır.

    • API artık kitle elde tutma raporunu destekliyor. Bu rapor, bir videonun kitleyi elde tutma oranını ölçer. Raporun yeni elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için geçen video süresini ölçer:

      • audienceWatchRatio metriği, videonun belirli bir noktasında videoyu izleyen izleyici sayısının mutlak oranını tanımlar. Bu oran, videonun bir kısmının izlenme sayısının videonun toplam görüntüleme sayısına bölünmesiyle hesaplanır.

        Videonun bir bölümünün, belirli bir video görüntülemesinde birden fazla kez (veya hiç) izlenebilir olduğunu unutmayın. Örneğin, kullanıcılar bir videonun aynı bölümünü geri sararak birden fazla kez izliyorsa videonun bu bölümüne ait mutlak oran 1'ten yüksek olabilir.

      • relativeRetentionPerformance metriği, benzer uzunluktaki tüm YouTube videolarına kıyasla bir videonun oynatma sırasında izleyicileri ne kadar iyi tuttuğunu gösterir. 0 değeri, videonun izleyicileri benzer uzunluktaki diğer videolardan daha kötü şekilde elde tuttuğunu, 1 değeri ise videonun izleyicileri benzer uzunluktaki diğer videolardan daha iyi şekilde elde tuttuğunu gösterir. 0,5 olan ortanca değer, benzer uzunluktaki videoların yarısının izleyicileri daha iyi, yarısının ise daha kötü tuttuğunu gösterir.

      Raporun yalnızca organik görüntülemelerle, yayın içi TrueView reklam görüntülemeleriyle veya TrueView görüntülü reklam görüntülemeleriyle ilişkili verileri döndürmesi için audienceType filtresini de kullanabilirsiniz. (Organik görüntülemeler, video arama veya önerilen bir videoyu tıklama gibi kullanıcı işlemlerinin doğrudan sonucudur.)

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

      Yeni metriklerin tümü temel metriktir ve Desteklenmesi Durdurulan Özellikler Politikası'na tabidir. Ancak yeni metrikler için verilerin 16 Temmuz 2013'ten itibaren kullanılabildiğini unutmayın. (annotationClickThroughRate ve annotationCloseRate metrikleriyle ilgili veriler 10 Haziran 2012'den itibaren kullanılabilir.)

    • GOOGLE_SEARCH artık insightTrafficSourceType boyutu için ayrı bir değer olarak raporlanmıyor. Bunun yerine, Google arama sonuçlarından gelen yönlendirmeler artık EXT_URL trafik kaynağı türüyle ilişkilendiriliyor. Sonuç olarak, insightTrafficSourceType filtresini GOOGLE_SEARCH olarak ayarlayan bir insightTrafficSourceDetail raporu da artık alınamıyor.

    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 kısa süre önce kullanıma sunulana benzer bir sekme biçimi kullanılarak örnekleri kategorilere göre gruplandıracak şekilde yeniden tasarlandı. Yeni tasarımda örnekler aşağıdaki kategorilere ayrılmıştır:

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

    • Örnek istekler belgesine, kanal raporlarında veya içerik sahibi raporlarında illere özgü verileri almak için yeni örnekler eklendi.

      • ABD eyaletleri ve Washington D.C. için eyalete özgü metrikler: Bu rapor, bir kanalın videolarının görüntüleme sayılarının ve diğer istatistiklerinin illere göre dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.'yi kapsar. Örnekte, yanıtı yalnızca ABD ile ilgili sonuçları içerecek şekilde kısıtlamak için province boyutu ve filters parametresi kullanılır.

      • Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet): Bu rapor, Kaliforniya'da bir kanalın videolarını izleyen veya içerik sahibi raporları için içerik sahibinin hak talebinde bulunduğu içerikleri izleyen izleyicilere ait yaş grubu ve cinsiyet istatistiklerini alır. Bu örnekte, yanıtın yalnızca belirli bir ile ait verileri içermesi için filters parametresi kullanılmaktadır.

    • province boyutunun tanımı, province dimensions parametre değerine dahil edildiğinde isteğin country==US parametre değerine filters ekleyerek verileri ABD ile sınırlaması gerektiğini 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 belge, olası tüm raporları listeleyen bir tablo yerine raporları kategorilere ayırır:

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

      Her belgede bu kategoriler sekme listesi olarak gösterilir. İstediğiniz sekmeyi tıklayarak ilgili kategorideki desteklenen raporları görebilirsiniz.

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

      • province boyutu, ABD eyaletleri ve Kolombiya Bölgesi ile ilgili istatistikleri almanıza olanak tanır. API, bu boyut için iki kullanım şeklini destekler:

        • API, istatistikleri eyalet bazında ayrıntılandıran iki raporu destekler. Her iki rapor da kanallar ve içerik sahipleri tarafından kullanılabilir.

          • Temel istatistikler raporu, görüntüleme sayısı ve izlenen tahmini 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 eyalete ait istatistikler içerecek şekilde kısıtlamak için filters sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografi raporları ve en popüler video raporları gibi çeşitli raporlar bu tür filtrelemeyi destekler.

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

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

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

    • Dokümanlar, insightTrafficSourceDetail boyutunun geçerli bir filtre değeri olarak insightTrafficSourceType değeri PROMOTED içermeyecek şekilde düzeltildi.

    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 Desteği Sonlandırılan API Politikası'na tabidir. Ancak API'nin temel olmayan boyutları ve temel olmayan metrikleri, Desteği Sonlandırılan Ürünler Politikası'na tabi değildir. Boyutlar ve metrikler 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 EXTERNAL_APP değerini desteklemektedir. Bu güncellemeyle birlikte, 10 Eylül 2013'ten itibaren oynatmalar artık MOBILE oynatmalar olarak sınıflandırılmıyor. Ancak bu tarihten önce gerçekleşen mobil oynatmalar bu değerle sınıflandırılmaya devam eder.

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

    • API artık insightTrafficSourceType boyutu için PLAYLIST değerini desteklemektedir. Bu değer, video görüntülemelerinin bir oynatma listesinden geldiğini gösterir. Bu görüntülemeler daha önce boyutun YT_OTHER_PAGE kategorisi kullanılarak sınıflandırılıyordu.

    16 Temmuz 2013

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

    • API artık raporları birden fazla boyuta ve metriğe göre sıralama özelliğini destekliyor. Örnek istekler belgesinde, bu işlevi gösteren İstekleri birden fazla boyuta/metriğe göre sıralama adlı yeni bir örnek yer alır. İstek, trafik kaynağı verilerini alır ve sort parametresi day,-views değerine sahiptir. Sonuçlar kronolojik olarak sıralanır ancak her güne ait sonuç kümesinde ilk satır en çok görüntüleme alan trafik kaynağının verilerini, ikinci satır ise en yüksek ikinci görüntüleme sayısını alan kaynağın verilerini içerir.

    • API artık izleyicilerinizin videolarınızı izlediği cihazlarla ilgili verileri almak için kullanılabilecek iki yeni boyutu (deviceType ve operatingSystem) destekliyor. API, bu boyutlardan birini veya ikisini birden kullanan 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 almanızı sağlar. Cihaz türü raporunu yalnızca Android veya iOS gibi belirli bir işletim sistemini çalıştıran cihazlara ait istatistikleri içerecek şekilde kısıtlamak iç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üresini almanızı sağlar. İşletim sistemi raporunu yalnızca mobil cihazlar veya tabletler gibi belirli bir cihaz türüyle ilgili istatistikler içerecek şekilde kısıtlamak 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, boyutun diğer değerlerinden biri kullanılarak sınıflandırılmayan görünümleri tanımlayan YT_OTHER değerini döndürebilir.

    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ı ve içerik sahibi raporları listeleri bu değişikliği yansıtacak şekilde güncellendi. (İzlenme süresi metrikleri, listelenen diğer raporların bir parçası olarak alınabildiğinden, listeler artık daha kısadır.)

      Örnek API istekleri dokümanı da güncellendi.

    • insightPlaybackLocationDetail ve insightTrafficSourceDetail boyutlarını kullanan raporlar aşağıdaki şekillerde geliştirildi:

      • Artık isteğe bağlı bir country filtresi destekleniyor.

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

        • 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ısı

          • 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 birçok farklı rapor türünün nasıl alınacağını gösteren örnekler verilmiştir. Her örnekte, isteğin aldığı raporun kısa bir açıklaması yer alır ve ardından istek için boyutlar, metrikler, filtreler ve sıralama parametreleri gösterilir.

    • insightTrafficSourceType boyutu artık geçerli değer olarak SUBSCRIBER'ı desteklemektedir. Bu değer, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden yönlendirilen video görüntülemelerini tanımlar. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, görüntülemelerin yönlendirildiği ana sayfa feed'ini veya 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. Tüm 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ı belgelerine bakın.

      • Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporları 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 reklamcılık kaynaklarından elde edilen toplam tahmini kazanç.
        • grossRevenue: Google veya DoubleClick iş ortaklarından elde edilen tahmini brüt gelir.
        • primaryAdGrossRevenue: Google veya DoubleClick iş ortaklarından, raporun kapsadığı video oynatma işlemleri için birincil reklam türü altında toplanan ve sınıflandırılan tahmini brüt gelir.
        • monetizedPlaybacks: En az bir reklam gösterimi gösteren oynatma sayısı.
        • playbackBasedCpm: Bin oynatma başına tahmini brüt gelirdir.
        • 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ına bakın.

      • 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 dokümanları, farklı rapor türlerinin ayrı sayfalarda açıklanacağı şekilde yeniden düzenlendi. Bu nedenle, farklı kanal raporlarını ve içerik sahibi raporlarını açıklayan ayrı sayfalar oluşturduk.

    4 Şubat 2013

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

    • API'nin referans kılavuzunda artık Java, JavaScript, Python ve Ruby istemci kitaplıklarını kullanarak API'nin nasıl çağrılacağını gösteren kod örneklerini içeren bir örnek bölümü bulunuyor. 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ıza, API isteğini görmenize ve yanıtta gerçek verileri almanıza olanak tanıyan APIs Explorer yer alıyor.

    • API, hem kanallar hem de içerik sahipleri için aşağıda açıklanan çeşitli yeni raporları destekler. Her rapor, kanal raporu veya içerik sahibi raporu olarak kullanılabilir. Boyutlar ve metrikler sayfaları da buna göre güncellendi.

      • Oynatma konumu raporu, farklı sayfa veya uygulama türlerinde gerçekleşen video görüntüleme sayısını belirtir.

      • Oynatma konumu ayrıntıları raporu, belirtilen bir video için en fazla görüntüleme alan yerleşik oynatıcıları tanımlar. En çok yerleştirilen oynatıcılarla ilişkili URL'leri tanımlayarak oynatma konumu raporundan daha ayrıntılı bir görünüm sunar.

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

      • Trafik kaynağı ayrıntıları raporu, belirli bir video ve belirli bir trafik kaynağı türü için en fazla görüntüleme sağlayan yönlendiricileri tanımlar. Örneğin, bu raporda belirli bir videoya en fazla trafik gönderen ilgili videoları görebilirsiniz. Bu rapor, çeşitli trafik kaynakları için desteklenir.

      • İzlenme süresi raporları, izleyicilerin içeriklerinizi izleyerek geçirdiği süreyi gösterir. Raporlar, belirli bir zaman aralığı (gün, önceki yedi gün, önceki 30 gün vb.) veya ülkeye ait verileri toplayabilir. Bir rapor verileri güne veya ülkeye göre topluyorsa her video görüntülemenin ortalama uzunluğunun yanı sıra kullanıcıların izlediği her videonun 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ştiriciler tarafından kullanılabilir. Projeniz için API'yi, önce erişim isteğinde bulunmak zorunda kalmadan APIs console'deki Hizmetler panelinden etkinleştirebilirsiniz.

    • Yeni Başlangıç bölümünde, YouTube Analytics API kullanan bir uygulama oluşturmak için gereken ön koşullar ve temel adımlar özetlenmiştir.

    12 Eylül 2012

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

    • Yeni Kota kullanımını anlama bölümünde, API kota kullanımınızı optimize etmeyle ilgili yönergeler sağlanmaktadır. API sunucusu her istek için bir sorgu maliyeti hesaplar ve bu maliyet API kullanım kotanızdan düşülür. Farklı rapor türlerinin sorgu maliyetleri çok farklı olabileceğinden kotanızı verimli bir şekilde kullanmayı planlamanız ve uygulamanızın yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemesi gerekir.

    • Zamansal boyutlar bölümü, bu boyutların bir Analytics raporunun verileri bir döneme göre topladığını belirtecek şekilde güncellendi. API artık aşağıdaki ek zamansal boyutları destekler:

      • 7DayTotals: Rapordaki veriler, her satır yedi günlük bir döneme ait veriler içerecek şekilde toplanır.
      • 30DayTotals: Rapordaki veriler, her satır 30 günlük bir döneme ait veriler içerecek şekilde toplanır.
      • month: Rapordaki veriler takvim ayına göre toplanır.

      Benzer şekilde, kullanılabilir raporlar bölümü, API'nin bu boyutları kullanan raporları desteklediğini yansıtacak şekilde güncellendi.

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

    • API artık en popüler videolarla ilgili raporlar için iki yeni sıralama seçeneği sunuyor. Kanal raporları veya içerik sahibi raporları olarak sunulan bu raporlar, ülke bazında metrikler (ör. görüntüleme sayısı, yorum sayısı, beğeni sayısı) içerir ve bu metrikleri videoya göre ayrıntılı olarak gösterir. Artık videonun izleme sayfasından bu raporları, kanala abone olan veya kanaldan aboneliği iptal eden kullanıcıların sayısına göre sıralayabilirsiniz.

    • subscribersGained ve subscribersLost metriklerinin tanımları, bir kanalın video izleme sayfası, kanal sayfası ve YouTube ana sayfasında görünen kılavuz dahil olmak üzere çeşitli yerlerde abone kazanabileceğini veya kaybedebileceğini açıklamak için güncellendi. Bu metrikler, videoya özel bir raporda göründüğünde yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.