XML 스키마 참조

도서: /product-review-feeds/_book.yaml

제목: XML 스키마 참조

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

이 XML 스키마 기본 지침서에서 XML 스키마에 대해 자세히 알아볼 수 있습니다.

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

다음은 이 스키마로 정의된 피드 구조에 대한 설명입니다. 이 설명에서 xs: 프리픽스가 있는 유형 이름은 XML 네임스페이스 http://www.w3.org/2001/XMLSchema에 있는 기본 제공 XML 스키마 유형을 나타냅니다.

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

최상위 <feed> 요소

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

요소 어커런스 유형 설명
<version> 필수 (1개) xs:string 사용 중인 제품 리뷰 피드 스키마 버전을 나타냅니다. 현재 <version>2.3</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 제품 리뷰의 작성자입니다.
<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 리뷰 콘텐츠입니다.
<pros> 선택사항(1개) xs:sequence 리뷰 작성자의 의견을 기반으로 장단점이 포함됩니다. 검토자가 작성한 것이 아니라면 'pro:'와 같은 상용구 텍스트는 생략합니다.
<cons> 선택사항(1개) xs:sequence 리뷰 작성자의 의견을 바탕으로 단점이 포함되어 있습니다. 검토자가 작성한 것이 아니라면 'con:;conquo;와 같은 상용구 텍스트는 생략합니다.
<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

리뷰 작성자의 의견에 따른 개인 전문가입니다. 전문가는 표시된 순서와 동일한 순서로 나열되어야 합니다. 검토자가 작성한 것이 아닌 경우에는 'pro:"와 같은 상용구 텍스트는 생략합니다.

예:

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

<cons>

리뷰 작성자의 의견을 바탕으로 단점이 포함되어 있습니다. <cons> 요소에는 이러한 요소가 나열된 순서대로 포함됩니다.

요소 어커런스 유형 설명
<con> 필수 항목(1개 무제한) nonEmptyStringType

리뷰 작성자의 의견을 바탕으로 한 개인적 결정입니다. 단점은 표시된 순서와 같아야 합니다. 검토자가 작성한 것이 아닌 경우 'con:;'과 같은 상용구 텍스트는 생략합니다.

예:

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

<review_url>

리뷰 방문 페이지의 URL입니다. <review_url> 요소는 httpUrlType의 확장이며 리뷰의 방문 페이지 링크를 포함합니다. <review_url> 요소에는 이러한 속성이 포함되어 있습니다.

속성 어커런스 유형 설명
type 필수 xs:string

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

singleton
리뷰 페이지에는 이 리뷰 1개만 포함됩니다.
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 (국제거래단품식별코드)이 포함됩니다.
<mpns> 필수 (리뷰와 연결된 제품에 할당된 GTIN이 없는 경우 리뷰 일치를 촉진하기 위해 MPN을 포함해야 함) 브랜드와 함께 제출해야 함)

그 밖의 모든 리뷰에 대한 선택사항(1개)		 mpnsType 제품과 연결된 MPN (제조업체 부품번호)이 포함되어 있습니다.
<skus> 필수 (리뷰와 연결된 제품에 할당된 GTIN 또는 MPN이 없는 경우 리뷰 일치를 용이하게 하기 위해 SKU를 포함해야 합니다. 브랜드와 함께 제출해야 함)

그 밖의 모든 리뷰에 대한 선택사항(1)		 skusType 제품과 연결된 SKU (재고 관리 단위)를 포함합니다. 대개 제품 피드의 제품 제공 ID와 일치합니다.
<brands> 필수사항 (리뷰와 연결된 제품에 할당된 GTIN이 없는 경우 브랜드를 쉽게 리뷰할 수 있도록 포함) MPN으로 제출해야 함)

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

<gtins>

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

요소 어커런스 유형 설명
<gtin> 필수 항목(1개 무제한) nonEmptyStringType 제품의 국제거래단품식별코드입니다.

<mpns>

제품과 연결된 MPN (제조업체 부품번호)이 포함되어 있습니다. <mpns> 요소에는 이러한 요소가 나열된 순서대로 포함됩니다.

요소 어커런스 유형 설명
<mpn> 필수 항목(1개 무제한) nonEmptyStringType 제품의 제조업체 부품 번호입니다.

<skus>

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

요소 어커런스 유형 설명
<sku> 필수 항목(1개 무제한) nonEmptyStringType 게시자의 인벤토리에서 제품의 재고가 유지되는 단위입니다.

<brands>

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

요소 어커런스 유형 설명
<brand> 필수 항목(1개 무제한) nonEmptyStringType 제품의 브랜드 이름입니다.

<asins>

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

요소 어커런스 유형 설명
<asin> 필수 항목(1개 무제한) nonEmptyStringType 제품의 Amazon 표준 식별 번호입니다. 각 ASIN은 길이와 영숫자로 10자입니다.