Dưới đây là cách bạn có thể tích hợp Merchant Reports API (API Báo cáo của người bán) với hoạt động triển khai Content API for Shopping hiện tại.
Yêu cầu
Hãy sử dụng định dạng URL yêu cầu sau đây cho API Báo cáo của người bán:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Dưới đây là dữ liệu so sánh mẫu giữa Content API for Shopping với API Báo cáo của người bán cho các yêu cầu search
:
Content API | API Merchant Center | |
URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
Giá trị nhận dạng | {merchantId}
|
{parent}
|
Phương thức
Bạn có thể truy vấn API Báo cáo của người bán bằng cách gọi phương thức ReportService.Search
.
Số lượt xem
Trong API Merchant, tên bảng được đổi từ CammelCase
thành snake_case
.
MerchantPerformanceView
đổi tên thành product_performance_view
Dưới đây là mối liên kết giữa các tên bảng trong Content API for Shopping và Merchant API:
Content API | API Merchant Center |
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
|
Trong API Merchant, việc chỉ định tiền tố trường, ví dụ: segments.offer_id
không còn là bắt buộc. Thay vào đó, bạn chỉ cần sử dụng tên trường offer_id
.
Dưới đây là thông tin so sánh mẫu về các truy vấn trong Content API for Shopping và Merchant API:
Content API | API Merchant Center |
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 |
Dưới đây là câu trả lời mẫu:
Content API | API Merchant Center |
{ "segments":{ "offerId":"abc" }, "metrics":{ "clicks":"123" } } |
{ "productPerformanceView" : { "offerId": "abc", "clicks": "123" } } |
Tên bảng có thể được dùng làm tiền tố của trường. Ví dụ: cả offer_id
và product_performance_view.offer_id
đều được chấp nhận trong truy vấn API Merchant.
Hiệu suất
Dưới đây là những thay đổi đối với chế độ xem hiệu suất trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
segments.program : chuỗi
|
marketing_method : chuỗi
|
Phân đoạn program được thay thế bằng trường marketing_method mới. Hãy xem phần Giá trị marketing method mới để biết thông tin chi tiết.
|
metrics.ctr : gấp đôi
|
clickThroughRate : gấp đôi
|
Đổi tên chỉ số ctr thành clickThroughRate
|
metrics.conversionValueMicros : số nguyên segments.currencyCode : chuỗi
|
conversionValue: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
metrics.orders,
|
Không thể làm | Các chỉ số của chương trình Mua trên Google không được hỗ trợ trong API Báo cáo của người bán |
Các giá trị mới của phương thức tiếp thị
Dưới đây là mối liên kết giữa các giá trị segments.program
và marketing_method
:
Content API | API Merchant Center |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
Không thể làm |
Sản phẩm
Dưới đây là những thay đổi đối với chế độ xem sản phẩm trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
productView.id : chuỗi
|
id : chuỗi
|
Định dạng trường thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
|
productView.priceMicros : số nguyên productView.currencyCode : chuỗi
|
price: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
productView.aggregated_destination_status : chuỗi
|
aggregated_reporting_context_status : chuỗi
|
Trường aggregated_destination_status được đổi tên thành aggregated_reporting_context_status , các giá trị không thay đổi
|
productView.item_issues: [
|
item_issues: [
|
Định nghĩa ItemIssue đã thay đổi
|
Không thể làm | feedLabel : chuỗi
|
Ra mắt trường feedLabel
|
Thông tin chi tiết về giá
Dưới đây là những điểm thay đổi đối với chế độ xem thông tin chi tiết về giá trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
productView.id : chuỗi
|
id : chuỗi
|
Định dạng trường sẽ thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
|
productView.priceMicros : số nguyên
productView.currencyCode : chuỗi
|
price: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
priceInsights.suggestedPriceMicros : số nguyên priceInsights.suggestedPriceCurrencyCode : chuỗi
|
suggestedPrice: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
priceInsights.predictedGrossProfitChangeFraction : kép
priceInsights.predictedMonthlyGrossProfitChangeMicros : số nguyên
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : chuỗi
|
Không thể làm | API Báo cáo của người bán không hỗ trợ các trường liên quan đến thay đổi về lợi nhuận gộp |
Tính cạnh tranh về giá
Dưới đây là những điểm thay đổi đối với chế độ xem sức cạnh tranh về giá trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
productView.id : chuỗi
|
id : chuỗi
|
Định dạng trường sẽ thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
|
productView.priceMicros : số nguyên productView.currencyCode : chuỗi
|
price: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
priceCompetitiveness.countryCode : chuỗi
|
reportCountryCode : chuỗi
|
Trường countryCode được đổi tên thành reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros : số nguyên priceCompetitiveness.benchmarkPriceCurrencyCode : chuỗi
|
benchmarkPrice: {
|
Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
|
Bán chạy nhất
Sau đây là những thay đổi đối với chế độ xem sản phẩm bán chạy nhất trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
bestSellers.countryCode : chuỗi
|
reportCountryCode : chuỗi
|
Trường countryCode được đổi tên thành reportCountryCode
|
bestSellers.categoryId : số nguyên
|
reportCategoryId : số nguyên
|
Trường categoryId được đổi tên thành reportCategoryId
|
Mức độ hiển thị cạnh tranh
Sau đây là những điểm thay đổi đối với chế độ xem khả năng hiển thị so với đối thủ cạnh tranh trong API Báo cáo của người bán:
Content API | API Merchant Center | Nội dung mô tả |
competitiveVisibility.countryCode : chuỗi
|
reportCountryCode : chuỗi
|
Trường countryCode được đổi tên thành reportCountryCode
|
competitiveVisibility.categoryId : số nguyên
|
reportCategoryId : số nguyên
|
Trường categoryId được đổi tên thành reportCategoryId
|