이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: accounts.reports.search

HTTP 요청
경로 매개변수
요청 본문
- JSON 표현
응답 본문
- JSON 표현
승인 범위
ReportRow
- JSON 표현
ProductPerformanceView
- JSON 표현
MarketingMethodEnum
NonProductPerformanceView
- JSON 표현
ProductView
- JSON 표현
AggregatedReportingContextStatus
ItemIssue(상품 문제)
- JSON 표현
ItemIssueType
- JSON 표현
ItemIssueSeverity
- JSON 표현
IssueSeverityPerReportingContext
- JSON 표현
AggregatedIssueSeverity
ItemIssueResolution
ClickPotential
PriceCompetitivenessProductView
- JSON 표현
PriceInsightsProductView
- JSON 표현
효과
BestSellersProductClusterView
- JSON 표현
ReportGranularityEnum
InventoryStatus
RelativeDemandEnum
RelativeDemandChangeTypeEnum
BestSellersBrandView
- JSON 표현
CompetitiveVisibilityCompetitorView
- JSON 표현
TrafficSourceEnum
CompetitiveVisibilityTopMerchantView
- JSON 표현
CompetitiveVisibilityBenchmarkView
- JSON 표현

검색어로 정의된 보고서를 검색합니다. 응답에 pageSize에서 지정된 것보다 적은 수의 행이 포함될 수 있습니다. nextPageToken를 사용하여 요청할 행이 더 있는지 확인합니다.

HTTP 요청

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수

매개변수
`parent`	`string` 필수 항목입니다. 호출 중인 계정의 ID입니다. 독립형 계정 또는 MCA 하위 계정이어야 합니다. 형식: accounts/{account}

parent

string

필수 항목입니다. 호출 중인 계정의 ID입니다. 독립형 계정 또는 MCA 하위 계정이어야 합니다. 형식: accounts/{account}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{ "query": string, "pageSize": integer, "pageToken": string }

입력란

입력란
`query`	`string` 필수 항목입니다. 가져올 보고서를 정의하는 쿼리입니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 쿼리 언어 가이드를 참조하세요. 사용 가능한 테이블 및 필드의 전체 목록은 사용 가능한 필드를 참조하세요.
`pageSize`	`integer` 선택사항입니다. 한 페이지에서 가져올 `ReportRows` 수입니다. 기본값은 1000입니다. 5,000 이상의 값은 5,000으로 강제 변환됩니다.
`pageToken`	`string` 선택사항입니다. 검색할 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 반환됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 `nextPageToken`에서 가져온 값을 사용해야 합니다.

query

string

필수 항목입니다. 가져올 보고서를 정의하는 쿼리입니다.

쿼리를 구성하는 방법에 대한 자세한 내용은 쿼리 언어 가이드를 참조하세요. 사용 가능한 테이블 및 필드의 전체 목록은 사용 가능한 필드를 참조하세요.

pageSize

integer

선택사항입니다. 한 페이지에서 가져올 ReportRows 수입니다. 기본값은 1000입니다. 5,000 이상의 값은 5,000으로 강제 변환됩니다.

pageToken

string

선택사항입니다. 검색할 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 반환됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 nextPageToken에서 가져온 값을 사용해야 합니다.

응답 본문

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

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{ "results": [ { object (`ReportRow`) } ], "nextPageToken": string }

입력란

입력란
`results[]`	`object (ReportRow)` 검색어와 일치하는 행입니다.
`nextPageToken`	`string` 다음 페이지를 검색하기 위해 `pageToken`로 전송할 수 있는 토큰입니다. 생략하면 후속 페이지가 표시되지 않습니다.

results[]

object (ReportRow)

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

nextPageToken

string

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

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ReportRow

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

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

JSON 표현

JSON 표현
{ "productPerformanceView": { object (`ProductPerformanceView`) }, "nonProductPerformanceView": { object (`NonProductPerformanceView`) }, "productView": { object (`ProductView`) }, "priceCompetitivenessProductView": { object (`PriceCompetitivenessProductView`) }, "priceInsightsProductView": { object (`PriceInsightsProductView`) }, "bestSellersProductClusterView": { object (`BestSellersProductClusterView`) }, "bestSellersBrandView": { object (`BestSellersBrandView`) }, "competitiveVisibilityCompetitorView": { object (`CompetitiveVisibilityCompetitorView`) }, "competitiveVisibilityTopMerchantView": { object (`CompetitiveVisibilityTopMerchantView`) }, "competitiveVisibilityBenchmarkView": { object (`CompetitiveVisibilityBenchmarkView`) } }

