job
kaynağı, planlanmış bir raporlama işini temsil eder. Raporlama işi, YouTube'un belirli bir kanal veya içerik sahibi için her gün oluşturduğu belirli bir raporu tanımlar.
Yöntemler
Aşağıdaki tabloda, API'nin job
kaynakları için desteklediği yöntemler gösterilmektedir.
Yöntemler | |
---|---|
create |
Raporlama işi oluşturur. Bir raporlama işi oluşturarak YouTube'dan bu raporu günlük olarak oluşturmasını istemiş olursunuz. Rapor, iş oluşturulduktan sonraki 24 saat içinde kullanılabilir hale gelir. |
delete |
Raporlama işini siler. |
get |
Bir kanal veya içerik sahibi için planlanmış belirli bir raporlama işi hakkındaki bilgileri getirir. |
list |
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şturulmuş raporların listesini almak veya işi silmek için bu kimliğe ihtiyacınız vardır. |
JSON kaynak gösterimi
Aşağıdaki JSON yapısı, bir job
kaynağının biçimini gösterir:
{ "id": string, "reportTypeId": string, "name": string, "createTime": timestamp, "expireTime": timestamp, "systemManaged": boolean }
Özellikler
Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:
Özellikler | |
---|---|
id |
string
YouTube'un raporlama işini benzersiz şekilde tanımlamak için kullandığı kimlik. Değerin maksimum uzunluğu 40 karakterdir. |
reportTypeId |
string
İşin oluşturduğu rapor türü. Özellik değeri, reportTypes.list yönteminden alınan reportType öğesi id öğesinin id değerine karşılık gelir. |
name |
string
YouTube'un işi tanımlamak için oluşturduğu bir ad. Değerin maksimum uzunluğu 100 karakterdir. |
createTime |
timestamp
İşin oluşturulduğu tarih ve saat. Özellik değeri, RFC3339 UTC "Zulu" zaman damgasıdır biçiminde, mikrosaniyelere kadar doğrulukta. Örnek: "2015-10-02T15:01:23.045678Z" . |
expireTime |
timestamp
İşin süresinin dolduğu veya sona ereceği tarih ve saat. Özellik değeri, RFC3339 UTC "Zulu" zaman damgasıdır biçiminde, mikrosaniyelere kadar doğrulukta. Örnek: "2015-10-02T15:01:23.045678Z" .İşle ilişkili rapor türü kullanımdan kaldırıldıysa veya iş için oluşturulan raporlar uzun bir süredir indirilmemişse bu mülkte bir değer bulunur. Bu değer, YouTube'un artık iş için yeni rapor oluşturmayacağı tarihi gösterir. Sona erme tarihinin belirtildiği bir işiniz varsa sistemlerinizi bu tarihe kadar rapor isteğinde bulunmayacak şekilde güncellemeniz gerekir. Bazı durumlarda değişim raporu sunulabilir. |
systemManaged |
boolean
İş, sistem tarafından yönetilen raporlar oluşturuyorsa bu değer true 'dir. YouTube, YouTube İçerik Stüdyosu'nda aynı raporlara erişimi olan YouTube içerik sahipleri için otomatik olarak sistem tarafından yönetilen raporlar oluşturur. İçerik sahipleri, bu raporları oluşturan işleri değiştiremez veya silemez. |