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'a bu raporu günlük olarak oluşturması için talimat vermiş olursunuz. Rapor, iş oluşturulduktan sonraki 24 saat içinde kullanıma sunulur.
delete	Raporlama işini siler.
get	Bir kanal veya içerik sahibi için planlanmış belirli bir raporlama işi hakkındaki bilgileri alır.
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şturulan 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 getirilen bir reportType id için id değerine karşılık gelir.
name	string YouTube'un işi tanımlamak için oluşturduğu ad. Değer en fazla 100 karakter uzunluğunda olabilir.
createTime	timestamp İşin oluşturulduğu tarih ve saat. Özellik değeri, RFC3339 UTC "Zulu" biçiminde ve mikrosaniyede doğruluğa sahip bir zaman damgasıdır. Ö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" biçiminde ve mikrosaniyede doğruluğa sahip bir zaman damgasıdır. Ö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 süre indirilmediyse bu özellik bir değere sahiptir. Bu değer, YouTube'un iş için artık yeni rapor oluşturmadığı tarihi işaret eder. Geçerlilik bitiş tarihi tanımlayan bir işiniz varsa sistemlerinizi bu tarihe kadar rapor istemeyecek şekilde güncellemeniz gerekir. Bazı durumlarda yedek rapor 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 sistem tarafından yönetilen raporları otomatik olarak oluşturur. İçerik sahipleri, bu raporları oluşturan işleri değiştiremez veya silemez.