{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}

입력란
`productPerformanceView`	`object (ProductPerformanceView)` `productPerformanceView` 테이블의 쿼리에 사용할 수 있는 필드
`nonProductPerformanceView`	`object (NonProductPerformanceView)` `nonProductPerformanceView` 테이블의 쿼리에 사용할 수 있는 필드
`productView`	`object (ProductView)` `productView` 테이블의 쿼리에 사용할 수 있는 필드
`priceCompetitivenessProductView`	`object (PriceCompetitivenessProductView)` `priceCompetitivenessProductView` 테이블의 쿼리에 사용할 수 있는 필드
`priceInsightsProductView`	`object (PriceInsightsProductView)` `priceInsightsProductView` 테이블의 쿼리에 사용할 수 있는 필드
`bestSellersProductClusterView`	`object (BestSellersProductClusterView)` `bestSellersProductClusterView` 테이블의 쿼리에 사용할 수 있는 필드
`bestSellersBrandView`	`object (BestSellersBrandView)` `bestSellersBrandView` 테이블의 쿼리에 사용할 수 있는 필드
`competitiveVisibilityCompetitorView`	`object (CompetitiveVisibilityCompetitorView)` `competitiveVisibilityCompetitorView` 테이블의 쿼리에 사용할 수 있는 필드
`competitiveVisibilityTopMerchantView`	`object (CompetitiveVisibilityTopMerchantView)` `competitiveVisibilityTopMerchantView` 테이블의 쿼리에 사용할 수 있는 필드
`competitiveVisibilityBenchmarkView`	`object (CompetitiveVisibilityBenchmarkView)` `competitiveVisibilityBenchmarkView` 테이블의 쿼리에 사용할 수 있는 필드

ProductPerformanceView

productPerformanceView 테이블의 쿼리에 사용할 수 있는 필드

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

측정항목 필드를 하나 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.

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

JSON 표현

JSON 표현
{ "date": { object (`Date`) }, "week": { object (`Date`) }, "conversionValue": { object (`Price`) }, "marketingMethod": enum (`MarketingMethodEnum`), "customerCountryCode": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "customLabel0": string, "customLabel1": string, "customLabel2": string, "customLabel3": string, "customLabel4": string, "clicks": string, "impressions": string, "clickThroughRate": number, "conversions": number, "conversionRate": number }

{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}

