Эта страница переведена с помощью Cloud Translation API.

Package google.shopping.merchant.reports.v1beta

Индекс

ReportService (интерфейс)
BestSellersBrandView (сообщение)
BestSellersProductClusterView (сообщение)
BestSellersProductClusterView.InventoryStatus (перечисление)
CompetitiveVisibilityBenchmarkView (сообщение)
CompetitiveVisibilityCompetitorView (сообщение)
CompetitiveVisibilityTopMerchantView (сообщение)
MarketingMethod (сообщение)
MarketingMethod.MarketingMethodEnum (перечисление)
NonProductPerformanceView (сообщение)
PriceCompetitivenessProductView (сообщение)
PriceInsightsProductView (сообщение)
PriceInsightsProductView.Effectiveness (перечисление)
ProductPerformanceView (сообщение)
ProductView (сообщение)
ProductView.AggregatedReportingContextStatus (перечисление)
ProductView.ClickPotential (перечисление)
ProductView.ItemIssue (сообщение)
ProductView.ItemIssue.ItemIssueResolution (перечисление)
ProductView.ItemIssue.ItemIssueSeverity (сообщение)
ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (перечисление)
ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (сообщение)
ProductView.ItemIssue.ItemIssueType (сообщение)
RelativeDemand (сообщение)
RelativeDemand.RelativeDemandEnum (перечисление)
RelativeDemandChangeType (сообщение)
RelativeDemandChangeType.RelativeDemandChangeTypeEnum (перечисление)
ReportGranularity (сообщение)
ReportGranularity.ReportGranularityEnum (перечисление)
ReportRow (сообщение)
SearchRequest (сообщение)
SearchResponse (сообщение)
TrafficSource (сообщение)
TrafficSource.TrafficSourceEnum (перечисление)

Служба отчетов

Сервис для получения отчетов и аналитической информации о ваших продуктах, их эффективности и конкурентной среде в Google.

Поиск

Поиск
`rpc Search( SearchRequest ) returns ( SearchResponse )` Получает отчет, определенный поисковым запросом. Ответ может содержать меньше строк, чем указано в параметре `page_size` . Положитесь на `next_page_token` , чтобы определить, нужно ли запрашивать еще строки. Области авторизации Требуется следующая область действия OAuth: `https://www.googleapis.com/auth/content` Для получения дополнительной информации см.OAuth 2.0 Overview .

rpc Search( SearchRequest ) returns ( SearchResponse )

Получает отчет, определенный поисковым запросом. Ответ может содержать меньше строк, чем указано в параметре page_size . Положитесь на next_page_token , чтобы определить, нужно ли запрашивать еще строки.

Области авторизации

Требуется следующая область действия OAuth:

https://www.googleapis.com/auth/content

Для получения дополнительной информации см.OAuth 2.0 Overview .

БестселлерыБрендПросмотреть

Поля, доступные для запроса в таблице best_sellers_brand_view .

Отчеты о бестселлерах ведущих брендов.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`report_ date`	`Date` Дата отчета. Значение этого поля может быть только одним из следующих: Первый день недели (понедельник) для еженедельных отчетов. Первый день месяца для ежемесячных отчетов. Требуется в предложении `SELECT` . Если в запросе не указано условие `WHERE` для `report_date` , возвращается последний доступный еженедельный или ежемесячный отчет.
`report_ granularity`	`ReportGranularityEnum` Детализация отчета. Рейтинг может быть составлен в течение недели или месяца. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие `report_granularity` .
`report_ country_ code`	`string` Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166. Требуется в предложении `SELECT` . Условие для `report_country_code` является обязательным в предложении `WHERE` .
`report_ category_ id`	`int64` Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google . Требуется в предложении `SELECT` . Если в запросе не указано условие `WHERE` для `report_category_id` , возвращаются рейтинги для всех категорий верхнего уровня.
`brand`	`string` Название бренда.
`rank`	`int64` Популярность бренда в рекламе и на органических поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц.
`previous_ rank`	`int64` Рейтинг популярности за предыдущую неделю или месяц.
`relative_ demand`	`RelativeDemandEnum` Предполагаемый спрос по отношению к бренду с самым высоким рейтингом популярности в той же категории и стране.
`previous_ relative_ demand`	`RelativeDemandEnum` Предполагаемый спрос по бренду, имевшему самый высокий рейтинг популярности в той же категории и стране на предыдущей неделе или месяце.
`relative_ demand_ change`	`RelativeDemandChangeTypeEnum` Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным.

БестселлерыПродуктКластерПросмотр

Поля, доступные для запроса в таблице best_sellers_product_cluster_view .

