REST Resource: accounts.productReviews

리소스: ProductReview

제품 리뷰입니다. 자세한 내용은 제품 리뷰 피드 소개를 참조하세요.

JSON 표현 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
필드
name

string

식별자. 제품 리뷰의 이름입니다. 형식: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

필수 항목입니다. 게시자 시스템에서 제품 리뷰를 식별하는 영구적이고 고유한 식별자입니다.
attributes

object (ProductReviewAttributes)

선택사항입니다. 제품 리뷰 속성의 목록입니다.
customAttributes[]

object (CustomAttribute)

선택사항입니다. 맞춤 (판매자 제공) 속성 목록입니다.
dataSource

string

출력 전용입니다. 제품 리뷰의 기본 데이터 소스입니다.
productReviewStatus

object (ProductReviewStatus)

출력 전용입니다. 제품 리뷰의 상태, 데이터 유효성 검사 문제, 즉 비동기식으로 계산된 제품 리뷰에 관한 정보입니다.

ProductReviewAttributes

속성.

JSON 표현 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
필드
reviewTime

string (Timestamp format)

필수 항목입니다. 리뷰가 작성된 시간을 나타내는 타임스탬프입니다.
pros[]

string

선택사항입니다. 리뷰 작성자의 의견에 따른 이점이 포함되어 있습니다. 리뷰 작성자가 작성한 것이 아니라면 'pro:'와 같은 상용구 텍스트는 생략합니다.
cons[]

string

선택사항입니다. 리뷰 작성자의 의견에 따른 단점이 포함되어 있습니다. 리뷰 작성자가 작성한 것이 아니라면 'con:'과 같은 상용구 텍스트는 생략합니다.
productNames[]

string

선택사항입니다. 제품을 설명하는 이름입니다.
asins[]

string

선택사항입니다. 제품과 연결된 ASIN (Amazon 표준 식별 번호)을 포함합니다.
gtins[]

string

선택사항입니다. 제품과 연결된 GTIN (국제거래단품식별코드)을 포함합니다. GTIN의 하위유형 (예: UPC, EAN, ISBN, JAN)이 지원됩니다.
mpns[]

string

선택사항입니다. 제품과 연결된 MPN (제조업체 부품번호)을 포함합니다.
skus[]

string

선택사항입니다. 제품과 연결된 SKU (재고 관리 단위)를 포함합니다. 이는 제품 피드의 제품 혜택 ID와 일치하는 경우가 많습니다.
brands[]

string

선택사항입니다. 제품과 연결된 브랜드 이름을 포함합니다.
collectionMethod

enum (CollectionMethod)

선택사항입니다. 리뷰를 수집하는 데 사용된 방법입니다.
transactionId

string

선택사항입니다. 게시자 시스템의 리뷰와 관련된 거래의 영구적인 고유 식별자입니다. 이 ID는 동일한 거래에 여러 리뷰가 연결되어 있음을 나타내는 데 사용할 수 있습니다.
aggregatorName

string

선택사항입니다. 제품 리뷰 애그리게이터의 이름입니다.

게시자는 리뷰 애그리게이터를 사용하여 리뷰를 관리하고 피드를 제공할 수 있습니다. 이 요소는 애그리게이터의 사용을 나타내며 애그리게이터에 대한 정보를 포함합니다.
subclientName

string

선택사항입니다. 제품 리뷰의 하위 클라이언트 이름입니다.

하위 클라이언트는 제품 리뷰 소스의 식별자입니다. 파일 데이터 소스 경로에 제공된 디렉터리와 동일해야 합니다.
publisherName

string

선택사항입니다. 제품 리뷰 게시자의 이름입니다.

소매업체, 제조업체, 리뷰 서비스 회사 또는 제품 리뷰를 게시하는 법인일 수 있는 게시자에 대한 정보입니다.
publisherFavicon

string

선택사항입니다. 게시자의 회사 favicon 링크입니다. 이미지 크기는 favicon 크기(16x16픽셀)여야 합니다. 이미지 형식은 GIF, JPG 또는 PNG여야 합니다.
reviewerId

string

선택사항입니다. 제품 리뷰의 작성자입니다.

게시자 시스템에서 리뷰 작성자를 식별하는 영구적이고 고유한 식별자입니다.
reviewerIsAnonymous

boolean