입력란
`date`	`object (Date)` 측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준 `WHERE` 절에는 `date` 조건이 필요합니다.
`week`	`object (Date)` 판매자 시간대의 측정항목 날짜의 첫 번째 요일 (월요일)입니다. 분류 기준
`conversionValue`	`object (Price)` 전환 날짜에 보고된 제품으로 인해 발생한 전환 가치입니다. 측정항목 `FREE` 트래픽 소스에만 사용할 수 있습니다.
`marketingMethod`	`enum (MarketingMethodEnum)` 측정항목이 적용되는 마케팅 방법입니다. 분류 기준
`customerCountryCode`	`string` 이벤트 발생 시점에 고객이 거주하는 국가의 코드입니다. ISO 3166 형식으로 표현됩니다. 분류 기준 고객 국가를 확인할 수 없는 경우 특별한 'ZZ' 코드가 반환됩니다.
`offerId`	`string` 판매자가 제공한 제품의 ID입니다. 분류 기준
`title`	`string` 제품의 이름입니다. 분류 기준
`brand`	`string` 제품의 브랜드입니다. 분류 기준
`categoryL1`	`string` Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. 분류 기준
`categoryL2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. 분류 기준
`categoryL3`	`string` Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. 분류 기준
`categoryL4`	`string` Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. 분류 기준
`categoryL5`	`string` Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. 분류 기준
`productTypeL1`	`string` 판매자 자체 상품 분류의 제품 유형 (첫 번째 수준)입니다. 분류 기준
`productTypeL2`	`string` 판매자 자체 상품 분류의 제품 유형 (두 번째 수준)입니다. 분류 기준
`productTypeL3`	`string` 판매자 자체 상품 분류의 제품 유형 (세 번째 수준)입니다. 분류 기준
`productTypeL4`	`string` 판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다. 분류 기준
`productTypeL5`	`string` 판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다. 분류 기준
`customLabel0`	`string` 제품의 맞춤 그룹화를 위한 맞춤 라벨 0입니다. 분류 기준
`customLabel1`	`string` 제품의 맞춤 그룹화를 위한 맞춤 라벨 1입니다. 분류 기준
`customLabel2`	`string` 제품의 맞춤 그룹화를 위한 맞춤 라벨 2입니다. 분류 기준
`customLabel3`	`string` 제품의 맞춤 그룹화를 위한 맞춤 라벨 3입니다. 분류 기준
`customLabel4`	`string` 제품의 맞춤 그룹화를 위한 맞춤 라벨 4입니다. 분류 기준
`clicks`	`string (int64 format)` 클릭수입니다. 측정항목
`impressions`	`string (int64 format)` 판매자의 제품이 표시된 횟수입니다. 측정항목
`clickThroughRate`	`number` 클릭률: 판매자의 제품에서 발생한 클릭수 (클릭수)를 제품이 표시된 횟수 (노출수)로 나눈 값입니다. 측정항목
`conversions`	`number` 전환 날짜에 보고된 제품으로 인해 발생한 전환수입니다. 기여 분석 모델에 따라 전환은 여러 클릭에 분산될 수 있으며, 이때 각 클릭에는 자체 크레딧이 할당됩니다. 이 측정항목은 이러한 모든 크레딧의 합계입니다. 측정항목 `FREE` 트래픽 소스에만 사용할 수 있습니다.
`conversionRate`	`number` 노출 날짜에 보고된 전환수를 클릭수로 나눈 값입니다. 측정항목 `FREE` 트래픽 소스에만 사용할 수 있습니다.

MarketingMethodEnum

마케팅 메서드 값입니다.

열거형
`MARKETING_METHOD_ENUM_UNSPECIFIED`	지정되지 않았습니다.
`ORGANIC`	자연 마케팅
`ADS`	광고 기반 마케팅.

NonProductPerformanceView

nonProductPerformanceView 테이블의 쿼리에 사용할 수 있는 필드

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

측정항목 필드를 하나 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.

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

JSON 표현
{ "date": { object (`Date`) }, "week": { object (`Date`) }, "clicks": string, "impressions": string, "clickThroughRate": number }

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

ProductView

productView 테이블의 쿼리에 사용할 수 있는 필드

현재 인벤토리의 제품입니다. 이 표의 제품은 제품 하위 API의 제품과 동일하지만 제품 하위 API의 일부 제품 속성을 이 표의 쿼리에 사용할 수 있는 것은 아닙니다. 제품 하위 API와 달리 이 표를 사용하면 반환된 제품 목록을 제품 속성별로 필터링할 수 있습니다. id로 단일 제품을 검색하거나 모든 제품을 나열하려면 제품 하위 API를 사용해야 합니다.

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

JSON 표현

JSON 표현
{ "price": { object (`Price`) }, "gtin": [ string ], "creationTime": string, "expirationDate": { object (`Date`) }, "itemIssues": [ { object (`ItemIssue`) } ], "clickPotential": enum (`ClickPotential`), "id": string, "channel": enum (`ChannelEnum`), "languageCode": string, "feedLabel": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "condition": string, "availability": string, "shippingLabel": string, "itemGroupId": string, "thumbnailLink": string, "aggregatedReportingContextStatus": enum (`AggregatedReportingContextStatus`), "clickPotentialRank": string }

{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}

입력란
`price`	`object (Price)` 제품 가격 제품 가격에 대한 정보가 없는 경우 비어 있습니다.
`gtin[]`	`string` 제품의 국제거래단품식별코드 (GTIN) 목록입니다.
`creationTime`	`string (Timestamp format)` 판매자가 제품을 만든 시간이며 타임스탬프(초)입니다.
`expirationDate`	`object (Date)` 삽입 시 지정된 제품의 만료일입니다.
`itemIssues[]`	`object (ItemIssue)` 제품의 상품 문제 목록입니다. 이 필드는 결과를 정렬하는 데 사용할 수 없습니다. 이 필드에서 선택한 속성 (예: `itemIssues.severity.aggregated_severity`)만 결과 필터링에 사용할 수 있습니다.
`clickPotential`	`enum (ClickPotential)` 판매자의 실적이 가장 우수한 제품과 비교한 예상 실적입니다.
`id`	`string` 제품의 REST ID로, `channel~languageCode~feedLabel~offerId` 형식입니다. 제품에서 작동하는 판매자 API 메서드는 이를 `name` 매개변수로 사용합니다. `SELECT` 절에 필요합니다.
`channel`	`enum (ChannelEnum)` 제품의 채널입니다. `ONLINE` 또는 `LOCAL`일 수 있습니다.
`languageCode`	`string` BCP 47 형식의 제품 언어 코드입니다.
`feedLabel`	`string` 제품의 피드 라벨입니다.
`offerId`	`string` 판매자가 제공한 제품의 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`categoryL1`	`string` Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
`categoryL2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`categoryL3`	`string` Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
`categoryL4`	`string` Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
`categoryL5`	`string` Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
`productTypeL1`	`string` 판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다.
`productTypeL2`	`string` 판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다.
`productTypeL3`	`string` 판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다.
`productTypeL4`	`string` 판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다.
`productTypeL5`	`string` 판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다.
`condition`	`string` 제품의 상태입니다.
`availability`	`string` 제품의 재고
`shippingLabel`	`string` 데이터 소스에 지정된 정규화된 배송물 라벨입니다.
`itemGroupId`	`string` 옵션을 함께 그룹화하기 위해 판매자가 제공한 상품 그룹 ID입니다.
`thumbnailLink`	`string` Google 인프라에서 호스팅되는 처리된 제품 이미지의 링크입니다.
`aggregatedReportingContextStatus`	`enum (AggregatedReportingContextStatus)` 집계 상태입니다.
`clickPotentialRank`	`string (int64 format)` 클릭 가능성을 기준으로 한 제품의 순위입니다. `clickPotentialRank`이 1인 제품은 검색어 조건을 충족하는 판매자의 제품 중 클릭 가능성이 가장 높습니다.

