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: gzip |