이 섹션에서는 판매자 리뷰 데이터 피드에 사용되는 XML 스키마를 설명합니다.
최상위 요소: <feed>
설명
피드의 다른 모든 요소를 포함하는 최상위 컨테이너 요소입니다.
속성
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
xmlns
|
xs:string | 필수 (1) | 다음 값을 하드코딩하세요.http://schemas.google.com/merchant_reviews/5.0
|
xmlns:xsi
|
xs:string | 필수 (1) | 다음 값을 하드코딩하세요.http://www.w3.org/2001/XMLSchema-instance
|
xsi:schemaLocation
|
xs:string | 필수 (1) | 다음 값을 하드코딩하고 URL 사이에 하나의 공백을 남겨주세요.http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd
|
예
<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
merchants |
-- | 선택사항 (0~1) | <merchant> 요소의 컨테이너 요소입니다. |
deleted_merchants |
-- | 선택사항 (0~1) | <deleted_merchant> 요소의 컨테이너 요소입니다. |
reviews |
-- | 선택사항 (0~1) | <review> 요소의 컨테이너 요소입니다. |
deleted_reviews |
-- | 선택사항 (0~1) | <deleted_review> 요소의 컨테이너 요소입니다. |
<merchants>
설명
<merchant> 요소의 컨테이너입니다.
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
merchant |
-- | 필수 (1~n) | 각 판매자에 대해 반복되는 요소입니다. |
<merchant>
설명
각 <merchant> 요소에는 한 판매자에 대한 정보와 리뷰가 포함됩니다.
속성
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
id |
Id | 필수 (1) | 모든 피드에서 고유하고 안정적이어야 합니다. 즉, 오늘 피드와 90일 전 피드가 동일한 판매자를 참조하는 경우 ID가 동일해야 합니다. |
예
<merchant id="2739">
포함
판매자 요소 내에 다음 요소를 포함하세요.
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
name |
NonEmptyString | 필수 (1) | 판매자의 사람이 읽을 수 있는 표시 이름입니다. |
merchant_url
|
xs:anyURI | 필수 (1) | 판매자의 기본 웹사이트 URL입니다. 이 값에 리디렉션 URL을 사용하지 마세요. 즉, 값은 판매자의 사이트를 직접 가리켜야 합니다. 예: <merchant_url> http://store.google.com </merchant_url> |
rating_url
|
xs:anyURI | 필수 (1) | 이 판매자의 리뷰를 호스팅하는 방문 페이지의 URL입니다. 리디렉션 URL을 사용하지 마세요. 예: <rating_url> http://merchant_url.com/reviews/ </rating_url> |
create_timestamp
|
DateTimeWithTimeZone | 필수 (1) | 판매자가 생성된 시간/날짜입니다. 변경되어서는 안 됩니다. |
last_update_timestamp
|
DateTimeWithTimeZone | 필수 (1) | 판매자가 마지막으로 업데이트된 시간/날짜입니다. 특정 판매자 ID에 대해 <merchant> 요소의 필드가 업데이트되면 이 값도 변경되어야 합니다.
|
<deleted_merchants>
설명
삭제된 판매자의 컨테이너입니다.
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
deleted_merchant |
-- | 필수 (1~n) | 삭제된 단일 판매자와 관련된 요소를 포함합니다. |
<deleted_merchant>
설명
삭제된 판매자입니다.
속성
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
id
|
Id | 필수 (1) | 피드에서 삭제해야 하는 판매자의 ID를 지정합니다. ID는 이전 피드 파일의 <merchant> 요소의 id 속성과 일치해야 합니다.
|
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
last_update_timestamp
|
DateTimeWithTimeZone | 필수 (1) | 판매자가 시스템에서 삭제된 시간/날짜입니다.
예: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp> |
예
<deleted_merchant id="10"> <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp> </deleted_merchant>
<reviews>
설명
<review> 요소의 컨테이너입니다.
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
review
|
-- | 필수 (1~n) | 각 리뷰에 대해 반복되는 요소입니다. |
<review>
설명
리뷰와 관련된 세부정보의 컨테이너입니다.
속성
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
id
|
Id | 필수 (1) | 시스템의 리뷰 식별자입니다. 모든 피드에서 고유하고 안정적이어야 합니다.
예: <review id=132739 mid=1234> |
mid
|
Id | 필수 (1) | 이 리뷰가 적용되는 판매자의 식별자입니다. |
포함
리뷰 요소 내에 다음 요소를 포함하세요.
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
reviewer_name
|
NonEmptyString | 선택사항 (0~1) | 리뷰에 이름이 지정된 작성자가 있어야 하는 경우 리뷰 작성자의 표시 이름입니다.
익명 리뷰에는 이 필드가 포함되지 않아야 합니다.
예: <reviewer_name> Joel </reviewer_name> |
create_timestamp
|
DateTimeWithTimeZone | 필수 (1) | 사용자가 리뷰를 제출한 시간/날짜입니다. 변경되어서는 안 됩니다.
예: <create_timestamp> 2016-04-03T18:37:32Z </create_timestamp> |
last_update_timestamp
|
DateTimeWithTimeZone | 필수 (1) | <review> 요소의 정보가 마지막으로 변경된 시간/날짜입니다. 특정 검토 ID에 대해 <review> 요소의 필드가 업데이트되면 이 값도 변경해야 합니다.
예: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp> |
country_code
|
CountryCode | 필수 (1) | 리뷰 작성자의 국가입니다. 해당되는 경우 제품이 배송되거나 서비스가 제공된 국가입니다. 그렇지 않은 경우 리뷰 작성 시점에 리뷰 작성자가 위치한 국가를 사용하세요. 국가 코드는 ISO 3166-1 alpha-2 형식이어야 합니다.
예: <country_code>
US
</country_code> |
title
|
xs:string | 선택사항 (0~1) | 리뷰의 제목입니다. 제목은 HTML 태그가 없는 일반 텍스트여야 합니다.
예: <title>
Great prices
</title> |
content
|
xs:string | 필수 (1) | 리뷰의 내용입니다. 이는 사용자가 제공한 자유 형식 텍스트여야 하며 잘리지 않아야 합니다. 콘텐츠는 HTML 태그가 없는 일반 텍스트여야 합니다. 예를 들어 줄바꿈은 <br> 태그가 아닌 줄바꿈 문자로 표시해야 합니다.
서로 다른 질문에 대한 여러 응답이 제공되는 경우 응답이 이해될 수 있도록 최소한의 컨텍스트와 함께 모든 응답이 포함되어야 합니다. 질문에 답변하지 않은 경우 컨텍스트를 제공해서는 안 됩니다.
예: <content>
I like this store!
My order arrived on time and I got
a great price.
</content>예: <content>
Positives: Great prices.
Suggestions: Selection could be better.
</content> |
ratings
|
-- | 필수 (1) | 판매자에 대한 리뷰 작성자의 평점을 위한 컨테이너 요소입니다. <overall> 요소에 사용할 수 있는 등급이 없으면 <overall> 요소가 필수이고 등급이 없으면 리뷰가 허용되지 않으므로 연결된 전체 리뷰를 피드에서 제외해야 합니다.
|
collection_method
|
CollectionMethodType | 필수 (1) | 리뷰를 수집하는 데 사용된 방법입니다. 값은 다음 중 하나여야 합니다.
예: <collection_method>
after_fulfillment
</collection_method> |
<ratings>
설명
리뷰 작성자의 판매자 평점을 포함합니다. <overall> 요소에 사용할 수 있는 평점이 없으면 <overall> 요소가 필수이고 평점이 없으면 리뷰가 허용되지 않으므로 연결된 전체 리뷰를 피드에서 제외해야 합니다.
포함
평가 요소 내에 다음 요소를 포함하세요.
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
overall
|
RatingRange | 필수 (1) | 판매자에 대한 리뷰 작성자의 전체 평점입니다.
예: <overall min="1" max="10">9</overall> |
customer_service
|
RatingRange | 선택사항 (0~1) | 이 판매자의 고객 서비스 품질에 대한 리뷰 작성자의 평가입니다.
예: <customer_service min="1" max="5">3</customer_service> |
<deleted_reviews>
설명
삭제된 리뷰의 컨테이너입니다.
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
deleted_review
|
-- | 필수 (1~n) | 삭제된 단일 리뷰와 관련된 요소를 포함합니다. |
<deleted_review>
설명
삭제된 리뷰입니다.
속성
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
id
|
Id | 필수 (1) | 피드에서 삭제해야 하는 리뷰의 ID를 지정합니다. ID는 피드 파일의 <review> 요소의 ID 속성과 일치해야 합니다.
|
포함
| 이름 | 형식 | 발생 횟수 | 설명 |
|---|---|---|---|
last_update_timestamp
|
DateTimeWithTimeZone | 필수 (1) | 리뷰가 시스템에서 삭제된 시간입니다.
예: <last_update_timestamp>
2016-04-03T18:37:32Z
</last_update_timestamp> |
예
<deleted_review id="10"> <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp> </deleted_review>