Перенос отчетов из Content API for Shopping

Вы можете использовать API Merchant Reports, чтобы узнать о своих продуктах, их эффективности и конкурентной среде в Google с помощью предлагаемого им представления данных.

API Merchant Reports можно использовать для следующих целей:

Вот как можно интегрировать API отчетов о торговле с существующей реализацией API контента для покупок .

Запросы

Используйте следующий формат URL-адреса запроса для API Merchant Reports:

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

Вот пример сравнения API контента для покупок с API отчетов о продавцах для search запросов:

API контента API торговца
URL https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /reports/search https://merchantapi.googleapis.com/reports/v1/ {PARENT} /reports:search
Идентификаторы {MERCHANT_ID} {PARENT}

Методы

Вы можете выполнить запрос к API Merchant Reports, вызвав метод ReportService.Search .

Просмотры

В API Merchant названия таблиц изменены с CamelCase на snake_case .

MerchantPerformanceView теперь называется product_performance_view .

Ниже приведено сопоставление имен таблиц в API контента для покупок и API торговца:

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 и Merchant API:

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

Вот пример ответа:

API контента API торговца 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Имя таблицы можно использовать в качестве префикса поля. Например, в запросе API Merchant принимаются как offer_id , так и product_performance_view.offer_id .

Производительность

Вот что изменилось в представлении производительности в API Merchant Reports:

API контента API торговца Описание
segments.program : строка marketing_method : строка Сегмент program заменён новым полем marketing_method . Подробнее см. в разделе «Значения нового marketing method .
metrics.ctr : double clickThroughRate : двойной Метрика ctr переименована в clickThroughRate
metrics.conversionValueMicros : целое число
segments.currencyCode : строка		 conversionValue: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .
metrics.orders,
metrics.orderedItems,
…		 Не поддерживается Показатели «Купить в Google» не поддерживаются в API Merchant Reports.

Ценности нового метода маркетинга

Вот сопоставление значений segments.program и marketing_method :

API контента API торговца
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Не поддерживается

Продукт

Вот что изменилось в представлении продуктов в API Merchant Reports:

API контента API торговца Описание
productView.id : строка id : строка Формат поля меняется с channel:language:targetCountry:offerId на
channel~language~feedLabel~offerId
productView.priceMicros : целое число
productView.currencyCode : строка		 price: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .
productView.aggregated_destination_status : строка aggregated_reporting_context_status : строка Поле aggregated_destination_status переименовано в aggregated_reporting_context_status , значения не изменились
productView.item_issues: [
{
object (ItemIssue)
}
]		 item_issues: [
{
object (ItemIssue)
}
]		 Определение ItemIssue изменилось
Не поддерживается feedLabel : строка введено поле feedLabel

Ценовая аналитика

Вот что изменилось в представлении ценовой аналитики в API Merchant Reports:

API контента API торговца Описание
productView.id : строка id : строка Формат поля меняется с channel:language:targetCountry:offerId на channel~language~feedLabel~offerId
productView.priceMicros : целое число
productView.currencyCode : строка		 price: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .
priceInsights.suggestedPriceMicros : целое число
priceInsights.suggestedPriceCurrencyCode : строка		 suggestedPrice: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .
priceInsights.predictedGrossProfitChangeFraction : double
priceInsights.predictedMonthlyGrossProfitChangeMicros : целое число
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode : строка		 Не поддерживается Поля, связанные с изменением валовой прибыли, не поддерживаются в API Merchant Reports.

Ценовая конкурентоспособность

Вот что изменилось в представлении конкурентоспособности цен в API Merchant Reports:

API контента API торговца Описание
productView.id : строка id : строка Формат поля меняется с channel:language:targetCountry:offerId на channel~language~feedLabel~offerId
productView.priceMicros : целое число
productView.currencyCode : строка		 price: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .
priceCompetitiveness.countryCode : string reportCountryCode : строка Поле countryCode переименовано в reportCountryCode
priceCompetitiveness.benchmarkPriceMicros : целое число
priceCompetitiveness.benchmarkPriceCurrencyCode : string		 benchmarkPrice: {
object (Price)
}		 Поля «Сумма микро» и «Валюта» объединены в одно поле с типом Price .

Бестселлеры

Вот что изменилось в представлениях бестселлеров в API Merchant Reports:

API контента API торговца Описание
bestSellers.countryCode : строка reportCountryCode : строка Поле countryCode переименовано в reportCountryCode
bestSellers.categoryId : int reportCategoryId : int Поле categoryId переименовано в reportCategoryId

Конкурентная видимость

Вот что изменилось в представлениях видимости конкурентов в API Merchant Reports:

API контента API торговца Описание
competitiveVisibility.countryCode : строка reportCountryCode : строка Поле countryCode переименовано в reportCountryCode
competitiveVisibility.categoryId : целое число reportCategoryId : целое число Поле categoryId переименовано в reportCategoryId

Назад
Migrate conversion sources management
Далее
Migrate local feeds partnership management