ทรัพยากร job แสดงถึงงานการรายงานที่กำหนดเวลาไว้ งานการรายงานจะระบุรายงานเฉพาะที่ YouTube สร้างขึ้นในแต่ละวันสำหรับช่องหรือเจ้าของเนื้อหาที่เจาะจง
เมธอด
ตารางต่อไปนี้แสดงวิธีการที่ API รองรับสำหรับทรัพยากร job
| เมธอด | |
|---|---|
create |
สร้างงานการรายงาน การสร้างงานการรายงานเป็นการสั่งให้ YouTube สร้างรายงานดังกล่าวทุกวัน รายงานจะพร้อมใช้งานภายใน 24 ชั่วโมงหลังจากเวลาที่สร้างงาน |
delete |
ลบงานการรายงาน |
get |
เรียกดูข้อมูลเกี่ยวกับงานการรายงานที่กำหนดเวลาไว้สำหรับช่องหรือเจ้าของเนื้อหา |
list |
แสดงรายการงานการรายงานที่กำหนดเวลาสำหรับช่องหรือเจ้าของเนื้อหา ทรัพยากรแต่ละรายการในการตอบกลับมีพร็อพเพอร์ตี้ id ซึ่งระบุรหัสที่ YouTube ใช้ในการระบุงานแบบไม่ซ้ำ คุณต้องใช้รหัสนั้นเพื่อเรียกข้อมูลรายการของรายงานที่สร้างขึ้นสำหรับงานหรือลบงานออก |
การแสดงทรัพยากร JSON
โครงสร้าง JSON ด้านล่างแสดงรูปแบบของทรัพยากร job
{
"id": string,
"reportTypeId": string,
"name": string,
"createTime": timestamp,
"expireTime": timestamp,
"systemManaged": boolean
}พร็อพเพอร์ตี้
ตารางต่อไปนี้จะระบุพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
| พร็อพเพอร์ตี้ | |
|---|---|
id |
stringรหัสที่ YouTube ใช้เพื่อระบุงานการรายงานโดยไม่ซ้ำกัน ค่ามีความยาวได้สูงสุด 40 อักขระ |
reportTypeId |
stringประเภทของรายงานที่งานสร้างขึ้น ค่าพร็อพเพอร์ตี้สอดคล้องกับ id ของ id ของ reportType ตามที่ดึงมาจากเมธอด reportTypes.list |
name |
stringชื่อที่ YouTube สร้างขึ้นเพื่ออธิบายงาน ค่ามีความยาวได้สูงสุด 100 อักขระ |
createTime |
timestampวันที่และเวลาที่สร้างงาน ค่าพร็อพเพอร์ตี้คือการประทับเวลาใน RFC3339 UTC "Zulu" แม่นยำในระดับไมโครวินาที ตัวอย่างเช่น "2015-10-02T15:01:23.045678Z" |
expireTime |
timestampวันที่และเวลาที่งานหมดอายุหรือจะหมดอายุ ค่าพร็อพเพอร์ตี้คือการประทับเวลาใน RFC3339 UTC "Zulu" แม่นยำในระดับไมโครวินาที ตัวอย่าง: "2015-10-02T15:01:23.045678Z"พร็อพเพอร์ตี้นี้มีค่าหากประเภทรายงานที่เชื่อมโยงกับงานเลิกใช้งานแล้ว หรือหากรายงานที่สร้างขึ้นสำหรับงานไม่มีการดาวน์โหลดรายงานเป็นระยะเวลานาน โดยค่านี้จะทำเครื่องหมายวันที่ที่ YouTube ไม่สร้างรายงานใหม่สำหรับงานนี้อีกต่อไป หากมีงานที่ระบุวันที่หมดอายุ คุณควรอัปเดตระบบเพื่อหยุดขอรายงานภายในวันที่ดังกล่าว ในบางกรณีอาจมีรายงานการแทนที่ |
systemManaged |
booleanค่านี้จะเป็น true หากงานสร้างรายงานที่จัดการโดยระบบ YouTube จะสร้างรายงานที่จัดการโดยระบบโดยอัตโนมัติสำหรับเจ้าของเนื้อหา YouTube ที่มีสิทธิ์เข้าถึงรายงานเดียวกันใน YouTube Creator Studio เจ้าของเนื้อหาจะแก้ไขหรือลบงานที่สร้างรายงานเหล่านั้นไม่ได้ |