XML 스키마 참조

Google 제품 리뷰 피드의 XML 스키마는 XML 피드의 허용되는 구조를 정의합니다. XML 스키마는 .xsd 파일 확장자를 사용합니다. DTD 파일과 마찬가지로 XML 스키마는 XML 문서에 표시될 수 있는 요소와 속성을 정의합니다.

이 XML 스키마 입문서에서 XML 스키마에 대해 자세히 알아볼 수 있습니다.

제품 리뷰 피드의 XML 스키마는 다음 위치에 게시됩니다. http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

이 스키마로 정의된 피드 구조에 대한 설명은 다음과 같습니다. 이 설명에서 xs: 접두사가 있는 유형 이름은 XML 네임스페이스 http://www.w3.org/2001/XMLSchema에 있는 내장 XML 스키마 유형을 나타냅니다.

Google 시스템에서는 항상 전체 피드를 예상합니다. 이전에 제출되었지만 다음 전체 피드에 포함되지 않은 리뷰는 삭제됩니다. 따라서 피드를 제출할 때는 항상 모든 리뷰를 제출해야 합니다.

최상위 <feed> 요소

<feed> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<version> 필수 (1) xs:string 사용 중인 제품 리뷰 피드 스키마의 버전을 나타냅니다. 현재는 <version>2.4</version>만 지원됩니다.
<aggregator> 선택사항 (1) aggregatorType 게시자는 리뷰 애그리게이터를 사용하여 리뷰를 관리하고 피드를 제공할 수 있습니다. 이 요소는 애그리게이터의 사용을 나타내며 애그리게이터에 관한 정보를 포함합니다.
<publisher> 필수 (1) publisherType 게시자에 관한 정보입니다. 게시자는 소매업체, 제조업체, 리뷰 서비스 회사 또는 제품 리뷰를 게시하는 모든 법인일 수 있습니다.
<reviews> 선택사항 (1) xs:sequence 제품 리뷰를 포함합니다.

<feed>는 피드에 사용되는 요소의 고유성 제약 조건을 정의합니다.

하위 요소

<aggregator>

게시자는 리뷰 애그리게이터를 사용하여 리뷰를 관리하고 피드를 제공할 수 있습니다. 이 요소는 애그리게이터의 사용을 나타내며 애그리게이터에 관한 정보를 포함합니다. <aggregator> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<name> 필수 (1) nonEmptyStringType 제품 리뷰의 애그리게이터 이름입니다.

<publisher>

게시자에 관한 정보입니다. 게시자는 소매업체, 제조업체, 리뷰 서비스 회사 또는 제품 리뷰를 게시하는 모든 법인일 수 있습니다. <publisher> 요소에는 이러한 요소가 나열된 순서대로 포함됩니다.

요소 발생 횟수 유형 설명
<name> 필수 (1) nonEmptyStringType 제품 리뷰 게시자의 이름입니다.
<favicon> 선택사항 (1) httpUrlType 게시자의 회사 파비콘 링크입니다. 이미지 크기는 파비콘 크기인 16x16픽셀이어야 합니다. 이미지 형식은 GIF, JPG 또는 PNG여야 합니다.

<reviews>

제품 리뷰를 포함합니다. <reviews> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<review> 필수 (1~무제한) reviewType 개별 고유 제품 리뷰입니다. 리뷰가 게시자의 인벤토리에 있는 여러 제품과 관련된 경우 리뷰를 한 번 지정하고 <products> 요소에 여러 <product> 요소를 포함합니다.

<review>

개별 고유 제품 리뷰입니다. 리뷰가 게시자의 인벤토리에 있는 여러 제품과 관련된 경우 리뷰를 한 번 지정하고 <products> 요소에 여러 <product> 요소를 포함합니다.<review> 요소에는 이러한 요소가 나열된 순서대로 포함됩니다.

요소 발생 횟수 유형 설명
<review_id> 필수 (1) nonEmptyStringType 게시자 시스템의 제품 리뷰를 위한 영구적이고 고유한 식별자입니다.
<reviewer> 필수 (1) reviewerType 제품 리뷰의 작성자입니다.
<is_verified_purchase> 선택사항 (1) xs:boolean 리뷰 작성자가 제품을 구매했는지 확인되었는지 여부를 나타냅니다.
<is_incentivized_review> 선택사항 (1) xs:boolean 리뷰 작성자가 제품을 리뷰하도록 인센티브를 받았는지 여부를 나타냅니다.
<review_timestamp> 필수 (1) xs:dateTime

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

예:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> 선택사항 (1) nonEmptyStringType 리뷰의 제목입니다.
<content> 필수 (1) nonEmptyStringType 리뷰의 내용입니다.
<review_language> 선택사항 (1) xs:string 리뷰의 언어 (BCP 47)입니다.
<review_country> 선택사항 (1) xs:string 리뷰어의 국가 코드 (ISO 3166-1)입니다.
<pros> 선택사항 (1) xs:sequence 리뷰 작성자의 의견을 기반으로 한 장점이 포함됩니다. 리뷰어가 작성하지 않은 경우 '장점'과 같은 상용구 텍스트를 생략합니다.
<cons> 선택사항 (1) xs:sequence 리뷰 작성자의 의견을 기반으로 한 단점을 포함합니다. 리뷰어가 작성하지 않은 경우 '단점:'과 같은 상용구 텍스트를 생략합니다.
<reviewer_images> 선택사항 (1) xs:sequence 리뷰 작성자가 제공한 제품 이미지 링크가 포함되어 있습니다.
<review_url> 필수 (1) reviewUrlType 리뷰 방문 페이지의 URL입니다.
<ratings> 필수 (1) xs:sequence 리뷰와 연결된 평점을 포함합니다.
<products> 필수 (1) xs:sequence 리뷰와 연결된 제품을 포함합니다.
<is_spam> 선택사항 (1) xs:boolean 리뷰가 게시자의 시스템에서 스팸으로 표시되었는지 여부를 나타냅니다.
<collection_method> 선택사항 (1) collectionMethodType

리뷰를 수집하는 데 사용된 방법입니다. 값은 다음 중 하나여야 합니다.

unsolicited
사용자가 리뷰를 제출할 때 특정 요청에 따른 것이 아니었습니다.
post_fulfillment
사용자가 주문을 완료한 후 요청에 따라 리뷰를 제출했습니다.
<transaction_id> 선택사항 (1) nonEmptyStringType 게시자 시스템에서 리뷰와 연결된 거래의 영구적인 고유 식별자입니다. 이 ID는 여러 리뷰가 동일한 거래와 연결되어 있음을 나타내는 데 사용할 수 있습니다.

<reviewer>

제품 리뷰의 작성자입니다. <reviewer> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<name> 필수 (1) reviewerNameType

리뷰 작성자의 이름입니다.

예:

<name>Jane</name>
<reviewer_id> 선택사항 (1) nonEmptyStringType

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

예:

<reviewer_id>14295</reviewer_id>

<name>

리뷰 작성자의 이름입니다. <name> 요소는 nonEmptyStringType의 확장이며 리뷰 작성자의 이름이나 별칭을 포함합니다. <name> 요소에는 다음 속성이 포함되어 있습니다.

속성 발생 횟수 유형 설명
is_anonymous 선택사항 xs:boolean

리뷰 작성자가 익명인지 여부를 나타냅니다.

예:

<name is_anonymous="true">Anonymous</name>

<pros>

리뷰 작성자의 의견을 기반으로 한 장점이 포함됩니다. <pros> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<pro> 필수 (1~무제한) nonEmptyStringType

검토자의 의견을 기반으로 한 개별 장점입니다. 장점은 표시되는 순서와 동일한 순서로 나열해야 합니다. 리뷰 작성자가 작성하지 않은 경우 '장점:'과 같은 상용구 텍스트를 생략합니다.

예:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

리뷰 작성자의 의견을 기반으로 한 단점을 포함합니다. <cons> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<con> 필수 (1~무제한) nonEmptyStringType

검토자의 의견을 기반으로 한 단점입니다. 단점은 표시되는 순서와 동일한 순서로 나열해야 합니다. 리뷰어가 작성하지 않은 경우 '단점'과 같은 상용구 텍스트를 생략합니다.

예:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

리뷰 방문 페이지의 URL입니다. <review_url> 요소는 httpUrlType의 확장이며 리뷰의 방문 페이지 링크를 포함합니다. <review_url> 요소는 다음 속성을 포함합니다.

속성 발생 횟수 유형 설명
type 필수 xs:string

유형은 다음 중 하나여야 합니다.

singleton
리뷰 페이지에 이 단일 리뷰만 포함되어 있습니다.
group
리뷰 페이지에는 이 리뷰를 포함한 리뷰 그룹이 포함되어 있습니다.

예:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

리뷰어가 제공한 제품 이미지가 포함되어 있습니다. <reviewer_images> 태그에는 여러 <reviewer_image> 요소가 포함되어 있습니다.

요소 발생 횟수 유형 설명
<reviewer_image> 필수 (1~무제한) reviewImageType

리뷰 작성자가 만든 리뷰 대상 제품의 이미지입니다.

