Düzeltme Geçmişi

Bu sayfada, hem YouTube Reporting API hem de YouTube Analytics API için API değişiklikleri ve belge güncellemeleri listelenmektedir. Her iki API de geliştiricilerin YouTube Analytics verilerine farklı şekillerde erişmesine olanak tanır. Bu değişiklik günlüğüne abone olun. Abone ol

6 Mayıs 2024

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

Ayrıca, Kitle Elde tutma raporu, üç yeni metriği destekleyecek şekilde iyileştirildi:

7 Nisan 2024

YouTube Analytics (Hedeflenen Sorgular) API'sinde içerik sahibiyle ilgili çeşitli güncellemeler vardır oynatma listesi raporları. Güncellemeler, kanal oynatma listesi raporlarıyla ilgili güncellemelerle aynıdır. 19 Ocak 2024'te duyurulacaktır.

Aşağıdaki düzeltme geçmişi girişi, 19 Ocak 2024 tarihli girişle aynı bilgileri girin. Bununla birlikte, içerik sahibinin oynatma listesi raporları isCurated boyuta kadar 31 Aralık 2024 itibarıyla bu boyut, kanal oynatma listesi raporlarında desteklenecek. 30 Haziran 2024.

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

    isCurated boyutu, içerik sahibi oynatma listesi raporları için kullanımdan kaldırılmıştır. Artık mümkün olmayacak 31 Aralık 2024'te veya sonrasında desteklenmelidir. Söz konusu boyutun tanımı güncellenmiştir buna göre hazırlar.

    isCurated öğesini kaldırdığınızda geriye dönük uyumluluğu korumak için boyutunu almak için playlistViews metriğini almak üzere kodunuzu da güncellemeniz gerekir. views metriğine karşılık gelir. views tarihinden beri oynatma listesi raporları için desteklenmeye devam etse de API, farklı bir anlama gelse de metrik adını güncellemezseniz veri döndürmeye devam eder. Tabii ki uygulamanızda değişiklik hem views hem de playlistViews öğesini almak ve görüntülemek için.

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

    • continent ve subcontinent gibi konum filtreleri aynı değildir yeni kanal oynatma listesi raporlarında desteklenir.
    • redViews ve estimatedRedMinutesWatched metrikleri artık kullanılmıyor yeni kanal oynatma listesi raporlarında desteklenir. Bu metrikler YouTube Studio'da kullanılamadığından Bu değişiklik, API işlevini Studio uygulamasında bulunan işlevlerle uyumlu hale getirecek.
    • subscribedStatus ve youtubeProduct boyutları artık kullanılmıyor Kanal oynatma listesi raporlarında filtre olarak desteklenir. Bu filtreler şurada kullanılamamaktadır: Bu değişiklik, YouTube Studio'daki API işlevlerini Studio uygulaması.

  • Oynatma listesi raporları bölümü, daha ayrıntılı olarak açıklandığı şekilde güncellendi. oynatma listesi raporları için desteklenen metrik türleri:

    • Toplu video metrikleri Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz: Bu içerik sahibinin oynatma listeleri de Birleştirilmiş video metrikleri: yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler Oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtmalıdır. Bu metrikler verilerini dahil edeceği zaman, oynatma listesindeki sahip olunmayan videolardan gelen izlemeleri de içerir. oynatma listesi bağlamında yer verildiğinden emin oluruz.
    • Desteklenen oynatma listesi metrikleri bölümü, şu anda izlediğiniz toplu video metriklerini ve oynatma listesi içi oynatma listesi raporları için desteklenir.

  • Aşağıdaki yeni oynatma listesi içi metrikler, şunlar için oynatma listesi raporlarında desteklenmektedir: içerik sahipleri. Bu metriklerin yalnızca API isteği, raporlarda isCurated boyutu kullanılmaz. Bkz. metrics belgesi her metriğin tanımı:

  • views cihazının davranışı metriği artık oynatma listesi raporunu alan API isteğinin isCurated boyut:

    • Bir istek isCurated boyutunu içerdiğinde views metriği, oynatma listesinde yer alıyor bu video bağlamında görüntüleme sayısını gösteren metrik oynatma listeleri oluşturun.
    • Bir istek isCurated boyutunu içermediğinde views metriği, toplam sayıyı belirten birleştirilmiş bir video metriğidir içerik sahibinin oynatma listelerindeki videoların kaç kez izlendiğine bakılmaksızın görüntüleme sayısı oynatma listesi bağlamında gerçekleşti. Toplu toplam yalnızca şu içeriklerin görüntülemelerini içerir: Oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videolar.

      isCurated boyutunun kullanılmadığı bu raporlarda, playlistViews metriği, videoların görüntülenme sayısını belirtir bir bağlam sunar. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını Video ve YouTube'u kullanabilirsiniz.

  • Her bir oynatma listesi raporu için içerik sahibi raporları Şuna bağlı olarak, artık ilgili rapor için desteklenen metrikleri gösteren tablolar API isteğinin isCurated boyutunu içerip içermediği. Daha ayrıntılı bilgi için zamana dayalı oynatma listesi raporları inceleyebilirsiniz.

