YouTube Reporting API

YouTube Reporting API, geliştiricilerin raporlama işleri planlamasına ve ardından oluşturulan toplu raporları indirmesine olanak tanır. API, her biri bir kanal veya içerik sahibi için kapsamlı bir YouTube Analytics veri kümesi içeren önceden tanımlanmış bir dizi raporu 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 raporu belirlemek ü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() özelliklerini kullanabilirsiniz.
  3. Belirli bir iş için oluşturulan raporların listesini almak için jobs.reports.list() yöntemini çağırın. Yanıttaki her kaynak, raporun indirilebileceği URL'yi belirten bir downloadUrl özelliği içerir.
  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 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.

Kaynak türleri

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

işler

Yöntemler
create POST /v1/jobs
Bir raporlama işi oluşturur. Bir raporlama işi oluşturarak YouTube'a bu raporu günlük olarak oluşturmasını söylersiniz. Rapor, iş oluşturulduktan sonraki 24 saat içinde kullanıma sunulur.
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şi hakkında bilgi alır.
list GET /v1/jobs
Bir kanal veya içerik sahibi için planlanmış raporlama işlerini listeler. Yanıttaki her kaynak, YouTube'un işi benzersiz şekilde tanımlamak için kullandığı kimliği belirten bir id özelliği içerir. İş için oluşturulan raporların listesini almak veya işi silmek için bu kimliğe ihtiyacınız vardır.

işler.raporlar

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şturulmuş raporları listeler.

reportTypes

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