İnceleme Geçmişi

Bu sayfada, hem YouTube Reporting API hem de YouTube Analytics API için API değişiklikleri ve belge güncellemeleri listelenir. Her iki API de geliştiricilerin YouTube Analytics verilerine farklı şekillerde erişmesine olanak tanır.

30 Ekim 2026

YouTube Reporting API artık içerik sahipleri için aşağıdaki sistem tarafından yönetilen raporları destekliyor:

Kategori Rapor adı Rapor türü kimliği
Finansal Özetler Aylık kanal düzenlemeleri özeti content_owner_channel_adjustments_summary_a1
Finansal Özetler Aylık ücretli özellik işlemleri geliri content_owner_transactions_paid_features_revenue_a1
Finansal Özetler Ülkeye göre başlık başına aylık TVOD işlem geliri tvod_content_owner_country_title_tvod_revenue_a1
Finansal Özetler Ülkelere göre aylık TVOD işlem geliri tvod_content_owner_country_transactions_tvod_revenue_a1
Shorts Müzik şirketlerinin aylık Shorts öğesi oluşturma sayısı music_content_owner_shorts_asset_creations_a1
Shorts Müzik şirketinin aylık Shorts öğesi görüntüleme sayısı music_content_owner_shorts_asset_views_a1
Shorts Aylık müzik yayıncısı Shorts öğesi oluşturma sayısı publisher_content_owner_shorts_asset_creations_a1
Shorts Aylık müzik yayıncısı Shorts öğe görüntüleme sayısı publisher_content_owner_shorts_asset_views_a1
Vergiler Aylık MCN satış ortağı vergi iadesi özet raporu content_owner_affiliate_tax_refund_summary_a1
Assets Haftalık SRMF raporu publisher_content_owner_weekly_srmf
Assets Günlük RSK istek durumu raporu content_owner_oac_request_status_a1
Assets Günlük RSK istek kalitesi raporu content_owner_oac_quality_status_a1

13 Eylül 2026

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

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

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

Raporun önceki sürümü olan Sürüm 1.0 (content_owner_active_references_a1) kullanılmaya devam edebilir.

9 Eylül 2026

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

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

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

  • Sorgu kısıtlamaları ve parametre uyumluluğu: Rapor tablolarını anlama bölümüne, geçersiz veya birbirini hariç tutan 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: YouTube Reporting API rapor özelliklerini güncelleyerek video_id veya channel_id gibi boyut sütunlarının, silinen kaynaklar için toplu metrik sayılarını korumak ve kanal düzeyindeki etkinlikleri temsil etmek amacıyla boş dizeler içerdiğini açıkladık.

27 Ağustos 2026

YouTube, herkese açık görüntüleme sayısını tüm video formatlarında (uzun videolar, canlı yayınlar ve Shorts videoları) aynı şekilde ölçecek. YouTube, video oynatılmaya başladığı andan itibaren herkese açık görüntülemeleri sayar.

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

YouTube İş Ortağı Programı'na uygunluk koşullarında herhangi bir değişiklik yapılmadı. YouTube İş Ortağı Programı'na katılım koşulları 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 Alanı
Görünüm Güncellendi Video, ilk kareden itibaren oynatılır (otomatik oynatma, fareyle üzerine gelme ve oynatmak için tıklama/dokunma dahildir). Standart herkese açık görüntüleme sayısı.
Etkileşimli Görüntüleme Değiştirilmemiş Oynatma ilk kareden sonra devam eder veya kullanıcı oynatmak için tıklar/dokunur. YouTube İş Ortağı Programı üzerinden para kazanma, temel analizlerin (tıklama oranı, ortalama görüntüleme süresi) büyük bir kısmı 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örünürlüğü ve paketlemeyi ölçer.

API belgeleriyle ilgili güncellemeler: YouTube Analytics API metrikleri ve YouTube Reporting API metrikleri belgelerindeki engagedViews metriğinin tanımı güncellendi.

25 Haziran 2026

YouTube Analytics API (Hedefli Sorgular) dokümanları, 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. İçerik sahiplerinin şehre göre kullanıcı etkinliği 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 kullanımdan kaldı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'de kullanımdan kaldırılacak olan Hak Talepleri raporu v1.0 (content_owner_active_claims_a1) ve Hak Talepleri raporu v1.1 (content_owner_active_claims_a2) hariç olmak üzere bu tarihe kadar kullanılabilir.

24 Haziran 2025

26 Mart 2025'te duyurulduğu üzere, 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ılmıştır:

  • Görüntüleme sayısını içeren her rapor için yeni rapor sürümleri oluşturuldu. Bu, raporların çoğunluğunu oluşturuyor. Etkilenen her raporun sürümü birer artırıldı (ör. a2 sürümünden a3 sürümüne).
  • Shorts videolarında görüntüleme sayısı, Shorts videosunun oynatılmaya veya tekrar oynatılmaya başlama sayısını ifade edecek. Videolar için herhangi bir değişiklik yoktur.
  • Güncellenen raporlarda, önceki görüntüleme sayısı hesaplama yöntemini yansıtan 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şleme sürecinizi buna göre ayarladığınızdan emin olun.

Raporların önceki 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 yeni sürümlere geçiş yaptığınızdan emin olun.

Son olarak, raporları işlerken en iyi uygulamalardan yararlanarak raporlarda gelecekte yapılacak değişikliklerin işleme hat hatlarına zarar vermesini önleyin.

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 yeni 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 yeni 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 yeni 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 yeni 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ı - Reklam Öğesi Raporları
Rapor adı Önceki sürüm En yeni 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 yeni 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
Ülke 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 yeni sürüm
Etkin hak talepleri content_owner_active_claims_a2 content_owner_active_claims_a3
İçerik Sahibi Raporları - Video Meta Veri Raporları
Rapor adı Önceki sürüm En yeni sürüm
Video meta verileri content_owner_video_metadata_a3 content_owner_video_metadata_a4
İçerik Sahibi Raporları - Reklam Öğesi Raporları
Rapor adı Önceki sürüm En yeni 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 üzere, Hedefli 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 olacak.

Bu değişiklikler, Hedefli 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.

Bulk Reports API'de ne zaman hangi değişikliklerin yapılacağını öğrenmek için bu düzeltme geçmişini inceleyin.

22 Nisan 2025

