İnceleme Geçmişi

Bu sayfada, hem YouTube Reporting API hem de YouTube Analytics API ile ilgili API değişiklikleri ve doküman güncellemeleri listelenmektedir. Her iki API de geliştiricilerin YouTube Analytics verilerine erişmesini sağlar ancak bu erişim farklı şekillerde gerçekleşir. Bu değişiklik günlüğüne abone olun. Abone ol

22 Eylül 2025

Raporların daha önce duyurulan desteğinin sonlandırılma tarihi 30 Eylül 2025'ten 31 Ekim 2025'e ertelendi. Shorts görüntüleme sayısı değişiklikleri için güncellenen raporların önceki sürümleri, 30 Eylül'e kadar kullanılmaya devam edecek. Ancak Hak Talepleri Raporu v1.0 (content_owner_active_claims_a1) ve Hak Talepleri Raporu v1.1 (content_owner_active_claims_a2) 30 Eylül'de kullanımdan kaldırılacak.

24 Haziran 2025

26 Mart 2025'te duyurulduğu gibi, Toplu Raporlar API'si yeni Shorts görüntüleme sayısı değişikliği kapsamında güncellenecek. Aşağıdaki değişiklikler yapıldı:

  • Görünümleri içeren her rapor için yeni rapor sürümleri oluşturuldu. Bu, raporların büyük bir kısmını kapsıyor. Etkilenen her raporun sürümü bir artırıldı (ör. a2 sürümünden a3 sürümüne).
  • Shorts videolarında görüntüleme sayısı, artık Shorts videolarının oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek. Videolar için herhangi bir değişiklik yapılmadı.
  • Güncellenen raporlarda, önceki görüntüleme sayısı metodolojisini yansıtacak yeni bir sütun (engaged_views) yer alacak.

Bu değişiklikler, Toplu Raporlar API'si için 30 Haziran 2025'ten itibaren geçerli olacaktır. Rapor işlemeyi buna göre ayarladığınızdan emin olun.

Önceki rapor sürümleri 30 Eylül 2025'e kadar kullanılabilir. 30 Eylül 2025'ten sonra önceki sürümler kullanımdan kaldırılacak. En son sürümlere geçiş yaptığınızdan emin olun.

Son olarak, raporları işlerken en iyi uygulamaları izlediğinizden emin olun. Böylece, raporlarda gelecekte yapılacak değişikliklerin işleme kanallarınızı bozmasını önleyebilirsiniz.

Aşağıdaki tablolarda her rapor türü için yeni rapor sürümleri gösterilmektedir:

YouTube Analytics için toplu veri raporları

Kanal raporları - Video raporları
Rapor adı Önceki sürüm En son sürüm
Kullanıcı etkinliği channel_basic_a2 channel_basic_a3
İle göre kullanıcı etkinliği channel_province_a2 channel_province_a3
Oynatma konumları channel_playback_location_a2 channel_playback_location_a3
Trafik kaynakları channel_traffic_source_a2 channel_traffic_source_a3
Cihaz türü ve işletim sistemi channel_device_os_a2 channel_device_os_a3
Altyazılar channel_subtitles_a2 channel_subtitles_a3
Birleşik channel_combined_a2 channel_combined_a3
Kanal Raporları - Oynatma Listesi Raporları
Rapor adı Önceki sürüm En son sürüm
Kullanıcı etkinliği playlist_basic_a1 playlist_basic_a2
İle göre kullanıcı etkinliği playlist_province_a1 playlist_province_a2
Oynatma konumları playlist_playback_location_a1 playlist_playback_location_a2
Trafik kaynakları playlist_traffic_source_a1 playlist_traffic_source_a2
Cihaz türü ve işletim sistemi playlist_device_os_a1 playlist_device_os_a2
Birleşik playlist_combined_a1 playlist_combined_a2
İçerik sahibi raporları - Video raporları
Rapor adı Önceki sürüm En son sürüm
Kullanıcı etkinliği content_owner_basic_a3 content_owner_basic_a4
İle göre kullanıcı etkinliği content_owner_province_a2 content_owner_province_a3
Oynatma konumları content_owner_playback_location_a2 content_owner_playback_location_a3
Trafik kaynakları content_owner_traffic_source_a2 content_owner_traffic_source_a3
Cihaz türü ve işletim sistemi content_owner_device_os_a2 content_owner_device_os_a3
Altyazılar content_owner_subtitles_a2 content_owner_subtitles_a3
Birleşik content_owner_combined_a2 content_owner_combined_a3
İçerik sahibi raporları - Oynatma listesi raporları
Rapor adı Önceki sürüm En son sürüm
Kullanıcı etkinliği content_owner_playlist_basic_a1 content_owner_playlist_basic_a2
İle göre kullanıcı etkinliği content_owner_playlist_province_a1 content_owner_playlist_province_a2
Oynatma konumları content_owner_playlist_playback_location_a1 content_owner_playlist_playback_location_a2
Trafik kaynakları content_owner_playlist_traffic_source_a1 content_owner_playlist_traffic_source_a2
Cihaz türü ve işletim sistemi content_owner_playlist_device_os_a1 content_owner_playlist_device_os_a2
Birleşik content_owner_playlist_combined_a1 content_owner_playlist_combined_a2
İçerik sahibi raporları - Öğe raporları
Rapor adı Önceki sürüm En son sürüm
Kullanıcı etkinliği content_owner_asset_basic_a2 content_owner_asset_basic_a3
İle göre kullanıcı etkinliği content_owner_asset_province_a2 content_owner_asset_province_a3
Video oynatma konumları content_owner_asset_playback_location_a2 content_owner_asset_playback_location_a3
Trafik kaynakları content_owner_asset_traffic_source_a2 content_owner_asset_traffic_source_a3
Cihaz türü ve işletim sistemi content_owner_asset_device_os_a2 content_owner_asset_device_os_a3
Birleşik content_owner_asset_combined_a2 content_owner_asset_combined_a3

Sistem Tarafından Yönetilen Raporlar - Finansal (Müzik Dışı)

İçerik sahibi raporları - Shorts raporları (müzik dışı)
Rapor adı Önceki sürüm En son sürüm
Genel reklam geliri özeti content_owner_shorts_global_ad_revenue_summary_a1 content_owner_shorts_global_ad_revenue_summary_a2
Günlük reklam geliri özeti content_owner_shorts_day_ad_revenue_summary_a1 content_owner_shorts_day_ad_revenue_summary_a2
Ülkeye göre reklam geliri özeti content_owner_shorts_country_ad_revenue_summary_a1 content_owner_shorts_country_ad_revenue_summary_a2
Reklam geliri özeti content_owner_shorts_ad_revenue_summary_a1 content_owner_shorts_ad_revenue_summary_a2

Sistem Tarafından Yönetilen Raporlar - Finansal Olmayan

İçerik sahibi raporları - Hak talebi raporları
Rapor adı Önceki sürüm En son sürüm
Etkin hak talepleri content_owner_active_claims_a2 content_owner_active_claims_a3
İçerik sahibi raporları - Video meta verileri raporları
Rapor adı Önceki sürüm En son sürüm
Video meta verileri content_owner_video_metadata_a3 content_owner_video_metadata_a4
İçerik sahibi raporları - Öğe raporları
Rapor adı Önceki sürüm En son sürüm
Öğeler content_owner_asset_a2 content_owner_asset_a3
Öğe anlaşmazlıkları content_owner_asset_conflict_a2 content_owner_asset_conflict_a3

24 Nisan 2025

