İ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

13 Eylül 2026

YouTube Reporting API artık içerik sahipleri için haftalık referans raporunun 1.1 sürümünü destekliyor (content_owner_active_references_a2).

1.1 sürümünde aşağıdaki değişiklikler yapıldı:

  • Referans dosyasının durumuyla ilgili ek ayrıntı veya neden sağlayan status_detail alanını ekler.
  • asset_owners alanını, iş ortağı kodları yerine içerik sahibinin görünen adlarını veya harici kimlikleri kullanacak şekilde günceller.

Raporun önceki sürümü olan Sürüm 1.0 (content_owner_active_references_a1) kullanıma sunulmaya devam edecektir.

9 Eylül 2026

YouTube Analytics API ve YouTube Reporting API dokümanları aşağıdaki eklemeler ve açıklamalarla güncellendi:

  • Veri güncelliği ve gecikme SLA'sı: Veri Modeli'ne, 48-72 saatlik veri işleme gecikmesini, bitiş tarihinin tam olarak işlenen son güne kadar kısaltılmasını açıklayan ve gerçek zamanlı video istatistikleri için YouTube Data API videos.list yöntemini öneren özel bir bölüm eklendi.

  • Kanal raporlarındaki parasal metrikler: Kanal raporları yetkilendirme dokümanı, kanal YouTube İş Ortağı Programı (YPP) üyesi olduğunda https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamıyla yetkilendirilmiş kanal raporlarında tahmini gelir ve reklam performansı metriklerinin desteklendiğini ve para kazanma özelliği etkin olmayan kanalların HTTP 403 Forbidden döndürdüğünü netleştirmek için güncellendi.

  • Sorgu kısıtlamaları ve parametre uyumluluğu: Rapor tablolarını anlama başlıklı makaleye, geçersiz veya birbirini dışlayan boyut, metrik ve filtre kombinasyonlarının HTTP 400 badRequest ("The query is not supported.") döndürdüğünü açıklayan bir tavsiye notu eklendi.

  • Toplu raporlardaki boş boyut değerleri: Silinen kaynaklar için toplu metrik sayılarını korumak ve kanal düzeyindeki etkinlikleri temsil etmek amacıyla video_id veya channel_id gibi boyut sütunlarının boş dizeler içerdiğini açıklamak için YouTube Reporting API rapor özelliklerini güncelledik.

27 Ağustos 2026

YouTube, uzun videolar, canlı yayınlar ve Shorts videoları dahil tüm video formatlarında herkese açık görüntüleme sayısını aynı şekilde hesaplayacak. YouTube, video oynatılmaya başlar başlamaz herkese açık görüntülemeleri sayar.

Para kazanmaya uygunluk ve temel performans metriklerinin çoğu, etkileşim metriklerine bağlı kaldıkları için etkilenmez. İçerik üreticilerin kazançları, YouTube Analytics > Gelişmiş Mod'da görebileceğiniz "aktif Shorts görüntülemeleri" ve "aktif izlenme saati"ne göre belirlenmeye devam edecek.

YouTube İş Ortağı Programı'na uygunluk koşullarında herhangi bir değişiklik yapılmadı. YouTube İş Ortağı Programı'na giriş şartları da artık "geçerli Shorts görüntülemeleri" ve "geçerli izlenme saati" (önceki adıyla "herkese açık geçerli Shorts görüntülemeleri" ve "herkese açık içeriklerin izlenme süresi") olarak adlandırılacak.

Daha fazla bilgi için YouTube içeriklerinizin performansına dair fikir edinme başlıklı makaleyi inceleyin.

Metrik Durum Tetikleyici Kullanım Amacı
Görünüm Güncellendi Video, ilk kareden oynatılır (otomatik oynatma, işaretçiyi üzerine getirme ve oynatmak için tıklama/dokunma dahil). Standart herkese açık görüntüleme sayıları.
Katılımlı Görüntüleme Değiştirilmemiş Oynatma ilk karenin ötesinde devam eder veya kullanıcı oynatmak için tıklar/dokunur. YouTube İş Ortağı Programı üzerinden para kazanma, temel analizlerin çoğu (tıklama oranı, ortalama izlenme süresi) ve etkileşim raporları.
Küçük resim gösterimi Değiştirilmemiş Küçük resim, etkileşim veya otomatik oynatma olmadan gösterilir. Feed düzeyinde gösterim ve paketlemeyi ölçer.

API belgelerinde yapılan güncellemeler: engagedViews metriğinin tanımı, YouTube Analytics API metrikleri ve YouTube Reporting API metrikleri belgelerinde güncellendi.

25 Haziran 2026

YouTube Analytics API (Hedefli Sorgular) dokümanı, içerik sahipleri için Şehre göre kullanıcı etkinliği raporunu kaldıracak şekilde güncellendi. Bu rapor, içerik sahipleri için desteklenmez. Kullanıcı etkinliğiyle ilgili içerik sahibi sorguları boş sonuçlar döndürür.

9 Mart 2026

ageGroup (YouTube Analytics API) ve age_group (YouTube Reporting API) boyutları artık YouTube'un 18 yaşından küçük olduğunu tahmin ettiği kullanıcıları da içeriyor.

15 Ocak 2026

