Jobs

Resource job mewakili tugas pelaporan terjadwal. Tugas pelaporan mengidentifikasi laporan tertentu yang dibuat YouTube setiap harinya untuk pemilik konten atau channel tertentu.

Metode

Tabel berikut menunjukkan metode yang didukung API untuk resource job.

Metode
create	Membuat tugas pelaporan. Dengan membuat tugas pelaporan, Anda meminta YouTube untuk membuat laporan tersebut setiap hari. Laporan tersedia dalam waktu 24 jam sejak tugas dibuat.
delete	Menghapus tugas pelaporan.
get	Mengambil informasi tentang tugas pelaporan tertentu yang telah dijadwalkan untuk pemilik channel atau konten.
list	Mencantumkan tugas pelaporan yang telah dijadwalkan untuk suatu channel atau pemilik konten. Setiap resource dalam respons berisi properti id, yang menentukan ID yang digunakan YouTube untuk mengidentifikasi pekerjaan secara unik. Anda memerlukan ID tersebut untuk mengambil daftar laporan yang telah dibuat untuk tugas atau untuk menghapus tugas.

Representasi resource JSON

Struktur JSON di bawah menunjukkan format resource job:

{
  "id": string,
  "reportTypeId": string,
  "name": string,
  "createTime": timestamp,
  "expireTime": timestamp,
  "systemManaged": boolean
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
id	string ID yang digunakan YouTube untuk mengidentifikasi tugas pelaporan secara unik. Nilai memiliki panjang maksimum 40 karakter.
reportTypeId	string Jenis laporan yang dibuat oleh tugas. Nilai properti sesuai dengan id dari id dari reportType seperti yang diambil dari metode reportTypes.list.
name	string Nama yang dibuat YouTube untuk mendeskripsikan pekerjaan. Nilai memiliki panjang maksimum 100 karakter.
createTime	timestamp Tanggal dan waktu tugas dibuat. Nilai properti adalah stempel waktu dalam RFC3339 UTC "Zulu" format yang akurat, akurat hingga mikrodetik. Contoh: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp Tanggal dan waktu tugas berakhir atau habis masa berlakunya. Nilai properti adalah stempel waktu dalam RFC3339 UTC "Zulu" format yang akurat, akurat hingga mikrodetik. Contoh: "2015-10-02T15:01:23.045678Z". Properti ini memiliki nilai jika jenis laporan yang terkait dengan tugas tidak digunakan lagi atau jika laporan yang dibuat untuk tugas belum didownload dalam jangka waktu yang lama. Nilai ini menandai tanggal ketika YouTube tidak lagi membuat laporan baru untuk tugas tersebut. Jika Anda memiliki tugas yang mengidentifikasi tanggal habis masa berlaku, sebaiknya update sistem agar berhenti meminta laporan sebelum tanggal tersebut. Dalam kasus tertentu, laporan penggantian mungkin tersedia.
systemManaged	boolean Nilai ini adalah true jika tugas menghasilkan laporan yang dikelola sistem. YouTube secara otomatis membuat laporan yang dikelola sistem untuk pemilik konten YouTube yang memiliki akses ke laporan yang sama di YouTube Creator Studio. Pemilik konten tidak dapat mengubah atau menghapus tugas yang membuat laporan tersebut.