26 Mart 2025'te duyurulduğu gibi, Hedeflenen Sorgular API'si yeni Shorts görüntüleme sayısı değişikliği kapsamında güncellenecek:

  • Shorts videolarında views artık Shorts videolarının oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek.
  • Yeni bir metrik olan engagedViews, önceki görüntüleme sayısı hesaplama yöntemini yansıtacak. engagedViews, views ile birlikte tüm raporlarda kullanılabilir.

Bu değişiklikler, Hedeflenen Sorgular API'si için 30 Nisan 2025'ten itibaren geçerli olacaktır. Sorgularınızı buna göre ayarladığınızdan emin olun.

Toplu Raporlar API'sinde hangi değişikliklerin ne zaman yapılacağını öğrenmek için bu düzeltme geçmişini kontrol edin.

22 Nisan 2025

7 Nisan 2024'te duyurulduğu üzere, kanal raporları ve içerik sahibi oynatma listesi raporları için isCurated boyutunun desteği sonlandırıldı. 31 Aralık 2024 itibarıyla bu boyut artık desteklenmemektedir. Boyut, raporlardan ve dokümanlardan kaldırıldı.

26 Mart 2025

Bu güncelleme, YouTube Analytics ve Reporting API'leriyle ilgili aşağıdaki değişikliği içerir:

YouTube, 31 Mart 2025'ten itibaren Shorts görüntülemelerinin sayılma şeklini değiştirecek. Geçmişte Shorts videolarında, videoların belirli bir süre oynatılması görüntüleme olarak sayılıyordu. Artık görüntüleme sayısı, Shorts videonuzun oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek. Minimum izlenme süresi şartı olmayacak. Daha fazla bilgi

YouTube Analytics (Hedefli Sorgular) ve Reporting (Toplu Raporlar) API'leri aşağıdaki değişikliklerle güncellenecek:

  • Shorts videolarında views, Shorts videosunun oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade eder.
  • Yeni bir metrik olan engagedViews kullanıma sunulacak ve önceki görüntüleme sayısı metodolojisini yansıtacak.
  • Bir kanalın sahibiyseniz veya bir kanalın verilerine erişme yetkiniz varsa hem güncellenen görüntülemeleri hem de etkileşimde bulunan görüntülemeleri sorgulayabilirsiniz.

Hedeflenen sorgular 30 Nisan'a kadar, toplu raporlar ise 30 Haziran'a kadar güncellenecek. O zamana kadar görüntülemeler eski yönteme göre hesaplanacak. Shorts ve kanal görüntülemeleri, Studio'daki Analytics ile eşleşmez.

Ayrıca, Günlük Hak Talepleri (1.0 Sürümü) raporunun daha önce duyurulan desteğinin sonlandırılması da ertelendi.

API'lerde değişiklik yapıldığında bilgi edinmek için bu düzeltme geçmişini kontrol edin.

3 Mart 2025

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

Not: Bu, desteği sonlandırma duyurusudur.

Günlük Hak Talepleri (1.0 Sürümü) raporu, iş ortakları için kullanımdan kaldırıldı. 30 Nisan 2025'ten sonra desteklenmeyecektir. Bu raporun tanımı buna göre güncellendi. Bunun yerine en son Günlük Hak Talepleri raporunu kullanın.

15 Kasım 2024

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

YouTube Analytics (Hedeflenen Sorgular) API dokümanları, Trafik kaynağı raporları için API'nin reports.query yönteminin,sorgulanan video sayısı X tarih aralığındaki gün sayısı çarpımının 50.000'i aşması durumunda artık hata döndüreceğini belirtecek şekilde güncellendi. Örneğin, 500 video kimliğine ait verileri alan bir sorgu, en fazla 100 günlük verileri isteyebilir.

Bu değişiklik hem kanalların hem de içerik sahiplerinin raporlarını etkiler.

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

6 Mayıs 2024

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

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

7 Nisan 2024

YouTube Analytics (Hedefli Sorgular) API'sinde içerik sahibi oynatma listesi raporlarıyla ilgili çeşitli güncellemeler yapıldı. Bu güncellemeler, 19 Ocak 2024'te duyurulan kanal oynatma listesi raporlarıyla ilgili güncellemelerle aynıdır.

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

  • Not: Bu, desteği sonlandırma duyurusudur.

    isCurated boyutunun içerik sahibi oynatma listesi raporlarındaki desteği sonlandırıldı. Bu özellik, 31 Aralık 2024'ten sonra desteklenmeyecektir. İlgili boyutun tanımı buna göre güncellendi.

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

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

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporlarında desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporlarında desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, bu değişiklik API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getiriyor.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarında filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, bu değişiklik API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getiriyor.

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

    • Toplu video metrikleri içerik sahibinin oynatma listelerindeki tüm videolar için toplu olarak sağlanan kullanıcı etkinliği ve gösterim metriklerini sunar. Bu oynatma listeleri de içerik sahibine aittir. Toplu video metrikleri yalnızca isCurated boyutu kullanılmayan API istekleri için desteklenir.
    • Oynatma listesindeki metrikler kullanıcı etkinliğini ve oynatma listesi sayfası bağlamındaki etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahip olunmayan videolardan gelen görüntülemeleri de içerir ancak bu görüntülemeler yalnızca oynatma listesi bağlamında gerçekleştiğinde dahil edilir.
    • Desteklenen oynatma listesi metrikleri bölümünde, oynatma listesi raporlarında desteklenen toplu video metrikleri ve oynatma listesi içi metrikler tanımlanır.

  • İçerik sahipleri için oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metriklerin yalnızca raporları almak için yapılan API isteğinde isCurated boyutunun kullanılmaması durumunda desteklendiğini unutmayın. Her metriğin tanımı için metrikler dokümanlarına bakın:

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

    • Bir istek isCurated boyutunu içerdiğinde views metriği, oynatma listesi içi bir metriktir ve videoların içerik sahibinin oynatma listeleri bağlamında kaç kez görüntülendiğini gösterir.
    • Bir istek isCurated boyutunu içermediğinde, views metriği, içerik sahibinin oynatma listelerindeki videoların oynatma listesi bağlamında görüntülenip görüntülenmediğine bakılmaksızın toplam görüntülenme sayısını belirten bir toplu video metriğidir. Toplam görüntüleme sayısı, yalnızca oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videoların görüntülemelerini içerir.

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

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

19 Ocak 2024

