Method jobs.reports.get
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אחזור המטא-נתונים של דוח ספציפי.
בקשה
בקשת HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}
אישור
כל הבקשות ל-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 לזיהוי ייחודי של המשימה שמשויכת לדוח שאוחזר. |
reportId |
string
המזהה שמשמש את YouTube לזיהוי ייחודי של הדוח שאוחזר. |
פרמטרים של שאילתה
| פרמטרים |
onBehalfOfContentOwner |
string
המזהה של בעלי התוכן שעבורו נשלחת בקשת ה-API. אם לא צוין ערך לפרמטר הזה בבקשה, שרת ה-API מניח שהבקשה נשלחת עבור הערוץ של המשתמש. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
תשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל משאב Report.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-18 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-18 (שעון UTC)."],[],["This describes how to retrieve metadata for a specific YouTube report using the Reporting API. A `GET` request is sent to a URL containing the `jobId` and `reportId`. Authorization is required using OAuth 2.0, with scopes for viewing analytics and/or monetary reports. The request can also specify a `content owner` using `onBehalfOfContentOwner`. The request body is empty. A successful response returns a `Report` resource.\n"]]