이 페이지는 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(열거형)

ReportService

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를 참고하세요.

BestSellersBrandView

best_sellers_brand_view 테이블에서 쿼리할 수 있는 필드입니다.

인기 브랜드가 포함된 베스트셀러 보고서

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`report_date`	`Date` 보고서 날짜 이 필드의 값은 다음 중 하나일 수 있습니다. 주별 보고서의 경우 주 첫날 (월요일) 월간 보고서의 경우 매월 1일입니다. `SELECT` 절에서 필요합니다. 쿼리에서 `report_date`의 `WHERE` 조건이 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
`report_granularity`	`ReportGranularityEnum` 보고서의 세부사항입니다. 순위는 1주 또는 1개월 동안 이루어질 수 있습니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_granularity`에 관한 조건이 필요합니다.
`report_country_code`	`string` 순위가 계산되는 국가입니다. ISO 3166 형식으로 표시됩니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_country_code`에 관한 조건이 필요합니다.
`report_category_id`	`int64` 순위를 계산하는 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다. `SELECT` 절에서 필요합니다. 쿼리에 `report_category_id`의 `WHERE` 조건이 지정되지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.
`brand`	`string` 브랜드 이름입니다.
`rank`	`int64` 예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 결과에 표시된 브랜드의 인기도입니다.
`previous_rank`	`int64` 지난주 또는 지난달의 인기도 순위입니다.
`relative_demand`	`RelativeDemandEnum` 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
`previous_relative_demand`	`RelativeDemandEnum` 이전 주 또는 월에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
`relative_demand_change`	`RelativeDemandChangeTypeEnum` 예상 수요의 변동입니다. 상승, 하락 또는 보합 상태인지 여부

BestSellersProductClusterView

best_sellers_product_cluster_view 테이블에서 쿼리할 수 있는 필드입니다.

인기 제품 클러스터가 포함된 베스트셀러 보고서 제품 클러스터는 동일한 제품(예: Google Pixel 7)을 나타내는 다양한 제품 및 옵션의 그룹입니다.

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`report_date`	`Date` 보고서 날짜 이 필드의 값은 다음 중 하나일 수 있습니다. 주별 보고서의 경우 주 첫날 (월요일) 월간 보고서의 경우 매월 1일입니다. `SELECT` 절에서 필요합니다. 쿼리에서 `report_date`의 `WHERE` 조건이 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
`variant_gtins[]`	`string` 제품 클러스터의 예시 옵션의 GTIN입니다.
`report_granularity`	`ReportGranularityEnum` 보고서의 세부사항입니다. 순위는 1주 또는 1개월 동안 이루어질 수 있습니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_granularity`에 관한 조건이 필요합니다.
`report_country_code`	`string` 순위가 계산되는 국가입니다. ISO 3166 형식으로 표시됩니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_country_code`에 관한 조건이 필요합니다.
`report_category_id`	`int64` 순위를 계산하는 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다. `SELECT` 절에서 필요합니다. 쿼리에 `report_category_id`의 `WHERE` 조건이 지정되지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.
`title`	`string` 제품 클러스터의 제목입니다.
`brand`	`string` 제품 클러스터의 브랜드입니다.
`category_l1`	`string` Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (1단계)입니다.
`category_l2`	`string` Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (2단계)입니다.
`category_l3`	`string` Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (3단계)입니다.
`category_l4`	`string` Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (4단계)입니다.
`category_l5`	`string` Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (5단계)입니다.
`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` 예상 수요의 변동입니다. 상승, 하락 또는 보합 상태인지 여부

InventoryStatus

인벤토리의 제품 클러스터 또는 브랜드 상태입니다.

열거형
`INVENTORY_STATUS_UNSPECIFIED`	지정되지 않음
`IN_STOCK`	이 제품 클러스터 또는 브랜드의 제품이 재고에 있습니다.
`OUT_OF_STOCK`	인벤토리에 이 제품 클러스터 또는 브랜드의 제품이 있지만 현재 재고가 없습니다.
`NOT_IN_INVENTORY`	인벤토리에 이 제품 클러스터 또는 브랜드의 제품이 없습니다.

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view 테이블에서 쿼리할 수 있는 필드입니다.