YouTube Reporting API artık kanallar ve içerik sahipleri için erişim raporlarını destekliyor. Erişim raporları, video küçük resmi gösterimleri ve tıklama oranlarıyla ilgili istatistikler sağlar.

  • channel_reach_basic_a1 ve channel_reach_combined_a1 raporları kanallar için kullanılabilir.
  • content_owner_reach_basic_a1 ve content_owner_reach_combined_a1 raporları, içerik sahipleri tarafından kullanılabilir.

Bu raporlar aşağıdaki yeni metrikleri destekler:

  • video_thumbnail_impressions
  • video_thumbnail_impressions_ctr

22 Eylül 2025

Raporların daha önce duyurulan desteğinin sonlandırılması 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 1.0 sürümü hak talepleri raporu (content_owner_active_claims_a1) ve 1.1 sürümü hak talepleri raporu (content_owner_active_claims_a2) 30 Eylül'de kullanımdan kaldırılacak.

24 Haziran 2025

26 Mart 2025'te duyurulduğu gibi, Bulk Reports API, 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üntülemeleri içeren her rapor için yeni rapor sürümleri oluşturuldu. Bu raporlar, raporların büyük bir kısmını oluşturuyor. 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ümlerin desteği sonlandı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şiklikler işleme kanallarınızı bozmaz.

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
Dünya genelinde 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ıma sunulacak.

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.
  • engagedViews adlı yeni bir metrik kullanıma sunulacak ve önceki görüntüleme sayısı metodolojisini yansıtacak.
  • Kanal sahibiyseniz veya bir kanalın verilerine erişme yetkiniz varsa hem güncellenmiş görüntüleme sayısını hem de aktif izlenme sayısını 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, daha önce duyurulan Günlük Hak Talepleri (Sürüm 1.0) raporunun desteğinin sonlandırılması da ertelendi.

API'lerde değişikliklerin ne zaman yapıldığını öğrenmek 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 desteklenmeyecek. 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 artık sorgulanan video sayısı X tarih aralığındaki gün sayısı çarpımının 50.000'i aşması durumunda 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 fazla sorguya bölün. Genel bir kural olarak, büyük veri kümeleri için toplu raporlar önerilir.

6 Mayıs 2024

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

Ayrıca, Kitleyi Elde Tutma raporu üç yeni metriği 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ında ise bu boyutun 30 Haziran 2024'e kadar destekleneceğ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. 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ılamadığından bu değişiklik, API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getirir.

  • İç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çıklayacak şekilde 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 size ait olmayan videoların görüntüleme sayılarını da 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 listesindeki bir metrik olarak 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 toplam görüntülenme sayısını belirten toplu bir video metriğidir. Bu görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediği dikkate alınmaz. 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 (Hedefe Yönelik Sorgular) API'sinde kanal oynatma listesi raporlarıyla ilgili çeşitli güncellemeler yapıldı. Güncellemeler, desteği sonlandırılan bir boyutu ve çeşitli yeni ve güncellenmiş metrikleri içerir:

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

    isCurated boyutu, kanal raporları için kullanımdan kaldırılmıştır. 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ılamadığından bu değişiklik, API işlevselliğini Studio uygulamasında kullanılabilen işlevsellikle uyumlu hale getirir.

  • 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, kanala ait oynatma listelerindeki tüm videolar için toplu olarak sunulan kullanıcı etkinliği ve gösterim metriklerini sağlar. 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 size ait olmayan videoların görüntüleme sayılarını da 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 görüntülenme sayısını 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 görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediği dikkate alınmaz. 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ı belgelerinde artık API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak ilgili raporda desteklenen metrikleri gösteren tablolar yer alıyor. Örnek için zamana dayalı oynatma listesi raporlarını tanımlayan bölüme bakın.

4 Aralık 2023

YouTube Analytics (Hedefli Sorgular) API'si, iki insightTrafficSourceType boyut değerini birleştirecek şekilde güncellendi. Daha önce, boyut 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ıyordu. Bundan sonra, her iki görüntüleme türü de PLAYLIST boyut değeriyle ilişkilendirilecek.

15 Aralık 2022

YouTube Analytics (Hedefli Sorgular) API, 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ı için isteğe bağlı bir 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 (Hedefe Yönelik Sorgular) API ve YouTube Reporting (Toplu Raporlar) API'nin her ikisi de yeni bir trafik kaynağı ayrıntısı değerini destekler:

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

11 Şubat 2022

gender boyutu için geçerli değ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 (Hedefe Yönelik Sorgular) API'sini hem de YouTube Reporting (Toplu Raporlar) API'sini etkiler.

2 Şubat 2022

Bu YouTube Reporting (Toplu Raporlar) API'si, görüntülemelerin canlı yönlendirmelerden 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 (Hedefe Yönelik 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ğı boyutu değerini destekler:

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

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öntemi'nin filters parametresi, YouTube Analytics verileri alınırken uygulanması gereken filtrelerin listesini tanımlar. Parametre, video, playlist ve channel filtreleri için birden fazla değer belirtme özelliğini destekler. Bu filtreler için belirtilebilecek maksimum kimlik sayısı 200'den 500'e yü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 olmayan 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 boyutunu kullanarak 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: