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

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

С помощью API отчетов для продавцов вы можете выполнить следующие действия:

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

Запросы

Для доступа к API отчетов для продавцов используйте следующий формат URL-адреса запроса:

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

Вот пример сравнения Content API для покупок и Merchant Reports 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 отчетов для продавцов, вызвав метод ReportService.Search .

Мнения

В API для продавцов названия таблиц изменены с CamelCase на snake_case .

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

Вот сопоставление названий таблиц в Content API для покупок и Merchant 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 для покупок и 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 продавца принимаются как offer_id , так и product_performance_view.offer_id .

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

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

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

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

Вот соответствие между значениями segments.program и marketing_method :

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

Продукт

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

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

Анализ цен

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

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

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

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

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

Бестселлеры

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

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

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

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

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

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