Package google.shopping.merchant.reviews.v1beta

색인

MerchantReviewsService

판매자 리뷰를 관리하는 서비스입니다.

DeleteMerchantReview

rpc DeleteMerchantReview(DeleteMerchantReviewRequest) returns (Empty)

판매자 리뷰를 삭제합니다.

승인 범위

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

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

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

GetMerchantReview

rpc GetMerchantReview(GetMerchantReviewRequest) returns (MerchantReview)

판매자 리뷰를 가져옵니다.

승인 범위

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

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

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

InsertMerchantReview

rpc InsertMerchantReview(InsertMerchantReviewRequest) returns (MerchantReview)

판매자 센터 계정에 대한 검토를 삽입합니다. 리뷰가 이미 있는 경우 리뷰가 새 인스턴스로 대체됩니다.

승인 범위

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

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

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

ListMerchantReviews

rpc ListMerchantReviews(ListMerchantReviewsRequest) returns (ListMerchantReviewsResponse)

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

승인 범위

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

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

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

ProductReviewsService

제품 리뷰를 관리하는 서비스입니다.

DeleteProductReview

rpc DeleteProductReview(DeleteProductReviewRequest) returns (Empty)

제품 리뷰를 삭제합니다.

승인 범위

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

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

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

GetProductReview

rpc GetProductReview(GetProductReviewRequest) returns (ProductReview)

제품 리뷰를 가져옵니다.

승인 범위

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

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

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

InsertProductReview

rpc InsertProductReview(InsertProductReviewRequest) returns (ProductReview)

제품 리뷰를 삽입합니다.

승인 범위

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

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

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

ListProductReviews

rpc ListProductReviews(ListProductReviewsRequest) returns (ListProductReviewsResponse)

제품 리뷰를 표시합니다.

승인 범위

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

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

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

DeleteMerchantReviewRequest

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

필드
name

string

필수 항목입니다. 판매자 리뷰의 ID입니다. 형식: accounts/{account}/merchantReviews/{merchantReview}

DeleteProductReviewRequest

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

필드
name

string

필수 항목입니다. 제품 리뷰의 ID입니다. 형식: accounts/{account}/productReviews/{productReview}

GetMerchantReviewRequest

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

필드
name

string

필수 항목입니다. 판매자 리뷰의 ID입니다. 형식: accounts/{account}/merchantReviews/{merchantReview}

GetProductReviewRequest

GetProductReview 메서드의 요청 메시지입니다.

필드
name

string

필수 항목입니다. 판매자 리뷰의 ID입니다. 형식: accounts/{account}/productReviews/{productReview}

InsertMerchantReviewRequest

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

필드
parent

string

필수 항목입니다. 판매자 리뷰가 삽입될 계정입니다. 형식: accounts/{account}

merchant_review

MerchantReview

필수 항목입니다. 삽입할 판매자 리뷰입니다.

data_source

string

필수 항목입니다. merchantreview 형식의 데이터 소스: accounts/{account}/dataSources/{datasource}

InsertProductReviewRequest

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

필드
parent

string

필수 항목입니다. 제품 리뷰가 삽입될 계정입니다. 형식: accounts/{account}

product_review

ProductReview

필수 항목입니다. 삽입할 제품 리뷰입니다.

data_source

string

필수 항목입니다. 형식: accounts/{account}/dataSources/{datasource}

ListMerchantReviewsRequest

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

필드
parent

string

필수 항목입니다. 판매자 리뷰를 표시할 계정입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 최대 판매자 리뷰 수입니다. 서비스는 이 값보다 적은 값을 반환할 수 있습니다. 최댓값은 1,000이며, 1,000을 초과하는 값은 1,000으로 변환됩니다. 지정하지 않으면 최대 리뷰 수가 반환됩니다.

page_token

string

선택사항입니다. 이전 ListMerchantReviews 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListMerchantReviews에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListMerchantReviewsResponse

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

필드
merchant_reviews[]

MerchantReview

판매자 리뷰

next_page_token

string

결과의 다음 페이지를 가져오는 토큰입니다.

