Method jobs.get

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

בקשה

בקשת HTTP

GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}

אישור

כל הבקשות ל-YouTube Reporting API חייבות להיות מאושרות. במדריך ההרשאות מוסבר איך להשתמש בפרוטוקול OAuth 2.0 כדי לאחזר אסימוני הרשאה.

בקשות ל-YouTube Reporting API משתמשות בהיקפי ההרשאות הבאים:

היקף תיאור
https://www.googleapis.com/auth/yt-analytics.readonly עיון בדוחות YouTube Analytics עבור התוכן שלך ב-YouTube. ההיקף הזה מספק גישה למדדים של פעילות המשתמשים, כמו מספר הצפיות ומספר הדירוגים.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly עיון בדוחות כספיים של YouTube Analytics לגבי התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדי פעילות המשתמשים ולמדדי ביצועי המודעות וההכנסות המשוערות.

פרמטרים

פרמטרים של נתיב

פרמטרים
jobId string
המזהה שמשמש את YouTube לזיהוי ייחודי של העבודה שאותה מאחזרים.

פרמטרים של שאילתה

פרמטרים
onBehalfOfContentOwner string
המזהה של בעל התוכן שבשמו מוגשת בקשת ה-API. אם בבקשה לא מצוין ערך לפרמטר הזה, שרת ה-API מניח שהבקשה נשלחת עבור הערוץ של המשתמש.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

תשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל משאב Job.

רוצה לנסות?