Отчеты о бестселлерах с топ-группами продуктов. Кластер продуктов — это группировка различных предложений и вариантов, представляющих один и тот же продукт, например Google Pixel 7.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`report_ date`	`Date` Дата отчета. Значение этого поля может быть только одним из следующих: Первый день недели (понедельник) для еженедельных отчетов. Первый день месяца для ежемесячных отчетов. Требуется в предложении `SELECT` . Если в запросе не указано условие `WHERE` для `report_date` , возвращается последний доступный еженедельный или ежемесячный отчет.
`variant_ gtins[]`	`string` GTIN примерных вариантов кластера товаров.
`report_ granularity`	`ReportGranularityEnum` Детализация отчета. Рейтинг может быть составлен в течение недели или месяца. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие `report_granularity` .
`report_ country_ code`	`string` Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166. Требуется в предложении `SELECT` . Условие для `report_country_code` является обязательным в предложении `WHERE` .
`report_ category_ id`	`int64` Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google . Требуется в предложении `SELECT` . Если в запросе не указано условие `WHERE` для `report_category_id` , возвращаются рейтинги для всех категорий верхнего уровня.
`title`	`string` Название кластера продуктов.
`brand`	`string` Бренд продуктового кластера.
`category_ l1`	`string` Категория продукта (1-й уровень) кластера продуктов, представленная в таксономии продуктов Google .
`category_ l2`	`string` Категория продукта (2-й уровень) кластера продуктов, представленная в таксономии продуктов Google .
`category_ l3`	`string` Категория продукта (3-й уровень) кластера продуктов, представленная в таксономии продуктов Google .
`category_ l4`	`string` Категория продукта (4-й уровень) кластера продуктов, представленная в таксономии продуктов Google .
`category_ l5`	`string` Категория продукта (5-й уровень) кластера продуктов, представленная в таксономии продуктов Google .
`inventory_ status`	`InventoryStatus` Является ли кластер продуктов `IN_STOCK` в вашем источнике данных о продуктах хотя бы в одной из стран, `OUT_OF_STOCK` в вашем источнике данных о продуктах во всех странах или вообще `NOT_IN_INVENTORY` . В этом поле не учитывается фильтр страны отчета о бестселлерах.
`brand_ inventory_ status`	`InventoryStatus` Если в вашем источнике данных о продуктах хотя бы в одной из стран есть хотя бы один продукт бренда, который в настоящее время `IN_STOCK` , все продукты в вашем источнике данных о продуктах во всех странах находятся `OUT_OF_STOCK` или `NOT_IN_INVENTORY` . В этом поле не учитывается фильтр страны отчета о бестселлерах.
`rank`	`int64` Популярность кластера продуктов в рекламе и на обычных поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц.
`previous_ rank`	`int64` Рейтинг популярности за предыдущую неделю или месяц.
`relative_ demand`	`RelativeDemandEnum` Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране.
`previous_ relative_ demand`	`RelativeDemandEnum` Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране на предыдущей неделе или месяце.
`relative_ demand_ change`	`RelativeDemandChangeTypeEnum` Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным.

Статус инвентаря

Статус группы продуктов или бренда в вашем инвентаре.

Перечисления
`INVENTORY_STATUS_UNSPECIFIED`	Не указан.
`IN_STOCK`	У вас есть на складе продукт для этой группы продуктов или бренда.
`OUT_OF_STOCK`	У вас есть продукт для этой группы продуктов или бренда в наличии, но в настоящее время его нет в наличии.
`NOT_IN_INVENTORY`	У вас нет продукта для этого кластера продуктов или бренда в наличии.

КонкурентныйВидимостьБенчмаркПросмотр

Поля, доступные для запроса в таблице competitive_visibility_benchmark_view .

Отчет о конкурентной видимости с эталоном категории.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`date`	`Date` Дата этой строки. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать `date` .
`report_ country_ code`	`string` Страна, где появились впечатления. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_country_code` .
`report_ category_ id`	`int64` Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_category_id` .
`traffic_ source`	`TrafficSourceEnum` Источник трафика показов. Требуется в предложении `SELECT` .
`your_ domain_ visibility_ trend`	`double` Изменение видимости в зависимости от показов вашего домена относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами). Невозможно отфильтровать в предложении «WHERE».
`category_ benchmark_ visibility_ trend`	`double` Изменение видимости на основе показов относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами) для объединенной группы продавцов с самой высокой видимостью, приближенной к рынку. Невозможно отфильтровать в предложении «WHERE».

КонкурентныйВидимостьПросмотр конкурента

Поля, доступные для запроса в таблице competitive_visibility_competitor_view .

