XML スキーマ

このセクションでは、販売者レビュー データフィードに使用される 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> 要素には、1 つの販売者に関する情報とレビューが含まれます。

属性

名前	形式	発生回数	説明
id	Id	必須（1）	すべてのフィードで一意かつ安定している必要があります。つまり、今日のフィードと 90 日前のフィードが同じ販売者を指している場合、それらの ID は同じである必要があります。

例

<merchant id="2739">

次を含む

merchant 要素内に次の要素を含めてください。

名前	形式	発生回数	説明
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）	削除された 1 つの販売者に関連する要素が含まれます。

<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）	レビューの収集に使用された方法。値は次のいずれかにする必要があります。 unsolicited: ユーザーは、特定の要請に応じるのではなく、自発的にレビューを送信しました。 point_of_sale: ユーザーが注文したときに、ユーザーは要請に応じてレビューを送信しました。 after_fulfillment: ユーザーは、注文した商品が届いた後に、要請に応じてレビューを送信しました。 例: <collection_method> after_fulfillment </collection_method>

<ratings>

説明

販売者に対するレビュー投稿者の評価が含まれます。<overall> 要素の評価がない場合は、<overall> 要素が必須であり、それがないとレビューが承認されないため、関連するレビュー全体をフィードから除外する必要があります。

次を含む

ratings 要素内に次の要素を含めてください。

名前	形式	発生回数	説明
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>