판매자 보고서를 통합하는 방법은 다음과 같습니다. API를 기존의 Content API Shopping 구현).
요청
판매자 보고서 API에는 다음 요청 URL 형식을 사용합니다.
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
다음은 Content API for Shopping과 판매자를 비교한 샘플입니다.
search 요청에 대한 Reports API:
| Content API | 판매자 API | |
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
| 식별자 | {merchantId}
|
{parent}
|
메서드
다음을 호출하여 판매자 보고서 API를 쿼리할 수 있습니다.
ReportService.Search 드림
메서드를 사용하여 축소하도록 요청합니다.
조회수
Merchant API에서 테이블 이름이 CammelCase에서 snake_case로 변경됩니다.
MerchantPerformanceView는 이제 product_performance_view입니다.
다음은 Content API for Shopping의 테이블 이름과 판매자 API:
| Content API | 판매자 API |
MerchantPerformanceView
|
product_performance_view
|
ProductView
|
product_view
|
PriceCompetitivenesProductView
|
price_competitiveness_product_view
|
PriceInsightsProductView
|
price_insights_product_view
|
BestSellersBrandView
|
best_sellers_brand_view
|
BestSellersProductClusterView
|
best_sellers_product_cluster_view
|
CompetitiveVisibilityCompetitorView
|
competitive_visibility_competitor_view
|
CompetitiveVisibilityTopMerchantView
|
competitive_visibility_top_merchant_view
|
CompetitiveVisibilityBenchmarkView
|
competitive_visibility_benchmark_view
|
판매자 API에서 필드 접두사 지정(예: segments.offer_id)
더 이상 필요하지 않습니다. 대신 필드 이름인 offer_id를 사용하세요.
다음은 Content API for Shopping의 쿼리와 판매자 API:
| Content API | 판매자 API |
SELECT
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date DURING LAST_7_DAYS
|
SELECT
offer_id,
clicks
FROM product_performance_view
WHERE date DURING LAST_7_DAYS
|
다음은 샘플 응답입니다.
| Content API | 판매자 API |
{
"segments":{
"offerId":"abc"
},
"metrics":{
"clicks":"123"
}
}
|
{
"productPerformanceView" : {
"offerId": "abc",
"clicks": "123"
}
}
|
테이블 이름을 필드 프리픽스로 사용할 수 있습니다. 예를 들어 offer_id 및
product_performance_view.offer_id는 판매자 API 쿼리에서 허용됩니다.
성능
판매자 보고서 API에서 실적 보기에서 변경된 사항은 다음과 같습니다.
| Content API | 판매자 API | 설명 |
segments.program: 문자열
|
marketing_method: 문자열
|
program 세그먼트가 새로운 marketing_method 필드로 대체됩니다. 자세한 내용은 새 marketing method 값을 참고하세요.
|
metrics.ctr: 실수
|
clickThroughRate: 실수
|
ctr 측정항목의 이름이 clickThroughRate로 변경되었습니다.
|
metrics.conversionValueMicros: 정수
segments.currencyCode: 문자열
|
conversionValue: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
metrics.orders,
|
지원되지 않음 | Buy on Google 측정항목은 판매자 보고서 API에서 지원되지 않습니다. |
새 마케팅 방법 값
segments.program 및 marketing_method 값의 매핑은 다음과 같습니다.
| Content API | 판매자 API |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
지원되지 않음 |
제품
Merchant Reports API에서 제품 보기에 대해 변경된 사항은 다음과 같습니다.
| Content API | 판매자 API | 설명 |
productView.id: 문자열
|
id: 문자열
|
입력란 형식이 channel:language:targetCountry:offerId에서 channel~language~feedLabel~offerId(으)로 변경됩니다.
|
productView.priceMicros: 정수
productView.currencyCode: 문자열
|
price: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
productView.aggregated_destination_status: 문자열
|
aggregated_reporting_context_status: 문자열
|
aggregated_destination_status 필드의 이름이 aggregated_reporting_context_status로 변경되었으며 값은 변경되지 않았습니다.
|
productView.item_issues: [
|
item_issues: [
|
ItemIssue 정의가 변경됨
|
| 지원되지 않음 | feedLabel: 문자열
|
feedLabel 필드 도입
|
가격 정보
판매자 보고서 API의 가격 통계 보기에서 변경된 사항은 다음과 같습니다.
| Content API | 판매자 API | 설명 |
productView.id: 문자열
|
id: 문자열
|
필드 형식이 channel:language:targetCountry:offerId에서 channel~language~feedLabel~offerId로 변경됩니다.
|
productView.priceMicros: 정수
productView.currencyCode: 문자열
|
price: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
priceInsights.suggestedPriceMicros: 정수
priceInsights.suggestedPriceCurrencyCode: 문자열
|
suggestedPrice: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
priceInsights.predictedGrossProfitChangeFraction: 실수
priceInsights.predictedMonthlyGrossProfitChangeMicros: 정수
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: 문자열
|
지원되지 않음 | 판매자 보고서 API에서는 총이익 변경과 관련된 필드가 지원되지 않습니다. |
가격 경쟁력
판매자 보고서의 가격 경쟁력 보기에서 변경된 사항은 다음과 같습니다. API:
| Content API | 판매자 API | 설명 |
productView.id: 문자열
|
id: 문자열
|
필드 형식이 channel:language:targetCountry:offerId에서 channel~language~feedLabel~offerId로 변경됩니다.
|
productView.priceMicros: 정수
productView.currencyCode: 문자열
|
price: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
priceCompetitiveness.countryCode: 문자열
|
reportCountryCode: 문자열
|
countryCode 필드의 이름이 reportCountryCode로 변경되었습니다.
|
priceCompetitiveness.benchmarkPriceMicros: 정수
priceCompetitiveness.benchmarkPriceCurrencyCode: 문자열
|
benchmarkPrice: {
|
금액 마이크로 및 통화 필드가 Price 유형의 필드 하나로 병합됩니다.
|
베스트셀러
판매자 보고서 API에서 베스트셀러 보기의 변경사항은 다음과 같습니다.
| Content API | 판매자 API | 설명 |
bestSellers.countryCode: 문자열
|
reportCountryCode: 문자열
|
countryCode 필드의 이름이 reportCountryCode로 변경되었습니다.
|
bestSellers.categoryId: 정수
|
reportCategoryId: 정수
|
categoryId 필드의 이름이 reportCategoryId로 변경되었습니다.
|
노출 경쟁
Merchant Reports API의 노출 경쟁 보기에서 다음과 같은 사항이 변경되었습니다.
| Content API | 판매자 API | 설명 |
competitiveVisibility.countryCode: 문자열
|
reportCountryCode: 문자열
|
countryCode 필드의 이름이 reportCountryCode로 변경되었습니다.
|
competitiveVisibility.categoryId: 정수
|
reportCategoryId: 정수
|
categoryId 필드의 이름이 reportCategoryId로 변경되었습니다.
|