Отчет о конкурентной видимости с предприятиями с аналогичной видимостью.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`date`	`Date` Дата этой строки. В предложении `WHERE` необходимо указать `date` .
`domain`	`string` Домен вашего конкурента или ваш домен, если is_your_domain имеет значение true. Требуется в предложении `SELECT` . Невозможно отфильтровать в предложении «WHERE».
`is_ your_ domain`	`bool` True, если эта строка содержит данные для вашего домена. Невозможно отфильтровать в предложении «WHERE».
`report_ country_ code`	`string` Страна, где появились впечатления. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_country_code` .
`report_ category_ id`	`int64` Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_category_id` .
`traffic_ source`	`TrafficSourceEnum` Источник трафика показов. Требуется в предложении `SELECT` .
`rank`	`int64` Позиция домена в рейтинге похожих компаний по выбранным ключам ( `date` , `report_category_id` , `report_country_code` , `traffic_source` ) на основе показов. 1 – самый высокий. Невозможно отфильтровать в предложении «WHERE».
`ads_ organic_ ratio`	`double` Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам. Невозможно отфильтровать в предложении «WHERE».
`page_ overlap_ rate`	`double` Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице. Невозможно отфильтровать в предложении «WHERE».
`higher_ position_ rate`	`double` Более высокий рейтинг позиций показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение. Невозможно отфильтровать в предложении «WHERE».
`relative_ visibility`	`double` Относительная видимость показывает, как часто показываются предложения ваших конкурентов по сравнению с вашими предложениями. Другими словами, это количество отображаемых показов у розничного продавца-конкурента, разделенное на количество отображаемых вами показов в течение выбранного диапазона времени для выбранной категории продуктов и страны. Невозможно отфильтровать в предложении «WHERE».

КонкурентныйVisibilityTopMerchantView

Поля, доступные для запроса в таблице competitive_visibility_top_merchant_view .

