你可以使用 Reporting 子 API，擷取參與 YouTube 聯盟計畫的產品主要成效指標。本指南說明如何查詢 YouTube 專屬聯盟資料，例如歸因於不同創作者、影片內容和個別產品的銷售額、佣金、訂單、觀看次數和點擊次數。
你可以使用 Merchant Center 查詢語言 (MCQL)，從專屬的 YouTube 聯盟檢視畫面選取指標和維度，這些檢視畫面在查詢中就像表格一樣。
必要條件
使用本指南前，請確認下列事項：
- 用於驗證 API 呼叫的帳戶具有「成效與洞察」角色，可存取成效指標。
- 你的 Google Merchant Center 帳戶已加入 YouTube 聯盟計畫。
查詢 Alpha 端點
請注意，由於這是公開 Alpha 版，端點有所不同。如要擷取 YouTube 聯盟計畫成效資料，請將 POST 要求傳送至 v1alpha 端點。以下是範例要求：
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--compressed
依創作者查看成效
如要瞭解哪些 YouTube 創作者帶來的參與度和銷售量最高，
可以查詢 youtube_creator_performance_view。
這個檢視畫面會依個別 YouTube 創作者匯總指標，並包含創作者標題和頻道 ID。
以下是 MCQL SELECT 陳述式範例，可用於取得 2025 年 5 月 1 日至 5 月 2 日銷售額前 3 名的創作者：
SELECT
title,
channel_id,
gross_sales,
net_sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY gross_sales DESC LIMIT 3
這項查詢會擷取指定日期範圍內，依總銷售額指標排名前 3 名的創作者名稱、頻道 ID 和主要成效指標。
依內容查看成效
如要查看成效最佳的特定 YouTube 影片，可以查詢 youtube_content_performance_view。這個檢視畫面會依個別 YouTube 影片匯總指標，並包含影片標題和 ID。
如要擷取 2025 年 5 月 1 日至 5 月 2 日觀看次數前 3 名的影片，請將下列 MCQL 陳述式傳遞至 accounts.reports.search 方法：
SELECT
title,
video_id,
gross_sales,
net_sales,
commissions,
orders,
clicks,
views
FROM youtube_content_performance_view
WHERE date >= '2025-05-01' AND date < '2025-05-02'
ORDER BY views DESC LIMIT 3
這項查詢會擷取指定日期範圍內，views總數排名前 3 的影片的影片標題、影片 ID 和重要指標。
查看參與度最高的標記產品
如要瞭解哪些標記產品的參與度和銷售量最高，可以查詢 youtube_product_tagged_stats_view。這個檢視畫面會彙整個別標記產品的指標，包括產品標題和方案 ID。
以下是 MCQL SELECT 陳述式範例，可用於取得 2026 年 1 月 20 日至 21 日瀏覽次數前 10 名的產品：
SELECT
title,
offer_id,
tagged_creator_count,
tagged_video_count,
gross_sales,
net_sales,
commissions,
views,
clicks,
impressions,
orders,
conversion_rate
FROM youtube_product_tagged_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY views DESC LIMIT 10
這項查詢會擷取指定日期範圍內，依views總數排名前 10 的產品，並傳回這些產品的名稱、標記影片數量和重要指標。
查看最暢銷的產品
如要瞭解哪些產品最暢銷，可以查詢 youtube_product_sold_stats_view。
以下是 MCQL SELECT 陳述式範例，可用於取得2026 年 1 月 20 日至 21 日總銷售額排名前 10 的產品：
SELECT
title,
offer_id,
gross_sales,
net_sales,
commissions,
orders
FROM youtube_product_sold_stats_view
WHERE date >= '2026-01-20' AND date < '2026-01-21'
ORDER BY gross_sales DESC LIMIT 10
這項查詢會擷取指定日期範圍內，依總銷售額排序的前 10 項產品的銷售資料、佣金和主要指標。
重要注意事項
- 日期：請務必使用
date透過WHERE子句篩選查詢，指定報表統計期。日期格式為YYYY-MM-DD。 - 延遲：查詢的延遲時間取決於要求的資料量。涵蓋大型資料集的查詢需要較長時間，且可能會導致逾時。