Reports API を使用すると、 YouTube アフィリエイト プログラム に参加している商品の主要なパフォーマンス指標を取得できます。このガイドでは、さまざまなクリエイター、動画コンテンツ、個々の商品に起因する、売上、コミッション、注文、視聴回数、クリック数など、YouTube 固有の アフィリエイト データ をクエリする方法について説明します。
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,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
このクエリは、指定した期間内の売上指標で上位 3 位のクリエイターのクリエイター タイトル、チャンネル ID、主要なパフォーマンス指標を取得します。
コンテンツ別のパフォーマンスを確認する
パフォーマンスが最も高い特定の YouTube 動画を確認するには、
youtube_content_performance_view をクエリします。
このビューでは、個々の
YouTube 動画別に指標が集計され、動画のタイトルと ID が含まれます。
2025 年 5 月 1 日から 5 月 2 日までの視聴回数で上位 3 位の動画を取得するには、
次の Merchant Center Query Language
ステートメントを accounts.reports.search
メソッドに渡します。
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
このクエリは、指定した期間内の views の合計数で上位 3 位の動画の動画タイトル、動画 ID、主要な指標を取得します。
重要な考慮事項
- 日付: レポート対象期間を指定するには、
WHERE句を使用して、クエリを常にdateでフィルタします。日付はYYYY-MM-DD形式です。 - レイテンシ: クエリのレイテンシは、リクエストされたデータの量によって異なります。クエリのサイズが大きいと、時間がかかり、タイムアウトが発生する可能性があります。