Jobs

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.