카테고리 벤치마크가 포함된 노출 경쟁 보고서

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`date`	`Date` 이 행의 날짜입니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `date`에 관한 조건이 필요합니다.
`report_country_code`	`string` 노출이 발생한 국가입니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_country_code`에 관한 조건이 필요합니다.
`report_category_id`	`int64` 보고서를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다. `SELECT` 절에서 필요합니다. `WHERE` 절에는 `report_category_id`에 관한 조건이 필요합니다.
`traffic_source`	`TrafficSourceEnum` 노출의 트래픽 소스입니다. `SELECT` 절에서 필요합니다.
`your_domain_visibility_trend`	`double` 선택한 기간의 시작일 (또는 노출수가 0이 아닌 첫 번째 날)을 기준으로 도메인의 노출수를 기준으로 한 노출 가능성의 변화입니다. 'WHERE' 절에서 필터링할 수 없습니다.
`category_benchmark_visibility_trend`	`double` 시장에서 가장 높은 노출률을 기록한 판매자 집합을 기준으로 선택한 기간의 시작일 (또는 노출수가 0이 아닌 첫 번째 날)과 관련하여 노출수를 기준으로 한 노출률의 변화입니다. 'WHERE' 절에서 필터링할 수 없습니다.

CompetitiveVisibilityCompetitorView

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 제품 카테고리 ID로, 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' 절에서 필터링할 수 없습니다.

CompetitiveVisibilityTopMerchantView

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 제품 카테고리 ID로, 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' 절에서 필터링할 수 없습니다.

MarketingMethod

이 유형에는 필드가 없습니다.

Google에서 제품을 홍보하는 데 사용되는 마케팅 방법 (자연 검색 vs. 광고)

MarketingMethodEnum

마케팅 방법 값입니다.

열거형
`MARKETING_METHOD_ENUM_UNSPECIFIED`	지정되지 않음
`ORGANIC`	자연 검색 결과 마케팅
`ADS`	광고 기반 마케팅

NonProductPerformanceView

non_product_performance_view 테이블에서 쿼리할 수 있는 필드입니다.

제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 실적 데이터입니다. 여기에는 실적 측정항목 (예: clicks)과 실적 측정항목이 분류되는 측정기준 (예: date)이 포함됩니다.

측정항목 필드를 하나 이상 선택하지 않으면 쿼리에서 세그먼트 필드를 선택할 수 없습니다.

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`date`	`Date` 측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준 `WHERE` 절에는 `date`에 관한 조건이 필요합니다.
`week`	`Date` 판매자 시간대의 측정항목 날짜의 첫째 날 (월요일)입니다. 분류 기준
`clicks`	`int64` 제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 클릭수입니다. 측정항목
`impressions`	`int64` 제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크가 표시된 횟수입니다. 측정항목
`click_through_rate`	`double` 클릭률: 제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 클릭수 (`clicks`)를 노출수 (`impressions`)로 나눈 값입니다. 측정항목

PriceCompetitivenessProductView

price_competitiveness_product_view 테이블에서 쿼리할 수 있는 필드입니다.

가격 경쟁력 보고서

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`price`	`Price` 제품의 현재 가격입니다.
`benchmark_price`	`Price` 기준 국가의 제품 카탈로그에 대해 사용 가능한 최신 가격 벤치마크입니다.
`report_country_code`	`string` 가격 벤치마크의 국가입니다. ISO 3166 형식으로 표시됩니다. `SELECT` 절에서 필요합니다.
`id`	`string` `channel~languageCode~feedLabel~offerId` 형식의 제품 REST ID입니다. 데이터를 `product_view` 테이블과 조인하는 데 사용할 수 있습니다. `SELECT` 절에서 필요합니다.
`offer_id`	`string` 판매자가 제공한 제품 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`category_l1`	`string` Google 상품 분류의 제품 카테고리 (1단계)입니다.
`category_l2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`category_l3`	`string` Google 상품 분류의 제품 카테고리 (3단계)입니다.
`category_l4`	`string` Google 상품 분류의 제품 카테고리 (4단계)입니다.
`category_l5`	`string` Google 상품 분류의 제품 카테고리 (5단계)입니다.
`product_type_l1`	`string` 판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
`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` `channel~languageCode~feedLabel~offerId` 형식의 제품 REST ID입니다. 데이터를 `product_view` 테이블과 조인하는 데 사용할 수 있습니다. `SELECT` 절에서 필요합니다.
`offer_id`	`string` 판매자가 제공한 제품 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`category_l1`	`string` Google 상품 분류의 제품 카테고리 (1단계)입니다.
`category_l2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`category_l3`	`string` Google 상품 분류의 제품 카테고리 (3단계)입니다.
`category_l4`	`string` Google 상품 분류의 제품 카테고리 (4단계)입니다.
`category_l5`	`string` Google 상품 분류의 제품 카테고리 (5단계)입니다.
`product_type_l1`	`string` 판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
`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`	효과성이 높습니다.

ProductPerformanceView

product_performance_view 테이블에서 쿼리할 수 있는 필드입니다.

실적 측정항목 (예: clicks) 및 실적 측정항목이 분류되는 측정기준 (예: offer_id)을 비롯한 계정의 제품 실적 데이터입니다. offer_id와 같은 제품 측정기준의 값은 노출 시 제품의 상태를 반영합니다.

측정항목 필드를 하나 이상 선택하지 않으면 쿼리에서 세그먼트 필드를 선택할 수 없습니다.

값은 요청의 검색 쿼리에서 명시적으로 요청된 필드에 대해서만 설정됩니다.

필드
`date`	`Date` 측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준 `WHERE` 절에는 `date`에 관한 조건이 필요합니다.
`week`	`Date` 판매자 시간대의 측정항목 날짜의 첫째 날 (월요일)입니다. 분류 기준
`conversion_value`	`Price` 전환 날짜에 보고된 제품에 기여한 전환 가치입니다. 측정항목 `FREE` 트래픽 소스에서만 사용할 수 있습니다.
`marketing_method`	`MarketingMethodEnum` 측정항목이 적용되는 마케팅 방법입니다. 분류 기준
`customer_country_code`	`string` 이벤트 발생 시 고객이 거주 중인 국가의 코드입니다. ISO 3166 형식으로 표시됩니다. 분류 기준 고객 국가를 확인할 수 없는 경우 특수 'ZZ' 코드가 반환됩니다.
`offer_id`	`string` 판매자가 제공한 제품 ID입니다. 분류 기준
`title`	`string` 제품의 이름입니다. 분류 기준
`brand`	`string` 제품의 브랜드입니다. 분류 기준
`category_l1`	`string` Google 상품 분류의 제품 카테고리 (1단계)입니다. 분류 기준
`category_l2`	`string` Google 상품 분류의 제품 카테고리 (2단계)입니다. 분류 기준
`category_l3`	`string` Google 상품 분류의 제품 카테고리 (3단계)입니다. 분류 기준
`category_l4`	`string` Google 상품 분류의 제품 카테고리 (4단계)입니다. 분류 기준
`category_l5`	`string` Google 상품 분류의 제품 카테고리 (5단계)입니다. 분류 기준
`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` 트래픽 소스에서만 사용할 수 있습니다.

ProductView

product_view 테이블에서 쿼리할 수 있는 필드입니다.

현재 인벤토리에 있는 제품입니다. 이 표의 제품은 Products 하위 API의 제품과 동일하지만 Products 하위 API의 일부 제품 속성은 이 표에서 쿼리할 수 없습니다. Products 하위 API와 달리 이 표를 사용하면 반환된 제품 목록을 제품 속성별로 필터링할 수 있습니다. id로 단일 제품을 검색하거나 모든 제품을 나열하려면 Products 하위 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` `channel~languageCode~feedLabel~offerId` 형식의 제품 REST ID입니다. 제품을 운영하는 Merchant API 메서드는 이를 `name` 매개변수로 사용합니다. `SELECT` 절에서 필요합니다.
`channel`	`ChannelEnum` 제품의 채널입니다. `ONLINE` 또는 `LOCAL`일 수 있습니다.
`language_code`	`string` 제품의 언어 코드입니다(BCP 47 형식).
`feed_label`	`string` 제품의 피드 라벨입니다.
`offer_id`	`string` 판매자가 제공한 제품 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`category_l1`	`string` Google 상품 분류의 제품 카테고리 (1단계)입니다.
`category_l2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`category_l3`	`string` Google 상품 분류의 제품 카테고리 (3단계)입니다.
`category_l4`	`string` Google 상품 분류의 제품 카테고리 (4단계)입니다.
`category_l5`	`string` Google 상품 분류의 제품 카테고리 (5단계)입니다.
`product_type_l1`	`string` 판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
`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` 판매자가 옵션을 그룹화하기 위해 제공한 상품 그룹 ID입니다.
`thumbnail_link`	`string` Google 인프라에 호스팅된 제품의 처리된 이미지로 연결되는 링크입니다.
`aggregated_reporting_context_status`	`AggregatedReportingContextStatus` 집계된 상태입니다.
`click_potential_rank`	`int64` 클릭 가능성을 기준으로 한 제품 순위입니다. `click_potential_rank`이 1인 제품은 검색어 조건을 충족하는 판매자의 제품 중 클릭 가능성이 가장 높습니다.

AggregatedReportingContextStatus

모든 보고 컨텍스트에서 집계된 제품 상태입니다.

다음은 집계된 상태가 계산되는 방식의 예입니다.

무료 등록정보	쇼핑 광고	상태
승인됨	승인됨	운영 가능
승인됨	대기 중	운영 가능
승인됨	비승인	ELIGIBLE_LIMITED
대기 중	대기 중	대기 중
비승인	비승인	NOT_ELIGIBLE_OR_DISAPPROVED

열거형
`AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED`	지정되지 않음
`NOT_ELIGIBLE_OR_DISAPPROVED`	제품이 모든 보고 컨텍스트에 적합하지 않거나 비승인되었습니다.
`PENDING`	모든 보고 컨텍스트에서 제품 상태가 대기 중입니다.
`ELIGIBLE_LIMITED`	제품이 일부 보고 컨텍스트에서만 사용할 수 있습니다.
`ELIGIBLE`	제품이 모든 보고 컨텍스트에 적합합니다.

ClickPotential

제품의 클릭 가능성은 판매자의 실적이 가장 우수한 제품과 비교하여 예상 실적을 예측합니다. 제품의 클릭 가능성을 통해 판매자는 수정할 제품의 우선순위를 정하고 제품의 잠재력 대비 실적을 파악할 수 있습니다.

열거형
`CLICK_POTENTIAL_UNSPECIFIED`	알 수 없는 예상 클릭수 영향
`LOW`	판매자의 실적이 가장 우수한 제품에 비해 클릭수가 적게 발생할 가능성이 있습니다.
`MEDIUM`	판매자의 실적이 가장 우수한 제품에 비해 보통 수준의 클릭수가 발생할 가능성이 있습니다.
`HIGH`	판매자의 실적이 가장 우수한 제품과 유사한 클릭수가 발생할 가능성이 있습니다.

ItemIssue

제품과 관련된 상품 문제입니다.

필드

필드
`type`	`ItemIssueType` 상품 문제 유형입니다.
`severity`	`ItemIssueSeverity` 상품 문제 심각도입니다.
`resolution`	`ItemIssueResolution` 상품 문제 해결

type

ItemIssueType

상품 문제 유형입니다.

severity

ItemIssueSeverity

상품 문제 심각도입니다.

resolution

ItemIssueResolution

상품 문제 해결

ItemIssueResolution

문제 해결 방법

열거형
`ITEM_ISSUE_RESOLUTION_UNSPECIFIED`	지정되지 않음
`MERCHANT_ACTION`	판매자가 문제를 해결해야 합니다.
`PENDING_PROCESSING`	문제는 자동으로 해결되거나 (예: 이미지 크롤링) Google 검토를 통해 해결됩니다. 지금은 판매자가 취해야 할 조치가 없습니다. 해결 과정에서 다른 문제가 발생할 수 있습니다 (예: 크롤링 실패).

ItemIssueSeverity

이 문제가 제품 게재에 미치는 영향

필드

필드
`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`입니다.

IssueSeverityPerReportingContext

보고 컨텍스트별 문제 심각도

필드

필드
`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

