YouTube Reporting API

YouTube Reporting API, geliştiricilerin raporlama işlerini planlamasına ve ardından oluşturulan toplu raporları indirmesine olanak tanır. API, her biri bir kanal veya içerik sahibine ait kapsamlı bir YouTube Analytics verileri grubu içeren önceden tanımlanmış bir rapor grubunu destekler.

Aşağıdaki adımlarda, raporlama işlerinin nasıl planlanacağı ve raporların nasıl alınacağı açıklanmaktadır:

  1. Bir kanalın veya içerik sahibinin alabileceği raporların listesini almak için reportTypes.list() yöntemini çağırın.
  2. Bir kanal veya içerik sahibi için oluşturulması gereken bir raporu tanımlamak üzere jobs.create() yöntemini çağırın. Daha sonra, oluşturulan raporların listesini almak veya değiştirmek için API'nin jobs.list() ve jobs.delete() işlevlerini kullanabilirsiniz.
  3. Belirli bir iş için oluşturulan raporların listesini almak üzere jobs.reports.list() yöntemini çağırın. Yanıtın her kaynağında, raporun indirilebileceği URL'yi belirten bir downloadUrl özelliği bulunur.
  4. Raporu indirme URL'sinden almak için yetkili bir GET isteği gönderin.

Yetkilendirme

Tüm YouTube Reporting 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 Reporting 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 derecelendirme 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 finansal raporlarını görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelire ve reklam performansı metriklerine erişim sağlar.

Kaynak türleri

Aşağıdaki bölümlerde API'nin kaynakları ve yöntemleri hakkında genel açıklamalar verilmektedir. Tablolarda gösterilen tüm yöntem URI'leri https://youtubereporting.googleapis.com ile ilgilidir.

jobs

Yöntemler
create POST /v1/jobs
Raporlama işi oluşturur. Raporlama işi oluşturarak YouTube'a bu raporu günlük olarak oluşturma talimatı vermiş olursunuz. Rapor, işin oluşturulmasından sonraki 24 saat içinde kullanılabilir.
delete DELETE /v1/jobs/{jobId}
Bir raporlama işini siler.
get GET /v1/jobs/{jobId}
Bir kanal veya içerik sahibi için planlanmış belirli bir raporlama işiyle ilgili bilgileri alır.
list GET /v1/jobs
Bir kanal veya içerik sahibi için planlanmış raporlama işlerini listeler. Yanıtın her kaynağında, YouTube'un işi benzersiz şekilde tanımlamak için kullandığı kimliği belirten bir id özelliği bulunur. İş için oluşturulan raporların listesini almak veya işi silmek için bu kimliğe ihtiyacınız vardır.

jobs.reports

Yöntemler
get GET /v1/jobs/{jobId}/reports/{reportId}
Belirli bir raporun meta verilerini alır.
list GET /v1/jobs/{jobId}/reports
Belirtilen raporlama işi için oluşturulan raporları listeler.

reportTypes

Yöntemler
list GET /v1/reportTypes
Kanalın veya içerik sahibinin alabileceği rapor türlerinin listesini döndürür.