Migracja raportów z Content API for Shopping

Oto, jak zintegrować interfejs Merchant Reports API z istniejącą implementacją Content API for Shopping.

Żądania

W przypadku interfejsu Merchant Reports API używaj tego formatu adresu URL żądania:

POST https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search

Oto przykładowe porównanie interfejsu Content API for Shopping z interfejsem Merchant Reports API dotyczącego żądań search:

Content API. Interfejs API sprzedawcy
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{PARENT}/reports:search
Identyfikatory {MERCHANT_ID} {PARENT}

Metody

Zapytania do interfejsu Merchant Reports API możesz wysyłać, wywołując metodę ReportService.Search.

Wyświetlenia

W Merchant API nazwy tabel zmieniono z CammelCase na snake_case.

MerchantPerformanceView to teraz product_performance_view.

Oto mapowanie nazw tabel w Content API for Shopping i Merchant API:

Content API. Interfejs API sprzedawcy
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

W interfejsie Merchant API nie musisz już określać prefiksu pola, np. segments.offer_id. Zamiast tego użyj nazwy pola offer_id.

Oto przykładowe porównanie zapytań w interfejsie Content API for Shopping i Merchant API:

Content API. Interfejs API sprzedawcy 
   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

Oto przykładowa odpowiedź:

Content API. Interfejs API sprzedawcy 
{
  "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 Merchant API akceptowane są zarówno offer_id, jak i product_performance_view.offer_id.

Wyniki

Oto, co się zmieniło w widoku skuteczności w interfejsie Merchant Reports API:

Content API. Interfejs API sprzedawcy Opis
segments.program: ciąg znaków marketing_method: ciąg znaków Segment program został zastąpiony nowym polem marketing_method. Więcej informacji znajdziesz w sekcji Nowe wartości marketing method.
metrics.ctr: podwójna precyzja clickThroughRate: podwójna precyzja Dane ctr zostały przemianowane na clickThroughRate
metrics.conversionValueMicros: liczba całkowita
segments.currencyCode: ciąg znaków 		conversionValue: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price
metrics.orders,
metrics.orderedItems,
… 		Nieobsługiwane Dane Kup przez Google nie są obsługiwane w interfejsie Merchant Reports API

Nowe wartości metody marketingowej

Oto mapowanie wartości segments.program i marketing_method:

Content API. Interfejs API sprzedawcy
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Nieobsługiwane

Produkt

Oto, co się zmieniło w widoku produktu w interfejsie Merchant Reports API:

Content API. Interfejs API sprzedawcy 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: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price
productView.aggregated_destination_status: ciąg znaków aggregated_reporting_context_status: ciąg znaków Pole aggregated_destination_status zostało przemianowane na aggregated_reporting_context_status, ale wartości nie uległy zmianie
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		Zmieniono definicję ItemIssue
Nieobsługiwane feedLabel: ciąg znaków Wprowadzono pole feedLabel

Statystyki dotyczące cen

Co się zmieniło w widoku statystyk cen w interfejsie API raportów sprzedawcy:

Content API. Interfejs API sprzedawcy 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: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price
priceInsights.suggestedPriceMicros: liczba całkowita
priceInsights.suggestedPriceCurrencyCode: ciąg znaków 		suggestedPrice: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price
priceInsights.predictedGrossProfitChangeFraction: podwójna
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 API raportów dla sprzedawców:

Content API. Interfejs API sprzedawcy 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: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price
priceCompetitiveness.countryCode: ciąg znaków reportCountryCode: ciąg znaków Zmieniono nazwę pola countryCode na reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: liczba całkowita
priceCompetitiveness.benchmarkPriceCurrencyCode: ciąg znaków 		benchmarkPrice: {
object (Price)
} 		Pola z kwotą w milionowych częściach i z walutą są łączone w jedno pole typu Price

Bestsellery

Oto, co się zmieniło w widokach bestsellerów w interfejsie API raportów Merchant Center:

Content API. Interfejs API sprzedawcy Opis
bestSellers.countryCode: ciąg znaków reportCountryCode: ciąg znaków Zmieniono nazwę pola countryCode na reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Zmieniono nazwę pola categoryId na reportCategoryId

Widoczność na tle konkurencji

Oto, co się zmieniło w widokach widoczności na tle konkurencji w interfejsie API raportów dla sprzedawców:

Content API. Interfejs API sprzedawcy Opis
competitiveVisibility.countryCode: ciąg znaków reportCountryCode: ciąg znaków Zmieniono nazwę pola countryCode na reportCountryCode
competitiveVisibility.categoryId: liczba całkowita reportCategoryId: liczba całkowita Zmieniono nazwę pola categoryId na reportCategoryId

Wstecz
Przenoszenie zarządzania źródłami konwersji
Dalej
Przenoszenie zarządzania współpracą z plikami danych o asortymencie lokalnym