Reports API를 사용하여 YouTube 제휴 프로그램 에 참여하는 제품의 주요 실적 측정항목을 가져올 수 있습니다. 이 가이드에서는 다양한 크리에이터, 동영상 콘텐츠, 개별 제품에 기여한 판매, 수수료, 주문, 조회수, 클릭수와 같은 YouTube 전용 제휴사 데이터 를 쿼리하는 방법을 설명합니다.
MCQL을 사용하여 쿼리의 테이블과 같이 작동하는 전용 YouTube 제휴사 '뷰'에서 측정항목과 측정기준을 선택할 수 있습니다.
기본 요건
이 가이드를 사용하기 전에 다음을 확인하세요.
- API 호출을 인증하는 데 사용되는 계정에 실적 및 통계 실적 측정항목에 대한 액세스 권한을 부여하는 역할이 있습니다.
- Google 판매자 센터 계정이 YouTube 제휴 프로그램에 참여합니다.
알파 엔드포인트 쿼리
공개 알파 버전이므로 엔드포인트가 다릅니다. 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를 포함합니다.
다음은 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개 동영상을 가져오려면,
다음 판매자 센터 쿼리 언어
문을 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형식입니다. - 지연 시간: 쿼리의 지연 시간은 요청된 데이터 양에 따라 다릅니다. 쿼리가 크면 시간이 오래 걸리고 시간 초과가 발생할 수 있습니다.