Reporting サブ API を使用すると、YouTube アフィリエイト プログラムに参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品に帰属する、販売、コミッション、注文、視聴回数、クリック数などの YouTube 固有のアフィリエイト データをクエリする方法について説明します。
Merchant Center クエリ言語（MCQL）を使用すると、専用の YouTube アフィリエイト ビューから指標とディメンションを選択できます。これは、クエリ内のテーブルのように機能します。
前提条件
このガイドを使用する前に、次のことを確認してください。
- API 呼び出しの認証に使用されるアカウントには、パフォーマンス指標へのアクセス権を付与するパフォーマンスと分析情報ロールがあります。
- Google Merchant Center アカウントが YouTube アフィリエイト プログラムに参加している。
アルファ版のエンドポイントをクエリする
これは公開アルファ版であるため、エンドポイントが異なります。YouTube アフィリエイトのパフォーマンス データを取得するには、v1alpha エンドポイントに POST リクエストを送信する必要があります。リクエストの例を次に示します。
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 が含まれます。
2025 年 5 月 1 日から 5 月 2 日までの期間の販売額上位 3 人のクリエイターを取得するために使用できる MCQL SELECT ステートメントの例を次に示します。
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 など）ごとに指標が集計されます。
以下は、2026 年 1 月 20 日から 21 日までの間にビュー数の多い上位 10 個の商品を取得するために使用できる MCQL SELECT ステートメントの例です。
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 をクエリします。
2026 年 1 月 20 日から 21 日までの総売上高で上位 10 個の商品を取得するために使用できる MCQL SELECT ステートメントの例を次に示します。
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 個の商品について、売上データ、コミッション、主要な指標を取得します。
重要な考慮事項
- 日付: 常に
WHERE句を使用してdateでクエリをフィルタし、レポート期間を指定します。日付はYYYY-MM-DD形式です。 - レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。大規模なデータセットを対象とするクエリは時間がかかり、タイムアウトが発生する可能性があります。