7 Nisan 2024'te duyurulduğu üzere isCurated boyutu, kanal raporları ve içerik sahibi oynatma listesi raporları için kullanımdan kaldırıldı. 31 Aralık 2024'ten itibaren bu boyut artık desteklenmeyecek. 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 videolarındaki görüntülemelerin sayılma şeklini değiştirecek. Shorts videolarında daha önce, videoların saniye cinsinden belirli bir süre oynatılması görüntüleme olarak sayılıyordu. Artık Shorts görüntülemeleri hesaplanırken minimum izlenme süresine bakılmayacak. Oynatma veya tekrar oynatma işlemlerinin her biri, başladığı andan itibaren görüntüleme olarak sayılacak. 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 bu metrik, önceki görüntüleme sayısı hesaplama yöntemini 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.

Hedefli sorgular 30 Nisan'a kadar, toplu raporlar ise 30 Haziran'a kadar güncellenecek. O zamana kadar görüntüleme sayıları eski yönteme göre hesaplanacak. Shorts ve kanal görüntüleme sayıları, Studio'daki Analytics ile eşleşmeyecek.

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

API'lerde ne zaman değişiklik yapıldığını öğrenmek için bu düzeltme geçmişini inceleyin.

3 Mart 2025

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

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

Günlük Hak Talepleri (Sürüm 1.0) raporu, iş ortakları için kullanımdan kaldırıldı. 30 Nisan 2025'ten itibaren desteklenmeyecek. Bu raporun tanımı buna göre güncellendi. Bunun yerine en yeni 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 (Hedefli Sorgular) API dokümanları, Trafik Kaynağı raporları için API'nin reports.query yönteminin, sorgulanan video sayısı ile tarih aralığındaki gün sayısının çarpımı 50.000'i aşarsa hata döndüreceğini belirtecek şekilde güncellendi. Örneğin, 500 video kimliği için veri alan bir sorgu, en fazla 100 günlük veri 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. Kural olarak, büyük veri kümeleri için toplu raporlar önerilir.

6 Mayıs 2024

YouTube Analytics (Hedefli Sorgular) API'si, 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 bu boyutu 30 Haziran 2024'e kadar destekleyeceğini unutmayın.

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

    İçerik sahibi oynatma listesi raporları için isCurated boyutunun desteği sonlandırıldı. 31 Aralık 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 da güncellemeniz gerekir. Böylece, yalnızca oynatma listesi raporları için views metriği yerine playlistViews metriği alınır. views metriği, farklı bir anlamda da olsa oynatma listesi raporları için hâlâ desteklendiğinden, metrik adını güncellemezseniz API veri döndürmeye devam eder. 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şlevi 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ı için desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu değişiklikle birlikte API işlevleri, Studio uygulamasında kullanılabilen işlevlerle uyumlu hale getirildi.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporları için filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu değişiklikle birlikte API işlevleri, Studio uygulamasındaki işlevlerle uyumlu hale getirildi.

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

    • Toplu video metrikleri, içerik sahibinin oynatma listelerinde yer alan ve yine içerik sahibine ait olan tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Toplu video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, oynatma listesindeki size ait olmayan videolardan elde edilen 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ü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.

  • İçerik sahipleri için oynatma listesi raporlarında aşağıdaki yeni oynatma listesi içi metrikleri desteklenir. Bu metriklerin yalnızca raporları almak için gönderilen API isteği isCurated boyutunu kullanmıyorsa desteklendiğini unutmayın. Her metriğin tanımı için metrikler ile ilgili belgelere bakın:

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

    • Bir istek isCurated boyutunu içerdiğinde views metriği, videoların içerik sahibinin oynatma listeleri bağlamında kaç kez görüntülendiğini gösteren bir oynatma listesi içi metriktir.
    • İstek 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. Birleştirilmiş toplam, yalnızca oynatma listesinin sahibi olan kanalla ilişkili içerik sahibine ait videoların görüntüleme sayısını içerir.

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

  • Her oynatma listesi raporu için içerik sahibi raporları belgelerinde, API isteğinin isCurated boyutunu içerip içermediğine bağlı olarak ilgili rapor için desteklenen metrikleri gösteren tablolar yer alır. Ö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ılmış bir boyut ve birkaç yeni ve güncellenmiş metrik yer alır:

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

    isCurated boyutu, kanal raporları için kullanımdan kaldırıldı. 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 da güncellemeniz gerekir. Böylece, yalnızca oynatma listesi raporları için views metriği yerine playlistViews metriği alınır. views metriği, farklı bir anlamda da olsa oynatma listesi raporları için hâlâ desteklendiğinden, metrik adını güncellemezseniz API veri döndürmeye devam eder. 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şlevi 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ı için desteklenmiyor. Bu metrikler YouTube Studio'da kullanılamıyordu. Bu değişiklikle birlikte API işlevleri, Studio uygulamasında kullanılabilen işlevlerle uyumlu hale getirildi.
    • subscribedStatus ve youtubeProduct boyutları artık kanal oynatma listesi raporları için filtre olarak desteklenmiyor. Bu filtreler YouTube Studio'da kullanılamıyordu. Bu değişiklikle birlikte API işlevleri, Studio uygulamasındaki işlevlerle uyumlu hale getirildi.

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

    • Toplu video metrikleri, kanalın oynatma listelerindeki tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Bu videoların sahibi de aynı kanaldır. Toplu video metrikleri yalnızca isCurated boyutunu kullanmayan API istekleri için desteklenir.
    • Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, oynatma listesindeki size ait olmayan videolardan elde edilen 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ü, oynatma listesi raporları için desteklenen toplu video metriklerini ve oynatma listesi içi metrikleri tanımlar.

  • Kanallara yönelik oynatma listesi raporları için aşağıdaki yeni oynatma listesi içi metrikleri desteklenir. Bu metrikler henüz içerik sahibi raporları için desteklenmemektedir. Bu metriklerin yalnızca, raporları almak için gönderilen API isteği isCurated boyutunu kullanmıyorsa desteklendiğini unutmayın. Her metriğin tanımı için metrikler ile ilgili belgelere bakın:

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

    • İstek isCurated boyutunu içerdiğinde views metriği, videoların kanalın oynatma listeleri bağlamında kaç kez görüntülendiğini gösteren bir oynatma listesi içi metriktir.
    • İstek isCurated boyutunu içermediğinde views metriği, kanalın 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 değer, yalnızca oynatma listesinin sahibi olan kanala ait videoların görüntüleme sayısını içerir.

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

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

4 Aralık 2023

YouTube Analytics (Hedefli Sorgular) API'si, iki insightTrafficSourceType boyut değerini birleştirecek şekilde güncellendi. Daha önce bu boyut, oynatma listesinin bir 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'si iki yeni boyutu ve bir yeni raporu destekler:

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

  • 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.

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

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

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

