XML スキーマ

このセクションでは、販売者がレビューするデータフィードに使用する XML スキーマについて説明します。

最上位の要素: <feed>

説明

フィード内の他のすべての要素を保持する最上位のコンテナ要素。

属性

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

含む

名前	Format	発生回数	説明
merchants	--	任意（0 ～ 1）	<merchant> 要素のコンテナ要素。
deleted_merchants	--	任意（0 ～ 1）	<deleted_merchant> 要素のコンテナ要素。
reviews	--	任意（0 ～ 1）	<review> 要素のコンテナ要素。
deleted_reviews	--	任意（0 ～ 1）	<deleted_review> 要素のコンテナ要素。

<merchants>

説明

<merchant> 要素のコンテナ。

含む

名前	Format	発生回数	説明
merchant	--	必須（1 ～ n）	販売者ごとに繰り返される要素。

<merchant>

説明

各 <merchant> 要素には、1 つの販売者の情報とレビューが含まれます。

属性

名前	Format	発生回数	説明
id	ID	必須（1）	すべてのフィードで一意で不変である必要があります。つまり、現在のフィードと 90 日前のフィードが同じ販売者を参照している場合、同じ ID が必要です。

例

<merchant id="2739">

含む

販売者要素には次の要素を含めます。

名前	Format	発生回数	説明
name	EmptyEmpty	必須（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>

説明

削除された販売者のコンテナ。

含む

名前	Format	発生回数	説明
deleted_merchant	--	必須（1 ～ n）	削除した 1 人の販売者に関連する要素が含まれます。

<deleted_merchant>

説明

削除された販売者。

属性

名前	Format	発生回数	説明
id	ID	必須（1）	フィードから削除する販売者の ID を指定します。この ID は、以前のフィード ファイル内にある <merchant> 要素の id 属性と一致する必要があります。

含む

名前	Format	発生回数	説明
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> 要素のコンテナ。

含む

名前	Format	発生回数	説明
review	--	必須（1 ～ n）	レビューごとに要素を繰り返す。

<review>

説明

クチコミに関連する詳細情報のコンテナ。

属性

名前	Format	発生回数	説明
id	ID	必須（1）	システムにおけるクチコミの ID。すべてのフィードで一意かつ安定した値にする必要があります。 例: <review id=132739 mid=1234>
mid	ID	必須（1）	このレビューの対象となる販売者の ID。

含む

レビュー要素内には、次の要素を含めます。

名前	Format	発生回数	説明
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> 要素の情報が最後に変更された日時。<review> 要素のフィールドのいずれかが特定のレビュー ID で更新された場合は、この値も変更する必要があります。 例: <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）	レビューの収集に使用された方法。値は次のいずれかにする必要があります。 自発的な問い合わせ: ユーザーがレビューを送った際に、特定の勧誘に対して回答しなかったこと。 point_of_sale: ユーザーが注文をしたときに、勧誘に応じてレビューを送信しました。 After_fulfillment: ユーザーは、注文のフルフィルメント後の勧誘に応じてレビューを提出しました。 例: <collection_method> after_fulfillment </collection_method>

<ratings>

説明

販売者のクチコミ投稿者の評価が含まれます。<overall> 要素の評価を使用できない場合は、関連するレビュー全体をフィードから除外する必要があります。これは、<overall> 要素が必要であり、これがないとレビューが受け付けられないためです。

含む

ratings 要素内には、次の要素を含めます。

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

説明

削除されたクチコミのコンテナ。

含む

名前	Format	発生回数	説明
deleted_review	--	必須（1 ～ n）	削除した 1 件のクチコミに関連する要素が含まれます。

<deleted_review>

説明

削除されたクチコミを確認します。

属性

名前	Format	発生回数	説明
id	ID	必須（1）	フィードから削除する必要があるクチコミの ID を指定します。この ID は、フィード ファイル内の <review> 要素の id 属性と一致する必要があります。

含む

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