Jobs

Resource job mewakili tugas pelaporan terjadwal. Tugas pelaporan mengidentifikasi laporan spesifik yang dibuat YouTube setiap hari untuk pemilik channel atau konten 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 ini 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 pemilik saluran atau konten. Setiap resource dalam respons berisi properti id, yang menentukan ID yang digunakan YouTube untuk mengidentifikasi tugas secara unik. Anda memerlukan ID tersebut untuk mengambil daftar laporan yang telah dibuat untuk tugas tersebut atau untuk menghapus tugas.

Representasi resource JSON

Struktur JSON di bawah ini 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 pekerjaan tersebut. Nilai properti sesuai dengan id dari id reportType 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 pekerjaan dibuat. Nilai properti adalah stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga mikrodetik. Contoh: "2015-10-02T15:01:23.045678Z".
expireTime timestamp
Tanggal dan waktu lowongan berakhir atau akan berakhir. Nilai properti adalah stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga mikrodetik. Contoh: "2015-10-02T15:01:23.045678Z".

Properti ini memiliki nilai jika jenis laporan yang terkait dengan pekerjaan sudah tidak digunakan lagi atau jika laporan yang dihasilkan untuk lowongan tersebut belum didownload dalam waktu yang lama. Nilai ini menandai tanggal saat YouTube tidak lagi membuat laporan baru untuk lowongan tersebut.

Jika Anda memiliki tugas yang mengidentifikasi tanggal habis masa berlaku, Anda harus mengupdate sistem agar berhenti meminta laporan sebelum tanggal tersebut. Dalam beberapa kasus, laporan pengganti mungkin tersedia.
systemManaged boolean
Nilai ini adalah true jika tugas menghasilkan laporan yang dikelola sistem. YouTube akan 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 pekerjaan yang membuat laporan tersebut.