속성별 문제의 표준 속성 이름입니다.

RelativeDemand

이 유형에는 필드가 없습니다.

베스트셀러 보고서의 제품 클러스터 또는 브랜드에 대한 상대 수요입니다.

RelativeDemandEnum

상대적 수요 값

열거형
`RELATIVE_DEMAND_ENUM_UNSPECIFIED`	지정되지 않음
`VERY_LOW`	수요가 순위가 가장 높은 제품 클러스터 또는 브랜드의 수요의 0~5% 에 해당합니다.
`LOW`	수요가 순위가 가장 높은 제품 클러스터 또는 브랜드의 수요의 6~10% 에 해당하는 제품
`MEDIUM`	수요가 순위가 가장 높은 제품 클러스터 또는 브랜드의 수요의 11~20% 에 해당합니다.
`HIGH`	수요가 순위가 가장 높은 제품 클러스터 또는 브랜드의 수요의 21~50% 에 해당합니다.
`VERY_HIGH`	수요가 순위가 가장 높은 제품 클러스터 또는 브랜드의 수요의 51~100% 에 해당합니다.

RelativeDemandChangeType

이 유형에는 필드가 없습니다.

이전 기간과 비교한 베스트셀러 보고서의 제품 클러스터 또는 브랜드의 상대 수요입니다.