선택사항입니다. 리뷰 작성자가 익명으로 유지되어야 하는 경우 true로 설정합니다.
reviewerUsername

string

선택사항입니다. 제품 리뷰 작성자의 이름입니다.
reviewLanguage

string

선택사항입니다. BCP-47 언어 코드로 정의된 리뷰 언어입니다.
reviewCountry

string

선택사항입니다. ISO 3166-1 Alpha-2 국가 코드로 정의된 리뷰 국가입니다.
title

string

선택사항입니다. 리뷰 제목입니다.
content

string

필수 항목입니다. 리뷰의 내용입니다.
minRating

string (int64 format)

선택사항입니다. 리뷰와 연결된 평점을 포함합니다. 가능한 최소 평점 수입니다. 가능한 최악의 평점이어야 하며 평점이 없는 값이면 안 됩니다.
maxRating

string (int64 format)

선택사항입니다. 가능한 최대 평점입니다. 최대 평점 값은 최소 속성 값보다 커야 합니다.
rating

number

선택사항입니다. 제품에 대한 리뷰 작성자의 전반적인 평점입니다.
isSpam

boolean

선택사항입니다. 리뷰가 게시자 시스템에서 스팸으로 표시되었는지 여부를 나타냅니다.

유형

리뷰 URI 유형입니다.

열거형
TYPE_UNSPECIFIED 유형이 지정되지 않습니다.
SINGLETON 리뷰 페이지에는 이 한 개의 리뷰만 포함되어 있습니다.
GROUP 리뷰 페이지에는 이 리뷰를 포함한 리뷰 그룹이 포함되어 있습니다.

CollectionMethod

리뷰를 수집하는 데 사용된 방법입니다.

열거형
COLLECTION_METHOD_UNSPECIFIED 수집 방법이 지정되지 않았습니다.
UNSOLICITED 사용자가 리뷰를 제출할 때 특정 요청에 응답하지 않았습니다.
POST_FULFILLMENT 사용자가 주문 제품이 발송된 후 요청에 따라 리뷰를 제출했습니다.

ProductReviewStatus

제품 검토 상태입니다.

JSON 표현 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
필드
destinationStatuses[]

object (ProductReviewDestinationStatus)

출력 전용입니다. 제품 리뷰의 의도한 대상 위치입니다.
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

출력 전용입니다. 제품 리뷰와 관련된 모든 문제의 목록입니다.
createTime

string (Timestamp format)

출력 전용입니다. 항목이 생성된 날짜(ISO 8601 형식)입니다.
lastUpdateTime

string (Timestamp format)

출력 전용입니다. 항목이 마지막으로 업데이트된 날짜입니다(ISO 8601 형식).

ProductReviewDestinationStatus

제품 리뷰 상태의 대상 유형 상태입니다.

JSON 표현 
{
  "reportingContext": enum (ReportingContextEnum)
}
필드
reportingContext

enum (ReportingContextEnum)

출력 전용입니다. 보고 컨텍스트의 이름입니다.

ProductReviewItemLevelIssue

제품 리뷰 상태의 ItemLevelIssue입니다.

JSON 표현 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
필드
code

string

출력 전용입니다. 문제의 오류 코드입니다.
severity

enum (Severity)

출력 전용입니다. 이 문제가 제품 리뷰 게재에 미치는 영향
resolution

string

출력 전용입니다. 판매자가 문제를 해결할 수 있는지 여부
attribute

string

출력 전용입니다. 문제가 단일 속성으로 인해 발생한 경우 속성의 이름
reportingContext

enum (ReportingContextEnum)

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

string

출력 전용입니다. 간단한 문제 설명(영어)
detail

string

출력 전용입니다. 자세한 문제 설명(영어)
documentation

string

출력 전용입니다. 이 문제를 해결하는 데 도움이 되는 웹 페이지의 URL

심각도

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

열거형
SEVERITY_UNSPECIFIED 지정되지 않음
NOT_IMPACTED 이 문제는 경고를 나타내며 제품 리뷰에 직접적인 영향을 미치지 않습니다.
DISAPPROVED 문제로 인해 제품 리뷰가 비승인됩니다.

메서드

delete

 제품 리뷰를 삭제합니다.

get

 제품 리뷰를 가져옵니다.

insert

 제품 리뷰를 삽입합니다.

list

 제품 리뷰를 표시합니다.