YouTube Analytics (Hedefli Sorgular) API'sinde kanal oynatma listesi raporlarıyla ilgili çeşitli güncellemeler yapıldı. Güncellemeler arasında desteği sonlandırılan bir boyut ve çeşitli yeni ve güncellenmiş metrikler yer alıyor:

  • Not: Bu, desteği sonlandırma duyurusudur.

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

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

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

    • continent ve subcontinent gibi konum filtreleri, yeni kanal oynatma listesi raporlarında desteklenmez.
    • redViews ve estimatedRedMinutesWatched metrikleri artık yeni kanal oynatma listesi raporlarında desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu nedenle, bu değişiklik API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getiriyor.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporlarında filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu nedenle, bu değişiklik API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getiriyor.

  • Kanal raporları dokümanlarının oynatma listesi raporları bölümü, oynatma listesi raporlarında desteklenen metrik türlerini daha ayrıntılı bir şekilde açıklamak için güncellendi:

    • Toplu video metrikleri Kanalın oynatma listelerindeki tüm videolar için toplu olarak sağlanan kullanıcı etkinliği ve gösterim metriklerini sunar. Toplu video metrikleri yalnızca isCurated boyutu kullanılmayan API istekleri için desteklenir.
    • Oynatma listesindeki metrikler kullanıcı etkinliğini ve oynatma listesi sayfası bağlamındaki etkileşimi yansıtır. Bu metrikler, oynatma listesindeki sahip olunmayan videolardan gelen görüntülemeleri de içerir ancak bu görüntülemeler yalnızca oynatma listesi bağlamında gerçekleştiğinde dahil edilir.
    • Desteklenen oynatma listesi metrikleri bölümünde, oynatma listesi raporlarında desteklenen toplu video metrikleri ve oynatma listesi içi metrikler tanımlanır.

  • Kanalların oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikler desteklenir. Bu metrikler henüz içerik sahibi raporlarında desteklenmemektedir. Bu metriklerin yalnızca raporları almak için yapılan API isteğinde isCurated boyutunun kullanılmaması durumunda desteklendiğini unutmayın. Her metriğin tanımı için metrikler dokümanlarına bakın:

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

    • Bir istek isCurated boyutunu içerdiğinde views metriği, videoların kanalın oynatma listeleri bağlamında kaç kez görüntülendiğini gösteren bir oynatma listesi içi metriktir.
    • Bir istek isCurated boyutunu içermediğinde, views metriği, bu videonun kanalın oynatma listelerinde kaç kez görüntülendiğini belirten toplu bir video metriğidir. Bu metrik, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğine bakılmaksızın hesaplanır. Toplam görüntüleme sayısı, yalnızca oynatma listesinin sahibi olan kanala ait videoların görüntülemelerini içerir.

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

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

4 Aralık 2023

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

15 Aralık 2022

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

  • Yeni bir rapor, kullanıcı etkinliğini şehre göre gösterir. Bu rapor, kanallar ve içerik sahipleri tarafından kullanılabilir. Bu raporda, kullanıcı etkinliğinin gerçekleştiği şehre ilişkin YouTube tahminini tanımlayan yeni city boyutu yer alır.

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

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

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

  • 7DayTotals ve 30DayTotals boyutlarına yapılan referanslar dokümanlardan kaldırıldı. Bu boyutların desteğinin sonlandırılacağı Ekim 2019'da duyurulmuştu.

26 Ağustos 2022

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

  • YouTube Analytics API'sinde (Hedeflenen Sorgular) API'sinde, boyutun değeri insightTrafficSourceType ise SUBSCRIBER değeri insightTrafficSourceDetail olarak ayarlanabilir. Bu, trafiğin Podcasts hedef sayfasından yönlendirildiğini gösterir.podcasts
  • YouTube Reporting (Toplu Raporlar) API'sinde, traffic_source_type boyutunun değeri 3 ise traffic_source_detail değeri podcasts olarak ayarlanabilir. Bu, trafiğin Podcast'ler hedef sayfasından yönlendirildiğini gösterir.

11 Şubat 2022

gender boyutu için geçerli değerler kümesi 11 Ağustos 2022'den itibaren değişecektir. Bu, API uygulamanızda eski sürümlerle uyumsuz bir değişiklik olabilir. YouTube API Hizmetleri Hizmet Şartları'nın Geriye Dönük Uyumsuz Değişiklikler bölümü uyarınca bu değişiklik, yürürlüğe girmeden altı ay önce duyurulmaktadır. Yeni değerler grubuna sorunsuz bir geçiş sağlamak için lütfen API uygulamanızı 11 Ağustos 2022'den önce güncelleyin.

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

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

9 Şubat 2022

13 Aralık 2021 itibarıyla iki metrik, döngüye alınan kliplerden gelen trafiği hariç tutacak şekilde güncellendi. Bu değişiklik hem YouTube Analytics (Hedefli Sorgular) API'sini hem de YouTube Reporting (Toplu Raporlar) API'sini etkiler.

2 Şubat 2022

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

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

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

23 Eylül 2020

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

YouTube Analytics API'deki veya YouTube Reporting API'deki trafik kaynağı ayrıntısı boyutu, bu yeni trafik kaynağı türü için doldurulmaz.insightTrafficSourceDetailtraffic_source_detail

20 Temmuz 2020

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

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

13 Şubat 2020

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

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

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

  • uploaded_push - Bir video yüklendiğinde abonelere gönderilen push bildirimlerinden kaynaklanan görüntülemeler
  • uploaded_other - Bir video yüklendiğinde abonelere gönderilen e-posta veya gelen kutusu bildirimleri gibi push bildirimleri dışındaki bildirimlerden kaynaklanan görüntülemeler.

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

Ayrıca, bu değerlerin bildirimleri değil, belirli YouTube görüntülemelerini sağlayan trafik kaynaklarını temsil ettiğini hatırlatırız. Örneğin, bir rapor satırında views=3, traffic_source_type=17 (NOTIFICATION) ve traffic_source_detail=uploaded_push değerleri gösteriliyorsa satır, videonun yüklendiği sırada gönderilen push bildirimlerini tıklayan izleyiciler sayesinde üç görüntüleme elde edildiğini belirtir.

15 Ekim 2019

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

  • Not: Bu, desteği sonlandırma duyurusudur.

    YouTube, 7DayTotals ve 30DayTotals boyutları için desteği kaldırıyor. Bu boyutları kullanarak 15 Nisan 2020'ye kadar veri almaya devam edebilirsiniz. Bu tarihten sonra 7DayTotals veya 30DayTotals boyutu kullanılarak rapor alma girişimleri hata döndürür.

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

    • Yedi günlük bir dönemdeki görüntüleme sayısı, bu dönemin her günündeki görüntüleme sayısının toplanmasıyla hesaplanabilir.
    • Yedi günlük bir dönem için viewerPercentage, her gün gerçekleşen görüntüleme sayısı ile o günkü viewerPercentage çarpılarak hesaplanabilir. Bu şekilde, o gün videoyu izlerken oturum açmış olan izleyici sayısı elde edilir. Ardından, oturum açmış izleyici sayısı tüm dönem için toplanabilir ve tüm dönemin izleyici yüzdesini elde etmek için bu dönemin toplam görüntüleme sayısına bölünebilir.
    • Aynı izleyici farklı günlerde tekil izleyici olarak sayılabileceğinden, yedi günlük bir dönemdeki tekil izleyici sayısı hesaplanamaz. Ancak 30 günlük bir dönemdeki benzersiz izleyici sayısı hakkında veri tahmininde bulunmak için month boyutu yerine 30DayTotals boyutunu kullanabilirsiniz. month boyutunun takvim aylarını ifade ettiğini, 30DayTotals boyutunun ise belirtilen başlangıç ve bitiş tarihine göre 30 günlük dönemleri hesapladığını unutmayın.

27 Haziran 2019

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

  • API'nin 1. sürümünün desteği tamamen sonlandırıldığından dokümanlar, bu sürüme yapılan referansları (desteği sonlandırma bildirimi ve 2. sürüme nasıl güncelleneceğini açıklayan taşıma kılavuzu dahil) kaldıracak şekilde güncellendi.

1 Kasım 2018

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

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

    Bu desteğin sonlandırılma planının ilk olarak 26 Nisan 2018'de duyurulduğunu hatırlatırız.

17 Eylül 2018

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

  • Veri Modeli 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 nedenlerle yaşanabilir. Uygulamada bu, aşağıdaki durumlarda bir raporun verilerinizin tümünü (veya herhangi birini) içermeyebileceği anlamına gelir:

    1. bir video veya kanalın belirli bir dönemde sınırlı trafiği varsa,

      veya

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

    Yeni bölümde, YouTube Analytics raporlarında sınırlı olabilecek veri türleri de ele alınıyor.

  • 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ı için desteklenmediğini yansıtacak şekilde güncellendi.

