Reporting サブ API を使用すると、 YouTube アフィリエイト プログラム に参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品に起因する、販売、コミッション、注文、視聴回数、 クリック数など、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 が含まれます。
視聴回数で上位 3 件の動画を取得するには、2025 年 5 月 1 日から 5 月 2 日まで、
次の 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 が含まれます。
視聴回数で上位 10 件の商品を取得するために使用できる MCQL SELECT ステートメントの例を次に示します。2026 年 1 月 20 日から 21 日まで
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 をクエリします。
総売上高で上位 10
件の商品を取得するために使用できる MCQL SELECT ステートメントの例を次に示します。2026 年 1 月 20 日から 21 日まで
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です。 - レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。 大規模なデータセットを対象とするクエリは時間がかかり、タイムアウトが発生する可能性があります。