<reviewer_image>

단일 리뷰 이미지 요소입니다.

요소 발생 횟수 유형 설명
<url> 필수 (1) httpUrlType

리뷰 작성자가 만든 리뷰 대상 제품의 이미지 URL입니다. URL이 이미지 파일 확장자로 끝나지 않아도 됩니다.

예:

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

리뷰와 연결된 평점을 포함합니다. <ratings> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<overall> 필수 (1) ratingType 제품에 대한 리뷰어의 전체 평점입니다.

<overall>

제품에 대한 리뷰어의 전체 평점입니다. <overall> 요소는 xs:decimal simpleType를 확장하고 검토자가 할당한 평가를 캡처합니다. 값은 min 및 max 속성으로 정의된 포함 범위 내에 있어야 합니다. <overall> 요소는 다음 속성을 포함합니다.

속성 발생 횟수 유형 설명
min 필수 xs:integer 평점의 최소 가능 수치입니다. 이 값은 가능한 최악의 평가여야 하며 평가가 없는 값이어서는 안 됩니다.
max 필수 xs:integer 평점의 최대 가능 수치입니다. max 속성 값은 min 속성 값보다 커야 합니다.

<products>

리뷰와 연결된 제품을 포함합니다. <products> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<product> 필수 (1~무제한) productType 리뷰와 연결된 제품입니다.

<product>

리뷰와 연결된 제품입니다. <product> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<product_ids> 선택사항 (1) productIdsType 제품과 연결된 식별자입니다.
<product_name> 선택사항 (1) nonEmptyStringType 제품의 설명 이름입니다.
<product_url> 필수 (1) httpUrlType 제품의 URL입니다. 리뷰 URL과 제품 URL이 동일한 경우 이 URL은 <review_url> 요소와 동일한 값을 가질 수 있습니다.

<product_ids>

제품과 연결된 식별자입니다. <product_ids> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<gtins> 필수사항 (알려진 GTIN이 있는 제품과 연결된 모든 리뷰에 해당)

기타 모든 리뷰의 경우 선택사항(1)		 gtinsType 제품과 연결된 GTIN (국제거래단품식별코드)을 포함합니다. GTIN 하위 유형 (예: UPC, EAN, ISBN, JAN)이 지원됩니다.
<mpns> 필수사항 (알려진 MPN이 있는 제품과 관련된 모든 리뷰)

기타 모든 리뷰의 경우 선택사항(1)		 mpnsType 제품과 관련된 MPN (제조업체 부품 번호)을 포함합니다.
<skus> 필수 (알려진 SKU가 있는 제품과 연결된 모든 리뷰)

기타 모든 리뷰의 경우 선택사항(1)		 skusType 제품과 연결된 SKU (재고 관리 단위)를 포함합니다. 이 값은 제품 피드의 제품 혜택 ID와 일치하는 경우가 많습니다.
<brands> 필수사항 (알려진 브랜드가 있는 제품과 관련된 모든 리뷰)

기타 모든 리뷰의 경우 선택사항 (1)		 brandsType 제품과 연결된 브랜드 이름을 포함합니다.
<asins> 선택사항 (1) asinsType 제품과 연결된 ASIN (Amazon 표준 식별 번호)을 포함합니다.

<gtins>

제품과 연결된 GTIN (국제거래단품식별코드)을 포함합니다. <gtins> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<gtin> 필수 (1~무제한) nonEmptyStringType 제품의 국제거래단품식별코드입니다. GTIN 하위 유형 (예: UPC, EAN, ISBN, JAN)이 지원됩니다.

<mpns>

제품과 관련된 MPN (제조업체 부품 번호)을 포함합니다. <mpns> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<mpn> 필수 (1~무제한) nonEmptyStringType 제품의 제조업체 부품 번호입니다.

<skus>

제품과 연결된 SKU (재고 관리 단위)를 포함합니다. <skus> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<sku> 필수 (1~무제한) nonEmptyStringType 발행인의 인벤토리에 있는 제품의 재고 관리 단위입니다.

<brands>

제품과 연결된 브랜드 이름을 포함합니다. <brands> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<brand> 필수 (1~무제한) nonEmptyStringType 제품의 브랜드 이름입니다.

<asins>

제품과 연결된 ASIN (Amazon 표준 식별 번호)을 포함합니다. <asins> 요소에는 나열된 순서대로 이러한 요소가 포함됩니다.

요소 발생 횟수 유형 설명
<asin> 필수 (1~무제한) nonEmptyStringType 제품의 Amazon 표준 식별 번호입니다. 각 ASIN은 10자 길이의 영숫자입니다.