XML 스키마

이 섹션에서는 판매자 리뷰 데이터 피드에 사용되는 XML 스키마를 설명합니다.

최상위 요소: <feed>

설명

피드에 있는 다른 모든 요소를 포함하는 최상위 컨테이너 요소.

속성

이름 형식 발생 횟수 설명
xmlns xs:문자열 필수 (1개) 다음 값을 하드코딩하세요.
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:문자열 필수 (1개) 다음 값을 하드코딩하세요.
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:문자열 필수 (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 국가 코드 필수 (1개) 리뷰 작성자의 국가입니다. 가능한 경우 제품이 배송된 국가 또는 서비스가 렌더링된 국가입니다. 그렇지 않은 경우 리뷰 작성자가 리뷰를 작성한 시점에 국가를 사용하세요. 국가 코드는 ISO 3166-1 alpha-2 형식이어야 합니다.

예: 

  <country_code>
    US
  </country_code>
title xs:문자열 선택사항 (0~1) 리뷰 제목입니다. 제목은 HTML 태그가 없는 일반 텍스트여야 합니다.

예: 

  <title>
    Great prices
  </title>
content xs:문자열 필수 (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개) 리뷰를 수집하는 데 사용된 방법입니다. 값은 다음 중 하나여야 합니다.
  • 요청하지 않음: 사용자가 리뷰를 제출할 때 특정 요청에 응답하지 않았습니다.
  • point_of_sale: 사용자가 주문 시 요청에 응답하여 리뷰를 제출했습니다.
  • after_fulfillment: 사용자의 주문이 완료된 후 사용자가 요청에 따라 리뷰를 제출했습니다.

예: 

  <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) 삭제된 리뷰 1개와 관련된 요소가 포함되어 있습니다.

<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>