我們正在更新 YouTube Analytics API 和 Reporting API,以便配合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
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 內容的 YouTube 數據分析報表。這個範圍可讓您存取使用者活動指標,例如觀看次數和評分次數。 |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly |
查看您 YouTube 內容的 YouTube 數據分析金額報表。這個範圍可讓您存取使用者活動指標,以及預估收益和廣告成效指標。 |
參數
路徑參數
參數 |
jobId |
string
YouTube 會使用這個 ID 來識別與所擷取報表相關聯的工作。 |
reportId |
string
YouTube 會使用這個 ID 來識別正在擷取的報表。 |
查詢參數
參數 |
onBehalfOfContentOwner |
string
發出 API 要求的內容擁有者 ID。如果要求並未指定此參數的值,API 伺服器會假設該要求是針對其使用者的管道發出。 |
回應
如果成功,回應主體會包含 Report 資源。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2023-02-22 (世界標準時間)。
[[["容易理解","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 (世界標準時間)。"],[[["This endpoint retrieves metadata for a specific report using its `jobId` and `reportId`."],["Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`."],["Path parameters `jobId` and `reportId` are required to identify the job and the report being retrieved."],["The `onBehalfOfContentOwner` query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel."],["A successful response returns a `Report` resource containing the report's metadata."]]],["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"]]