19 Ocak 2024

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

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

    isCurated boyutun kanal raporları için desteği sonlandırılmıştır. Artık desteklenmeyecek veya (30 Haziran 2024 tarihinden sonra) Bu boyutun tanımı buna göre güncellenmiştir.

    isCurated öğesini kaldırdığınızda geriye dönük uyumluluğu korumak için boyutunu almak için playlistViews metriğini almak üzere kodunuzu da güncellemeniz gerekir. views metriğine karşılık gelir. views tarihinden beri oynatma listesi raporları için desteklenmeye devam etse de API, farklı bir anlama gelse de metrik adını güncellemezseniz veri döndürmeye devam eder. Tabii ki uygulamanızda değişiklik hem views hem de playlistViews öğesini almak ve görüntülemek için.

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

    • continent ve subcontinent gibi konum filtreleri aynı değildir yeni kanal oynatma listesi raporlarında desteklenir.
    • redViews ve estimatedRedMinutesWatched metrikleri artık kullanılmıyor yeni kanal oynatma listesi raporlarında desteklenir. Bu metrikler YouTube Studio'da kullanılamadığından Bu değişiklik, API işlevini Studio uygulamasında bulunan işlevlerle uyumlu hale getirecek.
    • subscribedStatus ve youtubeProduct boyutları artık kullanılmıyor Kanal oynatma listesi raporlarında filtre olarak desteklenir. Bu filtreler şurada kullanılamamaktadır: Bu değişiklik, YouTube Studio'daki API işlevlerini Studio uygulaması.

  • Oynatma listesi raporları bölümü, daha ayrıntılı bir şekilde açıklandığı şekilde güncellendi. oynatma listesi raporları için desteklenen metrik türleri:

    • Toplu video metrikleri Şuradaki tüm videolar için birleştirilmiş kullanıcı etkinliği ve gösterim metriklerini sağlayabilirsiniz: kanaldaki oynatma listelerinden de gösterilir. Birleştirilmiş video metrikleri: yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler Oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtmalıdır. Bu metrikler verilerini dahil edeceği zaman, oynatma listesindeki sahip olunmayan videolardan gelen izlemeleri de içerir. oynatma listesi bağlamında yer verildiğinden emin oluruz.
    • Desteklenen oynatma listesi metrikleri bölümü, şu anda izlediğiniz toplu video metriklerini ve oynatma listesi içi oynatma listesi raporları için desteklenir.

  • Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenmektedir. Bu metrikler, içerik sahibi raporları için henüz desteklenmemektedir. Bu metriklerin yalnızca raporları almak için kullanılan API isteği isCurated boyutu. Bkz. metrics belgesi her metriğin tanımı:

  • views cihazının davranışı metriği artık oynatma listesi raporunu alan API isteğinin isCurated boyut:

    • Bir istek isCurated boyutunu içerdiğinde views metriği, oynatma listesinde yer alıyor bu video bağlamında görüntüleme sayısını gösteren metrik kanal oynatma listeleri oluşturun.
    • Bir istek isCurated boyutunu içermediğinde views metriği, toplam sayıyı belirten birleştirilmiş bir video metriğidir Bu videonun izlenme oranından bağımsız olarak, kanalın oynatma listelerindeki videoların görüntülenme sayısı görüntüleme sayısı oynatma listesi bağlamında gerçekleşti. Toplu toplam yalnızca şu içeriklerin görüntülemelerini içerir: Oynatma listesinin sahibi olan kanala ait videolar.

      isCurated boyutunun kullanılmadığı bu raporlarda, playlistViews metriği, videoların görüntülenme sayısını belirtir bir bağlam sunar. Bu metrik, oynatma listesindeki tüm videoların görüntüleme sayısını Video ve YouTube'u kullanabilirsiniz.

  • Kanal, her oynatma listesi raporu için Şuna bağlı olarak, artık ilgili rapor için desteklenen metrikleri gösteren tablolar API isteğinin isCurated boyutunu içerip içermediği. Daha ayrıntılı bilgi için zamana dayalı oynatma listesi raporları inceleyebilirsiniz.

4 Aralık 2023

YouTube Analytics (Hedeflenen Sorgular) API'si, insightTrafficSourceType. boyut değerleri. Önceden, bir oynatma listesinin parçası olarak oynatılan videolar arasındaki fark (PLAYLIST) ve oynatma listesindeki tüm videoların listelendiği bir sayfadan gelen görüntülemeler (YT_PLAYLIST_PAGE). Bundan sonra, her iki görüntüleme türü de PLAYLIST boyut değeri.

15 Aralık 2022

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

  • Yeni bir rapor, şehre göre kullanıcı etkinliğini sunar. Bu rapor şunlar için kullanılabilir: kanallar ve içerik sahipleri ile bağlantı kurabilir. Bu rapor yeni city içeriyor YouTube'un, kullanıcı etkinliğinin gerçekleştiği şehirle ilgili tahminini tanımlayan boyuttur.

  • Yeni creatorContentType boyut, kullanıcı etkinliğiyle ilişkilendirilmiş YouTube içeriğinin türünü tanımlar kullanabilirsiniz. Desteklenen değerler: LIVE_STREAM, SHORTS, STORY ve VIDEO_ON_DEMAND.

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

  • YouTube Analytics API örnek istekleri kılavuzunda artık her iki yeni boyut için de örnekler bulunmaktadır.

  • 7DayTotals ve 30DayTotals boyutlarına yapılan referanslar belgelerden kaldırılmıştır. Bu boyutların kullanımdan kaldırılacağı Ekim ayında duyurulmuştur 2019.

26 Ağustos 2022

