Jobs

משאב job מייצג משימת דיווח מתוזמנת. משימת דיווח מזהה דוח ספציפי שמערכת YouTube יוצרת מדי יום עבור ערוץ או בעלי תוכן מסוימים.

שיטות

בטבלה הבאה מוצגות ה-methods שבהן ה-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 כפי שאוחזר מה-method 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 Studio. בעלי תוכן לא יכולים לשנות או למחוק משימות שיוצרות את הדוחות האלה.