RelativeDemandChangeTypeEnum

상대적 수요 변동 유형 값입니다.

열거형
`RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED`	지정되지 않음
`SINKER`	상대적 수요가 이전 기간보다 낮습니다.
`FLAT`	상대적 수요는 이전 기간과 같습니다.
`RISER`	상대적 수요가 이전 기간보다 높습니다.

ReportGranularity

이 유형에는 필드가 없습니다.

베스트셀러 보고서의 세부사항 베스트셀러 보고서는 1주일 및 1개월 기간에 걸쳐 계산됩니다.

ReportGranularityEnum

세부사항 값을 보고합니다.

열거형
`REPORT_GRANULARITY_ENUM_UNSPECIFIED`	지정되지 않음
`WEEKLY`	보고서는 1주일 동안 계산됩니다.
`MONTHLY`	보고서는 한 달 동안 계산됩니다.

ReportRow

검색 쿼리에서 반환된 결과 행입니다.

쿼리된 테이블에 해당하는 메시지만 응답에 채워집니다. 채워진 메시지 내에서 쿼리에서 명시적으로 요청된 필드만 채워집니다.

필드
`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` 테이블에서 쿼리할 수 있는 필드입니다.

SearchRequest

ReportService.Search 메서드에 대한 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 호출을 실행하는 계정의 ID입니다. 독립형 계정 또는 MCA 하위 계정이어야 합니다. 형식: accounts/{account}
`query`	`string` 필수 항목입니다. 검색할 보고서를 정의하는 쿼리입니다. 쿼리를 구성하는 방법에 관한 자세한 내용은 쿼리 언어 가이드를 참고하세요. 사용 가능한 테이블 및 필드의 전체 목록은 사용 가능한 필드를 참고하세요.
`page_size`	`int32` 선택사항입니다. 단일 페이지에서 검색할 `ReportRows` 수입니다. 기본값은 1000입니다. 5,000을 초과하는 값은 5,000으로 변환됩니다.
`page_token`	`string` 선택사항입니다. 가져올 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 번째 페이지가 반환됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 `next_page_token`에서 가져온 값을 사용해야 합니다.

