Poniżej znajdziesz informacje o tym, jak zintegrować interfejs Merchant Reports API z dotychczasową implementacją Content API for Shopping.
Żądania
Użyj tego formatu adresu URL żądania dla interfejsu Merchant Reports API:
POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Oto przykładowe porównanie Content API for Shopping z interfejsem Merchant Reports API dla żądań search
:
Content API. | Interfejs API dla sprzedawców | |
URL | https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search | https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search |
Identyfikatory | {merchantId}
|
{parent}
|
Metody
Zapytanie do interfejsu Merchant Reports API możesz wysłać, wywołując metodę ReportService.Search
.
Wyświetlenia
W interfejsie Merchant API nazwy tabel zostały zmienione z CammelCase
na snake_case
.
MerchantPerformanceView
to teraz product_performance_view
.
Oto mapowanie nazw tabel w interfejsie Content API for Shopping i Merchant API:
Content API. | Interfejs API dla sprzedawców |
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
|
Określenie w interfejsie Merchant API prefiksu pola, np. segments.offer_id
, nie jest już wymagane. Zamiast tego użyj po prostu nazwy pola offer_id
.
Oto przykładowe porównanie zapytań w interfejsie Content API for Shopping i interfejsie Merchant API:
Content API. | Interfejs API dla sprzedawców |
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 |
Przykładowa odpowiedź:
Content API. | Interfejs API dla sprzedawców |
{ "segments":{ "offerId":"abc" }, "metrics":{ "clicks":"123" } } |
{ "productPerformanceView" : { "offerId": "abc", "clicks": "123" } } |
Nazwa tabeli może być używana jako prefiks pola. Na przykład w zapytaniu interfejsu Merchant API akceptowane są zarówno offer_id
, jak i product_performance_view.offer_id
.
Występy
Co się zmieniło w widoku skuteczności w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
segments.program : ciąg znaków
|
marketing_method : ciąg znaków
|
program segment został zastąpiony nowym polem marketing_method . Więcej informacji znajdziesz w sekcji Nowe wartości marketing method .
|
metrics.ctr : liczba zmiennoprzecinkowa
|
clickThroughRate : liczba zmiennoprzecinkowa
|
Zmieniono nazwę danych ctr na clickThroughRate
|
metrics.conversionValueMicros : liczba całkowita
segments.currencyCode : ciąg znaków
|
conversionValue: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
metrics.orders,
|
Nieobsługiwane | Dane usługi Kup przez Google nie są obsługiwane w interfejsie Merchant Reports API |
Nowe wartości metod marketingowych
Oto mapowanie wartości segments.program
i marketing_method
:
Content API. | Interfejs API dla sprzedawców |
SHOPPING_ADS
|
ADS
|
FREE_PRODUCT_LISTING
|
ORGANIC
|
FREE_LOCAL_PRODUCT_LISTING
|
ORGANIC
|
BUY_ON_GOOGLE_LISTING
|
Nieobsługiwane |
Produkt
Co się zmieniło w widoku produktu w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
productView.id : ciąg znaków
|
id : ciąg znaków
|
Format pola zmieni się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros : liczba całkowita
productView.currencyCode : ciąg znaków
|
price: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
productView.aggregated_destination_status : ciąg znaków
|
aggregated_reporting_context_status : ciąg znaków
|
Nazwa pola aggregated_destination_status została zmieniona na aggregated_reporting_context_status , wartości się nie zmieniły
|
productView.item_issues: [
|
item_issues: [
|
ItemIssue – definicja została zmieniona
|
Nieobsługiwane | feedLabel : ciąg znaków
|
Wprowadzono pole feedLabel
|
Statystyki dotyczące cen
Oto, co się zmieniło w widoku statystyk dotyczących cen w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
productView.id : ciąg znaków
|
id : ciąg znaków
|
Format pola zmieni się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros : liczba całkowita
productView.currencyCode : ciąg znaków
|
price: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
priceInsights.suggestedPriceMicros : liczba całkowita
priceInsights.suggestedPriceCurrencyCode : ciąg znaków
|
suggestedPrice: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
priceInsights.predictedGrossProfitChangeFraction : liczba zmiennoprzecinkowa
priceInsights.predictedMonthlyGrossProfitChangeMicros : liczba całkowita
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : ciąg znaków
|
Nieobsługiwane | Pola związane ze zmianą zysku brutto nie są obsługiwane w interfejsie Merchant Reports API |
Konkurencyjność cenowa
Oto, co się zmieniło w widoku konkurencyjności cenowej w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
productView.id : ciąg znaków
|
id : ciąg znaków
|
Format pola zmieni się z channel:language:targetCountry:offerId na channel~language~feedLabel~offerId
|
productView.priceMicros : liczba całkowita
productView.currencyCode : ciąg znaków
|
price: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
priceCompetitiveness.countryCode : ciąg znaków
|
reportCountryCode : ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
priceCompetitiveness.benchmarkPriceMicros : liczba całkowita
priceCompetitiveness.benchmarkPriceCurrencyCode : ciąg znaków
|
benchmarkPrice: {
|
Mikrodane kwoty i pola waluty zostały scalone w jedno pole typu Price
|
Bestsellery
Co się zmieniło w widokach bestsellerów w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
bestSellers.countryCode : ciąg znaków
|
reportCountryCode : ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
bestSellers.categoryId : liczba całkowita
|
reportCategoryId : liczba całkowita
|
Nazwa pola categoryId została zmieniona na reportCategoryId
|
Widoczność na tle konkurencji
Oto, co się zmieniło w widokach widoczności na tle konkurencji w interfejsie Merchant Reports API:
Content API. | Interfejs API dla sprzedawców | Opis |
competitiveVisibility.countryCode : ciąg znaków
|
reportCountryCode : ciąg znaków
|
Nazwa pola countryCode została zmieniona na reportCountryCode
|
competitiveVisibility.categoryId : liczba całkowita
|
reportCategoryId : liczba całkowita
|
Nazwa pola categoryId została zmieniona na reportCategoryId
|