ทรัพยากร 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 เจ้าของเนื้อหาจะแก้ไขหรือลบงานที่สร้างรายงานเหล่านั้นไม่ได้ |