YouTube Analytics (Hedeflenen Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si yeni bir trafik kaynağı ayrıntı değerini destekler:

11 Şubat 2022

gender boyutu için geçerli değerler grubu Ağustos'ta veya sonrasında değişecek 11 Eylül 2022 tarihinde sona erecektir. Bu, API uygulamanızda geriye dönük olarak uyumsuz bir değişiklik olabilir. Geri YouTube API Hizmetleri Hizmet Şartları'ndaki Uyumsuz Değişiklikler altı ay önce duyurulacaktır. Lütfen API uygulamanızı güncelleyin .

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

  • YouTube Analytics (Targeted Sorgular) API'sinde Şu anda gender boyut şu iki değeri destekler: female ve male. 11 Ağustos 2022 tarihinde veya sonrasında boyut üç değeri destekler: female, male ve user_specified.
  • YouTube Reporting (Toplu Raporlar) API'sinde Şu anda gender boyut üç değeri destekler: FEMALE, MALE ve GENDER_OTHER. 11 Ağustos 2022'de veya sonrasında, desteklenen değerler grubu FEMALE olarak değişecek. MALE ve USER_SPECIFIED.

9 Şubat 2022

İki metrik, hariç tutulacak şekilde güncellendi Şu andan itibaren döngülerdeki klipler trafiği 13 Aralık 2021. Bu değişiklik hem YouTube Analytics (Hedeflenen Sorgular) API'sini hem de YouTube Reporting (Toplu Raporlar) API'si.

2 Şubat 2022

Bu YouTube Reporting (Toplu Raporlar) API'si, şu özelliklere sahip yeni bir trafik kaynağı boyut değerini destekler: görüntülemelerin kaynaklandığı yeri Live Redirect'ler:

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

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

23 Eylül 2020

Bu YouTube Analytics (Hedeflenen Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si İzleyicinin yönlendirdiğini gösteren yeni bir trafik kaynağı boyut değerini destekler YouTube Shorts izleme deneyiminde dikey kaydırma:

  • YouTube Analytics API (Targeted Sorgular) API'sinde insightTrafficSourceType. boyutu, SHORTS değerini destekliyor.
  • YouTube Reporting (Toplu Raporlar) API'sinde traffic_source_type. boyutu, 24 değerini destekliyor.

Trafik kaynağı ayrıntısı boyutu: insightTrafficSourceDetail. YouTube Analytics API veya traffic_source_detail değeri — bu yeni trafik kaynağı türü için doldurulmaz.

20 Temmuz 2020

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

13 Şubat 2020

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

Her iki API'de de bildirimler için olası trafik kaynağı ayrıntı değerleri grubu değişiyor. Hedeflenen sorgularda, bildirimler insightTrafficSourceType=NOTIFICATION olarak bildirildi. İçinde toplu raporlar bildirimler traffic_source_type=17 olarak bildirildi.

Yeni değerler, daha önce yüklenen videolar ve canlı yayınlarla ilgili bildirimleri böler. uploaded olarak raporlandı ve iki kategoriye ayrılır:

  • uploaded_push - Görüntülemelerin kaynağı, adresine gönderilen push bildirimleri Video yüklendiğinde abone sayısı
  • uploaded_other - Push dışı bildirimlerden kaynaklanan görüntülemeler. Örneğin: Video yüklendiğinde abonelere gönderilen e-posta veya gelen kutusu bildirimleri.

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

Ayrıca, bu değerlerin bildirimlerin kendisini değil trafiği temsil ettiğini hatırlatmak isteriz. belirli YouTube görüntülemelerini sağlayan kaynaklar hakkında bilgi edinin. Örneğin, bir rapor satırında views=3 gösteriliyorsa traffic_source_type=17 (NOTIFICATION) ve traffic_source_detail=uploaded_push, satır, üç görüntülemenin izleyicilerin video yüklendiğinde gönderilen push bildirimlerini tıklamasından kaynaklandı.

15 Ekim 2019

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

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

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

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

    • Yedi günlük dönemdeki görüntüleme sayısı, söz konusu dönemin her günündeki görüntüleme sayısı toplanarak hesaplanabilir.
    • Yedi günlük bir dönem için izleyici yüzdesi, videoyu izlerken oturum açan izleyicilerin sayısını elde etmek amacıyla, her gün gerçekleşen görüntüleme sayısı ile ilgili gündeki izleyici Yüzdesi sayısının çarpılmasıyla hesaplanabilir. Ardından, oturum açmış izleyicilerin sayısı tüm dönem için eklenebilir ve söz konusu dönemdeki toplam görüntüleme sayısına bölünür. Böylece tüm dönem için izleyici yüzdesi elde edilir.
    • Aynı izleyici, farklı günlerde tekil izleyici olarak hesaplanabileceğinden, yedi günlük bir dönemdeki benzersiz görüntüleyen sayısı hesaplanamaz. Ancak, 30 günlük bir dönemdeki benzersiz izleyici sayısıyla ilgili verileri tahmin etmek için 30DayTotals boyutu yerine month boyutunu kullanabilirsiniz. month boyutu takvim aylarını gösterirken 30DayTotals boyutunun belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemler hesapladığını unutmayın.

27 Haziran 2019

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

  • API'nin 1. sürümü artık tamamen kullanımdan kaldırıldığından, kullanımdan kaldırma bildirimi ve sürüm 2'ye nasıl güncelleme yapılacağını açıklayan geçiş rehberi de dahil olmak üzere dokümanlarda bu sürümle ilgili referanslar kaldırıldı.

1 Kasım 2018

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

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

    Kullanımdan kaldırma takviminin ilk olarak 26 Nisan 2018'de duyurulduğunu unutmayın.

17 Eylül 2018

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

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

    1. Belirli bir dönemde videonun veya kanalın sınırlı trafiği olması

      veya

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

    Yeni bölüm, YouTube Analytics raporlarında sınırlı olabilecek veri türleriyle ilgili bir tartışma da içerir.

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

18 Haziran 2018

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

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

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

23 Mayıs 2018

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

  • API'ye Genel Bakış, metrikleri ve silinen öğeleri toplama adlı yeni bir bölüm içerir. Bu bölümde, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkilendirilen verileri nasıl ele aldığı açıklanmaktadır.
  • API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklar için ek meta verileri almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d arasındaki bölümler) belirtildiği üzere API istemcileri, söz konusu API'de depolanan kaynak meta verilerini 30 gün sonra silmeli veya yenilemelidir.

22 Mayıs 2018

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

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

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

      Bu duyurudan önce, tüm API raporları oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir durumdaydı. Bu politika değişikliği yürürlüğe girdikten sonra, 30 günden eski geçmiş veri raporlarına da API üzerinden erişilemeyecek. 60 günden eski olan diğer raporlara da artık erişemezsiniz. Bu nedenle dokümanlarda artık, politika değişikliğinden önce oluşturulan raporların 180 güne kadar kullanılabileceği belirtiliyor.

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

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

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

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

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

26 Nisan 2018

YouTube Analytics (Targeted Sorgular) API'sinin (v2) 2. sürümü artık herkesin kullanımına açıktır. Aşağıdaki liste, yeni API sürümüyle ilgili ürün ve belge değişikliklerini tanımlar:

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

    • API'nin v1 olan sürümü v2 olarak değişti.
    • API istekleri için temel URL https://www.googleapis.com/youtube/analytics/v1 iken https://youtubeanalytics.googleapis.com/v2 olarak değiştirildi.
    • reports.query yöntemine ilişkin bazı parametrelerin adları güncellendi. Özellikle, v1 API'sinde end-date gibi kısa çizgi içeren parametre adlarında v2 API'de kısa çizgi (endDate) yerine büyük/küçük harf kullanılır. API'nin grup oluşturma ve yönetme yöntemleri parametre adları için zaten büyük/küçük harf kullanımı kullandığından bu değişiklik, API genelinde parametre adlarını tutarlı hale getirir.
    • v2 API, Google'ın global HTTP toplu uç noktasına (www.googleapis.com/batch) gönderilen toplu istekleri desteklemez. Toplu istekleri v2 API'de gönderiyorsanız bunun yerine https://youtubeanalytics.googleapis.com/v2 uç noktasını kullanmanız gerekir.

    Ayrıca bazı v1 özellikleri v2 API'de desteklenmez:

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

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

    API'nin 1. sürümü (v1) artık kullanımdan kaldırıldı ve 31 Ekim 2018'e kadar desteklenecek. v1 API'ye yapılan tüm istekler bu tarihten sonra çalışmayı durduracak. Bu nedenle, YouTube Analytics verilerine API aracılığıyla erişiminizin kesintiye uğramaması için en geç 31 Ekim 2018 tarihine kadar v2 API'ye geçmeyi unutmayın.

21 Şubat 2018

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

  • Görüntüleme istatistiklerini görüntüleyen demografi verilerini temel alan, izleyici demografi raporları yaş grubu ve cinsiyet, kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlayan youtubeProduct boyutunu artık desteklemiyor.

18 Ocak 2018

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

  • YouTube Reporting API (Toplu Raporlar)

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

  • 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ırmasını desteklemektedir. gzip sıkıştırmanın diğer API isteği türleri için desteklenmediğini unutmayın. gzip sıkıştırmasının etkinleştirilmesi, her bir API yanıtı için gereken bant genişliğini azaltır. Uygulamanızın, API yanıtlarını açmak için ek CPU süresine ihtiyacı olacak olsa da daha az ağ kaynağı tüketmenin avantajı, genellikle bu maliyetten daha ağır basar.

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

    Accept-Encoding: gzip

    Bu işlev, API'ye genel bakış ve report kaynağının downloadUrl özelliğinin tanımında açıklanmaktadır.

  • age group ve gender boyutlarıyla ilgili belgeler, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bu düzeltmenin belgelerle ilgili olduğunu ve API işlevlerinde veya davranışında herhangi bir değişiklik olmadığını hatırlatmak isteriz. Özellikle aşağıdaki değerler değişti:

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

10 Ağustos 2017

Bu belge, 10 Ağustos 2016'da YouTube Analytics API'nin earnings metriğinin kullanımdan kaldırıldığını duyurdu. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue adlı yeni bir metrik için destek eklemiştir.)

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