Отчет о конкурентной видимости с бизнесом с максимальной заметностью.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`date`	`Date` Дата этой строки. Невозможно выбрать в предложении `SELECT` . В предложении `WHERE` необходимо указать `date` .
`domain`	`string` Домен вашего конкурента или ваш домен, если is_your_domain имеет значение true. Требуется в предложении `SELECT` . Невозможно отфильтровать в предложении «WHERE».
`is_ your_ domain`	`bool` True, если эта строка содержит данные для вашего домена. Невозможно отфильтровать в предложении «WHERE».
`report_ country_ code`	`string` Страна, где появились впечатления. Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_country_code` .
`report_ category_ id`	`int64` Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении `SELECT` . В предложении `WHERE` необходимо указать условие для `report_category_id` .
`traffic_ source`	`TrafficSourceEnum` Источник трафика показов. Требуется в предложении `SELECT` .
`rank`	`int64` Позиция домена в топе рейтинга продавцов по выбранным ключам ( `date` , `report_category_id` , `report_country_code` , `traffic_source` ) на основе показов. 1 – самый высокий. Невозможно отфильтровать в предложении «WHERE».
`ads_ organic_ ratio`	`double` Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам. Невозможно отфильтровать в предложении «WHERE».
`page_ overlap_ rate`	`double` Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице. Невозможно отфильтровать в предложении «WHERE».
`higher_ position_ rate`	`double` Более высокий рейтинг позиций показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение. Невозможно отфильтровать в предложении «WHERE».

Маркетинговый метод

Этот тип не имеет полей.

Маркетинговый метод, используемый для продвижения ваших продуктов в Google (органический или рекламный).

МаркетингМетодЕнум

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

Перечисления
`MARKETING_METHOD_ENUM_UNSPECIFIED`	Не указан.
`ORGANIC`	Органический маркетинг.
`ADS`	Рекламный маркетинг.

NonProductPerformanceView

Поля, доступные для запроса в таблице non_product_performance_view .

Данные об эффективности изображений и ссылок интернет-магазинов, ведущих на страницы, не связанные с товарами. Сюда входят показатели эффективности (например, clicks ) и параметры, по которым сегментируются показатели эффективности (например, date ).

Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`date`	`Date` Дата в часовом поясе продавца, к которой применяются показатели. Сегмент. Условие `date` необходимо в предложении `WHERE` .
`week`	`Date` Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент.
`clicks`	`int64` Количество кликов по изображениям и ссылкам интернет-магазина, ведущим на страницы, не связанные с товарами. Метрика.
`impressions`	`int64` Сколько раз были показаны изображения и ссылки интернет-магазина, ведущие на ваши страницы, не связанные с товарами. Метрика.
`click_ through_ rate`	`double` Кликабельность — количество кликов ( `clicks` ), деленное на количество показов ( `impressions` ) изображений и ссылок интернет-магазина, ведущих на ваши непродуктовые страницы. Метрика.

ЦенаКонкурентоспособностьПродуктПросмотр

Поля, доступные для запроса в таблице price_competitiveness_product_view .

Отчет о ценовой конкурентоспособности .

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`price`	`Price` Текущая цена товара.
`benchmark_ price`	`Price` Последняя доступная эталонная цена для каталога продуктов в эталонной стране.
`report_ country_ code`	`string` Страна ценового ориентира. Представлено в формате ISO 3166. Требуется в предложении `SELECT` .
`id`	`string` REST ID продукта в форме `channel~languageCode~feedLabel~offerId` . Может использоваться для объединения данных с таблицей `product_view` . Требуется в предложении `SELECT` .
`offer_ id`	`string` Идентификатор товара, предоставленный продавцом.
`title`	`string` Название продукта.
`brand`	`string` Бренд продукта.
`category_ l1`	`string` Категория продукта (1-й уровень) в таксономии продуктов Google .
`category_ l2`	`string` Категория продукта (2-й уровень) в таксономии продуктов Google .
`category_ l3`	`string` Категория продукта (3-й уровень) в таксономии продуктов Google .
`category_ l4`	`string` Категория продукта (4-й уровень) в таксономии продуктов Google .
`category_ l5`	`string` Категория продукта (5-й уровень) в таксономии продуктов Google .
`product_ type_ l1`	`string` Тип продукта (1-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l2`	`string` Тип продукта (2-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l3`	`string` Тип товара (3-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l4`	`string` Тип продукта (4-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l5`	`string` Тип продукта (5-й уровень) в собственной таксономии товаров продавца.

PriceInsightsProductView

Поля, доступные для запроса в таблице price_insights_product_view .

Отчет о ценах .

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`price`	`Price` Текущая цена товара.
`suggested_ price`	`Price` Последняя рекомендованная цена на продукт.
`effectiveness`	`Effectiveness` Прогнозируемая эффективность применения ценового предложения, распределенная по сегментам.
`id`	`string` REST ID продукта в форме `channel~languageCode~feedLabel~offerId` . Может использоваться для объединения данных с таблицей `product_view` . Требуется в предложении `SELECT` .
`offer_ id`	`string` Идентификатор товара, предоставленный продавцом.
`title`	`string` Название продукта.
`brand`	`string` Бренд продукта.
`category_ l1`	`string` Категория продукта (1-й уровень) в таксономии продуктов Google .
`category_ l2`	`string` Категория продукта (2-й уровень) в таксономии продуктов Google .
`category_ l3`	`string` Категория продукта (3-й уровень) в таксономии продуктов Google .
`category_ l4`	`string` Категория продукта (4-й уровень) в таксономии продуктов Google .
`category_ l5`	`string` Категория продукта (5-й уровень) в таксономии продуктов Google .
`product_ type_ l1`	`string` Тип продукта (1-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l2`	`string` Тип продукта (2-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l3`	`string` Тип товара (3-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l4`	`string` Тип продукта (4-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l5`	`string` Тип продукта (5-й уровень) в собственной таксономии товаров продавца.
`predicted_ impressions_ change_ fraction`	`double` Прогнозируемое изменение количества показов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества показов на 5%.
`predicted_ clicks_ change_ fraction`	`double` Прогнозируемое изменение количества кликов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества кликов на 5%.
`predicted_ conversions_ change_ fraction`	`double` Прогнозируемое изменение количества конверсий в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение конверсий на 5 %.

Эффективность

Ведро прогнозируемой эффективности.

Эффективность показывает, какие продукты больше всего выиграют от изменения цен. Этот рейтинг учитывает прогнозируемое повышение производительности за счет корректировки цены продажи и разницы между вашей текущей ценой и рекомендованной ценой. Прогнозируется, что ценовые предложения с HIGH эффективностью приведут к максимальному увеличению производительности.

Перечисления
`EFFECTIVENESS_UNSPECIFIED`	Эффективность неизвестна.
`LOW`	Эффективность низкая.
`MEDIUM`	Эффективность средняя.
`HIGH`	Эффективность высокая.

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

Поля, доступные для запроса в таблице product_performance_view .

Данные об эффективности продукта для вашего аккаунта, включая показатели эффективности (например, clicks ) и параметры, в соответствии с которыми сегментируются показатели эффективности (например, offer_id ). Значения параметров продукта, например offer_id , отражают состояние продукта на момент показа.

Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`date`	`Date` Дата в часовом поясе продавца, к которой применяются показатели. Сегмент. Условие `date` необходимо в предложении `WHERE` .
`week`	`Date` Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент.
`conversion_ value`	`Price` Ценность конверсий, связанных с продуктом, указанная на дату конверсии. Метрика. Доступно только для `FREE` источника трафика.
`marketing_ method`	`MarketingMethodEnum` Маркетинговый метод, к которому применяются показатели. Сегмент.
`customer_ country_ code`	`string` Код страны, в которой находится заказчик на момент мероприятия. Представлено в формате ISO 3166. Сегмент. Если страну клиента определить невозможно, возвращается специальный код «ZZ».
`offer_ id`	`string` Идентификатор товара, предоставленный продавцом. Сегмент.
`title`	`string` Название продукта. Сегмент.
`brand`	`string` Бренд продукта. Сегмент.
`category_ l1`	`string` Категория продукта (1-й уровень) в таксономии продуктов Google. Сегмент.
`category_ l2`	`string` Категория продукта (2-й уровень) в таксономии продуктов Google. Сегмент.
`category_ l3`	`string` Категория продукта (3-й уровень) в таксономии продуктов Google. Сегмент.
`category_ l4`	`string` Категория продукта (4-й уровень) в таксономии продуктов Google. Сегмент.
`category_ l5`	`string` Категория продукта (5-й уровень) в таксономии продуктов Google. Сегмент.
`product_ type_ l1`	`string` Тип продукта (1-й уровень) в собственной таксономии товаров продавца. Сегмент.
`product_ type_ l2`	`string` Тип продукта (2-й уровень) в собственной таксономии товаров продавца. Сегмент.
`product_ type_ l3`	`string` Тип продукта (3-й уровень) в собственной таксономии товаров продавца. Сегмент.
`product_ type_ l4`	`string` Тип продукта (4-й уровень) в собственной таксономии товаров продавца. Сегмент.
`product_ type_ l5`	`string` Тип продукта (5-й уровень) в собственной таксономии товаров продавца. Сегмент.
`custom_ label0`	`string` Пользовательская метка 0 для индивидуальной группировки продуктов. Сегмент.
`custom_ label1`	`string` Пользовательская этикетка 1 для индивидуальной группировки продуктов. Сегмент.
`custom_ label2`	`string` Специальная этикетка 2 для индивидуальной группировки продуктов. Сегмент.
`custom_ label3`	`string` Специальная этикетка 3 для индивидуальной группировки продуктов. Сегмент.
`custom_ label4`	`string` Пользовательская этикетка 4 для индивидуальной группировки продуктов. Сегмент.
`clicks`	`int64` Количество кликов. Метрика.
`impressions`	`int64` Количество показов товаров продавца. Метрика.
`click_ through_ rate`	`double` Рейтинг кликов – количество кликов, полученных товарами продавца (кликов), деленное на количество показов товаров (показов). Метрика.
`conversions`	`double` Количество конверсий, связанных с продуктом, зарегистрированное на дату конверсии. В зависимости от модели атрибуции конверсия может распределяться по нескольким кликам, при этом каждому клику присваивается своя ценность. Эта метрика представляет собой сумму всех таких кредитов. Метрика. Доступно только для `FREE` источника трафика.
`conversion_ rate`	`double` Количество конверсий, разделенное на количество кликов, зарегистрированное на дату показа. Метрика. Доступно только для `FREE` источника трафика.

Просмотр продукта

Поля, доступные для запроса в таблице product_view .

Товары в текущем наличии. Продукты в этой таблице такие же, как в суб-API «Продукты», но не все атрибуты продуктов из суб-API «Продукты» доступны для запроса в этой таблице. В отличие от суб-API «Продукты», эта таблица позволяет фильтровать возвращаемый список продуктов по атрибутам продукта. Чтобы получить один продукт по id или перечислить все продукты, следует использовать субAPI продуктов.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

Поля
`price`	`Price` Цена продукта. Отсутствует, если информация о цене товара отсутствует.
`gtin[]`	`string` Список глобальных номеров торговых позиций (GTIN) продукта.
`creation_ time`	`Timestamp` Время, когда продавец создал товар в секундах.
`expiration_ date`	`Date` Срок годности продукта указан при вставке.
`item_ issues[]`	`ItemIssue` Список проблем с продуктом. Это поле нельзя использовать для сортировки результатов. Для фильтрации результатов можно использовать только выбранные атрибуты этого поля (например, `item_issues.severity.aggregated_severity` ).
`click_ potential`	`ClickPotential` Предполагаемый потенциал производительности по сравнению с наиболее эффективными продуктами продавца.
`id`	`string` REST ID продукта в форме `channel~languageCode~feedLabel~offerId` . Методы Merchant API, которые работают с продуктами, принимают это значение в качестве параметра `name` . Требуется в предложении `SELECT` .
`channel`	`ChannelEnum` Канал продукта. Может быть `ONLINE` или `LOCAL` .
`language_ code`	`string` Код языка продукта в формате BCP 47.
`feed_ label`	`string` Кормовая этикетка продукта.
`offer_ id`	`string` Идентификатор товара, предоставленный продавцом.
`title`	`string` Название продукта.
`brand`	`string` Бренд продукта.
`category_ l1`	`string` Категория продукта (1-й уровень) в таксономии продуктов Google .
`category_ l2`	`string` Категория продукта (2-й уровень) в таксономии продуктов Google .
`category_ l3`	`string` Категория продукта (3-й уровень) в таксономии продуктов Google .
`category_ l4`	`string` Категория продукта (4-й уровень) в таксономии продуктов Google .
`category_ l5`	`string` Категория продукта (5-й уровень) в таксономии продуктов Google .
`product_ type_ l1`	`string` Тип продукта (1-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l2`	`string` Тип продукта (2-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l3`	`string` Тип товара (3-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l4`	`string` Тип продукта (4-й уровень) в собственной таксономии товаров продавца.
`product_ type_ l5`	`string` Тип продукта (5-й уровень) в собственной таксономии товаров продавца.
`condition`	`string` Состояние товара.
`availability`	`string` Доступность продукта.
`shipping_ label`	`string` Нормализованная транспортная этикетка, указанная в источнике данных.
`item_ group_ id`	`string` Идентификатор группы товаров, предоставленный продавцом для группировки вариантов.
`thumbnail_ link`	`string` Ссылка на обработанное изображение продукта, размещенное в инфраструктуре Google.
`aggregated_ reporting_ context_ status`	`AggregatedReportingContextStatus` Агрегированный статус.
`click_ potential_ rank`	`int64` Рейтинг продукта на основе его потенциала кликов. Продукт с `click_potential_rank` 1 имеет самый высокий потенциал кликов среди продуктов продавца, соответствующих условиям поискового запроса.

Агрегатерепортингконтекстстатус

Статус продукта, агрегированный для всех контекстов отчетности.

Вот пример того, как вычисляется агрегированный статус:

Бесплатные объявления	Товарные объявления	Статус
Одобренный	Одобренный	ИМЕЮЩИЙ ПРАВО
Одобренный	В ожидании	ИМЕЮЩИЙ ПРАВО
Одобренный	Отклонено	ELIGIBLE_LIMITED
В ожидании	В ожидании	В ОЖИДАНИИ
Отклонено	Отклонено	NOT_ELIGIBLE_OR_DISAPPROVED

Перечисления
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	Не указан.
`NOT_ELIGIBLE_OR_DISAPPROVED`	Продукт не соответствует критериям или отклонен для всех контекстов отчетности.
`PENDING`	Статус продукта ожидает во всех контекстах отчетности.
`ELIGIBLE_LIMITED`	Продукт подходит для некоторых (но не всех) контекстов отчетности.
`ELIGIBLE`	Продукт подходит для всех контекстов отчетности.

КликПотенциал

Потенциал кликов продукта оценивает его потенциал эффективности по сравнению с наиболее эффективными продуктами продавца. Потенциал кликов продукта помогает продавцам расставить приоритеты, какие продукты нужно исправить, и понять, насколько продукты работают в соответствии со своим потенциалом.

Перечисления
`CLICK_POTENTIAL_UNSPECIFIED`	Влияние неизвестных прогнозируемых кликов.
`LOW`	Потенциал получения меньшего количества кликов по сравнению с наиболее эффективными продуктами продавца.
`MEDIUM`	Потенциал получения умеренного количества кликов по сравнению с наиболее эффективными продуктами продавца.
`HIGH`	Потенциал для получения такого же количества кликов, как и у самых эффективных продуктов продавца.

ПредметПроблема

Проблема с товаром, связанная с товаром.

Поля

Поля
`type`	`ItemIssueType` Тип проблемы с товаром.
`severity`	`ItemIssueSeverity` Серьезность проблемы с элементом.
`resolution`	`ItemIssueResolution` Решение проблемы с товаром.

type

ItemIssueType

Тип проблемы с товаром.

severity

ItemIssueSeverity

Серьезность проблемы с элементом.

resolution

ItemIssueResolution

Решение проблемы с товаром.

ПредметПроблемаРешение

Как решить проблему.

Перечисления
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	Не указан.
`MERCHANT_ACTION`	Продавец должен устранить проблему.
`PENDING_PROCESSING`	Проблема будет решена автоматически (например, сканированием изображения) или посредством проверки Google. Никаких действий со стороны продавца теперь не требуется. Решение может привести к другой проблеме (например, в случае сбоя сканирования).

ПунктПроблемаСерьезность

Как проблема влияет на подачу продукта.

Поля

Поля
`severity_ per_ reporting_ context[]`	`IssueSeverityPerReportingContext` Серьезность проблемы в зависимости от контекста отчетности.
`aggregated_ severity`	`AggregatedIssueSeverity` Совокупная серьезность проблемы для всех контекстов отчетности, на которые она влияет. Это поле можно использовать для фильтрации результатов.

severity_ per_ reporting_ context[]

IssueSeverityPerReportingContext

Серьезность проблемы в зависимости от контекста отчетности.

aggregated_ severity

AggregatedIssueSeverity

Совокупная серьезность проблемы для всех контекстов отчетности, на которые она влияет.

Это поле можно использовать для фильтрации результатов.

AggregatedIssueSeverity

Серьезность проблемы агрегирована для всех контекстов отчетности.

Перечисления
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	Не указан.
`DISAPPROVED`	Проблема отклоняет продукт как минимум в одном контексте отчетности.
`DEMOTED`	Проблема снижает рейтинг продукта во всех контекстах отчетности, на которые она влияет.
`PENDING`	Разрешение проблемы: `PENDING_PROCESSING` .

ПроблемаSeverityPerReportingContext

Серьезность проблемы в зависимости от контекста отчетности.

Поля

Поля
`disapproved_ countries[]`	`string` Список отклоненных стран в контексте отчетности, представленный в формате ISO 3166.
`demoted_ countries[]`	`string` Список пониженных стран в контексте отчетности, представленный в формате ISO 3166.
`reporting_ context`	`ReportingContextEnum` Контекст отчета, к которому относится проблема.

disapproved_ countries[]

string

Список отклоненных стран в контексте отчетности, представленный в формате ISO 3166.

demoted_ countries[]

string

Список пониженных стран в контексте отчетности, представленный в формате ISO 3166.

reporting_ context

ReportingContextEnum

Контекст отчета, к которому относится проблема.

ItemIssueType

Тип проблемы.

Поля

Поля
`code`	`string` Код ошибки проблемы, эквивалентный `code` проблемы с Продуктом .
`canonical_ attribute`	`string` Каноническое имя атрибута для проблем, связанных с атрибутом.

code

string

Код ошибки проблемы, эквивалентный code проблемы с Продуктом .

canonical_ attribute

string

Каноническое имя атрибута для проблем, связанных с атрибутом.

Относительный спрос

Этот тип не имеет полей.

Относительный спрос на продуктовый кластер или бренд в отчете «Бестселлеры».

ОтносительныйДеманденум

Относительные значения спроса.

Перечисления
`RELATIVE_DEMAND_ENUM_UNSPECIFIED`	Не указан.
`VERY_LOW`	Спрос составляет 0–5% от спроса продуктового кластера или бренда с самым высоким рейтингом.
`LOW`	Спрос составляет 6-10% от спроса продуктового кластера или бренда с самым высоким рейтингом.
`MEDIUM`	Спрос составляет 11-20% от спроса продуктового кластера или бренда с самым высоким рейтингом.
`HIGH`	Спрос составляет 21–50% от спроса продуктового кластера или бренда с самым высоким рейтингом.
`VERY_HIGH`	Спрос составляет 51-100% спроса товарного кластера или бренда с самым высоким рейтингом.

Тип относительного спроса

Этот тип не имеет полей.

Относительный спрос на группу продуктов или бренд в отчете «Бестселлеры» по сравнению с предыдущим периодом времени.

ОтносительныйDemandChangeTypeEnum

Значения типа изменения относительного спроса.

Перечисления
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	Не указан.
`SINKER`	Относительный спрос ниже, чем в предыдущий период времени.
`FLAT`	Относительный спрос равен предыдущему периоду времени.
`RISER`	Относительный спрос выше, чем в предыдущий период времени.

Детализация отчета

Этот тип не имеет полей.

Детализация отчета о бестселлерах. Отчеты о бестселлерах рассчитываются за неделю и месяц.

ОтчетГранулярностьEnum

Сообщите значения детализации.

Перечисления
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	Не указан.
`WEEKLY`	Отчет рассчитывается за недельный период.
`MONTHLY`	Отчет рассчитывается за месячный период.

Строка отчета

Строка результата, полученная из поискового запроса.

В ответе заполняется только сообщение, соответствующее запрашиваемой таблице. В заполненном сообщении заполняются только поля, явно запрошенные в запросе.

Поля
`product_ performance_ view`	`ProductPerformanceView` Поля, доступные для запроса в таблице `product_performance_view` .
`non_ product_ performance_ view`	`NonProductPerformanceView` Поля, доступные для запроса в таблице `non_product_performance_view` .
`product_ view`	`ProductView` Поля, доступные для запроса в таблице `product_view` .
`price_ competitiveness_ product_ view`	`PriceCompetitivenessProductView` Поля, доступные для запроса в таблице `price_competitiveness_product_view` .
`price_ insights_ product_ view`	`PriceInsightsProductView` Поля, доступные для запроса в таблице `price_insights_product_view` .
`best_ sellers_ product_ cluster_ view`	`BestSellersProductClusterView` Поля, доступные для запроса в таблице `best_sellers_product_cluster_view` .
`best_ sellers_ brand_ view`	`BestSellersBrandView` Поля, доступные для запроса в таблице `best_sellers_brand_view` .
`competitive_ visibility_ competitor_ view`	`CompetitiveVisibilityCompetitorView` Поля, доступные для запроса в таблице `competitive_visibility_competitor_view` .
`competitive_ visibility_ top_ merchant_ view`	`CompetitiveVisibilityTopMerchantView` Поля, доступные для запроса в таблице `competitive_visibility_top_merchant_view` .
`competitive_ visibility_ benchmark_ view`	`CompetitiveVisibilityBenchmarkView` Поля, доступные для запроса в таблице `competitive_visibility_benchmark_view` .

ПоискЗапрос

Сообщение запроса для метода ReportService.Search .

Поля
`parent`	`string` Необходимый. Идентификатор аккаунта, с которого осуществляется звонок. Должен быть отдельным аккаунтом или субаккаунтом MCA. Формат: аккаунты/{аккаунт}
`query`	`string` Необходимый. Запрос, определяющий извлекаемый отчет. Подробную информацию о том, как составить запрос, см. в руководстве по языку запросов. Полный список доступных таблиц и полей см. в разделе Доступные поля.
`page_ size`	`int32` Необязательный. Количество `ReportRows` , которые нужно получить на одной странице. По умолчанию — 1000. Значения выше 5000 приводятся к 5000.
`page_ token`	`string` Необязательный. Токен страницы, которую нужно получить. Если не указано, возвращается первая страница результатов. Чтобы запросить следующую страницу результатов, следует использовать значение, полученное из `next_page_token` в предыдущем ответе.

ПоискОтвет

Ответное сообщение для метода ReportService.Search .

Поля

Поля
`results[]`	`ReportRow` Строки, соответствующие поисковому запросу.
`next_ page_ token`	`string` Токен, который можно отправить как `page_token` для получения следующей страницы. Если этот параметр опущен, последующие страницы отсутствуют.

results[]

ReportRow

Строки, соответствующие поисковому запросу.

next_ page_ token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если этот параметр опущен, последующие страницы отсутствуют.

Источник трафика

Этот тип не имеет полей.

Источник трафика показов в отчете «Конкурентная видимость».

Трафиксаурцеенум

Значения источника трафика.

Перечисления
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	Не указан.
`ORGANIC`	Органический трафик.
`ADS`	Трафик с рекламы.
`ALL`	Органический и рекламный трафик.

Package google.shopping.merchant.reports.v1beta Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Индекс

Служба отчетов

БестселлерыБрендПросмотреть

БестселлерыПродуктКластерПросмотр

Статус инвентаря

КонкурентныйВидимостьБенчмаркПросмотр

КонкурентныйВидимостьПросмотр конкурента

КонкурентныйVisibilityTopMerchantView

Маркетинговый метод

МаркетингМетодЕнум

NonProductPerformanceView

ЦенаКонкурентоспособностьПродуктПросмотр

PriceInsightsProductView

Эффективность

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

Просмотр продукта

Агрегатерепортингконтекстстатус

КликПотенциал

ПредметПроблема

ПредметПроблемаРешение

ПунктПроблемаСерьезность

AggregatedIssueSeverity

ПроблемаSeverityPerReportingContext

ItemIssueType

Относительный спрос

ОтносительныйДеманденум

Тип относительного спроса

ОтносительныйDemandChangeTypeEnum

Детализация отчета

ОтчетГранулярностьEnum

Строка отчета

ПоискЗапрос

ПоискОтвет

Источник трафика

Трафиксаурцеенум

Package google.shopping.merchant.reports.v1beta