18 Haziran 2018

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

  • Aşağıdaki yöntemlerin 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öntemine yapılan isteklerin aşağıdakilerden birine erişimi olmalıdır:
      • https://www.googleapis.com/auth/youtube kapsamı
        veya
      • https://www.googleapis.com/auth/youtube.readonly kapsamı
        ve
        https://www.googleapis.com/auth/yt-analytics.readonly kapsamı

      İlk seçenekte okuma/yazma kapsamı olan tek bir kapsam kullanılırken ikinci seçenekte salt okunur iki kapsam kullanılır.

23 Mayıs 2018

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

  • API'ye Genel Bakış bölümünde, API yanıtlarının videolar, oynatma listeleri veya kanallar gibi silinmiş kaynaklarla ilişkili verileri nasıl işlediğini açıklayan yeni bir bölüm (toplu metrikler ve silinmiş öğeler) yer alıyor.
  • API'ye Genel Bakış bölümündeki 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 gibi, API istemcileri 30 gün sonra depolanan kaynak meta verilerini silmeli veya yenilemelidir.

22 Mayıs 2018

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

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

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

      Bu duyurudan önce tüm API raporları, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir durumdaydı. Bu politika değişikliği yürürlüğe girdiğinde 30 günden eski geçmiş veri raporlarına API üzerinden erişilemeyeceğini hatırlatırız. 60 günden eski diğer tüm raporlara da artık erişilemeyecek. Bu nedenle, dokümanlarda artık politika değişikliğinden önce oluşturulan raporların en fazla 180 gün boyunca kullanılabileceği belirtiliyor.

    • Değişiklikten sonra bir raporlama işi planladığınızda YouTube, o günden itibaren ve 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şturuyordu.

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

  • Rapor özellikleri bölümü, rapor verileri filtrelenmemiş olsa bile 1 Haziran 2018'de veya bu tarihten sonraki bir dönem için veriler içeren raporlarda, raporun oluşturulduğu tarihten en az 30 gün önce silinen YouTube kaynaklarına yapılan referansların yer almayacağını belirtecek şekilde güncellendi.

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

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

26 Nisan 2018

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

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

    • API'nin sürümü v1'dan v2'ye değişti.
    • API isteklerinin temel URL'si https://www.googleapis.com/youtube/analytics/v1 olarak değiştirildi.https://youtubeanalytics.googleapis.com/v2
    • reports.query yöntemi için çeşitli parametrelerin adları güncellendi. Özellikle, v1 API'sindeki end-date gibi tire içeren parametre adları, v2 API'sinde tire yerine camel case (endDate) kullanır. API'nin grup oluşturma ve yönetme yöntemleri zaten parametre adları için camel case kullanıyordu. Bu değişiklik, parametre adlarını API genelinde tutarlı hale getiriyor.
    • v2 API, Google'ın genel HTTP toplu uç noktasına (www.googleapis.com/batch) gönderilen toplu istekleri desteklemez. v2 API'de toplu istek gönderiyorsanız bunun yerine https://youtubeanalytics.googleapis.com/v2 uç noktasını kullanmanız gerekir.

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

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

  • Not: Bu, desteği sonlandırma duyurusudur.

    API'nin 1. sürümü (v1) artık kullanımdan kaldırıldı ve 31 Ekim 2018'e kadar desteklenecek. Bu tarihten sonra v1 API'ye yapılan tüm istekler çalışmayı durduracak. Bu nedenle, API üzerinden YouTube Analytics verilerine erişiminizde kesinti olmaması için lütfen 31 Ekim 2018'e kadar v2 API'ye yükseltme yapın.

21 Şubat 2018

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

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

18 Ocak 2018

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

  • YouTube Reporting API (Toplu Raporlar)

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

  • YouTube Analytics API (Hedeflenen Sorgular)

20 Aralık 2017

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

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

    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ış bölümünde ve report kaynağının downloadUrl özelliğinin tanımında açıklanmıştır.

  • age group ve gender boyutlarının dokümanları, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bu değişikliğin, API işlevselliğinde veya davranışında bir değişikliği yansıtmadığını, yalnızca dokümanda yapılan bir düzeltme olduğunu hatırlatırız. Özellikle aşağıdaki değerler değişti:

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

10 Ağustos 2017

Bu dokümanda, 10 Ağustos 2016'da YouTube Analytics API'nin earnings metriğinin desteğinin sonlandırıldığı duyurulmuştu. (Aynı zamanda API, aynı verileri sağlayan estimatedRevenue adlı yeni bir metrik için destek ekledi.)

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

API belgeleri, earnings metriğine yapılan referansları kaldırmak için güncellendi.

6 Temmuz 2017

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

  • YouTube Analytics API (Hedeflenen Sorgular)

    • API dokümanları, API yanıtlarının, sorgulanan tüm metriklerin kullanılabildiği, istenen tarih aralığındaki son güne kadar olan verileri içerdiğini yansıtacak şekilde güncellendi.

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

    • adType boyutu artık reservedBumperInstream değerini destekliyor. Bu değer, bir video görüntülenmeden önce oynatılan ve en fazla 6 saniye süren atlanamayan video reklamı ifade eder. Reklam biçimi, auctionBumperInstream reklamıyla aynıdır ancak bu tür, açık artırma yerine ayrılmış temelde satılan reklamları ifade eder.

  • YouTube Reporting API (Toplu Raporlar)

    • ad_type boyutu artık, ayrılmış olarak satılan kısa reklamları ifade eden 20 değerini destekliyor. Bumper reklamlar, videonun görüntülenebilmesi için oynatılan, 6 saniyeye kadar süren ve atlanamayan video reklamlardır. Bu boyut için 19 değerinin, ayrılmış temel yerine açık artırma temelinde satılan bumper reklamları da ifade ettiğini unutmayın.

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

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

      Bu rapor türlerinin desteğinin sonlandırılacağı 15 Eylül 2016'da duyurulmuştu. 15 Aralık 2016'dan sonra bu rapor türleri için rapor oluşturulmamaya başlandı. Daha önce oluşturulan raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir. Bu nedenle, bazı raporlara 15 Haziran 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek kalmaz.

24 Mayıs 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Bu rapor türlerinin desteğinin sonlandırılacağı 22 Haziran 2016'da duyurulmuştu. Bu rapor türleri için 22 Eylül 2016'dan sonra rapor oluşturulmamıştır. Daha önce oluşturulan raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir. Bu nedenle, bazı raporlara 22 Mart 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek kalmaz.

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 Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      Ayrıca, 52 değerini tanımlamak için kullanılan ad, 73 değerinden (Kakao Story) daha net bir şekilde ayırt edilebilmesi için dokümanlarda Kakao (Kakao Talk) olarak güncellendi. Bu değişiklik, API davranışında veya bu hizmetlerle paylaşılan videoların sınıflandırılmasında herhangi bir değişikliği yansıtmaz.

  • 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'ndaki YouTube Analytics aracılığıyla gelir verilerine erişebilen kanal sahipleri artık bu gelir verilerine YouTube Analytics API üzerinden de erişebilir:

17 Mart 2017

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

  • YouTube Analytics API, YouTube Premium izleyici kitlesiyle ilgili olan redViews ve estimatedRedMinutesWatched metriklerini destekler. Aslında API, bu metrikleri bir süredir desteklemektedir ve 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 görüntülenme sayısını gösterir.
    • estimatedRedMinutesWatched metriği, YouTube Red üyelerinin bir videoyu izlediği dakika sayısını gösterir.

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

