API Reference

YouTube Analytics API, bir YouTube kanalı veya içerik sahibine ait YouTube Analytics verilerini almanıza olanak tanır. API, gerçek zamanlı sorguları destekler ve API istek parametrelerine göre 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 grupları, en fazla 500 kanal, video, oynatma listesi veya öğe içeren özel koleksiyonlardır. API, YouTube Analytics grupları oluşturmak, almak ve güncellemek için çeşitli yöntemleri destekler. 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 istekleri aşağıdaki yetkilendirme kapsamlarını kullanır:

Kapsamlar
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'teki parasal raporları görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelir ve 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'daki YouTube öğelerini ve ilişkili içeriği görüntüleyin ve yönetin. YouTube Analytics API'de içerik sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.

Rapor getirme

API'nin reports.query yöntemi, birçok farklı YouTube Analytics raporunu almanıza olanak tanır. Her istek, kanal kimliği veya içerik sahibi, başlangıç tarihi, bitiş tarihi ve en az bir metrik belirtmek için sorgu parametreleri 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 raporunu alır. Her API isteği, kanal kimliği veya içerik sahibi, başlangıç tarihi, bitiş tarihi ve en az bir metrik belirtmek için sorgu parametreleri kullanır. Boyutlar, filtreler veya sıralama talimatları gibi ek sorgu parametreleri de sağlayabilirsiniz.
  • Metrikler, kullanıcı etkinliğinin video görüntüleme veya derecelendirme (beğenme ve beğenmeme) gibi bağımsız ölçümleridir.
  • Boyutlar, verileri toplamak için kullanılan ortak ölçütlerdir (ör. kullanıcı etkinliğinin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke). Bir rapordaki her veri satırında benzersiz bir boyut değeri kombinasyonu bulunur.
  • Filtreler, getirilecek verileri belirten boyut değerleridir. Örneğin, belirli bir ülke, belirli bir video veya bir video grubuyla ilgili 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ı oluşturmak ve yönetmek için iki kaynak sağlar:

Gruplar

group kaynağı, 500 adede kadar kanal, video, oynatma listesi veya öğenin yer aldığı özel bir koleksiyon olan YouTube Analytics grubunu temsil eder.

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

Analytics grupları yalnızca yüklediğiniz veya hak talebinde bulunduğunuz ya da yönettiğiniz bir kanala bağlı kaynaklar içerebilir. Bu sayede 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 özellik listesine bakın.

Yöntem HTTP isteği Açıklama
https://youtubeanalytics.googleapis.com/v2 ile ilgili URI'ler
list GET /groups API istek 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ı veya benzersiz kimliklerine göre bir veya daha fazla grubu alabilirsiniz.
insert POST /groups YouTube Analytics grubu oluşturur. 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 grubun başlığıdır. (Grup öğeleri eklemek ve kaldırmak için groupItems.insert ve groupItems.delete simgesini kullanın.)
delete DELETE /groups Grubu siler.

GroupItems

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

Bu kaynak hakkında daha fazla bilgi için kaynak temsiline ve özellik listesine bakın.

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