API Reference

YouTube Analytics API, YouTube kanalları veya içerik sahipleri için YouTube Analytics verilerini almanıza olanak tanır. API, gerçek zamanlı sorguları destekler ve API isteği parametrelerine dayalı bir rapor oluşturur.

API iki tür işlevi destekler:

  • Rapor alma: API'nin reports.query yöntemi, YouTube Analytics raporlarını alır.

  • YouTube Analytics grup yönetimi: YouTube Analytics grubu, en fazla 500 kanal, video, oynatma listesi veya öğeden oluşan özel bir koleksiyondur. API, YouTube Analytics gruplarını oluşturmak, almak ve güncellemek için çeşitli yöntemleri destekler. Ardından, kanal ve içerik sahipleri bir gruptaki tüm öğelerin toplu verilerini almak için reports.query yöntemini kullanabilir. Bu yöntem, performans analizine yardımcı olabilir.

Bu sayfada, bu işlevleri etkinleştiren API kaynaklarına ve yöntemlerine kısa bir genel bakış sunulmaktadır.

Yetkilendirme

Tüm YouTube Analytics API istekleri yetkilendirilmelidir. Yetkilendirme kılavuzunda, yetkilendirme jetonlarını almak için OAuth 2.0 protokolünün nasıl kullanılacağı açıklanmaktadır.

YouTube Analytics API isteklerinde aşağıdaki yetkilendirme kapsamları kullanılır:

Nişan dürbünleri
https://www.googleapis.com/auth/yt-analytics.readonly YouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin. Bu kapsam, görüntüleme sayısı ve puan sayısı gibi kullanıcı etkinliği metriklerine erişim sağlar.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube içeriğiniz için YouTube Analytics mali raporlarını görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine ve tahmini gelir ile reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube YouTube hesabınızı yönetin. YouTube Analytics API'de kanal sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
https://www.googleapis.com/auth/youtubepartner YouTube öğelerini ve YouTube'daki ilişkili içerikleri görüntüleyin ve yönetin. YouTube Analytics API'de, içerik sahipleri bu kapsamı YouTube Analytics gruplarını ve grup öğelerini yönetmek için kullanır.

Rapor alma

API'nin reports.query yöntemi, birçok farklı YouTube Analytics raporu almanıza olanak tanır. Her istek; bir kanal kimliği veya içerik sahibi, başlangıç tarihi, bitiş tarihi ve en az bir metrik belirtmek için sorgu parametrelerini kullanır. Boyutlar, filtreler ve sıralama talimatları gibi ek sorgu parametreleri de sağlayabilirsiniz.

Yöntem HTTP isteği Açıklama
https://youtubeanalytics.googleapis.com/v2 ile ilgili URI'ler
query GET /reports YouTube Analytics raporu alır. Her API isteği; bir kanal kimliği veya içerik sahibi, başlangıç tarihi, bitiş tarihi ve en az bir metrik belirtmek için sorgu parametrelerini kullanır. Boyutlar, filtreler veya sıralama talimatları gibi ek sorgu parametreleri de sağlayabilirsiniz.
  • Metrikler, video etkinliğinin veya kullanıcı oylarının (beğenme ve beğenmeme sayısı) gibi kullanıcı etkinliğinin ayrı ayrı ölçümleridir.
  • Boyutlar, kullanıcı etkinliğinin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke gibi verileri toplamak için kullanılan yaygın ölçütlerdir. Bir raporda, her veri satırının boyut değerlerinin benzersiz bir kombinasyonu vardır.
  • Filtreler, alınacak verileri belirten boyut değerleridir. Örneğin, belirli bir ülkeye, belirli bir videoya veya bir grup videoya ait verileri alabilirsiniz.
Desteklenen kanal raporları ve içerik sahibi raporlarının listeleri, geçerli metrik, boyut ve filtre kombinasyonlarını tanımlar.

Grup yönetimi

API, YouTube Analytics gruplarını oluşturmak ve yönetmek için iki kaynak sunar:

Gruplar

group kaynağı, en fazla 500 kanal, video, oynatma listesi veya öğeden oluşan özel bir koleksiyon olan YouTube Analytics grubunu temsil eder.

Gruptaki tüm öğeler aynı kaynak türünü temsil etmelidir. Örneğin, 100 video ve 100 oynatma listesi içeren bir grup oluşturamazsınız.

Bir Analytics grubu yalnızca yüklediğiniz veya hak talebinde bulunduğunuz ya da yönettiğiniz bir kanala bağlı olan kaynakları içerebilir. Sonuç olarak, kanal sahipleri video ve oynatma listesi grupları oluşturabilir. İçerik sahipleri video, oynatma listesi, kanal veya öğe grupları oluşturabilir.

Bu kaynak hakkında daha fazla bilgi için kaynak temsiline ve mülklerin listesine bakın.

Yöntem HTTP isteği Açıklama
https://youtubeanalytics.googleapis.com/v2 ile ilgili URI'ler
list GET /groups API isteği parametreleriyle eşleşen grupların listesini döndürür. Örneğin, kimliği doğrulanmış kullanıcının sahip olduğu tüm grupları alabilir veya bir veya daha fazla grubu benzersiz kimliklerine göre alabilirsiniz.
insert POST /groups YouTube Analytics grubu oluşturur. Bir grup oluşturduktan sonra, gruba öğe eklemek için groupItems.insert yöntemini kullanın.
update PUT /groups Bir grubun meta verilerini değiştirir. Şu anda güncellenebilen tek özellik grup başlığıdır. (Grup öğeleri eklemek ve kaldırmak için groupItems.insert ve groupItems.delete özelliklerini kullanın.)
delete DELETE /groups Bir grubu siler.

Grup Öğeleri

groupItem kaynağı, YouTube Analytics grubundaki bir öğeyi temsil eder.

Bu kaynak hakkında daha fazla bilgi için kaynak temsiline ve mülklerin listesine bakın.

Yöntem HTTP isteği Açıklama
https://youtubeanalytics.googleapis.com/v2 ile ilgili URI'ler
list GET /groupItems API isteği parametreleriyle eşleşen grup öğelerinden oluşan bir koleksiyon döndürür.
insert POST /groupItems Grup öğesi oluşturur.
delete DELETE /groupItems Bir öğeyi gruptan kaldırır.