API dokümanları, earnings metriğine yönelik kalan referansları kaldıracak şekilde güncellendi.

6 Temmuz 2017

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

  • YouTube Analytics API (Hedeflenen Sorgular)

    • API belgeleri, API yanıtlarının, istenen tarih aralığında sorgulanan tüm metriklerin kullanılabilir olduğu son güne kadar olan verileri içerdiğini yansıtacak şekilde güncellendi.

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

    • adType boyutu artık reservedBumperInstream değerini destekliyor. Bu değer, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamı ifade eder. Reklam biçimi auctionBumperInstream reklamı ile aynı olsa da bu tür, açık artırma yerine ayrılmış olarak satılan reklamları ifade eder.

  • YouTube Reporting API (Toplu Raporlar)

    • ad_type boyutu artık, ayrılmış olarak satılan bumper reklamları ifade eden 20 değerini destekliyor. Bumper reklamlar, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamlardır. Bu boyut için 19 değerinin, ayrılmış bir şekilde değil, açık artırma yöntemiyle satılan bumper reklamları ifade ettiğini unutmayın.

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

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

      Bu rapor türlerinin 15 Eylül 2016'da kullanımdan kaldırılacağı duyuruldu ve 15 Aralık 2016'dan sonra bu rapor türleri için artık rapor oluşturulmadı. Önceden oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılmaya devam ediyordu. Bu sayede, bazı raporlara 15 Haziran 2017 gibi geç bir tarihte erişebiliyordu. Ancak raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

24 Mayıs 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Bu rapor türlerinin 22 Haziran 2016'da kullanımdan kaldırılacağı duyuruldu ve 22 Eylül 2016'dan sonra bu rapor türleri için artık rapor oluşturulmadı. Önceden oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün süreyle kullanılmaya devam ediyordu. Bu sayede, bazı raporlara 22 Mart 2017 gibi geç bir tarihte erişebiliyordu. Ancak raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

22 Mayıs 2017

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

  • YouTube Reporting API (Toplu Raporlar)

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

      • 85: YouTube Music
      • 86: YouTube Oyun
      • 87: YouTube Çocuk
      • 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ümanlarda Kakao (Kakao Talk) olarak güncellendi. Bu değişiklikle birlikte, bu hizmetlerle paylaşılan videoların API davranışı veya sınıflandırmasında herhangi bir değişiklik yapılmamıştır.

  • YouTube Analytics API (Hedeflenen Sorgular)

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

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 Mart 2017

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

17 Mart 2017

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

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

    • redViews metriği, bir videonun YouTube Red üyeleri tarafından kaç kez görüntülendiğini tanımlar.
    • estimatedRedMinutesWatched metriği, YouTube Red üyelerinin bir videoyu kaç dakika izlediğine dair metriği belirler.

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

3 Mart 2017

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

  • YouTube Reporting API (Toplu Raporlar)

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

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

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

    • Görüntülemelerin gerçekleştiği cihazın yazılım sistemini tanımlayan operating_system boyutu artık aşağıdaki değerleri desteklemektedir:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • content_owner_basic_a1 rapor türündeki tüm raporlama işleri silindi. Bu rapor türü 19 Ağustos 2016 itibarıyla tamamen kullanımdan kaldırılmıştı, ancak daha önce oluşturulan content_owner_basic_a1 raporları, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir durumdaydı. Bu sayede, bazı raporlara 19 Şubat 2017 gibi geç bir tarihte erişebiliyordu. Ancak raporlar artık kullanılamadığı için raporlarla ilişkili işler de gerekli değildir.

  • YouTube Analytics API (Hedeflenen Sorgular)

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

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

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

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

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

8 Şubat 2017

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

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

Bu kurallar, API isteği birden çok kanala ait verileri aldığında da geçerli olur:

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

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

15 Aralık 2016

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

API referans belgelerindeki geçerli rapor türleri listesi de güncellendi.

