Reports

report kaynağı, raporun belirli bir örneğini tanımlar. Kaynak, raporun indirilebileceği zamanın yanı sıra raporun indirilebileceği URL'yi tanımlar.

Yöntemler

Aşağıdaki tabloda API'nin report kaynakları için desteklediği yöntemler gösterilmektedir.

Yöntemler
get	Belirli bir raporun meta verilerini alır.
list	Belirtilen raporlama işi için oluşturulmuş raporları listeler.

JSON kaynak gösterimi

Aşağıdaki JSON yapısı, bir report kaynağının biçimini gösterir:

{
  "id": string,
  "jobId": string,
  "startTime": timestamp,
  "endTime": timestamp,
  "createTime": timestamp,
  "jobExpireTime": timestamp,
  "downloadUrl": string
}

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
id	string YouTube'un raporu benzersiz şekilde tanımlamak için atadığı kimlik. Her rapor tek bir işle ilişkilendirilir, ancak bir iş birçok rapor kimliğiyle ilişkilendirilebilir.
jobId	string Bu raporu oluşturan işin kimliği.
startTime	timestamp Rapor örneğinin kapsadığı dönemin başlangıcı. Kapsayıcı değer, RFC3339 UTC "Zulu" biçiminde bir zaman damgasıdır ve mikrosaniye cinsinden doğrudur. Örnek: "2015-10-02T15:01:23.045678Z".
endTime	timestamp Rapor örneğinin kapsadığı dönem. Özel değer, RFC3339 UTC "Zulu" biçiminde bir zaman damgasıdır ve mikrosaniye cinsinden doğrudur. Örnek: "2015-10-02T15:01:23.045678Z".
createTime	timestamp İşin oluşturulduğu tarih ve saat. Özellik değeri, RFC3339 UTC "Zulu" biçiminde bir zaman damgasıdır ve mikrosaniye cinsinden doğrudur. Örnek: "2015-10-02T15:01:23.045678Z".
jobExpireTime	timestamp Raporla ilişkilendirilmiş işin süresinin dolacağı veya süresinin dolacağı saat. Özellik değeri, RFC3339 UTC "Zulu" biçiminde bir zaman damgasıdır ve mikrosaniye cinsinden doğrudur. Örnek: "2015-10-02T15:01:23.045678Z". Bu mülkün değeri, raporun işi ile ilişkili rapor türü kullanımdan kaldırıldıysa veya söz konusu iş için oluşturulan raporlar uzun bir süre boyunca indirilmezse değer taşır. Değer, YouTube'un artık söz konusu iş için yeni rapor oluşturamayacağı tarihi belirtir. Son kullanma tarihini tanımlayan bir işiniz varsa sisteminizi bu tarihe kadar rapor almayı durduracak şekilde güncellemeniz gerekir. Bazı durumlarda yenisi kullanılabilir bir rapor olabilir.
downloadUrl	string Raporun indirilebileceği URL. Özellik değerinin maksimum uzunluğu 1.000 karakterdir. Raporu almak için bu URL'ye bir HTTP GET isteği gönderin. İstekte, başlık değeri olarak yetkilendirme jetonunuzu kullanarak Authorization HTTP İsteği başlığını ayarlayın. gzip'i kullanma Raporları indirmek için gereken bant genişliğini, indirme isteklerinde gzip sıkıştırmayı etkinleştirerek azaltabilirsiniz. Uygulamanız, API yanıtlarını açmak için ek CPU süresine ihtiyaç duyacak olsa da daha az ağ kaynağı kullanma avantajı, genellikle bu maliyetten daha değerlidir. gzip kodlu 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