ListProductReviewsRequest

ListProductReviews 메서드의 요청 메시지입니다.

필드
parent

string

필수 항목입니다. 제품 리뷰를 표시할 계정입니다. 형식: accounts/{account}

page_size

int32

선택사항입니다. 반환할 제품의 최대 개수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다.

page_token

string

선택사항입니다. 이전 ListProductReviews 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 ListProductReviews에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

ListProductReviewsResponse

ListProductReviews 메서드의 응답 메시지입니다.

필드
product_reviews[]

ProductReview

제품 리뷰입니다.

next_page_token

string

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

MerchantReview

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

필드
name

string

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

merchant_review_id

string

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

attributes

MerchantReviewAttributes

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

custom_attributes[]

CustomAttribute

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

data_source

string

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

merchant_review_status

MerchantReviewStatus

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

MerchantReviewAttributes

속성

필드
merchant_id

string

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

merchant_display_name

string

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

min_rating

int64

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

max_rating

int64

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

rating

double

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

title

string

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

content

string

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

reviewer_id

string

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

reviewer_username

string

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

is_anonymous

bool

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

collection_method

CollectionMethod

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

review_time

Timestamp

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

review_language

string

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

review_country

string

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

CollectionMethod

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

열거형
COLLECTION_METHOD_UNSPECIFIED 수집 방법이 지정되지 않았습니다.
MERCHANT_UNSOLICITED 사용자가 리뷰를 제출할 때 특정 요청에 따른 것이 아니었습니다.
POINT_OF_SALE 사용자가 주문할 때 요청에 따라 리뷰를 제출했습니다.
AFTER_FULFILLMENT 사용자가 주문 제품이 처리된 후 요청에 따라 리뷰를 제출했습니다.

MerchantReviewStatus

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

필드
destination_statuses[]

MerchantReviewDestinationStatus

출력 전용입니다. 판매자 리뷰의 의도한 대상 위치

item_level_issues[]

MerchantReviewItemLevelIssue

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

create_time

Timestamp

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

last_update_time

Timestamp

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

MerchantReviewDestinationStatus

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

필드
reporting_context

ReportingContextEnum

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

MerchantReviewItemLevelIssue

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

필드
code

string

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

severity

Severity

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

resolution

string

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

attribute

string

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

reporting_context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

심각도

이 문제가 판매자 리뷰 게재에 미치는 영향

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

ProductReview

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

필드
name

string

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

product_review_id

string

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

attributes

ProductReviewAttributes

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

custom_attributes[]

CustomAttribute

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

data_source

string

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

product_review_status

ProductReviewStatus

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

ProductReviewAttributes

속성

필드
review_time

Timestamp

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

pros[]

string

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

cons[]

string

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

product_names[]

string

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

asins[]

string

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

gtins[]

string

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

mpns[]

string

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

skus[]

string

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

brands[]

string

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

collection_method

CollectionMethod

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

transaction_id

string

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

aggregator_name

string

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

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

subclient_name

string

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

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

publisher_name

string

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

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

publisher_favicon

string

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

reviewer_id

string

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

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

reviewer_is_anonymous

bool

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

reviewer_username

string

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

review_language

string

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

review_country

string

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

title

string

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

content

string

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

min_rating

int64

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

max_rating

int64

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

rating

double

선택사항입니다. 검토자가 제품에 부여한 전체 평점입니다.

is_spam

bool

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

CollectionMethod

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

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

유형

리뷰 URI 유형입니다.

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

ProductReviewStatus

제품 검토 상태입니다.

필드
destination_statuses[]

ProductReviewDestinationStatus

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

item_level_issues[]

ProductReviewItemLevelIssue

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

create_time

Timestamp

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

last_update_time

Timestamp

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

ProductReviewDestinationStatus

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

필드
reporting_context

ReportingContextEnum

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

ProductReviewItemLevelIssue

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

필드
code

string

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

severity

Severity

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

resolution

string

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

attribute

string

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

reporting_context

ReportingContextEnum

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

description

string

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

detail

string

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

documentation

string

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

심각도

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

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