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. |