AggregatedReportingContextStatus

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

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

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

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

ItemIssue

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

JSON 표현
{ "type": { object (`ItemIssueType`) }, "severity": { object (`ItemIssueSeverity`) }, "resolution": enum (`ItemIssueResolution`) }

입력란

입력란
`type`	`object (ItemIssueType)` 항목 문제 유형입니다.
`severity`	`object (ItemIssueSeverity)` 상품 문제의 심각도입니다.
`resolution`	`enum (ItemIssueResolution)` 상품 문제가 해결되었습니다.

type

object (ItemIssueType)

항목 문제 유형입니다.

severity

object (ItemIssueSeverity)

상품 문제의 심각도입니다.

resolution

enum (ItemIssueResolution)

상품 문제가 해결되었습니다.

ItemIssueType

문제 유형.

JSON 표현
{ "code": string, "canonicalAttribute": string }

입력란

입력란
`code`	`string` 문제의 오류 코드로, 제품 문제의 `code`와 같습니다.
`canonicalAttribute`	`string` 속성별 문제의 표준 속성 이름입니다.

code

string

문제의 오류 코드로, 제품 문제의 code와 같습니다.

canonicalAttribute

string

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

ItemIssueSeverity

문제가 제품 제공에 미치는 영향

JSON 표현
{ "severityPerReportingContext": [ { object (`IssueSeverityPerReportingContext`) } ], "aggregatedSeverity": enum (`AggregatedIssueSeverity`) }

입력란

입력란
`severityPerReportingContext[]`	`object (IssueSeverityPerReportingContext)` 보고 컨텍스트별 문제 심각도입니다.
`aggregatedSeverity`	`enum (AggregatedIssueSeverity)` 영향을 받는 모든 보고 컨텍스트에서 집계된 문제 심각도. 이 필드는 결과를 필터링하는 데 사용할 수 있습니다.

severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

보고 컨텍스트별 문제 심각도입니다.

aggregatedSeverity

enum (AggregatedIssueSeverity)

영향을 받는 모든 보고 컨텍스트에서 집계된 문제 심각도.

이 필드는 결과를 필터링하는 데 사용할 수 있습니다.

IssueSeverityPerReportingContext

보고 컨텍스트별 문제 심각도입니다.

JSON 표현
{ "disapprovedCountries": [ string ], "demotedCountries": [ string ], "reportingContext": enum (`ReportingContextEnum`) }

입력란

입력란
`disapprovedCountries[]`	`string` ISO 3166 형식으로 표현된, 보고 컨텍스트의 비승인 국가 목록입니다.
`demotedCountries[]`	`string` ISO 3166 형식으로 표시된, 보고 컨텍스트에서 순위가 내려진 국가 목록
`reportingContext`	`enum (ReportingContextEnum)` 문제가 적용되는 보고 컨텍스트입니다.

disapprovedCountries[]

string

ISO 3166 형식으로 표현된, 보고 컨텍스트의 비승인 국가 목록입니다.

demotedCountries[]

string

ISO 3166 형식으로 표시된, 보고 컨텍스트에서 순위가 내려진 국가 목록

reportingContext

enum (ReportingContextEnum)

문제가 적용되는 보고 컨텍스트입니다.

AggregatedIssueSeverity