SearchResponse

ReportService.Search 메서드에 대한 응답 메시지입니다.

필드

필드
`results[]`	`ReportRow` 검색어와 일치하는 행입니다.
`next_page_token`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 생략하면 후속 페이지가 표시되지 않습니다.

results[]

ReportRow

검색어와 일치하는 행입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 생략하면 후속 페이지가 표시되지 않습니다.

TrafficSource

이 유형에는 필드가 없습니다.

노출 경쟁 보고서의 노출 트래픽 소스입니다.

TrafficSourceEnum

트래픽 소스 값

열거형
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	지정되지 않음
`ORGANIC`	자연 트래픽
`ADS`	광고에서 발생한 트래픽
`ALL`	자연 및 광고 트래픽

Package google.shopping.merchant.reports.v1beta 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

색인

ReportService

BestSellersBrandView

BestSellersProductClusterView

InventoryStatus

CompetitiveVisibilityBenchmarkView

CompetitiveVisibilityCompetitorView

CompetitiveVisibilityTopMerchantView

MarketingMethod

MarketingMethodEnum

NonProductPerformanceView

PriceCompetitivenessProductView

PriceInsightsProductView

효과

ProductPerformanceView

ProductView

AggregatedReportingContextStatus

ClickPotential

ItemIssue

ItemIssueResolution

ItemIssueSeverity

AggregatedIssueSeverity

IssueSeverityPerReportingContext

ItemIssueType

RelativeDemand

RelativeDemandEnum

RelativeDemandChangeType

RelativeDemandChangeTypeEnum

ReportGranularity

ReportGranularityEnum

ReportRow

SearchRequest

SearchResponse

TrafficSource

TrafficSourceEnum

Package google.shopping.merchant.reports.v1beta