3 Mart 2017

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

  • YouTube Reporting API (Toplu Raporlar)

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

      Tarihler genellikle 24 saatlik bir süreyi temsil etse de saatlerin ileriye alındığı tarihler 23 saatlik bir süreyi, geriye alındığı tarihler ise 25 saatlik bir süreyi 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 destekliyor:
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia

    • content_owner_basic_a1 rapor türüyle ilgili 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ı tarihten itibaren 180 gün boyunca kullanılmaya devam ediyordu. Bu nedenle, bazı raporlara 19 Şubat 2017'ye kadar erişilebiliyordu. Ancak raporlar artık kullanılamadığından raporlarla ilişkili işlere de gerek kalmaz.

  • YouTube Analytics API (Hedeflenen Sorgular)

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

      Tarihler genellikle 24 saatlik bir süreyi temsil etse de saatlerin ileriye alındığı tarihler 23 saatlik bir süreyi, geriye alındığı tarihler ise 25 saatlik bir süreyi temsil eder. (Daha önce dokümanda Pasifik saatinin UTC-8 olduğu belirtiliyor ve bir günün 24 saatlik bir süreyi temsil etmeyebileceği olasılığından bahsedilmiyordu.)

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

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

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

8 Şubat 2017

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

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

API isteği birden fazla kanalın verilerini alıyorsa da bu kurallar geçerlidir:

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

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

15 Aralık 2016