모든 보고 컨텍스트에서 집계된 문제 심각도입니다.

열거형
`AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED`	지정되지 않았습니다.
`DISAPPROVED`	문제는 하나 이상의 보고 컨텍스트에서 제품을 비승인합니다.
`DEMOTED`	문제가 영향을 받는 모든 보고 컨텍스트에서 제품의 순위를 내립니다.
`PENDING`	문제 해결은 `PENDING_PROCESSING`입니다.

ItemIssueResolution

문제 해결 방법

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

ClickPotential

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

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

PriceCompetitivenessProductView

priceCompetitivenessProductView 테이블의 쿼리에 사용할 수 있는 필드

가격 경쟁력 보고서

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

JSON 표현

JSON 표현
{ "price": { object (`Price`) }, "benchmarkPrice": { object (`Price`) }, "reportCountryCode": string, "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string }

{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}

입력란
`price`	`object (Price)` 제품의 현재 가격입니다.
`benchmarkPrice`	`object (Price)` 벤치마크 국가의 제품 카탈로그에 제공되는 최신 가격 벤치마크입니다.
`reportCountryCode`	`string` 가격 벤치마크의 국가입니다. ISO 3166 형식으로 표현됩니다. `SELECT` 절에 필요합니다.
`id`	`string` 제품의 REST ID로, `channel~languageCode~feedLabel~offerId` 형식입니다. 데이터를 `productView` 테이블과 조인하는 데 사용할 수 있습니다. `SELECT` 절에 필요합니다.
`offerId`	`string` 판매자가 제공한 제품의 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`categoryL1`	`string` Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
`categoryL2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`categoryL3`	`string` Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
`categoryL4`	`string` Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
`categoryL5`	`string` Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
`productTypeL1`	`string` 판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다.
`productTypeL2`	`string` 판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다.
`productTypeL3`	`string` 판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다.
`productTypeL4`	`string` 판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다.
`productTypeL5`	`string` 판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다.

PriceInsightsProductView

priceInsightsProductView 테이블의 쿼리에 사용할 수 있는 필드

가격 정보 보고서

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

JSON 표현

JSON 표현
{ "price": { object (`Price`) }, "suggestedPrice": { object (`Price`) }, "effectiveness": enum (`Effectiveness`), "id": string, "offerId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "productTypeL1": string, "productTypeL2": string, "productTypeL3": string, "productTypeL4": string, "productTypeL5": string, "predictedImpressionsChangeFraction": number, "predictedClicksChangeFraction": number, "predictedConversionsChangeFraction": number }

{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}

입력란
`price`	`object (Price)` 제품의 현재 가격입니다.
`suggestedPrice`	`object (Price)` 제품의 최신 제안 가격입니다.
`effectiveness`	`enum (Effectiveness)` 버케팅된 가격 추천 적용 시 예상되는 효과입니다.
`id`	`string` 제품의 REST ID로, `channel~languageCode~feedLabel~offerId` 형식입니다. 데이터를 `productView` 테이블과 조인하는 데 사용할 수 있습니다. `SELECT` 절에 필요합니다.
`offerId`	`string` 판매자가 제공한 제품의 ID입니다.
`title`	`string` 제품의 이름입니다.
`brand`	`string` 제품의 브랜드입니다.
`categoryL1`	`string` Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
`categoryL2`	`string` Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
`categoryL3`	`string` Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
`categoryL4`	`string` Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
`categoryL5`	`string` Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
`productTypeL1`	`string` 판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다.
`productTypeL2`	`string` 판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다.
`productTypeL3`	`string` 판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다.
`productTypeL4`	`string` 판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다.
`productTypeL5`	`string` 판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다.
`predictedImpressionsChangeFraction`	`number` 권장 가격을 현재 활성 가격과 비교한 후 예상되는 노출수 변화입니다. 예를 들어 0.05는 예상되는 노출수 증가가 5% 임을 나타냅니다.
`predictedClicksChangeFraction`	`number` 권장 가격을 현재 활성 가격과 비교한 후 예상되는 클릭수 변동을 분수로 나타낸 것입니다. 예를 들어 0.05는 예상되는 클릭수 증가가 5% 임을 나타냅니다.
`predictedConversionsChangeFraction`	`number` 권장 가격을 현재 활성 가격과 비교한 후 예상되는 전환수 변화를 분수로 나타낸 것입니다. 예를 들어 0.05는 예상되는 전환수 증가가 5% 임을 나타냅니다).

효과

예측 효과 버킷.

효과는 가격을 변경할 경우 어떤 제품이 가장 큰 이점을 얻을 수 있는지를 나타냅니다. 이 평가에는 할인가, 현재 가격과 추천 가격 간의 차이를 조정하여 예측한 실적 향상이 반영됩니다. 효과가 HIGH인 가격 제안은 실적이 가장 크게 향상될 것으로 예상됩니다.

열거형
`EFFECTIVENESS_UNSPECIFIED`	효과는 알 수 없습니다.
`LOW`	효율성이 낮습니다.
`MEDIUM`	효율성이 중간입니다.
`HIGH`	효과가 높습니다.

BestSellersProductClusterView

bestSellersProductClusterView 테이블의 쿼리에 사용할 수 있는 필드

인기 제품 클러스터가 포함된 베스트셀러 보고서입니다. 제품 클러스터는 Google Pixel 7과 같이 동일한 제품을 나타내는 다양한 상품 및 옵션을 그룹화한 것입니다.

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

JSON 표현

JSON 표현
{ "reportDate": { object (`Date`) }, "variantGtins": [ string ], "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "title": string, "brand": string, "categoryL1": string, "categoryL2": string, "categoryL3": string, "categoryL4": string, "categoryL5": string, "inventoryStatus": enum (`InventoryStatus`), "brandInventoryStatus": enum (`InventoryStatus`), "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) }

{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}

입력란
`reportDate`	`object (Date)` 보고서 작성일. 이 필드의 값은 다음 중 하나여야 합니다. 주별 보고서의 경우 첫 번째 요일 (월요일)이며, 월별 보고서의 첫 번째 날입니다. `SELECT` 절에 필요합니다. 쿼리에 `reportDate`의 `WHERE` 조건이 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
`variantGtins[]`	`string` 제품 클러스터 옵션 예시의 GTIN입니다.
`reportGranularity`	`enum (ReportGranularityEnum)` 보고서의 세부사항입니다. 순위는 일주일 또는 한 달 동안 결정됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportGranularity` 조건이 필요합니다.
`reportCountryCode`	`string` 순위가 계산되는 국가입니다. ISO 3166 형식으로 표현됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCountryCode` 조건이 필요합니다.
`reportCategoryId`	`string (int64 format)` 순위를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다. `SELECT` 절에 필요합니다. 쿼리에 `reportCategoryId`의 `WHERE` 조건이 지정되어 있지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.
`title`	`string` 제품 클러스터의 제목입니다.
`brand`	`string` 제품 클러스터의 브랜드입니다.
`categoryL1`	`string` Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (첫 번째 수준)입니다.
`categoryL2`	`string` Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (두 번째 수준)입니다.
`categoryL3`	`string` Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (세 번째 수준)입니다.
`categoryL4`	`string` Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (네 번째 수준)입니다.
`categoryL5`	`string` Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (다섯 번째 수준)입니다.
`inventoryStatus`	`enum (InventoryStatus)` 제품 클러스터가 하나 이상의 국가 제품 데이터 소스에서 `IN_STOCK`인지, 모든 국가의 제품 데이터 소스에서 `OUT_OF_STOCK`인지 아니면 전혀 `NOT_IN_INVENTORY`인지 여부입니다. 이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다.
`brandInventoryStatus`	`enum (InventoryStatus)` 현재 1개 이상의 국가에서 제품 데이터 소스에 `IN_STOCK`인 브랜드의 제품이 하나 이상 있든지 상관 없이 모든 제품은 모든 국가의 제품 데이터 소스에서 `OUT_OF_STOCK` 또는 `NOT_IN_INVENTORY`입니다. 이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다.
`rank`	`string (int64 format)` 예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 위치에 표시된 제품 클러스터의 인기도입니다.
`previousRank`	`string (int64 format)` 지난주 또는 지난달의 인기도 순위입니다.
`relativeDemand`	`enum (RelativeDemandEnum)` 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다.
`previousRelativeDemand`	`enum (RelativeDemandEnum)` 지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다.
`relativeDemandChange`	`enum (RelativeDemandChangeTypeEnum)` 예상 수요 변동입니다. 상승, 침몰, 수평 유지 여부 등

ReportGranularityEnum

보고서 세부사항 값입니다.

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

InventoryStatus

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

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

RelativeDemandEnum

상대적 수요 가치입니다.

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

RelativeDemandChangeTypeEnum

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

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

BestSellersBrandView

bestSellersBrandView 테이블의 쿼리에 사용할 수 있는 필드

베스트셀러 보고서는 인기 브랜드를 보여줍니다.

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

JSON 표현

JSON 표현
{ "reportDate": { object (`Date`) }, "reportGranularity": enum (`ReportGranularityEnum`), "reportCountryCode": string, "reportCategoryId": string, "brand": string, "rank": string, "previousRank": string, "relativeDemand": enum (`RelativeDemandEnum`), "previousRelativeDemand": enum (`RelativeDemandEnum`), "relativeDemandChange": enum (`RelativeDemandChangeTypeEnum`) }

{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}

입력란
`reportDate`	`object (Date)` 보고서 작성일. 이 필드의 값은 다음 중 하나여야 합니다. 주별 보고서의 경우 첫 번째 요일 (월요일)이며, 월별 보고서의 첫 번째 날입니다. `SELECT` 절에 필요합니다. 쿼리에 `reportDate`의 `WHERE` 조건이 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
`reportGranularity`	`enum (ReportGranularityEnum)` 보고서의 세부사항입니다. 순위는 일주일 또는 한 달 동안 결정됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportGranularity` 조건이 필요합니다.
`reportCountryCode`	`string` 순위가 계산되는 국가입니다. ISO 3166 형식으로 표현됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCountryCode` 조건이 필요합니다.
`reportCategoryId`	`string (int64 format)` 순위를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다. `SELECT` 절에 필요합니다. 쿼리에 `reportCategoryId`의 `WHERE` 조건이 지정되어 있지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.
`brand`	`string` 브랜드 이름입니다.
`rank`	`string (int64 format)` 예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 위치에 표시되는 브랜드의 인기도입니다.
`previousRank`	`string (int64 format)` 지난주 또는 지난달의 인기도 순위입니다.
`relativeDemand`	`enum (RelativeDemandEnum)` 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
`previousRelativeDemand`	`enum (RelativeDemandEnum)` 지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
`relativeDemandChange`	`enum (RelativeDemandChangeTypeEnum)` 예상 수요 변동입니다. 상승, 침몰, 수평 유지 여부 등

CompetitiveVisibilityCompetitorView

competitiveVisibilityCompetitorView 테이블의 쿼리에 사용할 수 있는 필드

노출 경쟁 보고서이며 노출이 비슷한 비즈니스와 관련이 있습니다.

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

JSON 표현

JSON 표현
{ "date": { object (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number, "relativeVisibility": number }

{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}

입력란
`date`	`object (Date)` 이 행의 날짜입니다. `WHERE` 절에는 `date`에 대한 조건이 필요합니다.
`domain`	`string` 경쟁업체의 도메인 또는 내 도메인('isYourDomain'이 true인 경우) `SELECT` 절에 필요합니다. 'WHERE' 절에서 필터링할 수 없습니다.
`isYourDomain`	`boolean` 이 행에 도메인 데이터가 포함되어 있으면 true입니다. 'WHERE' 절에서 필터링할 수 없습니다.
`reportCountryCode`	`string` 노출이 발생한 국가입니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCountryCode`에 대한 조건이 필요합니다.
`reportCategoryId`	`string (int64 format)` 보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCategoryId`에 대한 조건이 필요합니다.
`trafficSource`	`enum (TrafficSourceEnum)` 노출의 트래픽 소스입니다. `SELECT` 절에 필요합니다.
`rank`	`string (int64 format)` 노출수를 기준으로 선택된 키 (`date`, `reportCategoryId`, `reportCountryCode`, `trafficSource`)에 대해 비슷한 비즈니스에서 도메인의 순위입니다. 1이 가장 높습니다. 'WHERE' 절에서 필터링할 수 없습니다.
`adsOrganicRatio`	`number` 광고 / 자연 비율은 도메인이 자연 트래픽과 비교하여 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림되고 버케팅됩니다. 'WHERE' 절에서 필터링할 수 없습니다.
`pageOverlapRate`	`number` 페이지 중복률은 경쟁 소매업체의 상품과 내 상품이 같은 페이지에 함께 표시되는 빈도를 나타냅니다. 'WHERE' 절에서 필터링할 수 없습니다.
`higherPositionRate`	`number` 높은 게재순위 비율은 경쟁업체의 상품이 페이지에서 내 상품보다 더 높은 순위에 게재되는 빈도를 나타냅니다. 'WHERE' 절에서 필터링할 수 없습니다.
`relativeVisibility`	`number` 상대적 노출률은 내 상품과 비교하여 경쟁업체의 상품이 표시되는 빈도를 나타냅니다. 즉, 선택한 제품 카테고리 및 국가에 대해 선택한 기간 동안 경쟁 소매업체가 표시된 노출수를 표시된 노출수로 나눈 값입니다. 'WHERE' 절에서 필터링할 수 없습니다.

TrafficSourceEnum

트래픽 소스 값입니다.

열거형
`TRAFFIC_SOURCE_ENUM_UNSPECIFIED`	지정되지 않았습니다.
`ORGANIC`	자연 트래픽.
`ADS`	광고에서 발생한 트래픽입니다.
`ALL`	자연 및 광고 트래픽

CompetitiveVisibilityTopMerchantView

competitiveVisibilityTopMerchantView 테이블의 쿼리에 사용할 수 있는 필드

노출 경쟁 보고서: 노출률이 가장 높은 비즈니스입니다.

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

JSON 표현

JSON 표현
{ "date": { object (`Date`) }, "domain": string, "isYourDomain": boolean, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "rank": string, "adsOrganicRatio": number, "pageOverlapRate": number, "higherPositionRate": number }

{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}

입력란
`date`	`object (Date)` 이 행의 날짜입니다. `SELECT` 절에서 선택할 수 없습니다. `WHERE` 절에는 `date`에 대한 조건이 필요합니다.
`domain`	`string` 경쟁업체의 도메인 또는 내 도메인('isYourDomain'이 true인 경우) `SELECT` 절에 필요합니다. 'WHERE' 절에서 필터링할 수 없습니다.
`isYourDomain`	`boolean` 이 행에 도메인 데이터가 포함되어 있으면 true입니다. 'WHERE' 절에서 필터링할 수 없습니다.
`reportCountryCode`	`string` 노출이 발생한 국가입니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCountryCode`에 대한 조건이 필요합니다.
`reportCategoryId`	`string (int64 format)` 보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCategoryId`에 대한 조건이 필요합니다.
`trafficSource`	`enum (TrafficSourceEnum)` 노출의 트래픽 소스입니다. `SELECT` 절에 필요합니다.
`rank`	`string (int64 format)` 노출수를 기준으로 선택한 키 (`date`, `reportCategoryId`, `reportCountryCode`, `trafficSource`)에 대해 상위 판매자에서 도메인의 순위입니다. 1이 가장 높습니다. 'WHERE' 절에서 필터링할 수 없습니다.
`adsOrganicRatio`	`number` 광고 / 자연 비율은 도메인이 자연 트래픽과 비교하여 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림되고 버케팅됩니다. 'WHERE' 절에서 필터링할 수 없습니다.
`pageOverlapRate`	`number` 페이지 중복률은 경쟁 소매업체의 상품과 내 상품이 같은 페이지에 함께 표시되는 빈도를 나타냅니다. 'WHERE' 절에서 필터링할 수 없습니다.
`higherPositionRate`	`number` 높은 게재순위 비율은 경쟁업체의 상품이 페이지에서 내 상품보다 더 높은 순위에 게재되는 빈도를 나타냅니다. 'WHERE' 절에서 필터링할 수 없습니다.

CompetitiveVisibilityBenchmarkView

competitiveVisibilityBenchmarkView 테이블의 쿼리에 사용할 수 있는 필드

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

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

JSON 표현

JSON 표현
{ "date": { object (`Date`) }, "reportCountryCode": string, "reportCategoryId": string, "trafficSource": enum (`TrafficSourceEnum`), "yourDomainVisibilityTrend": number, "categoryBenchmarkVisibilityTrend": number }

{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}

입력란
`date`	`object (Date)` 이 행의 날짜입니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `date`에 대한 조건이 필요합니다.
`reportCountryCode`	`string` 노출이 발생한 국가입니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCountryCode`에 대한 조건이 필요합니다.
`reportCategoryId`	`string (int64 format)` 보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다. `SELECT` 절에 필요합니다. `WHERE` 절에는 `reportCategoryId`에 대한 조건이 필요합니다.
`trafficSource`	`enum (TrafficSourceEnum)` 노출의 트래픽 소스입니다. `SELECT` 절에 필요합니다.
`yourDomainVisibilityTrend`	`number` 선택한 기간의 시작 (또는 노출수가 0이 아닌 첫날)을 기준으로 도메인의 노출수를 기반으로 한 공개 상태 변경입니다. 'WHERE' 절에서 필터링할 수 없습니다.
`categoryBenchmarkVisibilityTrend`	`number` 시장에 근접하여 노출률이 가장 높은 통합 판매자 집합에서 선택한 기간의 시작 (또는 노출수가 0이 아닌 첫날)을 기준으로 노출수를 기반으로 한 노출의 변화입니다. 'WHERE' 절에서 필터링할 수 없습니다.