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