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 ニュース メディアの会社のファビコンへのリンク。画像のサイズはファビコンのサイズ（16×16 ピクセル）にする必要があります。画像形式は GIF、JPG、PNG のいずれかにする必要があります。

<reviews>

商品レビューが含まれます。<reviews> 要素には、次の要素が記載されている順序で含まれます。

要素 オカレンス タイプ 説明
<review> 必須 （1 ～無制限） reviewType 個別の固有の商品レビュー。レビューがパブリッシャーのインベントリ内の複数の商品に関連する場合は、レビューを 1 回指定し、<products> 要素に複数の <product> 要素を含めます。

<review>

個別の固有の商品レビュー。レビューがパブリッシャーのインベントリ内の複数の商品に関連する場合は、レビューを 1 回指定し、<products> 要素に複数の <product> 要素を含めます。<review> 要素には、これらの要素がリストに記載されている順序で含まれます。

要素 オカレンス タイプ 説明
<review_id> 必須（1） nonEmptyStringType パブリッシャーのシステム内の商品レビューの永続的な固有 ID。
<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 レビュー担当者の意見に基づく長所が含まれます。レビュー投稿者が書いた場合を除き、「pro:」などのボイラープレート テキストは省略します。
<cons> 省略可 （1） xs:sequence レビュー担当者の意見に基づく短所が含まれます。レビュー担当者が書いた場合を除き、「con:」のような定型文は省略します。
<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。この ID を使用して、複数のレビューが同じ取引に関連付けられていることを示すことができます。

<reviewer>

商品レビューの投稿者。<reviewer> 要素には、次の要素がリストされた順序で含まれます。

要素 オカレンス タイプ 説明
<name> 必須（1） reviewerNameType

レビュー投稿者の名前。

例:

<name>Jane</name>
<reviewer_id> 省略可 （1） nonEmptyStringType

パブリッシャーのシステムにおけるレビューの著者の永続的な固有 ID。

例:

<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（国際取引商品番号）が含まれます。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 販売元の在庫内の商品の最小管理単位（SKU）。

<brands>

商品に関連付けられているブランド名が含まれます。<brands> 要素には、これらの要素がリストに記載された順序で含まれています。

要素 オカレンス タイプ 説明
<brand> 必須 （1 ～無制限） nonEmptyStringType 商品のブランド名。

<asins>

商品に関連付けられている ASIN（Amazon Standard Identification Number）が含まれます。<asins> 要素には、次の要素が記載されている順序で含まれます。

要素 オカレンス タイプ 説明
<asin> 必須 （1 ～無制限） nonEmptyStringType 商品の Amazon 標準識別番号。各 ASIN は 10 文字の英数字です。