Aşağıdaki YouTube Reporting API raporları artık desteklenmiyor ve dokümanlardan kaldırıldı. Her raporun daha yeni bir sürümü mevcuttur. (Bu raporlarla ilgili desteği sonlandırma duyurusu 15 Eylül 2016'da yapıldı.)

API referans belgelerindeki mevcut 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 boyutları ve metrikleri destekler. Raporlar, video oynatıldıktan sonra gösterilen bitiş ekranları için gösterim ve tıklama oranı istatistikleri sağlar.

8 Kasım 2016

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

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

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

27 Ekim 2016

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

Sistem tarafından yönetilen raporlara genel bakış, yeni raporlara kısa bir genel bakış sunar ve API aracılığıyla bu raporların nasıl alınacağını açıklar. Bu işlem, YouTube Analytics için toplu rapor alma işleminden biraz farklıdır. İş ortaklarının rapor oluşturmak için iş planlaması yapması gerekmez.

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

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

27 Eylül 2016

Not: Bu, desteği sonlandırma duyurusudur.

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

15 Eylül 2016

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

19 Ağustos 2016

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

  • content_owner_basic_a1 raporu tamamen kullanımdan kaldırıldı ve dokümanlardan çıkarıldı. YouTube artık bu türde yeni raporlar oluşturmayacak. Ancak daha önce oluşturulan raporlar, oluşturuldukları tarihten itibaren 180 gün boyunca kullanılabilir.

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

11 Ağustos 2016

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

  • YouTube Mühendislik ve Geliştiriciler Blogu'nda ayrıntılı olarak ele alınan, yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda kapsamlı bir güncelleme seti sunuyor. 10 Şubat 2017'den itibaren geçerli olacak Güncellenen Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici belgeler 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 destekleyici belgelerde gelecekte yapılacak değişiklikler de bu revizyon geçmişinde açıklanacaktır. Bu dokümandaki bir bağlantıdan, düzeltme geçmişindeki değişiklikleri listeleyen bir RSS özet akışına abone olabilirsiniz.

10 Ağustos 2016

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

  • YouTube Analytics API (Hedeflenen Sorgular)

    • Not: Bu, desteği sonlandırma duyurusudur.

      Aşağıdaki tablodaki metriklerin desteği sonlandırılıyor. Aynı zamanda, aynı verilere atıfta bulunan yeni metrikler kullanıma sunuluyor. Bu, YouTube Analytics API'nin tabloda listelenen desteğin sonlandırılma tarihlerine kadar her iki metrik adını da destekleyecek olmasına rağmen eski metriklerin yeniden adlandırıldığı anlamına gelir.

      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 ve bu nedenle bu duyurunun tarihinden itibaren bir yıl boyunca destekleneceğini unutmayın. Temel metrikler arasında yer almayan diğer metrikler ise 4 Kasım 2016'ya kadar üç ay boyunca desteklenecektir.

      Örneğin, 4 Kasım 2016'ya kadar bir API isteği impressionBasedCpm metriğini, cpm metriğini veya her ikisini de 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 metrik, görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, kullanıcı tarafından yüklenen ve hak talebinde bulunulan videolardan kaynaklandığını gösterir.
      • END_SCREEN: Veriler, başka bir videonun bitiş 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 video görüntülenmeden önce oynatılan ve 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 metrik, görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, kullanıcı tarafından yüklenen ve hak talebinde bulunulan videolardan kaynaklandığını gösterir.
      • 20: Veriler, başka bir videonun bitiş 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 öğesini temel metrik olarak listeleyecek ve earnings öğesini bu listeden kaldıracak şekilde düzeltildi. (earnings metriği, YouTube Reporting API'de hiçbir zaman desteklenmemiştir.)

    • ad_type boyutu artık, bir video görüntülenmeden önce oynatılan ve 6 saniyeye kadar süren atlanamayan video reklamlar olan bumper reklamları ifade eden 19 değerini 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ı için desteklenen metriklerin listeleri, kart metriklerini içerecek şekilde güncellendi. Bu raporlarda kart metrikleri desteği aslında 28 Haziran 2016'da eklenmişti ve o tarihe ait düzeltme geçmişi girişi, değişikliği daha ayrıntılı olarak açıklıyor. Raporlar:
      • ABD eyaletlerindeki temel kullanıcı etkinliği
      • Belirli dönemlerde ABD eyaletlerindeki kullanıcı etkinliği
      • İle göre kullanıcı etkinliği
      • Abone olma durumuna göre kullanıcı etkinliği
      • İllere göre abone olma durumuna göre kullanıcı etkinliği
      • Eyalete göre en popüler videolar
      • Abone olan veya olmayan izleyiciler için en popüler videolar

    • video filtresinin gerekli olduğu ve group filtresinin desteklenmediği bilgisi, hem kanal kitleyi elde tutma raporları hem de içerik sahibi kitleyi elde tutma raporları için filtre listelerinde düzeltildi.

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

  • YouTube Reporting API (Toplu Raporlar)

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

28 Haziran 2016

YouTube Analytics API dokümanları, ç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 aşağıdaki YouTube Reporting API değişikliklerini içerir. İlk değişiklik genel olarak API'yi ilgilendirir. Diğer değişiklikler ise yalnızca içerik sahibi raporlarını etkiler:

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

    Daha önce dokümanlarda, raporların API isteğinin gönderildiği tarihten önceki 180 günlük dönem için kullanılabildiği belirtiliyordu. Orijinal metin teknik olarak doğru olsa da en iyi ihtimalle kafa karıştırıcıydı.

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

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

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

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

      Yeni adlandırılan her iki rapor da önceki sürümlerinden şu açılardan farklıdır:

    Bu raporların eski sürümlerinden herhangi birini oluşturmak için zaten işleriniz varsa yeniden adlandırılan raporlar için yeni işler oluşturmanız gerektiğini unutmayın. Yeni rapor sürümlerinin yayınlanmasıyla birlikte content_owner_ad_performance_a1, content_owner_estimated_earnings_a1 ve content_owner_asset_estimated_earnings_a1 raporlarının desteği sonlandırıldı.

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

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

  • Belgelerde, raporlarda görünen adlarla eşleşmesi için iki metriğin adı düzeltildi. Bu yalnızca dokümanda yapılan bir düzeltme olup raporun gerçek içeriğinde 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, bu güncellemeyle kullanımdan kaldırılacak iki raporda göründüğünü unutmayın. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların daha yeni sürümlerinde estimated_partner_ad_auction_revenue olarak yeniden adlandırılmıştır.
    • estimated_partner_doubleclick_revenue metriğinin adı estimated_partner_double_click_revenue olarak güncellendi. Bu metriğin yalnızca bu güncelleme ile kullanımdan kaldırılan iki raporda göründüğünü tekrar hatırlatırız. Yukarıda açıklandığı gibi, bu metrik söz konusu raporların daha yeni sürümlerinde estimated_partner_ad_reserved_revenue olarak yeniden adlandırılmıştır.

  • Raporlama API'si için boyutlar dokümanı, elapsed_video_time_percentage ve audience_retention_type özelliklerini artık listelemeyecek şekilde güncellendi. Bu boyutlar şu anda API üzerinden kullanılabilen hiçbir rapor tarafından desteklenmemektedir.

19 Mayıs 2016

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

  • API, içerik sahipleri için kullanıcı etkinliği raporunun yeni bir sürümünü destekler. Yeni raporun rapor türü kimliği content_owner_basic_a2'dır. Raporun önceki sürümü olan content_owner_basic_a1'dan farklı olarak yeni sürümde likes ve dislikes metrikleri desteklenir.

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

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

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

    • reportType kaynağının deprecateTime özelliği, rapor türünün desteğinin sonlandırılacağı tarihi ve saati belirtir. Bu özelliğin değeri yalnızca desteği sonlandırıldığı duyurulan raporlar için geçerlidir ve değer, YouTube'un bu tür raporlar oluşturmayı durduracağı tarihi gösterir.

      Bir rapor türünün kullanımdan kaldırıldığı duyurulduktan sonra YouTube, üç ay daha bu tür raporlar oluşturur. Örneğin, 19 Mayıs 2016'daki bu güncellemede content_owner_basic_a1 raporunun desteğinin sonlandırıldığı duyuruluyor. Dolayısıyla, bu rapor türü için deprecateTime, 19 Ağustos 2016'da YouTube'un bu tür raporlar oluşturmayı durduracağı bir zamanı belirtir.

    • job kaynağının expireTime özelliği, işin sona erdiği veya sona ereceği tarihi ve saati belirtir. İşle ilişkili rapor türü kullanımdan kaldırıldıysa veya iş için oluşturulan raporlar uzun süre boyunca indirilmediyse bu özelliğin değeri olur. Bu tarih, YouTube'un iş için yeni rapor oluşturmayı bıraktığı zamanı gösterir.

    • report kaynağının jobExpireTime özelliği, raporla ilişkili işin sona erdiği veya sona ereceği tarihi ve saati belirtir. Bu özellik, bu listedeki önceki öğede açıklandığı gibi, job kaynağındaki expireTime özelliğiyle aynı değeri içerir.

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

12 Nisan 2016

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

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

    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. Bu nedenle, bir raporlama işi planladıktan bir ay sonra yaklaşık yedi aylık verilere erişebilirsiniz. (Bu duyurudan önce oluşturulan işlerle ilgili tüm geçmiş veriler, duyurudan sonraki bir ay içinde yayınlanmalıdır.)

    Geçmiş verilerin yalnızca 1 Temmuz 2015'ten itibaren kullanılabildiğini unutmayın. Bu nedenle, 28 Aralık 2015'ten önce oluşturulan işlerde 180 günden daha az geçmiş veri bulunur.

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

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

    • Belgelerde artık raporların oluşturulduktan sonraki 180 gün boyunca kullanılabildiği ve bu nedenle API istemcileri tarafından indirilebileceği belirtiliyor. Daha önce dokümanlarda, raporların API isteğinin gönderildiği tarihten önceki altı aylık dönem için kullanılabildiği belirtiliyordu.

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

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

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

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

    • jobs.list yönteminin yeni includeSystemManaged parametresi, API yanıtının sistem tarafından yönetilen raporlarla ilgili işleri içerip içermeyeceğini belirtir. Parametrenin varsayılan değeri false'dır.

    • jobs.reports.list yönteminin yeni startTimeAtOrAfter parametresi, API yanıtının yalnızca rapordaki en erken veriler belirtilen tarihte veya bu tarihten sonra ise rapor içermesi gerektiğini gösterir. Benzer şekilde, startTimeBefore parametresi, API yanıtının yalnızca rapordaki en erken tarih belirtilen tarihten önceyse raporları içermesi gerektiğini gösterir.

      Yöntemin raporun oluşturulma zamanıyla ilgili olan createdAfter parametresinin aksine, yeni parametreler rapordaki verilerle ilgilidir.

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

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

28 Mart 2016

YouTube Reporting API ve YouTube Analytics API artık birkaç 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 Inbox
    • 84: Android Messenger
  • YouTube Analytics API'de sharingService boyutu şu yeni değerleri destekler:
    • ANDROID_MESSENGER: Android Messenger
    • INBOX: Google Inbox
    • 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 özet akışında ya da başka bir YouTube'da gezinme özelliğinde gerçekleşen görüntülemelerle ilgilidir.
    • 8: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
  • traffic_source_type boyutu artık boyut değeri olarak 18'yi destekliyor. Bu değer, video görüntülemelerinin bir oynatma listesindeki tüm videoların listelendiği bir sayfadan geldiğini gösterir. Bu kaynak, izlenmelerin video bir oynatma listesinin parçası olarak oynatılırken gerçekleştiğini belirten 14 kaynak türünden farklıdır.

YouTube Analytics API

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

8 Şubat 2016

YouTube Analytics API için desteklenen metriklerin listesi güncellendi. Bu nedenle, kart metrikleri artık söz konusu API için desteklenen metrikler olarak listelenmiyor. (Bu API'nin raporlarının hiçbiri kart metriklerinden herhangi birini desteklediği şeklinde belgelenmemişti.)

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

6 Ocak 2016

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

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

21 Aralık 2015

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

18 Aralık 2015

Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamalar yapılmalı ve bu kullanıcılardan izin alınmalıdır. 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 bildirimi YouTube API Hizmet Şartları'na ekledik.

15 Aralık 2015

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

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

    • liveOrOnDemand: Bu boyut, rapordaki verilerin canlı yayın sırasında gerçekleşen kullanıcı etkinliğini 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 için kullanılabilen yeni oynatma ayrıntıları raporlarını belirtecek şekilde güncellendi. Ayrıca, diğer birçok rapor da bu boyutlardan bir veya daha fazlasının isteğe bağlı olarak bu raporlarda boyut ve/veya filtre olarak kullanılabileceğini belirtecek şekilde güncellendi.

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

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

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

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

    Örneğin, bir kullanıcının video filtresinde 20 video kimliğinin listelendiği bir API isteği gönderdiğini varsayalım. Kullanıcı, videolardan 18'inin sahibi. Ancak bir video kimliği, başka bir kanala ait bir videoyu tanımlarken diğer kimlik, silindiği için artık mevcut olmayan bir videoyu tanımlıyor. Bu durumda, API sunucusu artık hata döndürmek yerine kullanıcının erişemediği iki videoyu bırakıyor ve API yanıtı, API kullanıcısının sahip olduğu 18 videonun verilerini içeriyor.

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

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

  • YouTube Analytics API'nin groups.list yöntemi artık sayfalara ayırmayı destekliyor. API yanıtı, mevcut tüm grupları içermiyorsa yanıttaki nextPageToken parametresi, sonuçların sonraki sayfasını almak için kullanılabilecek bir jeton belirtir. Ek sonuç 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üman, tarihler Pasifik saatiyle (UTC-8) 00:00'da başlayan 24 saatlik dönemi ifade edecek şekilde düzeltildi. Daha önce dokümanda, tarihin 00:00'da (GMT) başladığı belirtiliyordu.

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

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

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

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

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

8 Ekim 2015

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

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

    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 enum değerleri, listedeki yeni değerlerdir.

24 Eylül 2015

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

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

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

    YouTube'un oluşturması gereken bir raporu tanımlayan raporlama işlerini planlamak için API'yi kullanabilirsiniz. Bir iş oluşturduktan sonra YouTube, eşzamansız olarak indirilebilen günlük bir rapor oluşturur. Her rapor, benzersiz bir 24 saatlik döneme ait verileri içerir.

  • YouTube Analytics API ve YouTube Reporting API farklı API'ler olsa da her ikisi de geliştiricilerin YouTube Analytics verilerini almasına olanak tanır. API'lerin her ikisi de benzer veri kümelerine erişim sağladığından, iki API'nin dokümanları tek bir doküman kümesi olarak yayınlanmaktadır.

    • Doküman setindeki Kılavuzlar sekmesinde, API isteklerini yetkilendirme talimatları da dahil olmak üzere her iki API'de de ortak olan bilgiler yer alır.
    • Toplu raporlar sekmesinde, YouTube Reporting API'ye özel referans belgeleri ve diğer içerikler yer alır.
    • Hedeflenen sorgular sekmesinde, YouTube Analytics API'ye özel referans dokümanları ve diğer içerikler yer alır.
    • Örnekler sekmesinde, iki API'den biri için kullanılabilen kod örnekleri listelenir.
    • Araçlar sekmesinde, geliştiricilerin 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'nin daha kolay anlaşılması için API belgeleri yeniden yapılandırıldı. Bu nedenle, bu değişiklikler yeni özellikleri açıklamaz:

    • Belgelerde artık tüm kanal raporlarının listelendiği bir sayfa ve tüm içerik sahibi raporlarının listelendiği başka bir sayfa yer alıyor. Daha önce dokümanda kanal video raporları, kanal oynatma listesi raporları vb. için ayrı sayfalar vardı.

    • Yeni veri modeli genel bakışı, API'nin işleyiş şekli hakkında daha net bir giriş yapmayı amaçlamaktadır. Bu belgede, YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığı daha iyi açıklanmaya çalışılmaktadır.

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

22 Temmuz 2015

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

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

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

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

  • Desteği sonlandırılan primaryAdGrossRevenue metriğine ek olarak, reklam performansı raporları artık monetizedPlaybacks ve playbackBasedCpm metriklerini desteklemiyor. Ancak bazı video raporları bu metrikleri desteklemeye devam etmektedir.

1 Haziran 2015

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

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

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

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

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

31 Mart 2015

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

  • favoritesAdded ve favoritesRemoved metriklerinin her ikisi de bu duyuru itibarıyla kullanımdan kaldırıldı. Bu metrikler hem temel metriklerdir hem de Hizmet Şartları'nda belirtilen Kullanımdan Kaldırma Politikası'na tabidir.

16 Mart 2015

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

  • Yeni currency parametresi, kazanç metriklerini ABD doları (USD) dışında bir para biriminde almanıza olanak tanır. Parametre ayarlanırsa API, earnings, grossRevenue, playbackBasedCpm ve impressionBasedCpm metriklerinin değerlerini belirtilen para birimine dönüştürür. Döndürülen değerler, günlük olarak değişen döviz kurları kullanılarak hesaplanan tahminlerdir.

    Parametre değeri, üç harfli bir ISO 4217 para birimi kodudur. Varsayılan değer: USD. Parametre tanımı, desteklenen para birimi kodlarının bir 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 ile bu gruplar için rapor verilerini alma özelliğini destekliyor.

    • Grup oluşturma ve yönetme

      Bu güncellemede, gruplar oluşturmak ve yönetmek için group ve groupItem kaynakları kullanıma sunulmaktadır.

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

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

    • Bir grup için rapor verilerini alma

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

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

13 Şubat 2015

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

  • API artık show boyutunu desteklemiyor.

28 Ağustos 2014

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

  • API artık bu boyutlar filtre olarak kullanıldığında video, playlist, channel ve show boyutları için birden fazla değer belirtme özelliğini destekliyor. 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 bu filtreyi, istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen boyut olarak listelenmemiş olsa bile geçerlidir. Filtreyi boyutlar listesine eklerseniz API, sonuçları gruplandırmak için filtre değerlerini de kullanır.

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

16 Temmuz 2014

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

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

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

    Tüm oynatma listesi raporları views ve estimatedMinutesWatched metriklerini destekler. Bazı raporlar ise averageViewDuration metriğini de destekler.

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

    • playlistStarts: İzleyicilerin bir oynatma listesini başlatma sayısı.
    • viewsPerPlaylistStart: 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 yapılan tüm isteklerde isCurated filtresi kullanılmalıdır. Bu filtre 1 (isCurated==1) olarak ayarlanmalıdır.

  • API artık kitleyi elde tutma raporunu destekliyor. Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. Raporun yeni elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için videonun ne kadarının izlendiğini ölçer:

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

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

    • relativeRetentionPerformance metriği, bir videonun oynatma sırasında izleyicileri elde tutma performansını benzer uzunluktaki tüm YouTube videolarıyla karşılaştırarak gösterir. 0 değeri, videonun izleyicileri benzer uzunluktaki diğer videolardan daha kötü şekilde elde tuttuğunu, 1 değeri ise videonun izleyicileri benzer uzunluktaki diğer videolardan daha iyi şekilde elde tuttuğunu gösterir. 0,5'lik bir ortanca değer, benzer uzunluktaki videoların yarısının izleyicileri daha iyi elde tuttuğunu, yarısının ise daha kötü elde tuttuğunu gösterir.

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

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

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

  • GOOGLE_SEARCH artık insightTrafficSourceType boyutu için ayrı bir değer olarak raporlanmıyor. Bunun yerine, Google arama sonuçlarından gelen yönlendirmeler artık EXT_URL trafik kaynağı türüyle ilişkilendiriliyor. Bu nedenle, insightTrafficSourceDetail filtresini insightTrafficSourceType olarak ayarlayan bir GOOGLE_SEARCH 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ı, örnekleri kategoriler halinde gruplandırmak için yeniden tasarlandı. Bu dokümanda, kısa süre önce kanal ve içerik sahibi raporları için kullanıma sunulan sekme biçimi kullanılıyor. Yeni tasarımda örnekler aşağıdaki kategorilerde gruplandırılmıştır:

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

  • Örnek istekler dokümanına, kanal raporlarında veya içerik sahibi raporlarında eyalete özgü verileri alma konusunda yeni örnekler eklendi.

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

    • Kaliforniya'daki izleyicilerin demografik bilgileri (yaş grubu ve cinsiyet): Bu rapor, Kaliforniya'da bir kanalın videolarını veya içerik sahibi raporları için bir içerik sahibinin hak talebinde bulunduğu içerikleri izleyen izleyicilerin yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Bu örnekte, yanıtın yalnızca belirli bir eyalete ait verileri içermesini sağlamak için filters parametresi kullanılmaktadır.

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

6 Ocak 2014

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

  • Desteklenen kanal ve içerik sahibi raporlarının listelendiği belgeler yeniden tasarlandı. Tüm olası raporların listelendiği bir tablo sağlamak yerine, her belgede raporlar kategorilere ayrılır:

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

    Her dokümanda bu kategoriler sekme listesi olarak gösterilir. İlgili kategorideki desteklenen raporları görmek için herhangi bir sekmeyi tıklayabilirsiniz.

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

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

      • API, istatistikleri eyalet bazında ayrıntılı olarak gösteren iki raporu destekler. Her iki rapor da kanallar ve içerik sahipleri için kullanılabilir.

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

      • Bir raporun yalnızca belirli bir eyalete ait istatistikleri içermesini sağlamak için filters sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografi raporları ve en popüler videolar raporları dahil olmak üzere çeşitli raporlar bu filtreleme türünü destekler.

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

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

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

  • insightTrafficSourceDetail boyutunun insightTrafficSourceType değerini PROMOTED geçerli bir filtre değeri olarak içermemesi için doküman 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, desteği sonlandırma politikasına tabi değildir. Boyutlar ve metrikler sayfaları, temel boyutları ve temel metrikleri listeleyecek şekilde güncellendi. Ayrıca, bu sayfalardaki tanımlar, temel boyutları ve metrikleri açıkça belirtecek şekilde güncellendi.

  • API artık insightPlaybackLocationType boyutu için değer olarak EXTERNAL_APP'ı destekliyor. Bu güncelleme ile birlikte, 10 Eylül 2013'ten itibaren 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, oynatmanın gerçekleştiği uygulama türüne bağlı olarak mobil oynatmalar artık WATCH, EMBEDDED veya EXTERNAL_APP oynatma olarak sınıflandırılıyor.

  • API artık insightTrafficSourceType boyutu için değer olarak PLAYLIST'ı destekliyor. Bu değer, video görüntülemelerinin bir oynatma listesinden yönlendirildiğini gösterir. Daha önce bu görünümler, 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 belgesinde, bu işlevi gösteren yeni bir örnek (İstekleri birden fazla boyuta/metriğe göre sıralama) yer almaktadır. İstek, trafik kaynağı verilerini alır ve sort parametre değeri day,-views'dir. Sonuçlar kronolojik olarak sıralanır ancak her günün sonuç kümesinde ilk satır en çok görüntüleme oluşturan trafik kaynağına ait verileri, ikinci satır ise bir sonraki en yüksek görüntüleme sayısını oluşturan kaynağa ait verileri içerir.

  • API artık, izleyicilerin videolarınızı izlediği cihazlarla ilgili verileri almak için kullanılabilecek iki yeni boyutu (deviceType ve operatingSystem) destekliyor. API, boyutlardan birini veya her ikisini de kullanan 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. Cihaz türü raporunun yalnızca belirli bir işletim sistemini (ör. Android veya iOS) ç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 sistemlerindeki görüntüleme sayılarını ve tahmini izlenme süresini almanızı sağlar. Ayrıca, işletim sistemi raporunu yalnızca belirli bir cihaz türüne (ör. mobil cihazlar veya tabletler) ait istatistikleri içerecek şekilde kısıtlamak için deviceType filtresini de kullanabilirsiniz.

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

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

  • insightPlaybackLocationType boyutu, boyutun diğer değerlerinden biri kullanılarak sınıflandırılmayan görünümleri tanımlayan YT_OTHER değerini döndürebilir.

23 Mayıs 2013

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

10 Mayıs 2013

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

6 Mayıs 2013

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

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

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

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

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

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

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

      • Oynatma konumu ayrıntısı

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

      • Trafik kaynağı ayrıntıları

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

3 Mayıs 2013

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

  • Yeni Örnek API istekleri dokümanında, YouTube Analytics API kullanılarak birçok farklı rapor türünün nasıl alınacağını gösteren örnekler yer almaktadır. Her örnekte, isteğin aldığı raporun kısa bir açıklaması yer alır. Ardından, isteğin boyutları, metrikleri, filtreleri ve sıralama parametreleri gösterilir.

  • insightTrafficSourceType boyutu artık geçerli bir değer olarak SUBSCRIBER'yi destekliyor. Bu değer, YouTube ana sayfasındaki özet akışlarından veya YouTube abonelik özelliklerinden yönlendirilen video görüntülemelerini tanımlar. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanında, görüntülemelerin yönlendirildiği ana sayfa feed'i veya diğer sayfa belirtilir.

28 Mart 2013

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

21 Mart 2013

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

  • API artık kazanç ve reklam performansı metriklerinin yanı sıra yeni reklam performansı raporlarını da destekliyor. Metrikler ve raporlar yalnızca YouTube İş Ortağı Programı'na katılan YouTube içerik iş ortakları tarafından kullanılabilir.

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

    • Yeni desteklenen metrikler aşağıda listelenmiştir. İçerik sahibi raporları listesi, bu metrikleri destekleyen raporları (iki yeni rapor dahil) belirtecek şekilde güncellendi.

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

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

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

  • API dokümanları, farklı rapor türlerinin ayrı sayfalarda açıklanması için yeniden düzenlendi. Bu nedenle, artık farklı kanal raporu ve içerik sahibi raporu 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 Java, JavaScript, Python ve Ruby istemci kitaplıklarını kullanarak API'nin nasıl çağrılacağını gösteren kod örneklerinin yer aldığı bir örnekler bölümü var. JavaScript kodu örneği, örnek uygulama dokümanı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 APIs Explorer özelliği bulunuyor. Bu özellik sayesinde API'yi çağırabilir, API isteğini görebilir ve yanıttaki gerçek verileri alabilirsiniz.

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

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

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

    • Trafik kaynağı raporu, farklı türdeki yönlendirenlerden kaynaklanan video görüntüleme sayısını gösterir.

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

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

2 Ekim 2012

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

  • YouTube Analytics API artık tüm geliştiriciler tarafından kullanılabilir. Önce erişim isteğinde bulunmanıza gerek kalmadan, APIs console içindeki Hizmetler panelinden projeniz için API'yi etkinleştirebilirsiniz.

  • Yeni Başlarken bölümünde, YouTube Analytics API kullanan bir uygulama oluşturmayla ilgili ö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ünde, API kotası kullanımınızı optimize etme yönergeleri verilmektedir. 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 büyük ölçüde değişebileceğinden kotanızı verimli bir şekilde kullanmayı planlamalı ve uygulamanız yalnızca gerçekten ihtiyaç duyduğu metrikleri ve verileri istemelidir.

  • Zaman boyutları bölümü, bu boyutların bir Analytics raporunun verileri bir zaman aralığına göre toplaması gerektiğini gösterdiğini açıklayacak şekilde güncellendi. API artık aşağıdaki ek zamansal boyutları destekliyor:

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

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

  • Raporlama öğesi boyutları bölümü, içerik sahibinin raporlarını almak için yapılan API isteklerinin verileri bu boyutlardan (video, channel veya show) biri ya da claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak filtrelenmesi gerektiğini belirtecek şekilde güncellendi.

  • API artık en iyi 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 (izlenme sayısı, yorumlar, beğeniler vb.) içerir ve bu metrikleri videoya göre ayırır. Artık bu raporları, videonun izleme sayfasından 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 abone kazanabileceği veya kaybedebileceği yerleri (ör. video izleme sayfası, kanal sayfası ve YouTube ana sayfasında görünen kılavuz) açıklayacak şekilde güncellendi. Bu metrikler videoya özel bir raporda göründüğünde yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.