26 Ağustos 2022

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

  • YouTube Analytics API (Hedefli 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 grubu 11 Ağustos 2022'de veya bu tarihten sonra değişecek. Bu, API uygulamanızda geriye dönük uyumsuz bir değişiklik olabilir. YouTube API Hizmetleri Hizmet Şartları'nın Geriye Dönük Uyumsuz Değişiklikler bölümü uyarınca, bu değişiklik yürürlüğe girmeden altı ay önce duyurulmaktadır. Yeni değer grubuna sorunsuz bir geçiş 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 iki değeri destekler: female ve male. 11 Ağustos 2022'de veya sonrasında bu boyut üç değeri destekleyecek: female, male ve user_specified.
  • YouTube Reporting (Toplu Raporlar) API'sinde gender boyutu şu anda üç değeri destekler: FEMALE, MALE ve GENDER_OTHER. 11 Ağustos 2022'de veya bu tarihten sonra, desteklenen değerler kümesi FEMALE, MALE ve USER_SPECIFIED olarak değişecek.

9 Şubat 2022

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

2 Şubat 2022

Bu YouTube Reporting (Toplu Raporlar) API'si, görüntülemelerin Live Redirects kaynaklandığını gösteren yeni bir trafik kaynağı boyut 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

YouTube Analytics (Hedefli Sorgular) API'si ve YouTube Reporting (Toplu Raporlar) API'si, izleyicinin YouTube Shorts izleme deneyiminde dikey olarak kaydırarak yönlendirildiğini gösteren yeni bir trafik kaynağı boyut değerini destekler:

Trafik kaynağı ayrıntı boyutu (YouTube Analytics API'de insightTrafficSourceDetail veya YouTube Reporting API'de traffic_source_detail), 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 öğeden 500 öğeye çıkarıldı.
  • reports.query yönteminin filters parametresi, YouTube Analytics verileri alınırken uygulanması gereken filtrelerin listesini tanımlar. Parametre; video, playlist ve channel filtreleri için birden fazla değer belirtme özelliğini destekler. Bu filtreler için belirtilebilecek maksimum kimlik sayısı 200'den 500'e çıkarılmıştır.

13 Şubat 2020

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

Her iki API'de de bildirimler için olası trafik kaynağı ayrıntı değerleri kümesi değişiyor. Hedefli 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 gelen görüntülemeler
  • uploaded_other: Bir video yüklendiğinde abonelere gönderilen e-posta veya gelen kutusu bildirimleri gibi push bildirimi olmayan bildirimlerden gelen görüntüleme sayısıdır.

Bu değerler, 13.01.2020 (13 Ocak 2020) tarihinden itibaren geçerli olan zaman aralığı için döndürülür.

Ayrıca, bu değerlerin bildirimleri değil, belirli YouTube görüntülemelerini sağlayan trafik kaynaklarını temsil ettiğini hatırlatmak isteriz. Örneğin, bir rapor satırında views=3, traffic_source_type=17 (NOTIFICATION) ve traffic_source_detail=uploaded_push gösteriliyorsa bu satır, video yüklendiğinde gönderilen push bildirimlerini tıklayan izleyicilerden üç görüntüleme elde edildiğini gösterir.

15 Ekim 2019

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

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

    Kullanıcılar, day boyutunu kullanarak sorgulama yapıp yedi veya 30 günlük dönemlerdeki verileri toplayarak ya da türeterek bu boyutlara ait verilerin bir kısmını yeniden oluşturabilir. Ö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önemin viewerPercentage değeri, her gün gerçekleşen görüntüleme sayısının o günün viewerPercentage değeriyle çarpılmasıyla hesaplanabilir. Bu sayede, o gün videoyu izlerken oturum açmış olan izleyicilerin sayısı elde edilir. Ardından, tüm dönem için giriş yapmış izleyicilerin sayısı eklenebilir ve tüm dönemin viewerPercentage değerini elde etmek için bu dönemin toplam görüntüleme sayısına bölünebilir.
    • Aynı izleyici farklı günlerde benzersiz izleyici olarak hesaplanabileceğinden, yedi günlük bir dönem için benzersiz izleyici sayısı hesaplanamaz. Ancak 30 günlük bir dönemdeki benzersiz izleyici sayısıyla ilgili verileri tahmin etmek için 30DayTotals boyutu yerine month boyutunu kullanabilirsiniz. month boyutunun takvim aylarını 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'si 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ı kaldıracak şekilde güncellendi. Bu referanslar arasında, desteğin sonlandırılmasına ilişkin bildirim ve 2. sürüme nasıl geçileceğini açıklayan geçiş rehberi de yer alıyor.

1 Kasım 2018

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

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

    Bu desteği sonlandırma planı ilk olarak 26 Nisan 2018'de duyurulmuştu.

17 Eylül 2018

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

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

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

      veya

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

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

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

18 Haziran 2018

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

  • Aşağıdaki yöntemlerin kapsam koşulları değişti:
    • reports.query yöntemine yönelik isteklerin https://www.googleapis.com/auth/youtube.readonly kapsamına erişimi olmalıdır.
    • groupItems.list yöntemine yönelik 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 bir kapsam (okuma-yazma kapsamı) kullanılırken ikinci seçenekte iki salt okunur 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 silinen kaynaklarla (ör. videolar, oynatma listeleri veya kanallar) ilişkili verileri nasıl işlediğini açıklayan yeni bir bölüm (toplu metrikler ve silinen öğeler) yer alır.
  • API'ye Genel Bakış'ın en iyi uygulamalar bölümü, YouTube Analytics API yanıtlarında tanımlanan kaynaklar için ek meta veriler almak üzere YouTube Data API'yi kullanabileceğinizi hatırlatacak şekilde güncellendi. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d arasındaki bölümler) belirtildiği üzere, API istemcileri söz konusu API'den depolanan kaynak meta verilerini 30 gün sonra 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 ve yeni politikalar tüm raporlar ve raporlama işleri için dünya genelinde geçerli olacaktır.

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

      Bu duyurudan önce, tüm API raporları oluş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 da API üzerinden erişilemeyecek. 60 günden eski diğer tüm raporlara da artık erişilemeyecek. Bu nedenle, politika değişikliğinden önce oluşturulan raporların 180 güne kadar kullanılabileceği artık belgelerde 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şturur.

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

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

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

  • API'ye genel bakış sayfasının backfill data (dolgu verileri) bölümü, backfill data'yı (dolgu verileri) daha önce yayınlanan bir veri kümesinin yerini alan bir veri kümesi olarak daha net tanımlayacak şekilde güncellendi.

26 Nisan 2018

YouTube Analytics (Hedefli Sorgular) API'sinin 2. sürümü (v2) artık herkes tarafından 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. Tüm bu değişiklikler yeni geçiş rehberinde ayrıntılı olarak açıklanmıştır.

    • API'nin sürümü v1 iken v2 olarak değiştirildi.
    • API istekleri için ana URL, https://www.googleapis.com/youtube/analytics/v1 yerine https://youtubeanalytics.googleapis.com/v2 olarak değiştirildi.
    • reports.query yönteminin çeşitli parametrelerinin adları güncellendi. Özellikle, v1 API'de end-date gibi kısa çizgi içeren parametre adları, v2 API'de kısa çizgi yerine camel case (endDate) kullanır. API'nin grup oluşturma ve yönetme yöntemleri, parametre adları için zaten camel case kullandığından bu değişiklik, parametre adlarını API genelinde tutarlı hale getirir.
    • v2 API, Google'ın global 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, v2 API'de desteklenmeyen birkaç v1 özelliği vardır:

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

  • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

    API'nin 1. sürümü (v1) artık kullanımdan kaldırılmıştır ve 31 Ekim 2018'e kadar desteklenecektir. Bu tarihten sonra v1 API'ye gönderilen tüm istekler çalışmayı durduracak. Bu nedenle, YouTube Analytics verilerine API üzerinden erişiminizde herhangi bir kesinti olmaması için lütfen en geç 31 Ekim 2018'e kadar v2 API'ye geçiş yapın.

21 Şubat 2018

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

  • İzleme istatistiklerini izleyicilerin yaş grubu ve cinsiyetine göre toplayan izleyici demografisi raporları, kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlayan youtubeProduct boyutunu artık desteklemiyor.

18 Ocak 2018

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

  • YouTube Reporting API (Toplu Raporlar)

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

  • YouTube Analytics API (Hedefli Sorgular)

20 Aralık 2017

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

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

    Gzip ile kodlanmış 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 mülkünün tanımında açıklanmıştır.

  • age group ve gender boyutlarının belgeleri, API'nin bu boyutlar için döndürdüğü gerçek değerleri gösterecek şekilde düzeltildi. Bu değişikliğin bir doküman düzeltmesi olduğunu ve API işlevinde veya davranışında bir değişikliği yansıtmadığını unutmayın. Ö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 boyutunun değerlerinde 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

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

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

API dokümanları, earnings metriğine dair kalan referansları kaldırmak için güncellendi.

6 Temmuz 2017

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

  • YouTube Analytics API (Hedefli Sorgular)

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

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

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

  • YouTube Reporting API (Toplu Raporlar)

    • ad_type boyutu artık, rezerve edilerek satılan bumper reklamları ifade eden 20 değerini destekliyor. Bumper reklamlar, video izlenmeden önce oynatılan, 6 saniyeye kadar süren ve atlanamayan video reklamlardır. Bu boyut için 19 değerinin, rezervasyon yerine açık artırma temelinde satılan bumper reklamları da ifade ettiğini unutmayın.

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

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

      Bu rapor türlerinin desteğinin sonlandırıldığı 15 Eylül 2016'da duyurulmuş ve 15 Aralık 2016'dan sonra bu rapor türleri için rapor oluşturulmamıştır. Önceden 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 yoktur.

24 Mayıs 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

Bu rapor türlerinin desteğinin sonlandırıldığı 22 Haziran 2016'da duyurulmuş ve 22 Eylül 2016'dan sonra bu rapor türleri için rapor oluşturulmamıştır. Önceden 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 yoktur.

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 (Kakao Story) değerinden 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 (Hedefli 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 üzerinden gelir verilerine erişebilen kanal sahipleri, artık bu verilere YouTube Analytics API aracılığıyla da erişebilir:

17 Mart 2017

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

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 00:00'da Pasifik Saati ile başlayıp 23:59'da Pasifik Saati ile sona eren dönemi ifade ettiğini belirtecek şekilde düzeltildi. Yılın zamanına bağlı olarak Pasifik saati UTC-7 veya UTC-8'dir.

      Tarihler genellikle 24 saatlik bir dönemi temsil etse de saatlerin ileri alındığı tarihler 23 saatlik bir dönemi, saatlerin geri alındığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce belgelerde, her tarihin benzersiz bir 24 saatlik dönemi temsil ettiği ve Pasifik Saati'nin her zaman UTC-8 olduğu belirtiliyordu.)

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

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

    • content_owner_basic_a1 rapor türü için 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ılabilir durumdaydı. 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 yoktur.

  • YouTube Analytics API (Hedefli Sorgular)

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

      Tarihler genellikle 24 saatlik bir dönemi temsil etse de saatlerin ileri alındığı tarihler 23 saatlik bir dönemi, saatlerin geri alındığı tarihler ise 25 saatlik bir dönemi temsil eder. (Daha önce dokümanlarda, Pasifik Saati'nin UTC-8 olduğu belirtiliyor ve bir günün 24 saatlik bir dönemi temsil etmeyebileceği olasılığından bahsedilmiyordu.)

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

    • Kanal raporları belgeleri, 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 vermiyor.

    • 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, API yanıtının kanalların içerik sahibine bağlanmasından önceki döneme ait izlenme süresi ve görüntüleme verilerini içermesi gerektiğini belirtmesine olanak tanır. Varsayılan parametre değeri false olduğundan API yanıtı, varsayılan olarak yalnızca kanalların içerik sahibine bağlandığı zamandan itibaren izlenme süresi ve görüntüleme verilerini içerir.

API isteği birden fazla kanal için veri 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 sayısı verileri, 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 desteklenmemektedir ve belgelerden kaldırılmıştır. Her raporun daha yeni bir sürümü mevcuttur. (Bu raporların kullanımdan kaldırılacağı 15 Eylül 2016'da duyurulmuştu.)

API referans belgelerindeki mevcut rapor türlerinin listesi de güncellendi.

11 Kasım 2016

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

YouTube Reporting API, üç yeni bitiş ekranı raporunun yanı sıra bu raporlar için yeni boyutları ve metrikleri destekler. Raporlar, video oynatımı durduktan 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ılmıştır ve artık desteklenmemektedir. 10 Ağustos 2016'da duyurulduğu üzere, 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'un İçerik Stüdyosu'ndaki Raporlar bölümünde ilgili raporlara erişimi olan içerik sahipleri için sistem tarafından yönetilen bir dizi reklam geliri raporunu otomatik olarak oluşturur. Sistem tarafından yönetilen yeni API raporları, manuel olarak indirilebilen İçerik Stüdyosu raporlarında da bulunan verilere programatik erişim sağlamak için tasarlanmıştır.

Sistem tarafından yönetilen raporlara genel bakış bölümünde yeni raporlara kısa bir genel bakış sunulur ve bu raporların API aracılığıyla alınması süreci açıklanır. İş ortaklarının raporları oluşturmak için iş planlaması gerekmediğinden bu işlem, YouTube Analytics için toplu raporları alma işleminden biraz farklıdır.

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
  • Video başına günlük, ülkeye göre reklam geliri
  • Öğe başına aylık, dünya genelindeki reklam geliri
  • Öğe başına günlük, ülkeye göre reklam geliri
  • Hak talepleri (Bu rapor, gelir verilerini içermez.)

27 Eylül 2016

Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

15 Eylül 2016

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

19 Ağustos 2016

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

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

    19 Mayıs 2016 tarihli düzeltme geçmişi girişinde açıklandığı gibi, content_owner_basic_a1 raporunun yerini content_owner_basic_a2 raporu almıştır.

11 Ağustos 2016

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

  • YouTube Mühendislik ve Geliştirici Blogu'nda ayrıntılı olarak ele alınan ve yeni yayınlanan YouTube API Hizmetleri Hizmet Şartları ("Güncellenen Şartlar"), mevcut Hizmet Şartları'nda yapılan birçok güncellemeyi içerir. 10 Şubat 2017'den itibaren geçerli olacak Güncellenmiş Şartlar'a ek olarak bu güncelleme, geliştiricilerin uyması gereken politikaları açıklamaya yardımcı olacak çeşitli destekleyici belgeler de içerir.

    Yeni belgelerin tamamı, Güncellenen Şartlar'ın düzeltme geçmişinde açıklanmıştır. Ayrıca, Güncellenen Şartlar'da veya bu destekleyici belgelerde gelecekte yapılacak değişiklikler de bu düzeltme geçmişinde açıklanacaktır. 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 (Hedefli Sorgular)

    • Not: Bu, desteğin sonlandırılmasıyla ilgili bir duyurudur.

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

      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ği temel bir metrik olduğundan bu duyurunun yapıldığı tarihten itibaren bir yıl boyunca desteklenecektir. Temel metrik olmayan diğer metrikler, üç ay boyunca (4 Kasım 2016'ya kadar) desteklenecektir.

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

    • insightTrafficSourceType boyutu iki yeni boyut değerini destekler:
      • CAMPAIGN_CARD: Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan ve kullanıcı tarafından yüklenen videolardan geldiğini 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, 6 saniyeye kadar süren ve atlanamayan video reklamları 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. Görüntülemelerin, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan ve kullanıcı tarafından yüklenen videolardan geldiğini gösterir.
      • 20: Veriler, başka bir videonun bitiş ekranından gelen görüntülemelerle ilgilidir.

      Her iki yeni trafik kaynağında da traffic_source_detail boyutu, izleyicinin yönlendirildiği videoyu tanımlar.

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

    • ad_type boyutu artık bumper reklamları ifade eden 19 değerini destekliyor. Bumper reklamlar, videonun görüntülenebilmesi için izlenmesi gereken, 6 saniyeye kadar süren ve atlanamayan video reklamlardır.

18 Temmuz 2016

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

  • YouTube Analytics API (Hedefli Sorgular)

    • Aşağıdaki kanal raporları için desteklenen metriklerin listeleri, kart metriklerini içerecek şekilde güncellendi. Bu raporlardaki kart metrikleri için destek aslında 28 Haziran 2016'da eklenmiştir ve bu tarihe ait düzeltme geçmişi girişi, değişikliği daha ayrıntılı bir şekilde açıklamaktadır. Raporlar şunlardır:
      • ABD eyaletleri için temel kullanıcı etkinliği
      • Belirli dönemlerde ABD eyaletlerindeki kullanıcı etkinliği
      • İle göre kullanıcı etkinliği
      • Abonelik 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

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

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

  • YouTube Reporting API (Toplu Raporlar)

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

28 Haziran 2016

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

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

22 Haziran 2016

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

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

    Daha önce belgelerde, raporların API isteğinin gönderildiği tarihten önceki 180 güne kadar olan dönem için kullanılabildiği belirtiliyordu. Teknik olarak doğru olsa da orijinal metin 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 adlandırılan rapor, önceki sürümle aynıdır.

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

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

      Yeniden adlandırılan her iki rapor da önceki sürümlerinden aşağıdaki yönlerden 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ı kullanımdan kaldırıldı.

    Bu raporlardan herhangi biri için işleriniz 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 rapor grubunu yansıtacak şekilde güncellendi.

  • İki metriğin adı, raporlarda görünen adlarla eşleşecek şekilde belgelerde düzeltildi. Bu yalnızca dokümanla ilgili bir düzeltmedir ve gerçek rapor içeriklerinde bir değişiklik olduğu anlamına gelmez:

    • estimated_partner_adsense_revenue metriğinin adı estimated_partner_ad_sense_revenue olarak güncellendi. Ancak bu metriğin yalnızca bu güncellemeyle kullanımdan kaldırılan 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üncellemeyle kullanımdan kaldırılan iki raporda göründüğünü tekrar hatırlatmak isteriz. 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.

  • Reporting API'nin boyutlar belgesi, elapsed_video_time_percentage ve audience_retention_type özelliklerini artık listelemeyecek şekilde güncellendi. Bu boyutlar şu anda API üzerinden erişilebilen hiçbir rapor tarafından desteklenmemektedir.

19 Mayıs 2016

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

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

    content_owner_basic_a1 raporunu oluşturmak için 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ünmesi zarar veren bir değişiklik olabilir.

    Yeni raporun yayınlanmasıyla birlikte content_owner_basic_a1 raporu kullanımdan kaldırıldı. Bu rapor için bir işiniz varsa YouTube'un 19 Ağustos 2016'dan sonra bu iş için yeni raporlar oluşturmasını beklememelisiniz. 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 desteği sonlandı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 kullanımdan kaldırılacağı tarih ve saati belirtir. Bu özellik yalnızca desteği sonlandırıldığı duyurulan raporlar için bir değere sahiptir ve bu değer, YouTube'un bu tür raporları oluşturmayı durduracağı tarihi temsil eder.

      Bir rapor türünün desteğinin sonlandırıldığı duyurulduktan sonra YouTube, üç ay daha bu türde raporlar oluşturur. Örneğin, 19 Mayıs 2016 tarihli bu güncelleme, content_owner_basic_a1 raporunun kullanımdan kaldırıldığını duyurur. Bu nedenle, bu rapor türü için deprecateTime, 19 Ağustos 2016'da bir zaman belirtir. Bu zamandan sonra YouTube, bu tür raporlar oluşturmayı durdurur.

    • job kaynağının expireTime özelliği, işin sona erdiği veya sona ereceği tarih ve saati belirtir. İşle ilişkili rapor türü kullanımdan kaldırılmışsa veya iş için oluşturulan raporlar uzun bir süre boyunca indirilmemişse bu özelliğin bir değeri olur. Bu tarih, YouTube'un iş için yeni raporlar oluşturmayı durdurduğu zamanı belirtir.

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

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

12 Nisan 2016

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

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

    Geçmiş raporlar, hazır oldukları anda yayınlanır. Ancak bir işe ait tüm geçmiş verilerin yayınlanması yaklaşık bir ay sürer. Dolayısıyla, bir raporlama işi planladıktan bir ay sonra yaklaşık yedi aylık verilere erişebilirsiniz. (Bu duyurudan önce oluşturulan iş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şlerin 180 günden daha az geçmiş verisi olacaktır.

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

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

    • Belgelerde artık raporların oluşturulduktan sonra 180 gün boyunca kullanılabilir olduğu ve bu nedenle API istemcileri tarafından indirilebileceği belirtiliyor. Daha önce belgelerde, raporların API isteğinin gönderildiği tarihten önceki altı aya kadar olan bir süre için kullanılabildiği belirtiliyordu.

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

  • 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 sahipleri tarafından kullanılabilir. Bu nedenle, yeni API işlevi bu verilere programatik erişim sağlayacaktır.

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

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

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

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

      Yöntemin raporun oluşturulduğu zamanla 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 tanımlayıp tanımlamadığını gösterir.

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

28 Mart 2016

YouTube Reporting API ve YouTube Analytics API artık birkaç paylaşım hizmeti için daha görüntüleme istatistikleri 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 abonelikler akışında ya da başka bir YouTube göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
    • 8: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
  • traffic_source_type boyutu artık boyut değeri olarak 18 değerini destekliyor. Bu değer, video görüntülemelerinin bir oynatma listesindeki tüm videoları listeleyen bir sayfadan kaynaklandığını gösterir. Bu kaynak, görüntülemelerin 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 abonelikler akışında ya da başka bir YouTube göz atma özelliğinde gerçekleşen görüntülemelerle ilgilidir.
    • SEARCH: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemelerle ilgilidir.
  • insightTrafficSourceType boyutu artık boyut değeri olarak YT_PLAYLIST_PAGE değerini destekliyor. Bu değer, video görüntülemelerinin bir oynatma listesindeki tüm videoları listeleyen bir sayfadan kaynaklandığını gösterir. Bu kaynak, görüntülemelerin video bir oynatma listesinin parçası olarak oynatılırken 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 API için desteklenen metrikler arasında artık kart metrikleri yer almıyor. (Bu API'nin raporlarından hiçbirinin kart metriklerinden herhangi birini desteklediği belgelenmemişti.)

Çok sayıda kanal ve içerik sahibi raporu için bu metrikleri destekleyen YouTube Reporting API'yi kullanarak kart metriklerini almaya devam edebileceğinizi unutmayın.

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

21 Aralık 2015

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

18 Aralık 2015

Avrupa Birliği (AB) yasaları uyarınca, AB'deki son kullanıcılara belirli açıklamaların yapılması ve bu kullanıcılardan izin alınması zorunludur. Bu nedenle, Avrupa Birliği'ndeki son kullanıcılar için AB Kullanıcı Rızası Politikası'na uymanız gerekir. Bu şartla ilgili bir bildirimi YouTube API Hizmet Şartları'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ılabilen üç yeni oynatma ayrıntısı boyutunu destekliyor:

    • liveOrOnDemand: Bu boyut, rapordaki verilerin canlı yayın sırasında gerçekleşen kullanıcı etkinliğini açıklayıp açıklamadığını gösterir.
    • subscribedStatus: Bu boyut, verilerdeki kullanıcı etkinliği metriklerinin videonun veya oynatma listesinin kanalına abone olan izleyicilerle iliş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.

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

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

    Mülk Değer
    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, grup
    0 veya daha fazla kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

  • YouTube Analytics API, API kullanıcısının veri alamadığı varlıkları birden fazla değeri destekleyen filtrelerden (video, playlist ve channel) otomatik olarak kaldırır. API sunucusu daha önce, API kullanıcısı belirtilen öğelerden en az birinin verilerine erişemediğinde 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ı, videoların 18'inin sahibidir. Ancak video kimliklerinden biri başka bir kanala ait bir videoyu, diğeri ise silinmiş ve 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ır ve API yanıtı, API kullanıcısının sahip olduğu 18 videonun verilerini içerir.

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

  • YouTube Analytics API'nin groupItems.insert yöntemi, bir gruba öğe eklemeye çalıştığınızda ancak bu öğeye erişiminiz olmadığında artık yetkisiz (403 HTTP yanıt kodu) hatası döndürüyor. Daha önce API, varlığı gruba eklemenize izin veriyordu ancak daha sonra bu grubun raporlama verilerini almaya çalıştığınızda yetkisiz 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ıtın nextPageToken parametresi, sonuçların sonraki sayfasını almak için kullanılabilecek bir jeton belirtir. Ek sonuçlar almak için yöntemin pageToken parametresini bu değere ayarlayın.

10 Kasım 2015

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

29 Ekim 2015

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

  • YouTube Reporting API'nin date boyutuyla ilgili dokümanlar, tarihlerin Pasifik Saati'ne (UTC-8) göre 00:00'da başlayan 24 saatlik dönemi referans aldığını yansıtacak şekilde düzeltildi. Daha önce dokümanda, tarihin 12:00'de (GMT) başladığı belirtiliyordu.

    Ayrıca, YouTube Analytics API belgeleri, tarihle ilgili tüm boyutların (day, 7DayTotals, 30DayTotals ve month) Pasifik Saati'ne (UTC-8) göre 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ı (geçmiş verilerle doldurulan yeni raporlar dahil) listelemesi gerektiğini gösterir. Parametre değerinin, döndürülen verilerle ilişkili tarihler için değil, raporun oluşturulduğu zaman için geçerli olduğunu unutmayın.

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

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

  • job kaynağının createTime özelliğinin ve report kaynağının startTime, endTime ve createTime özelliklerinin tanımları, özellik değerlerinin nanosaniye değil mikrosaniye 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ümanlar, olası boyut değerlerinin listesini içerecek şekilde güncellendi. Listede, yeni desteklenen bir dizi hizmet 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 amacıyla satırlar genelinde verileri boyut değerlerine göre birleştirebilirsiniz.

    YouTube'un oluşturması gereken raporları 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.

  • Farklı API'ler olmalarına rağmen hem YouTube Analytics API hem de YouTube Reporting API, geliştiricilerin YouTube Analytics verilerini almasına olanak tanır. Her iki API de benzer veri kümelerine erişim sağladığından, iki API'nin belgeleri tek bir belge seti olarak yayınlanmaktadır.

    • Doküman setindeki Kılavuzlar sekmesi, API isteklerini yetkilendirme talimatları da dahil olmak üzere her iki API için de ortak bilgiler içerir.
    • Toplu raporlar sekmesinde, özellikle YouTube Reporting API ile ilgili referans belgeleri ve diğer içerikler yer alır.
    • Hedefli sorgular sekmesinde, özellikle YouTube Analytics API için referans belgeleri ve diğer içerikler bulunur.
    • Örnekler sekmesinde, iki API için de 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 mevcut tüm kanal raporlarını listeleyen bir sayfa ve mevcut tüm içerik sahibi raporlarını listeleyen başka bir sayfa yer alıyor. Daha önce dokümanlarda kanal video raporları, kanal oynatma listesi raporları vb. için ayrı sayfalar vardı.

    • Yeni veri modeline genel bakış, API'nin işleyiş şeklini daha net bir şekilde açıklamayı amaçlar. Bu dokümanda, YouTube'un rapor değerlerini hesaplamak için metrikleri, boyutları ve filtreleri nasıl kullandığı daha ayrıntılı bir şekilde açıklanmaktadır.

    • API'nin raporları almak için kullandığınız reports.query yöntemi artık ayrı olarak belgelenmektedir. Bu sayfadaki bilgiler daha önce başka sayfalarda yer alıyordu. Yeni sayfa, rapor almak için göndermeniz gereken bilgileri daha kolay belirlemenize yardımcı olacak şekilde 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 tahmini toplam kazancı (net gelir) içerir. Temel bir metrik değildir. API, earnings metriğini zaten destekleyen tüm raporlar için adEarnings metriğini destekler.

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

  • primaryAdGrossRevenue metriğ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. Kanallar ve içerik sahipleri için video raporu listeleri, yeni metrikleri destekleyen raporları tanımlayacak şekilde güncellendi.

    • videosAddedToPlaylists: Sorgu kapsamındaki videoların herhangi bir YouTube oynatma listesine eklenme sayısıdır. Videolar, video sahibinin oynatma listesine veya diğer kanalların oynatma listelerine eklenmiş olabilir.
    • videosRemovedFromPlaylists: Sorgu kapsamındaki videoların YouTube oynatma listelerinden kaldırılma sayısı. 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. bir kanalın yüklemeler oynatma listesi veya bir kullanıcının izleme geçmişi) bu sayıya dahil edilmez. Ayrıca bu metriklerin, ekleme ve silme işlemlerinin mutlak sayısını yansıttığını unutmayın. Örneğin, bir kullanıcı oynatma listesine bir video ekleyip 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:

16 Mart 2015

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

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

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

25 Şubat 2015

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

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

    • Grup oluşturma ve yönetme

      Bu güncellemeyle, grup oluşturma ve yönetme için group ve groupItem kaynakları kullanıma sunuluyor.

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

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

    • Bir grubun raporlama 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, ilgili gruptaki tüm öğelerin verilerini döndürür. API'nin şu anda öğe grupları için rapor oluşturma özelliğini desteklemediğini unutmayın.

    YouTube Analytics grupları hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni inceleyin.

13 Şubat 2015

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

  • API artık show boyutunu desteklemiyor.

28 Ağustos 2014

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

  • API artık video, playlist, channel ve show boyutları filtre olarak kullanıldığında bu boyutlar için birden fazla değer belirtme özelliğini destekliyor. Birden fazla değer belirtmek için filters parametre değerini, API yanıtının filtrelenmesi gereken video, oynatma listesi, kanal veya program kimliklerinin virgülle ayrılmış listesi olarak 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. Filtre, belirli bir rapor için desteklenen bir boyut olarak listelenmese bile bu durum geçerlidir. Filtreyi boyut listesine eklerseniz API, sonuçları gruplandırmak için filtre değerlerini de kullanır.

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

16 Temmuz 2014

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

  • 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 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ıdır.
    • viewsPerPlaylistStart: Bir oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme sayısıdır.
    • averageTimeInPlaylist: Bir izleyicinin, oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları izlediği tahmini ortalama süre (dakika cinsinden).

    Oynatma listesi raporu alma isteklerinde isCurated filtresi kullanılmalı ve bu filtre 1 (isCurated==1) olarak ayarlanmalıdır.

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

    • audienceWatchRatio metriği, videoyu belirli bir noktada izleyen izleyicilerin mutlak oranını gösterir. Bu oran, 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.

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

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

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

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

    Yeni metriklerin tümü temel metriklerdir ve Kullanımdan Kaldırma Politikası'na tabidir. Ancak, yeni metriklerle ilgili verilerin 16 Temmuz 2013'ten itibaren kullanılabilir olduğunu unutmayın. (annotationClickThroughRate ve annotationCloseRate metriklerine ait 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şkilendirilir. Bu nedenle, insightTrafficSourceType filtresini GOOGLE_SEARCH olarak ayarlayan bir insightTrafficSourceDetail raporu almak da artık mümkün değildir.

31 Ocak 2014

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

16 Ocak 2014

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

  • Örnek istekler dokümanı, örnekleri kategoriler halinde gruplandıracak şekilde yeniden tasarlandı. Bu amaçla, kanal ve içerik sahibi raporları için yakın zamanda kullanıma sunulan sekme biçimine benzer bir biçim kullanıldı. Yeni tasarımda örnekler aşağıdaki kategorilerde gruplandırılı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 belgesinde artık kanal raporlarında veya içerik sahibi raporlarında eyalete özgü verileri almak için yeni örnekler yer alıyor.

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

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

  • province boyutunun tanımı, dimensions parametre değerine province dahil edildiğinde isteğin, filters parametre değerine country==US ekleyerek verileri ABD ile 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 dokümanlar yeniden tasarlandı. Her dokümanda, olası tüm raporları listeleyen bir tablo sunmak yerine raporlar kategoriler halinde gruplandırı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 bir sekme listesi olarak gösterilir. Herhangi bir sekmeyi tıklayarak ilgili kategorideki desteklenen raporları görebilirsiniz.

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

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

      • API, istatistikleri eyalet bazında dökümünü çıkaran iki raporu destekler. Her iki rapor da kanallar ve içerik sahipleri tarafından kullanılabilir.

        • Temel istatistikler raporu, görüntüleme sayısı ve tahmini izlenme süresi (dakika) 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 raporu yalnızca belirli bir eyalete ait istatistikleri içerecek şekilde kısıtlamak için filters sorgu parametresini kullanabilirsiniz. Coğrafi raporlar, oynatma konumu raporları, trafik kaynağı raporları, cihaz raporları, işletim sistemi raporları, demografi raporları ve en popüler video raporları dahil olmak üzere çeşitli raporlar bu filtreleme türünü destekler.

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

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

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

  • Belgeler, insightTrafficSourceDetail boyutunun geçerli bir filtre değeri olarak insightTrafficSourceType değerini (PROMOTED) içermeyeceği şekilde düzeltildi.

30 Eylül 2013

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

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

  • API artık insightPlaybackLocationType boyutu için EXTERNAL_APP değerini destekliyor. Bu güncellemeyle birlikte, 10 Eylül 2013'ten itibaren oynatmalar artık MOBILE oynatma olarak kategorize edilmeyecek. Ancak bu tarihten önce gerçekleşen mobil oynatmalar bu değerle kategorize edilmeye devam edecek.

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

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

16 Temmuz 2013

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

  • API artık raporları birden fazla boyut ve metriğe göre sıralama özelliğini destekliyor. Örnek istekler dokümanında, bu işlevi gösteren yeni bir örnek (İstekleri birden fazla boyuta/metriğe göre sıralama) bulunmaktadır. İstek, trafik kaynağı verilerini alır ve day,-views değerinde bir sort parametresine sahiptir. Sonuçlar kronolojik olarak sıralanır ancak her günün sonuç kümesinde ilk satır en fazla görüntülemeyi oluşturan trafik kaynağına ait verileri, ikinci satır en yüksek ikinci görüntüleme sayısını oluşturan kaynağa ait verileri içerir ve bu şekilde devam eder.

  • API artık izleyicilerin videolarınızı izlediği cihazlar hakkında veri almak için kullanılabilecek iki yeni boyutu (deviceType ve operatingSystem) destekliyor. API, boyutlardan birini veya her ikisini kullanan raporları destekler.

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

    • operatingSystem raporu; Android, iOS, Linux ve diğer işletim sistemleri için görüntüleme sayılarını ve tahmini izlenme süresini almanıza olanak tanır. İş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 dokümanı, kanallar için üç cihaz raporu ve içerik sahipleri için üç cihaz raporu içerecek şekilde güncellendi.

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

23 Mayıs 2013

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

10 Mayıs 2013

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

6 Mayıs 2013

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

  • API artık izlenme süresi metriklerini (estimatedMinutesWatched, averageViewDuration ve averageViewPercentage) görüntüleme metrikleri, etkileşim metrikleri, kazanç metrikleri ve reklam performansı metrikleri gibi diğer metriklerle birlikte alma özelliğini 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ı bir 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ünün isteğe bağlı country filtresini de desteklediğini unutmayın.

      • Oynatma konumu ayrıntısı

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

      • Trafik kaynağı ayrıntısı

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

3 Mayıs 2013

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

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

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

28 Mart 2013

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

21 Mart 2013

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

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

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

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

      • earnings: Google tarafından satılan tüm reklam kaynaklarından elde edilen tahmini toplam 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österimi içeren oynatma sayısıdır.
      • playbackBasedCpm: Bin oynatma başına tahmini brüt gelir.
      • impressions: Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
      • impressionBasedCpm: Bin reklam gösterimi başına tahmini brüt gelir.

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

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

  • API dokümanları, farklı rapor türleri ayrı sayfalarda açıklanacak şekilde yeniden düzenlendi. Bu nedenle, farklı kanal raporu ve içerik sahibi raporu türlerini açıklayan ayrı sayfalar oluşturuldu.

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ü bulunuyor. JavaScript kod örneği, örnek uygulama dokümanlarında ayrıntılı olarak ele alınan örnekle aynıdır.

14 Kasım 2012

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

  • API referans kılavuzu artık APIs Explorer özelliğini içeriyor. 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 yeri ayrıntı raporu, belirli bir video için en çok görüntüleme sağlayan yerleştirilmiş oynatıcıları tanımlar. En popüler yerleştirilmiş oynatıcılarla ilişkili URL'leri belirleyerek oynatma konumu raporundan daha ayrıntılı bir görünüm sunar.

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

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

    • İzlenme süresi raporları, izleyicilerin içeriğinizi izlemek için harcadığı süreyi gösterir. Raporlar, belirli bir zaman dilimi (gün, önceki yedi gün, önceki 30 gün vb.) veya ülke için verileri birleştirebilir. Bir rapor, verileri güne veya ülkeye göre birleştiriyorsa her bir video görüntülemenin ortalama uzunluğunu ve kullanıcıların her bir videoyu izleme yüzdesinin ortalamasını da belirtebilir.

2 Ekim 2012

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

  • YouTube Analytics API artık tüm geliştiricilerin kullanımına sunuldu. Önceden erişim isteğinde bulunmanıza gerek kalmadan APIs console'daki Hizmetler panelinden projeniz için API'yi etkinleştirebilirsiniz.

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

12 Eylül 2012

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

  • Yeni kota kullanımını anlama bölümünde, API kota kullanımınızı optimize etmeye yönelik yönergeler sunulmaktadır. API sunucusu, her istek için bir sorgu maliyeti hesaplar ve bu maliyet, API kullanım kotanızdan düşülür. Farklı rapor türlerinin sorgu maliyetleri büyük ölçüde farklı olabileceğinden kotanızı verimli bir şekilde kullanmayı planlamanız gerekir. 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 birleştirmesi gerektiğini belirttiğini açıklayacak şekilde güncellendi. API artık aşağıdaki ek zamansal boyutları desteklemektedir:

    • 7DayTotals: Rapordaki veriler, her satırda yedi günlük bir döneme ait veriler olacak şekilde birleştirilir.
    • 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 raporlara yönelik desteğini yansıtacak şekilde güncellendi.

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

  • API artık en popüler 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 metrikleri (görüntüleme 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 bir kanala abone olan veya abonelikten çıkan kullanıcıların sayısına göre sıralayabilirsiniz.

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