REST Resource: accounts.merchantReviews

리소스: MerchantReview

판매자에 대한 리뷰입니다. 자세한 내용은 판매자 리뷰 피드 소개를 참고하세요.

JSON 표현 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
필드
name

string

식별자. 판매자 리뷰의 이름입니다. 형식: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

필수 항목입니다. 사용자가 판매자 리뷰를 고유하게 식별하기 위해 판매자 리뷰 ID를 제공했습니다.
attributes

object (MerchantReviewAttributes)

선택사항입니다. 판매자 리뷰 속성 목록입니다.
customAttributes[]

object (CustomAttribute)

필수 항목입니다. 맞춤 (판매자 제공) 속성 목록입니다. 데이터 사양의 속성을 제네릭 형식 (예: { "name": "size type", "value": "regular" })으로 제출하는 데도 사용할 수 있습니다. 이는 실험용 속성과 같이 API에 의해 명시적으로 노출되지 않는 속성을 제출하는 데 유용합니다. 각 맞춤 속성의 최대 허용 문자 수는 10,240자(영문 기준)입니다(이름과 값의 문자 수 합계를 나타냄). 제품당 최대 2, 500개의 맞춤 속성을 설정할 수 있으며 총 크기는 102.4KB입니다. 맞춤 속성 이름의 밑줄은 삽입할 때 공백으로 대체됩니다.
dataSource

string

출력 전용입니다. 판매자 리뷰의 기본 데이터 소스입니다.
merchantReviewStatus

object (MerchantReviewStatus)

출력 전용입니다. 판매자 리뷰 상태, 데이터 유효성 문제, 즉 비동기식으로 계산된 판매자 리뷰에 대한 정보입니다.

MerchantReviewAttributes

속성

JSON 표현 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
필드
merchantId

string

필수 항목입니다. 모든 요청에서 고유하고 안정적이어야 합니다. 즉, 오늘과 다른 90일 전의 요청이 동일한 판매자를 참조하는 경우 ID가 동일해야 합니다.
merchantDisplayName

string

선택사항입니다. 사람이 읽을 수 있는 판매자의 표시 이름입니다.
minRating

string (int64 format)

선택사항입니다. 평점에 사용할 수 있는 최소 개수입니다. 가능한 최악의 평점이어야 하며 평점이 없는 값이면 안 됩니다.
maxRating

string (int64 format)

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

number

선택사항입니다. 리뷰 작성자가 판매자에 대해 부여한 전반적인 평점입니다.
title

string

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

string

필수 항목입니다. 사용자가 제공한 자유 형식 텍스트여야 하며 잘리지 않아야 합니다. 여러 질문에 대한 응답이 여러 개 제공되는 경우 응답을 이해하는 데 필요한 최소한의 맥락과 함께 모든 응답을 포함해야 합니다. 질문에 답변하지 않은 경우에는 맥락을 제공해서는 안 됩니다.
reviewerId

string

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

string

선택사항입니다. 리뷰 작성자의 표시 이름입니다.
isAnonymous

boolean

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

enum (CollectionMethod)

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

string (Timestamp format)

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

string

필수 항목입니다. BCP-47 언어 코드로 정의된 리뷰의 언어입니다.
reviewCountry

string

선택사항입니다. 검토자가 주문한 국가로, ISO 3166-1 Alpha-2 국가 코드로 정의됩니다.

CollectionMethod

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

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

MerchantReviewStatus

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

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

object (MerchantReviewDestinationStatus)

출력 전용입니다. 판매자 리뷰를 대상으로 하는 대상 유형입니다.
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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

MerchantReviewDestinationStatus

판매자 검토 상태의 대상 상태입니다.

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

enum (ReportingContextEnum)

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

MerchantReviewItemLevelIssue

판매자 리뷰 상태의 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

 판매자 리뷰를 나열합니다.