Jobs

Tài nguyên job thể hiện một công việc báo cáo theo lịch. Tác vụ báo cáo xác định một báo cáo cụ thể mà YouTube tạo ra 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 trình bày 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á công việc báo cáo.
get	Truy xuất thông tin về một công việc báo cáo cụ thể đã được lên lịch cho kênh hoặc chủ sở hữu nội dung.
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 mà YouTube dùng để xác định duy nhất tác vụ đó. Bạn cần có mã nhận dạng đó để 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 dùng để xác định riêng 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 mà YouTube tạo ra để mô tả việc làm đó. Giá trị này có độ dài tối đa là 100 ký tự.
createTime	timestamp Ngày và giờ tạo việc làm. Giá trị thuộc tính là dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến micrô giây. Ví dụ: "2015-10-02T15:01:23.045678Z".
expireTime	timestamp Ngày và giờ mà việc làm đó hết hạn hoặc sẽ hết hạn. Giá trị thuộc tính là dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến 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 kết với công việc không còn được dùng nữa hoặc nếu 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 YouTube không còn tạo báo cáo mới về công việc đó nữa. Nếu công việc của bạn có 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 trước 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 sẽ 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 báo cáo do hệ thống quản lý cho những chủ sở hữu nội dung trên YouTube có quyền truy cập vào các báo cáo tương tự trong YouTube Studio. Chủ sở hữu nội dung không thể sửa đổi hoặc xoá các công việc tạo ra các báo cáo đó.