Method jobs.get
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מאחזר מידע על משימת דיווח ספציפית שתוזמנה לערוץ או לבעלי תוכן.
שליחת בקשה
בקשת HTTP
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
הרשאה
כל הבקשות של YouTube Reporting API חייבות להיות מאושרות. במדריך ההרשאות מוסבר איך להשתמש בפרוטוקול OAuth 2.0 כדי לאחזר אסימוני הרשאה.
בקשות ל-API של דיווח ב-YouTube כוללות את היקפי ההרשאות הבאים:
| טווחים |
| 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.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-02-22 (שעון 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"]],["עדכון אחרון: 2023-02-22 (שעון UTC)."],[[["This endpoint retrieves details about a specific reporting job identified by its `jobId`."],["Authorization is required for all requests, using either `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scopes."],["The `jobId` is a required path parameter, identifying the specific job to retrieve."],["The optional `onBehalfOfContentOwner` query parameter specifies the content owner for the request, otherwise defaults to the user's channel."],["A successful request returns a `Job` resource in the response body, and the request body itself must be empty."]]],["The content details retrieving a scheduled reporting job's information via the YouTube Reporting API. A `GET` request is made to `https://youtubereporting.googleapis.com/v1/jobs/{jobId}` using OAuth 2.0 authorization. The request requires a `jobId` path parameter and can include an optional `onBehalfOfContentOwner` query parameter. Authorization requires specific scopes like `yt-analytics.readonly` or `yt-analytics-monetary.readonly`. A successful request returns a `Job` resource, and the request body must remain empty.\n"]]
