Package google.shopping.merchant.reports.v1beta

Индекс

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

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

Поиск

rpc Search( SearchRequest ) returns ( SearchResponse )

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

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

Поля, доступные для запроса в таблице 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

Идентификатор группы товаров, предоставленный продавцом для группировки вариантов.

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

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

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

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

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

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

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

Поля
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

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

ItemIssueType

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

Поля
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 для получения следующей страницы. Если этот параметр опущен, последующие страницы отсутствуют.

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

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

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

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

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

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