Jobs

Tài nguyên job đại diện cho một công việc báo cáo định kỳ. Công việc báo cáo xác định một báo cáo cụ thể mà YouTube tạo mỗi ngày cho một kênh hoặc chủ sở hữu nội dung cụ thể.

Phương thức

Bảng sau đây cho biết các phương thức mà API hỗ trợ cho các tài nguyên job.

Phương thức
create	Tạo công việc báo cáo. Bằng việc tạo công việc báo cáo, bạn hướng dẫn YouTube tạo báo cáo đó hằng ngày. Báo cáo sẽ có trong vòng 24 giờ kể từ khi tạo công việc.
delete	Xoá một công việc báo cáo.
get	Truy xuất thông tin về công việc báo cáo cụ thể đã được lên lịch cho chủ sở hữu nội dung hoặc kênh.
list	Liệt kê các công việc báo cáo đã được lên lịch cho một kênh hoặc chủ sở hữu nội dung. Mỗi tài nguyên trong phản hồi chứa một thuộc tính id. Thuộc tính này chỉ định mã nhận dạng duy nhất mà YouTube sử dụng để xác định công việc đó. Bạn cần mã đó để truy xuất danh sách báo cáo đã được tạo cho công việc đó hoặc để xoá công việc.

Biểu diễn tài nguyên JSON

Cấu trúc JSON dưới đây cho thấy định dạng của tài nguyên job:

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

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:

Thuộc tính
id	string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt công việc báo cáo. Giá trị này có độ dài tối đa là 40 ký tự.
reportTypeId	string Loại báo cáo mà công việc tạo ra. Giá trị thuộc tính tương ứng với id của id của reportType được truy xuất từ phương thức reportTypes.list.
name	string Tên do YouTube tạo ra để mô tả công việc này. Giá trị này có độ dài tối đa là 100 ký tự.
createTime	timestamp Ngày và giờ tạo công việc. Giá trị thuộc tính là một dấu thời gian trong RFC3339 giờ UTC "Zulu" , chính xác đến từng micrô giây. Ví dụ: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp Ngày và giờ công việc đã hết hạn hoặc sẽ hết hạn. Giá trị thuộc tính là một dấu thời gian trong RFC3339 giờ UTC "Zulu" , chính xác đến từng micrô giây. Ví dụ: "2015-10-02T15:01:23.045678Z". Thuộc tính này có giá trị nếu loại báo cáo liên quan đến công việc không còn được dùng nữa hoặc nếu các báo cáo được tạo cho công việc không được tải xuống trong một khoảng thời gian dài. Giá trị này đánh dấu ngày mà sau đó YouTube không còn tạo báo cáo mới cho công việc đó nữa. Nếu có công việc xác định ngày hết hạn, bạn nên cập nhật hệ thống để ngừng yêu cầu báo cáo chậm nhất vào ngày đó. Trong một số trường hợp, có thể có báo cáo thay thế.
systemManaged	boolean Giá trị này là true nếu công việc đó tạo báo cáo do hệ thống quản lý. YouTube tự động tạo các báo cáo do hệ thống quản lý cho những chủ sở hữu nội dung YouTube có quyền truy cập vào cùng các báo cáo đó trong YouTube Creator Studio. Chủ sở hữu nội dung không thể sửa đổi hoặc xóa các công việc tạo ra những báo cáo đó.