我們正在更新 YouTube Analytics API 和 Reporting API,以便配合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
YouTube Reporting API
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
開發人員可透過 YouTube Reporting API 排定報表工作,然後下載產生的大量報表。這項 API 支援一組預先定義的報表,每份報表都包含頻道或內容擁有者的完整 YouTube 數據分析資料。
以下步驟說明如何安排報表工作排程及擷取報表:
- 呼叫
reportTypes.list()
方法,擷取頻道或內容擁有者可擷取的報表清單。 - 呼叫
jobs.create()
方法,找出要為頻道或內容擁有者產生的報表。之後,您可以使用 API 的 jobs.list()
和 jobs.delete()
擷取或變更產生的報表清單。 - 呼叫
jobs.reports.list()
方法,即可擷取為特定工作產生的報表清單。回應中的每個資源都包含 downloadUrl
屬性,用於指定可下載報表的網址。 - 傳送已授權的
GET
要求,從下載網址擷取報表。
授權
所有 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 數據分析金額報表。這個範圍可存取使用者活動指標,以及預估收益和廣告成效指標。 |
資源類型
以下各節將提供 API 資源和方法的一般說明。表格中顯示的所有方法 URI 皆與 https://youtubereporting.googleapis.com
相關。
方法 |
create |
POST /v1/jobs
建立報表工作。建立報表工作後,YouTube 就會每天產生該報表。作業建立後 24 小時內,您就能查看報表。 |
delete |
DELETE /v1/jobs/{jobId}
刪除報表工作。 |
get |
GET /v1/jobs/{jobId}
擷取已排定要為頻道或內容擁有者執行的特定報表工作相關資訊。 |
list |
GET /v1/jobs
列出已為頻道或內容擁有者排定的報表工作。回應中的每個資源都包含 id 屬性,指定 YouTube 用來不重複識別工作的 ID。您需要這個 ID 才能擷取為該工作產生的報表清單,或刪除該工作。 |
方法 |
get |
GET /v1/jobs/{jobId}/reports/{reportId}
擷取特定報表的中繼資料。 |
list |
GET /v1/jobs/{jobId}/reports
列出為指定報表工作產生的報表。 |
方法 |
list |
GET /v1/reportTypes
傳回頻道或內容擁有者可擷取的報表類型清單。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-16 (世界標準時間)。
[[["容易理解","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-07-16 (世界標準時間)。"],[[["The YouTube Reporting API allows developers to schedule and download bulk reports containing comprehensive YouTube Analytics data for channels or content owners."],["Developers can use the API to retrieve a list of available reports, create jobs to generate reports, and manage these jobs through listing and deletion."],["Generated reports can be downloaded via a specified URL obtained from the API's response, after retrieving them by using the `jobs.reports.list()` method."],["The API requires OAuth 2.0 authorization, and provides scopes for viewing user activity metrics (`https://www.googleapis.com/auth/yt-analytics.readonly`) and monetary reports (`https://www.googleapis.com/auth/yt-analytics-monetary.readonly`)."]]],["Developers use the YouTube Reporting API to schedule and download bulk reports containing YouTube Analytics data. Key actions include: listing available report types via `reportTypes.list()`, creating reporting jobs with `jobs.create()`, and managing jobs using `jobs.list()` and `jobs.delete()`. To get data, retrieve generated reports for a specific job with `jobs.reports.list()`, each with a downloadable URL. Finally, you can request the download using the given URL. All actions require authorization via OAuth 2.0.\n"]]