11 Kasım 2016

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

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

    8 Kasım 2016

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

    • Aşağıdaki listede bulunan metrikler kullanımdan kaldırılmıştır ve artık desteklenmemektedir. 10 Ağustos 2016'da duyurulduğu gibi, aynı verileri referans alan yeni metrikler zaten desteklenmektedir. Aşağıdaki tabloda, desteği sonlandırılmış metrik adı ve yeni metrik adı gösterilmektedir:

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

    27 Ekim 2016

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

    Sistem tarafından yönetilen raporlara genel bakış, yeni raporlara kısa bir genel bakış sağlar ve API aracılığıyla bu raporları alma sürecini açıklar. İş ortaklarının raporları oluşturmak için işleri planlamasına gerek olmadığından bu işlem, YouTube Analytics için toplu rapor alma işleminden biraz farklıdır.

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

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

    27 Eylül 2016

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

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

    15 Eylül 2016

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

    19 Ağustos 2016

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

    • content_owner_basic_a1 raporu tamamen kullanımdan kaldırıldı ve dokümanlardan kaldırıldı. YouTube artık bu türden yeni raporlar oluşturmayacak. Bununla birlikte, daha önce oluşturulmuş raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam edecek.

      content_owner_basic_a1 raporunun yerini, 19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklandığı gibi content_owner_basic_a2 raporu alacaktı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 kapsamlı güncellemeler sağlar. Bu güncelleme, 10 Şubat 2017'de yürürlüğe girecek Güncellenen Şartlar'a ek olarak, geliştiricilerin uyması gereken politikaların açıklanmasına yardımcı olacak birkaç destekleyici belge içerir.

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

    10 Ağustos 2016

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

    • YouTube Analytics API (Hedeflenen Sorgular)

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

        Aşağıdaki tabloda yer alan metriklerin desteği sonlandırılıyor. Aynı zamanda, aynı verilere atıfta bulunan yeni metrikler de kullanıma sunuluyor. Bu durum, eski metriklerin yeniden adlandırıldığı anlamına gelir. Ancak YouTube Analytics API, tabloda listelenen kullanımdan kaldırma tarihlerine kadar her iki metrik adını da destekleyecektir.

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

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

        Örneğin, 4 Kasım 2016 tarihine kadar bir API isteği impressionBasedCpm metriğini, cpm metriğini veya her ikisini birden belirtebilir. Ancak bu tarihten sonra yalnı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 özellik, görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklandığını gösterir.
        • END_SCREEN: Veriler, başka bir videonun son ekranından gelen görüntülemelerle ilgilidir.

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

      • adType boyutu artık auctionBumperInstream değerini destekliyor. Bu değer, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamı ifade eder.

    • YouTube Reporting API (Toplu Raporlar)

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

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

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

      • ad_type boyutu artık, bir videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamlar olan bumper reklamlarla ilişkili 19 değerini artık destekliyor.

    18 Temmuz 2016

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

    • YouTube Analytics API (Hedeflenen Sorgular)

      • Aşağıdaki kanal raporlarında desteklenen metriklerin listesi, kart metriklerini içerecek şekilde güncellendi. Bu raporlara kart metrikleri için destek 28 Haziran 2016 tarihinde eklenmiş olup bu tarihe ait düzeltme geçmişi girişinde bu değişiklik daha ayrıntılı olarak açıklanmaktadır. Raporlar şunlardır:
        • ABD eyaletleri için temel kullanıcı etkinliği
        • ABD eyaletlerindeki belirli dönemler için kullanıcı etkinliği
        • Eyalete göre kullanıcı etkinliği
        • Abone olma durumuna göre kullanıcı etkinliği
        • İller için abone durumuna göre kullanıcı etkinliği
        • Eyaletlere göre en popüler videolar
        • Abone olan veya abone olmayan izleyiciler için en popüler videolar

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

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

    • YouTube Reporting API (Toplu Raporlar)

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

    28 Haziran 2016

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

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

    22 Haziran 2016

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

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

      Daha önce belgeler, API isteğinin gönderildiği tarihten en fazla 180 gün öncesine kadar raporların kullanılabilir olduğunu belirtiyordu. Teknik açıdan da doğru olsa da orijinal metin en iyi ihtimalle biraz kafa karıştırıcıydı.

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

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

      • Sürümleri yeni olan iki rapor yeniden adlandırıldı:

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

        Yeniden adlandırılan her iki rapor da öncekilerden şu yönleriyle farklılık gösterir:

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

      Bu raporların herhangi birinde işiniz varsa YouTube'un 22 Eylül 2016'dan sonra bu işler için yeni raporlar oluşturmasını beklememelisiniz. Oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam eder.

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

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

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

    • Reporting API'nin boyutlar dokümanları, elapsed_video_time_percentage ve audience_retention_type mülklerinin listelenmemesi için güncellendi. Bu boyutlar, şu anda API üzerinden kullanılabilen raporlar tarafından desteklenmemektedir.

    19 Mayıs 2016

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

    • API, içerik sahipleri için kullanıcı etkinliği raporunun yeni bir sürümünü destekler. Yeni raporun rapor türü kimliği: content_owner_basic_a2. Raporun önceki sürümünden (content_owner_basic_a1) farklı olarak yeni sürüm likes ve dislikes metriklerini destekler.

      content_owner_basic_a1 raporunu oluşturmak için işiniz zaten 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şturmak için otomatik olarak bir iş oluşturmaz. Bazı uygulamalarda, yeni ve beklenmedik bir işin ortaya çıkması yıkıcı bir değişiklik olabilir.

      Yeni raporun kullanıma sunulmasıyla birlikte, content_owner_basic_a1 raporu kullanımdan kaldırıldı. Bu rapor için bir işiniz varsa, YouTube'un 19 Ağustos 2016'dan sonra bu iş için yeni raporlar oluşturmasını beklememelisiniz. Oluşturulan raporlar, oluşturuldukları andan itibaren 180 gün boyunca kullanılabilir olmaya devam eder.

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

      • reportType kaynağının deprecateTime özelliği, rapor türünün kullanımdan kaldırılacağı tarih ve saati belirtir. Bu mülkte yalnızca desteğinin sonlandırıldığı bildirilen raporlar için bir değer bulunur. Bu değer, YouTube'un bu türden raporlar oluşturmayı durduracağı tarihi temsil eder.

        Bir rapor türünün desteğinin sonlandırıldığı duyurulduktan sonra YouTube, bu tür raporları üç ay daha oluşturur. Örneğin, 19 Mayıs 2016'da yapılan bu güncellemede content_owner_basic_a1 raporunun kullanımdan kaldırılacağı duyurulmuştur. Böylece, söz konusu rapor türünün deprecateTime özelliği 19 Ağustos 2016'da bir zaman belirtir ve YouTube bu tarihten sonra bu türden raporlar oluşturmayı durdurur.

      • job kaynağının expireTime özelliği, işin süresinin dolduğu veya sona ereceği tarih ve saati belirtir. İşle ilişkili rapor türü kullanımdan kaldırıldıysa veya iş için oluşturulan raporlar uzun süredir indirilmemişse bu mülkte bir değer bulunur. Tarih, YouTube'un artık iş için yeni raporlar oluşturmayacağı zamanı belirtir.

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

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

    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 planlanan zamanından önceki 180 günlük dönemi kapsayan veriler oluşturmaktadır. Daha önce Reporting API geçmiş verileri sunmuyordu. Bu değişiklik, bu duyurudan önce oluşturulanlar dahil olmak üzere tüm işleri etkileyecektir.

      Geçmiş raporlar kullanıma sunulur sunulmaz yayınlanır ancak bir iş için tüm geçmiş verilerin yayınlanması yaklaşık bir ay sürer. Dolayısıyla, bir raporlama işi planladıktan bir ay sonra, yaklaşık yedi aylık verilere erişebilirsiniz. (Bu duyurudan önce oluşturulan işlere ait tüm geçmiş veriler, duyurudan sonraki bir ay içinde yayınlanmalıdır.)

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

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

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

      • Dokümanlar artık raporların oluşturulduktan sonraki 180 gün boyunca kullanılabilir olduğunu ve bu nedenle API istemcileri tarafından indirilebileceğini belirtmektedir. Daha önce belgeler, API isteğinin gönderildiği tarihten altı ay öncesine kadar raporların kullanılabilir olduğunu belirtiyordu.

      • Belgeler, API'nin artık veri bulunmadığı günler için indirilebilir raporlar oluşturduğunu yansıtacak şekilde güncellendi. Bu raporlar başlık satırları içerir ancak ek veriler içermez.

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

      Sistem tarafından yönetilen raporların kullanıma sunulmasına hazırlık kapsamında aşağıdaki API değişiklikleri duyurulmuştur:

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

      • jobs.list yönteminin yeni includeSystemManaged parametresi, API yanıtının sistem tarafından yönetilen raporlara yönelik işleri içerip içermediğini gösterir. Parametrenin varsayılan değeri: false.

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

        Raporun oluşturulma zamanıyla ilişkili olan yöntemin createdAfter parametresinden farklı olarak, yeni parametreler rapordaki verilerle ilgilidir.

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

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

    28 Mart 2016

    YouTube Reporting API ve YouTube Analytics API artık birçok ek paylaşım hizmeti için görüntüleme istatistiklerini döndürüyor.

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

    16 Mart 2016

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

    YouTube Reporting API

    • playback_location_type boyutu iki yeni boyut değerini destekler:
      • 7: Veriler, YouTube ana sayfasında veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
      • 8: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
    • traffic_source_type boyutu, boyut değeri olarak artık 18 değerini destekliyor. Bu değer, video görüntülemelerinin, oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını belirtir. Bu kaynak, görüntülemelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini gösteren 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 ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
      • SEARCH: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
    • insightTrafficSourceType boyutu, boyut değeri olarak artık YT_PLAYLIST_PAGE değerini destekliyor. Bu değer, video görüntülemelerinin, oynatma listesindeki tüm videoların listelendiği bir sayfadan kaynaklandığını belirtir. Bu kaynak, görüntülemelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini gösteren PLAYLIST kaynak türünden farklıdır.

    8 Şubat 2016

    YouTube Analytics API'si için desteklenen metriklerin listesi, kart metriklerinin artık söz konusu API için desteklenen metrikler olarak listelenmemesini sağlayacak şekilde güncellendi. (Söz konusu API'nin raporlarından hiçbirinin kart metriklerini desteklediği belirtilmemiştir.)

    Birçok kanal ve içerik sahibi raporunda bu metrikleri destekleyen YouTube Reporting API'yi kullanarak kart metriklerini almaya devam edebilirsiniz.

    6 Ocak 2016

    Hem YouTube Reporting API hem de YouTube Analytics API artık bir Chromecast cihazı üzerinden gerçekleşen görüntülemeleri özel olarak tanımlamaktadır.

    • 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

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

    18 Aralık 2015

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

    15 Aralık 2015

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

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

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

      Dokümanlar, kanallar ve içerik sahipleri tarafından kullanılabilen yeni oynatma ayrıntısı raporlarını tanımlayacak şekilde güncellendi. Ayrıca diğer birçok raporda, bu boyutlardan bir veya daha fazlasının bu raporlarda isteğe bağlı olarak boyut ve/veya filtre olarak kullanılabileceğini belirten bir güncelleme yapıldı.

    • Raporları açıklayan tabloların biçimi, her bir raporu almak için kullanılabilecek geçerli boyut, metrik ve filtre kombinasyonlarını tanımlamanızı kolaylaştırmak amacıyla değiştirilmiştir. "Cihaz Türü"nü açıklayan aşağıdaki tablo yeni biçimi gösterir:

      İçindekiler
      Boyutlar:
      Zorunlu deviceType
      0 veya daha yüksek bir değer kullanın day, liveOrOnDemand, subscribedStatus, youtubeProduct
      Metrikler:
      1 veya daha fazla alan kullanın görüntüleme sayısı, estimatedMinutesWatched
      Filtreler:
      0 veya 1 değerini kullanın ülke, il, kıta, subContinent
      0 veya 1 değerini kullanın video, grup
      0 veya daha yüksek bir değer kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

    • YouTube Analytics API, API kullanıcısının birden çok değeri destekleyen filtrelerden veri alamadığı öğeleri artık otomatik olarak bırakıyor (video, playlist ve channel). Önceden, API kullanıcısı belirtilen öğelerden en az birinin verilerine erişemezse API sunucusu hata döndürürdü.

      Örneğin, bir kullanıcının, video filtresinin 20 video kimliği listelediği bir API isteği gönderdiğini varsayalım. Kullanıcı, videoların 18'ine sahip olur. Ancak, bir video kimliği başka bir kanala ait videoyu tanımlarken, başka bir kimlik de silinen ve bu nedenle artık mevcut olmayan bir videoyu tanımlar. Bu durumda, API sunucusu hata döndürmek yerine artık kullanıcının erişemediği iki videoyu bırakır ve API yanıtı, API kullanıcısının sahip olduğu 18 videoya ilişkin verileri içerir.

    • Boş bir YouTube Analytics group için veri isterseniz API artık hata yerine boş bir veri kümesi döndürüyor.

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

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

    10 Kasım 2015

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

    29 Ekim 2015

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

    • YouTube Reporting API'nin date boyutuyla ilgili dokümanlar, tarihlerin Pasifik saatine göre 00:00'da (UTC-8) başlayan 24 saatlik dönemi referans alacak şekilde düzeltildi. Daha önce, dokümanlarda tarihin 00:00'da (GMT) başladığı belirtiliyordu.

      Ayrıca YouTube Analytics API belgelerinde, tarihle ilgili tüm boyutların (day, 7DayTotals, 30DayTotals ve month) Pasifik saatine göre 00:00'da (UTC-8) başlayan tarihlere işaret ettiği unutulmamalıdır.

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

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

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

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

    8 Ekim 2015

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

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

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

    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 uygulamalar için tasarlanmıştır. Bu verileri filtreleme, sıralama ve maden çıkarma araçlarına sahiptir.

      Her YouTube Reporting API raporu, önceden tanımlanmış bir dizi boyut ve metrik içerir. (YouTube Analytics API raporlarında metrikler ve boyutlar da kullanılır.) Raporda, her veri satırında boyut değerlerinin benzersiz bir kombinasyonu bulunur. Tek tek videolar, ülkeler, canlı videolar, abone olunan kullanıcılar vb. ile ilgili metrikleri hesaplamak için boyut değerlerine göre satırlar arasında verileri birleştirebilirsiniz.

      Raporlama işlerini planlamak için API'yi kullanabilirsiniz. Bu işlerin her biri, YouTube'un oluşturması gereken bir raporu tanımlar. Bir iş oluşturduğunuzda, YouTube eşzamansız olarak indirilebilen günlük rapor oluşturur. Her raporda benzersiz bir 24 saatlik döneme ait veriler yer alır.

    • Farklı API'ler olmalarına rağmen, hem YouTube Analytics API hem de YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini alabilmesini sağlar. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'ye ilişkin belgeler tek bir belge seti olarak yayınlanmaktadır.

      • Doküman kümesindeki Kılavuzlar sekmesi, API isteklerinin yetkilendirilmesine ilişkin talimatlar da dahil olmak üzere her iki API için ortak bilgileri içerir.
      • Toplu raporlar sekmesi, referans belgeleri ve özellikle YouTube Reporting API'ye yönelik diğer içerikleri içerir.
      • Hedeflenen sorgular sekmesi, referans belgeleri ve özellikle YouTube Analytics API'ye yönelik diğer içerikleri içerir.
      • Örnekler sekmesinde, iki API'den biri için mevcut olan kod örnekleri listelenir.
      • Araçlar sekmesinde, geliştiricilerin iki API'den birini uygulamasına yardımcı olacak ek kaynaklar listelenir.

    20 Ağustos 2015

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

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

      • Dokümanlar artık mevcut tüm kanal raporlarının listelendiği bir sayfayı ve mevcut tüm içerik sahibi raporlarının listelendiği başka bir sayfayı içerir. Daha önce belgelerde kanal videosu raporları, kanal oynatma listesi raporları vb. için ayrı sayfalar yer alıyordu.

      • Yeni veri modeline genel bakış bölümünde, API'nin işleyiş şekli hakkında daha net bir tanıtımın sağlanması amaçlanmaktadır. Daha ayrıntılı olarak belirtmek gerekirse, bu doküman YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığını daha iyi açıklamaya çalışmaktadır.

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

    22 Temmuz 2015

    Bu güncellemede, yalnızca içerik sahipleri için geçerli olan çeşitli değişiklikler bulunuyor:

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

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

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

    • Kullanımdan kaldırılan primaryAdGrossRevenue metriğine ek olarak, reklam performansı raporları da artık monetizedPlaybacks ve playbackBasedCpm metriklerini desteklememektedir. 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 iki yeni metriği destekliyor: videosAddedToPlaylists ve videosRemovedFromPlaylists. Kanallar ve içerik sahipleri için video raporları listeleri, yeni metrikleri destekleyen raporları belirlemek üzere güncellendi.

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

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

      Bu metriklere ilişkin veriler 1 Ekim 2014 itibarıyla kullanılabilmektedir.

    31 Mart 2015

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

    • Bu duyurudan itibaren geçerli olmak üzere favoritesAdded ve favoritesRemoved metrikleri için destek sonlandırıldı. Bunların her ikisi de temel metriklerdir ve Hizmet Şartları'nda belirtilen Kullanımdan Kaldırma Politikası'na tabidir.

    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ızı sağlar. 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önetme özelliğinin yanı sıra bu gruplar için rapor verileri alma özelliğini de desteklemektedir.

      • Grup oluşturma ve yönetme

        Bu güncellemeyle, grup oluşturmak ve yönetmek için kullanabileceğiniz group ve groupItem kaynakları kullanıma sunuluyor.

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

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

      • Bir grup için rapor verilerini alma

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

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

    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:

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

      Aynı filtre için birden fazla değer belirtirseniz söz konusu filtreyi istek için belirttiğiniz boyut listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen bir boyut olarak listelenmese bile geçerlidir. Filtreyi boyut listesine eklerseniz API, sonuçları gruplandırmak için filtre değerlerini de kullanır.

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

    16 Temmuz 2014

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

    • Bir kanal raporu alırken artık ids parametresinin değerini channel==MINE olarak ayarlayarak kimliği doğrulanmış kullanıcının kanalı için verileri alabilirsiniz. (Belirtilen kanaldan veri almak için ids parametresini channel==CHANNEL_ID olarak da ayarlayabilirsiniz.)

    • API artık bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikleri içeren oynatma listesi raporlarını desteklemektedir. Oynatma listesi raporları, kanallar ve içerik sahipleri tarafından kullanılabilir.

      Tüm oynatma listesi raporları views ve estimatedMinutesWatched metriklerini, bazıları da averageViewDuration metriğini destekler.

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

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

      Oynatma listesi raporu almak için tüm istekler isCurated filtresini kullanmalıdır. Bu filtrenin 1 (isCurated==1) olarak ayarlanması gerekir.

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

      • audienceWatchRatio metriği, videonun belirli bir noktasında videoyu izleyen kullanıcıların mutlak oranını tanımlar. Bu oran, videonun bir bölümünün izlenme sayısı ile videonun toplam görüntüleme sayısının karşılaştırılmasıyla hesaplanır.

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

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

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

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

      Yeni metriklerin tümü temel metriklerdir ve Kullanımdan Kaldırma Politikası'na tabidir. Ancak, 16 Temmuz 2013 tarihinden itibaren yeni metriklere ilişkin verilerin kullanılabildiğini unutmayın. (annotationClickThroughRate ve annotationCloseRate metriklerine ilişkin veriler, 10 Haziran 2012 tarihinden itibaren kullanılabilir.)

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

    31 Ocak 2014

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

    16 Ocak 2014

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

    • Örnek istekler dokümanı, yakın zamanda kanal ve içerik sahibi raporları için kullanıma sunulan sekmeye benzer bir sekme biçimi kullanılarak örnekleri kategoriler halinde gruplandırmak üzere yeniden tasarlandı. Yeni tasarımda örnekler aşağıdaki kategorilere ayrılmıştır:

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

    • Örnek istekler belgesi, artık kanal raporlarında veya içerik sahibi raporlarında eyalete özgü verileri almayla ilgili yeni örnekler içeriyor.

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

      • Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet): Bu rapor, Kaliforniya'da bir kanalın videolarını izleyen veya içerik sahibi raporlarında içerik sahibinin hak talebinde bulunulan içeriklerini izleyen kullanıcıların yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Bu örnekte, yanıtın yalnızca belirli bir ille ilgili verileri içermesini sağlamak için filters parametresi kullanılmaktadır.

    • province boyutunun tanımı, dimensions parametre değerine province eklendiğinde, filters parametre değerine country==US eklenerek isteğin verileri ABD ile de sınırlaması gerektiğini dikkate alacak ş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ın listelendiği dokümanlar yeniden tasarlandı. Olası tüm raporları listeleyen bir tablo sağlamak yerine her bir doküman, raporları kategoriler halinde gruplandırır:

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

      Her dokümanda bu kategoriler bir sekme listesi olarak görüntülenir. Herhangi bir sekmeyi tıklayarak ilgili kategorideki desteklenen raporları görebilirsiniz.

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

      • province boyutu, ABD eyaletlerine ve Kolombiya Bölgesi'ne ait istatistikleri almanıza olanak tanır. API, bu boyutun iki kullanımını destekler:

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

          • Temel istatistik raporu, görüntüleme sayıları ve tahmini izleme süresi gibi çeşitli istatistikler sunar.
          • Zamana dayalı rapor da aynı istatistikleri sunar ancak verileri günlük, 7 günlük, 30 günlük veya aylık bazda toplar.

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

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

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

        Her alt bölge yalnızca bir kıtayla ilişkilendirildiğinden, subContinent filtresini kullanırken continent filtresini de kullanmanız gerekmez. (Aslında, istekte her iki boyut da kullanılıyorsa API hata döndürür.)

    • Dokümanlar, insightTrafficSourceDetail boyutunun geçerli bir filtre değeri olarak insightTrafficSourceType değerini 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 Kullanımdan Kaldırma Politikası'na tabidir. Ancak API'nin temel olmayan boyutları ve temel olmayan metrikleri, Kullanımdan Kaldırma Politikası'na tabi değildir. Boyutlar ve metrikler sayfaları, temel boyutlar ve temel metrikler listelenecek şekilde güncellendi. Ayrıca bu sayfalardaki tanımlar, temel boyutları ve metrikleri açıkça tanımlamak için güncellenmiştir.

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

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

    • API artık insightTrafficSourceType boyutu için PLAYLIST değerini desteklemektedir. Bu değer, video görüntülemelerinin bir oynatma listesinden yönlendirildiğini gösterir. Daha önce bu görüntülemeler, 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 boyut ve metriğe göre sıralama özelliğini destekliyor. Örnek istekler dokümanı, bu işlevi gösteren yeni bir örnek içerir: İstekleri birden çok boyuta/metriğe göre sıralama. İstek, trafik kaynağı verilerini alır ve sort parametre değeri day,-views. Sonuçlar kronolojik olarak sıralanır. Ancak her güne ait sonuç kümesinde ilk satırda, en çok görüntüleme alan trafik kaynağına ait veriler, ikinci satırda ise sonraki en yüksek görüntüleme sayısına sahip kaynakla ilgili veriler yer alır.

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

      • deviceType raporu; masaüstü, mobil ve tablet cihazlar da dahil olmak üzere farklı cihaz türleri için görüntüleme sayılarını ve tahmini izlenme süresini almanıza olanak tanır. Ayrıca, cihaz türü raporunu yalnızca Android veya iOS gibi belirli bir işletim sistemini çalıştıran cihazlara ait istatistikleri içerecek şekilde kısıtlamak iç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 öğrenmenize olanak tanır. İşletim sistemi raporunu yalnızca mobil cihazlar veya tabletler gibi belirli bir cihaz türüne ait istatistikleri içerecek şekilde kısıtlamak için de deviceType filtresini kullanabilirsiniz.

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

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

    • insightPlaybackLocationType boyutu, boyutun diğer değerlerinden biri kullanılarak sınıflandırılmamış görüntülemeleri tanı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 metriklerin yanı sıra izlenme süresi metriklerini (estimatedMinutesWatched, averageViewDuration ve averageViewPercentage) alma özelliğini de destekliyor.

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

      Örnek API istekleri belgesi de güncellendi.

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

      • Bu filtreler artık isteğe bağlı country filtresini destekliyor.

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

        • Oynatma konumu ayrıntıları

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

        • Trafik kaynağı ayrıntıları

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

    3 Mayıs 2013

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

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

    • insightTrafficSourceType boyutu artık geçerli bir değer olarak SUBSCRIBER değerini destekliyor. Bu değer, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden yönlendirilen video görüntülemelerini tanımlar. Bu trafik kaynağına göre filtreleme yaparsanı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 yeni reklam performansı raporlarının yanı sıra kazanç ve reklam performansı metriklerini de desteklemektedir. Metriklere ve raporlara yalnızca YouTube İş Ortağı Programı'na katılan YouTube içerik iş ortakları erişebilir.

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

      • Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporları listesi, iki yeni raporu da içeren ve bu metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.

        • earnings: Google'ın sattığı tüm reklam kaynaklarından elde edilen toplam tahmini kazançlar.
        • grossRevenue – Google veya DoubleClick iş ortaklarından elde edilen tahmini brüt gelir.
        • primaryAdGrossRevenue – Google veya DoubleClick iş ortaklarından, raporun kapsadığı video oynatmaları için birincil reklam türü altında toplanan ve sınıflandırılan tahmini brüt gelir.
        • monetizedPlaybacks – En az bir reklam gösterimi yapılan oynatmaların sayısı.
        • playbackBasedCpm: Bin oynatma başına tahmini brüt gelirdir.
        • impressions – Sunulan doğrulanmış reklam gösterimlerinin sayısı.
        • impressionBasedCpm – Bin reklam gösterimi başına tahmini brüt gelir.

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

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

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

    4 Şubat 2013

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

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

    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 özelliği yer alıyor.

    • API, hem kanallar hem de içerik sahipleri için birçok yeni raporu destekler. Bunlar aşağıda açıklanmıştır. Her rapor, kanal raporu veya içerik sahibi raporu olarak sunulur. Boyutlar ve metrikler sayfaları da buna göre güncellendi.

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

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

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

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

      • İzlenme süresi raporları, izleyicilerin içeriklerinizi izlerken harcadıkları süreyi gösterir. Raporlar belirli bir zaman aralığına (gün, önceki yedi gün, önceki 30 gün vb.) veya ülkeye ilişkin verileri toplayabilir. Bir rapor, verileri güne veya ülkeye göre topluyorsa her video görüntülemenin ortalama uzunluğunun yanı sıra her videonun kullanıcıların izlediği ortalama yüzdesini de belirtebilir.

    2 Ekim 2012

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

    • YouTube Analytics API artık tüm geliştiricilerin kullanımına sunulmuştur. Öncelikle erişim isteğinde bulunmak zorunda kalmadan APIs console içindeki Hizmetler panelinden projenize ilişkin API'yi etkinleştirebilirsiniz.

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

    12 Eylül 2012

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

    • Yeni kota kullanımını anlama bölümü, API kota kullanımınızı optimize etmeye yönelik yönergeler sağlamaktadır. API sunucusu, her istek için bir sorgu maliyeti hesaplar ve bu maliyet, API kullanım kotanızdan düşülür. Farklı rapor türlerinin sorgu maliyetleri oldukça farklı olabilir. Bu nedenle, kotanızı verimli bir şekilde kullanmayı planlamanız ve uygulamanızın yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemesi gerekir.

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

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

      Benzer şekilde, kullanılabilir raporlar bölümü, API'nin bu boyutları kullanan raporlara yönelik desteğini yansıtacak şekilde güncellenmiştir.

    • Rapor eden varlık boyutları bölümü, içerik sahibi raporlarını almaya yönelik API isteklerinde verileri bu boyutlardan biri (video, channel veya show) ya da claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak filtrelemesi gerektiğini belirtecek şekilde güncellendi.

    • API artık üstteki video raporları için iki yeni sıralama seçeneğini destekliyor. Kanal raporları veya içerik sahibi raporları olarak sunulan bu raporlar ülke bazında metrikler (görüntüleme sayısı, yorumlar, beğeniler vb.) içerir ve bu metriklerin videoya göre dökümü yapılır. Artık bu raporları videonun izleme sayfasından bir kanala abone olan veya kanaldan abonelikten çıkan kullanıcı sayısına göre sıralayabilirsiniz.

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