Jobs

ทรัพยากร 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 "ซูลู" ซึ่งมีความแม่นยำเป็นไมโครวินาที ตัวอย่าง: "2015-10-02T15:01:23.045678Z"
expireTime timestamp
วันที่และเวลาที่งานหมดอายุหรือจะหมดอายุ ค่าพร็อพเพอร์ตี้คือการประทับเวลาในรูปแบบ RFC3339 UTC "ซูลู" ซึ่งมีความแม่นยำเป็นไมโครวินาที ตัวอย่าง: "2015-10-02T15:01:23.045678Z"

พร็อพเพอร์ตี้นี้จะมีค่าหากประเภทรายงานที่เชื่อมโยงกับงานถูกเลิกใช้งาน หรือไม่มีการดาวน์โหลดรายงานที่สร้างขึ้นสำหรับงานมาเป็นเวลานาน ค่านี้จะระบุวันที่ที่ YouTube จะไม่สร้างรายงานใหม่สำหรับงานดังกล่าวอีกต่อไป

หากมีงานที่ระบุวันที่หมดอายุ คุณควรอัปเดตระบบให้หยุดขอรายงานภายในวันที่ดังกล่าว ในบางกรณีอาจมีรายงานทดแทนให้ใช้งาน
systemManaged boolean
ค่านี้จะเป็น true หากงานสร้างรายงานที่จัดการโดยระบบ YouTube จะสร้างรายงานที่จัดการโดยระบบโดยอัตโนมัติสำหรับเจ้าของเนื้อหา YouTube ที่มีสิทธิ์เข้าถึงรายงานเดียวกันใน YouTube Creator Studio เจ้าของเนื้อหาจะแก้ไขหรือลบงานที่สร้างรายงานเหล่านั้นไม่ได้